索引API的HTML表示现已冻结
内容提要
PyPI已采纳PEP 833，冻结索引API的HTML表示，未来开发聚焦JSON表示。HTML仍会更新内容，但不再扩展新功能，因维护成本高且用户多转向JSON。下游用户无需立即行动，但建议批量消费者改用JSON，以获取更佳元数据和功能。
延伸解读
冻结而非废弃：HTML索引仍可用
PEP 833的冻结并非移除HTML表示，而是停止为其添加新功能。PyPI仍会继续更新HTML内容，新包和版本会照常出现，因此现有依赖HTML的消费者不会遇到破坏性变化。这一政策调整主要影响未来标准化方向，而非当前可用性。
为何冻结HTML？维护成本与用户习惯
HTML表示因历史原因结构僵化，添加新元数据需通过<meta>标签或属性“硬塞”，且许多消费者对空白、属性顺序等无关细节做出假设，导致改动困难。相比之下，JSON表示设计初衷即面向机器，扩展自然。同时，多数用户已转向JSON，继续维护HTML收益有限。
批量消费者应转向JSON
对于镜像PyPI的批量消费者，建议将JSON作为主要消费格式。JSON提供更丰富的字段和结构化元数据，如PEP 700的upload-time仅存在于JSON。即使需要HTML，也可从JSON重建。个人用户无需操作，因为pip和uv已默认优先使用JSON。
Q&A
PyPI 采纳 PEP 833 后，索引 API 的 HTML 表示发生了什么变化？
PyPI 采纳了 PEP 833，正式冻结了索引 API 的 HTML 表示（也称为简单 API）。这意味着 HTML 表示仍会继续更新内容，但不再扩展新功能，未来的标准化和开发工作将聚焦于 JSON 表示。
为什么 PyPI 决定冻结 HTML 表示而不是直接弃用？
因为 HTML 表示历史悠久，许多下游消费者依赖它，无法直接弃用。但 HTML 结构不灵活，添加新元数据需要强行塞入 HTML 属性或 meta 标签，维护成本高，且用户多转向 JSON，因此决定冻结，不再扩展新功能。
作为普通用户（使用 pip 或 uv 安装包），PEP 833 对我有影响吗？
没有影响。因为 HTML 表示本身没有变化，而且 pip（自 22.2 版本起）和 uv 已经支持 JSON 表示，通常会优先使用 JSON。
作为批量索引消费者（如镜像 PyPI），我是否需要立即采取行动？
不需要立即行动，HTML 表示仍会继续更新内容。但强烈建议考虑切换到 JSON 表示作为主要消费格式，因为 JSON 提供更好的元数据和结构化信息，且可以从 JSON 重建 HTML 表示。
HTML 表示和 JSON 表示在标准化上有什么区别？
HTML 表示在 PEP 503 中标准化，是早期为人类阅读设计的，结构简单；JSON 表示在 PEP 691 中标准化，专为机器客户端设计，能自然表达对象模型，添加新元数据更容易。
PEP 792 中 HTML 和 JSON 表示如何体现元数据？
以项目状态为例，JSON 表示使用嵌套对象：{"meta": {"api-version": "1.4"}, "project-status": {"status": "quarantined", "reason": "..."}}；HTML 表示则使用多个 meta 标签：<meta name="pypi:repository-version" content="1.4"> 等，需要扁平化处理。
