PyPI 11 月 6 日上线了改版后的项目页,侧栏和 Security 页会标出一个版本的 provenance 状态。我没有升级任何包,用这台机器上 Python 3.11.9 正在用的 8 个包对了一遍:项目页、每个文件的 Integrity API,再加上 https://pypi.org/pypi/<name>/json。
8 个包的最新版里,5 个是 Full provenance,3 个一个文件都没有证明。本机正在用的版本也是这个比例。另外,JSON API 里这 8 个包合计 18304 个文件都没有 provenance 字段,页面上明明写着 Full 的也一样。照着 JSON 查,会把有证明的包看成没有。
先说结论
| 包 | 本机 | PyPI 最新 | 最新版 | 本机这个版本 |
|---|---|---|---|---|
| requests | 2.34.2 | 2.34.2(2026-05-14) | Full,2 个文件都有 | 同左 |
| pydantic | 2.13.4 | 2.14.3(2026-11-05) | Full,2 个文件都有 | 2.13.4 也是 Full |
| certifi | 2026.6.17 | 2026.10.23(2026-10-23) | Full,2 个文件都有 | 2026.6.17 也是 Full |
| aiohttp | 3.14.3 | 3.14.5(2026-10-11) | Full,161 个文件逐个查过 | 3.14.3 的源码包有证明 |
| cryptography | 50.0.2 | 50.0.2(2026-09-30) | Full,59 个文件逐个查过 | 同左 |
| httpx | 0.28.1 | 0.28.1(2024-12-06) | No provenance | 同左,发布历史里 76 个版本全是 |
| fastapi | 0.139.0 | 0.163.1(2026-11-15) | No provenance | 0.139.0 也没有 |
| anthropic | 0.116.0 | 2.9.0(2026-11-16) | No provenance | 0.116.0 也没有 |
三条可以带走的:
- 页面写 No provenance,只说明这个版本的文件来源没法做密码学校验。官方原文写了,这不等于包是恶意的。
- fastapi 不是从来没有证明。0.115.5 到 0.128.0 这 53 个版本是 Full,0.128.1(2026-02-04)起直到昨天的 0.163.1 都没有。本机装的 0.139.0 落在断开之后。
- 不要用 JSON API 的
urls[].provenance做判断。这次查的 8 个包、全部历史文件,这个键都不存在。要查就查项目页,或者GET /integrity/<项目>/<版本>/<文件名>/provenance:有证明是 200,没有是 404。
背景
PyPI 的博客(2026-11-06)说,7 月预告的界面改动已经全部上线。新的 Security 页按文件列出 attestation,侧栏在 Full provenance 或出现警告时显示状态。
博客把状态分成两类常见结果和四种警告。Full Provenance 是这个版本 100% 的文件都有证明,类型是 PyPI Publish、SLSA Build Provenance,或者两种都有。No provenance 是一个文件都没有,常见于旧版本和还没配 Trusted Publishing 的项目。四种警告是:部分文件有、部分没有(Incomplete);同一版本的文件来自不同构建或不同仓库(Inconsistent);跟上一个版本的仓库或工作流不一样(Change of provenance);以前有、这次没有(Loss of provenance)。
用户文档把 No provenance 写成:它不表示这个版本或文件是恶意的,只表示文件来源不能被密码学校验。文档还写了两处边界:Change 和 Loss 这两种警告,只在跟过去 14 天内的某个版本对比出差异时才出现;attestation 只说明文件从哪来,不说明源码或构建环境本身可信。安装器这边,文档写 pip 和 uv 的原生校验都还没在做,第三方有 pip-plugin-pep740。
证明本身从 2024 年就有。这次改的是把它放到项目页上,不是新发明了一种签名。
实测
环境是 Windows 10,Python 3.11.9。8 个包都已经装在 F:\Python311\Lib\site-packages。版本号、368 个历史版本的接口和下面这几段原始输出,是让 SpectrAI 里的 Agent 逐条查的,命令和返回都留在这次的记录里。全程只读,没有执行安装或升级:
$ python -c "import importlib.metadata as m
for n in ['requests','httpx','cryptography','fastapi','pydantic','aiohttp','certifi','anthropic']:
print(n, m.version(n))"
requests 2.34.2
httpx 0.28.1
cryptography 50.0.2
fastapi 0.139.0
pydantic 2.13.4
aiohttp 3.14.3
certifi 2026.6.17
anthropic 0.116.0
项目页直接打开了 6 个。cryptography 和 anthropic 的 HTML 请求被拦在一段 Client Challenge 上,页面只有「JavaScript is disabled in your browser」,正文没出来。这两个改用 JSON API 拿版本和文件名,再用 Integrity API 逐个文件核对,状态不靠那两页 HTML。
有证明的 5 个,发布者都是 GitHub 上的一个 workflow,证明类型都是 PyPI publish(https://docs.pypi.org/attestations/publish/v1),没有看到 SLSA。对应关系:
requests 2.34.2 psf/requests publish.yml
pydantic 2.14.3 pydantic/pydantic ci.yml 本机 2.13.4 同一条
certifi 2026.10.23 certifi/python-certifi release.yml 本机 2026.6.17 同一条
cryptography 50.0.2 pyca/cryptography pypi-publish.yml
aiohttp 3.14.5 aio-libs/aiohttp ci-cd.yml 本机 3.14.3 同一条
文件数不是凭页面上的一句话。aiohttp 3.14.5 有 161 个文件,cryptography 50.0.2 有 59 个,我按文件名各请求了一次 Integrity API,161 个和 59 个全部返回 200。页面写「All 161 files in this release have provenance metadata」和接口结果一致。
没有证明的 3 个,接口返回的是同一句:
$ curl -s -o - -w "\nHTTP %{http_code}\n" \
https://pypi.org/integrity/httpx/0.28.1/httpx-0.28.1.tar.gz/provenance
{"message":"No provenance available for httpx-0.28.1.tar.gz"}
HTTP 404
$ curl -s -o - -w "\nHTTP %{http_code}\n" \
https://pypi.org/integrity/fastapi/0.163.1/fastapi-0.163.1.tar.gz/provenance
{"message":"No provenance available for fastapi-0.163.1.tar.gz"}
HTTP 404
$ curl -s -o - -w "\nHTTP %{http_code}\n" \
https://pypi.org/integrity/anthropic/2.9.0/anthropic-2.9.0.tar.gz/provenance
{"message":"No provenance available for anthropic-2.9.0.tar.gz"}
HTTP 404
三个包的 wheel 也是 404。httpx 的项目页更彻底:Release history 里能读到的 76 个版本全部标着 No provenance,0.28.1 是 2024-12-06 传的,到今天还是最新版。anthropic 的最新版 2.9.0 是 2026-11-16 16:47 UTC 传的,也就是昨天,两个文件都没有证明;本机的 0.116.0(2026-07-02)同样 404。
对照着看,有证明的包不是「大项目才有」。certifi 只有 1 个维护者,最新版两个文件都有;anthropic 是官方客户端,昨天的版本没有。
JSON API 读不到这个字段
https://pypi.org/pypi/pydantic/json 的最新版是 2.14.3,项目页写 Full provenance,Integrity API 对两个文件都返回 200。同一份 JSON 里,文件对象的键是这些:
comment_text, core-metadata, digests, downloads, filename, has_sig,
md5_digest, packagetype, python_version, requires_python, size,
upload_time, upload_time_iso_8601, url, yanked, yanked_reason
没有 provenance。不是空字符串,也不是 null,是这个键不在。
我把 8 个包的历史版本都数了一遍,看的是 releases 里每一个文件:
requests 163 个版本 244 个文件 带 provenance 键的文件 0
httpx 77 个版本 145 个文件 0
cryptography 160 个版本 3742 个文件 0
fastapi 368 个版本 736 个文件 0
pydantic 211 个版本 2066 个文件 0
aiohttp 314 个版本 10746 个文件 0
certifi 79 个版本 146 个文件 0
anthropic 240 个版本 479 个文件 0
合计 18304 个文件 0
pydantic 的页面明明写着 Full,JSON 里从 2017 年的 0.0.1 到 2026-11-05 的 2.14.3,没有一个文件带这个键。用它做「有没有来源证明」的判断,结果是全部漏报。
Integrity API 的文档写的是另一条路由:GET /integrity/<project>/<version>/<filename>/provenance。200 是有 provenance 对象,404 的响应体是 {"message":"No provenance available for <filename>"}。上面 8 个包的抽查,200 和 404 跟项目页上的 Full / No provenance 对得上。
fastapi 是中途丢掉的,不是从来没有
本机装的是 0.139.0,最新是 0.163.1,两个都没有证明。我把 fastapi 368 个有文件的版本各查了一次源码包:
0.115.4 及更早 页面 No provenance,接口 404
0.115.5 到 0.128.0 53 个版本,页面 Full provenance,接口 200
0.128.1 到 0.163.1 102 个版本,页面 No provenance,接口 404
0.115.5 上传于 2024-11-12,0.128.0 上传于 2025-12-27。这两头我都解了证明里的发布者,是同一个:
0.115.5 publisher.kind=GitHub repository=fastapi/fastapi workflow=publish.yml
0.128.0 publisher.kind=GitHub repository=fastapi/fastapi workflow=publish.yml
0.128.1 上传于 2026-02-04,源码包和 wheel 都是 404,项目页写 No provenance。从它到 0.163.1,中间没有一个版本的源码包返回 200。版本号不是连号,JSON 里没有 0.136.2,所以「0.128.1 之后 102 个版本」不是「版本号差 102」。
这正好落在文档说的 Loss of provenance 上:以前用会生成 attestation 的方式发布,后来改成了不生成。但文档同时写了,Loss 和 Change 这两种警告只跟过去 14 天内的版本比。0.128.0 是 2025-12-27,0.128.1 是 2026-02-04,隔了 39 天。所以 0.128.1 的页面上只有一行 No provenance,没有那条警告。本机的 0.139.0 距今更远,警告同样不会出现。
只看最新版,会得出「fastapi 没有证明」。把历史拉开才看得到:它有过 13 个月,然后停了,并且因为停的时候隔了超过 14 天,新页面不会主动提醒你这件事。
暂时做不了怎么办
这次没有做签名校验。Integrity API 返回的是 attestation 原文和 transparency log,我只看了 HTTP 状态、发布者字段和 predicate type。文档给出的校验工具是 pip-plugin-pep740,pip 和 uv 自己还不会在安装时拒绝没有证明的文件。
No provenance 不是卸载理由。httpx 0.28.1 从 2024-12-06 就是这样,发布历史里看不到一个带证明的版本;fastapi 是原先有、后来没有。两种都值得知道,处理不一样:前者是维护者还没配,后者是配过又停了。官方原文的原话是,没有证明不等于恶意,只是来源没法用密码学校验。
也不要因为页面写了 Full 就当代码安全。文档写了,attestation 只告诉你文件从哪来,不告诉你源码或构建环境可不可信。这次查到的 5 个 Full,证明类型全部是「哪个 GitHub workflow 上传的」,没有一条是 SLSA 那种构建证明。
查自己的环境,用项目页或 Integrity API。JSON API 现在给不出这个字段。
清单
- 对自己在用的包打开
https://pypi.org/project/<name>/,看侧栏的 Provenance,而不是只看版本号 - 要脚本化就请求
GET /integrity/<项目>/<版本>/<文件名>/provenance,200 是有,404 是没有 - 不要读
https://pypi.org/pypi/<name>/json的provenance字段,这次 8 个包的全部历史文件里这个键都不存在 - 最新版是 No provenance 时,翻一下 Release history:是从来没有,还是像 fastapi 这样 0.128.0 之后断了
- 看到 No provenance 先核对维护者和发布节奏,不把它当成「这个包有问题」
- 看到 Full 也只说明上传者对得上,不说明代码本身被审计过
参考
- PyPI 博客,改版上线(2026-11-06):blog.pypi.org/posts/2026-…
- 用户文档,Checking Provenance:docs.pypi.org/using-pypi/…
- Integrity API:docs.pypi.org/api/integri…
- 讨论帖:news.ycombinator.com/item?id=504…