进阶 docs.pypi.org 2026-10-20 06:39:13 · 22 阅读

第3章 PEP 541:包名称保留策略解析

Name Retention

注意

本页仅收录 PEP 541 的政策部分内容。PEP 中的程序性部分(摘要、动机等)未包含在本页,可在 PEP 原文中查阅。

规范

本文档的核心理念是:Package Index 为社区服务。我们欢迎每位用户在遵守使用条款的前提下向 Package Index 上传内容,但风险由用户自行承担。Package Index 虽然不是备份服务,其维护者仍会尽力让已发布的内容永久保持可访问状态。但在某些极端情况下,社区的整体需求可能高于个人对包名的所有权预期。本文档覆盖以下用例:

  • 被遗弃的项目:
    • 由其他用户接手继续维护;或
    • 从 Index 中移除,将名称让给其他项目使用。
  • 活跃项目:
    • 解决名称纠纷。
  • 无效项目:
    • 涉嫌侵犯知识产权的项目。

在“实施”一节中提出的使用条款扩展,将作为独立文档发布在 Package Index 上,并在首页页脚现有使用条款旁提供链接。

实施

可达性

对于自己拥有的项目相关事务,用户有责任确保 Package Index 维护者能够联系到自己。凡需要联系用户时,维护者会至少尝试三次,联系方式包括:

  • 用户在 Package Index 上个人资料中登记的电子邮箱;
  • 上传到 Index 的项目 Author 字段中列出的电子邮箱;以及
  • 项目在 Index 上的文档或所列主页中出现的任何电子邮箱。

六周后,维护者将停止尝试联系该用户。

被遗弃的项目

同时满足以下全部条件的项目视为被遗弃:

  • 所有者无法联系(参见上文“可达性”);
  • 过去十二个月内没有发布过新版本;且
  • 所有者在其项目主页上没有任何活动(或未列出主页)。

其余项目均视为活跃项目。

被遗弃项目的接手维护

如果有候选人愿意接手维护某个被遗弃的项目,需同时满足以下全部条件,名称所有权才会转移:

  • 项目已按上述规则被判定为遗弃;
  • 候选人能证明自己曾尝试联系现有所有者但失败;
  • 候选人能证明自己在项目 fork 上做出的改进;
  • 候选人能说明为何换一个名称的 fork 不能作为替代方案;以及
  • Package Index 维护者没有其他保留意见。

任何情况下,都不会在所有者可联系且明确反对时重新分配名称。

移除被遗弃的项目

项目绝不会仅因被遗弃就从 Package Index 中移除。上传到 Package Index 的产物本身具有历史价值。

若要将名称转让给新所有者以便复用,需同时满足以下全部条件:

  • 项目已按上述规则被判定为遗弃;
  • 候选人能证明自己曾尝试联系现有所有者但失败;
  • 候选人能证明拟复用该名称的项目已实际存在,并满足知名度要求;
  • 候选人能说明为何换一个名称的 fork 不能作为替代方案;且现有包在 Package Index 上的下载统计显示该项目已无人使用;
  • Package Index 维护者没有其他保留意见。
活跃项目的名称纠纷解决

Package Index 维护者不担任活跃项目纠纷的仲裁者。实际情况多种多样,下面列出的(非穷尽的)是一些真实案例。以下情形均不符合包名所有权转移的条件:

  • 用户 A 和用户 B 共同维护项目 X。后来两人分道扬镳,都想继续以名称 X 维护该项目。
  • 用户 A 在 Package Index 之外拥有项目 X。用户 B 在 Index 上以 X 为名创建了包。之后用户 A 想把项目 X 发布到 Index,却发现名称已被占用。即使用户 A 的项目 X 已有知名度,而用户 B 的项目 X 毫不起眼,结果也一样。
  • 用户 A 将项目 X 发布到 Package Index。之后用户 B 提交了 bug 修复,但用户 A 一直没有发布新版本。即使用户 A 曾同意发布新版本却最终没有发布,即使用户 B 的改动已合并到项目 X 的源码仓库,结果也一样。

再次强调,上述列表并非穷尽。Package Index 维护者建议用户之间直接沟通,通过相互尊重的交流来解决问题(参见 PSF 行为准则)。

无效项目

发布在 Package Index 上的项目如满足以下任一条件,即被视为无效并从 Index 中移除:

  • 项目不符合使用条款;
  • 项目是恶意软件(直接用于攻击或危害系统/用户、协助命令与控制攻击、或窃取数据);
  • 项目是垃圾内容(用于宣传或兜售商品或服务);
  • 项目包含违法内容;
  • 项目侵犯版权、商标、专利或许可证;
  • 项目属于抢注名称(包没有任何功能或为空);
  • 项目名称、描述或内容违反行为准则;
  • 项目使用混淆手段隐藏或掩盖其功能;或
  • 项目将 Package Index 用于非预期用途。

出于安全考虑,Package Index 维护者会预先将某些包名设为不可用。

知识产权政策

Python Software Foundation 和 Package Index 维护者的政策是:对第三方提出的知识产权侵权主张做出适当回应。但两者均不负责对上传的包进行任何形式的知识产权侵权预审。

疑似侵权的包应报告至 legal@python.org,Python Software Foundation 的法律顾问将决定合适的处理方式。为应对侵权主张,Python Software Foundation 可自行决定移除该包或将其转让给新所有者。

发布在 Package Index 上的项目如满足以下任一条件,可能被视为侵权,并从 Index 中移除或转让给新所有者:

  • 项目包含未经许可的第三方版权材料,并已收到依据 DMCA 正式提出的侵权主张;
  • 项目以名义性使用或合理使用准则之外的方式使用了第三方商标;
  • 项目明显涉及某项已授予专利的系统或流程,并成为投诉对象;或
  • 项目正在被诉讼。

收到知识产权侵权投诉后,投诉副本将发送给包所有者。某些情况下,Package Index 维护者可能在所有者回应之前就采取行动。

Python Software Foundation 的角色

Python Software Foundation 是以社区服务形式提供 Package Index 的非营利法人实体。

当本文档所涉问题不够明确时,Package Index 维护者可将问题上报给 Packaging Workgroup 处理。某些决定需要 Board 做出额外判断,尤其是涉及违反行为准则或法律主张的情形。Board 提出的建议会交由 Packaging Workgroup 审议。

对于本文档所涉的任何纠纷,Packaging Workgroup 拥有最终决定权。即使未完全满足本文所列的全部条件,Packaging Workgroup 也可在审慎考虑后决定重新分配项目名称或将项目从 Package Index 中移除。

如何申请名称转让

如果你想接管 PyPI 上已有的项目名称,请按以下步骤操作:

  1. 先直接联系当前所有者:发邮件,如果能找到相关代码仓库也可以提 issue。本文所述流程是联系不到所有者时的最后手段。
  2. 对照上文标准,确认转让是否被允许。特别要注意,将名称复用于另一个项目的标准比接手继续维护原项目更严格——虽然两种情形下名称转让都不容易。
  3. 搜索 PyPI Support issues,看是否已有人申请同一个名称。
  4. 如果全部条件都满足,提一个新 issue 提出申请,详细说明你认为各项相关条件已满足的理由。

评论 (0)