软件健康报告模式 0.31.0 · 指标 2.10.0 · 2026-08-04 19:46 UTC

pypa / setuptools-scm

the blessed package to manage your versions by scm tags

Python未检测到许可证★ 950 星标⑂ 242 复刻始于 2015年7月在 GitHub 上查看 ↗

类型插件命令行工具库如何判定

#metadata #packaging #python #version-control

pypa/setuptools-scm 的健康指数为 100 分中的 93 分，处于「卓越」区间。其得分最高的类别是Vitality（95/100），最低的是Security（61/100）。最近一次更新在 1 天前。近期的大部分工作由 1 位贡献者完成。

总分 / 100

卓越

软件健康指数

指标归入加权类别，统一采用 1–100 量表。总体分先取类别加权平均，再依据公开记录的分布进行校准，使各等级具有百分位含义；当公开证据触发高风险司法辖区政策时，评级会按政策调整，并设置 34（存在风险）的上限。

卓越93-100公开记录中的最高层级（约前 5%）；基本满足所有检验标准

优秀80-92各方面均表现强劲；仅有少量不足

良好65-79健康；不足之处有限且可控

中等50-64可接受，但存在明显不足；建议进行审查

薄弱35-49多个领域存在实质性薄弱环节

存在风险20-34存在重大薄弱环节；采用时应保持审慎

危急1-19问题严重（项目被弃置、仅有单一维护者、缺乏基本工程规范）

评分画像

每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形，而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。

加权总体分 79 经校准后在公布的指数量表上为 93（记录校准 2026-08-02）。

所有权

Python Packaging Authority组织

2,394 关注者59 个公开仓库始于 2011年3月

该仓库由组织支持——共同承担、可问责的托管责任，可延续于任何单一维护者之后。

软件包生态系统

注册表	软件包	版本	月下载量	版本数	最近发布
PyPI	setuptools-scm	10.2.1	-	106	14 天前
PyPI	vcs-versioning	2.2.3	-	12	6 天前

按类别列示的指标

活力

项目是否仍有生命——是否仍在编写代码，是否仍在发布版本？

95卓越 · 占总体的 21%

开发活跃度

91优秀

评分方式

36/36	推送新近度 — 最近一次推送于 1 天前
27/36	提交节奏 — 52 周中有 39 周有提交
18/18	提交量 — 最近一年 646 次提交
10/10	OpenSSF Scorecard：Maintained — 30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10

所用输入

commits_last_year	646
human_commit_share	0.82
days_since_last_push	1
active_weeks_last_year	39

发布纪律

100卓越

评分方式

27/27	有发布版本 — 已发布 90 个发布版本
36/36	发布时效 — 最近一次发布版本于 6 天前
27/27	发布节奏 — 约每 4 天发布一次
0/10	OpenSSF Scorecard：Signed-Releases — 无数据

所用输入

releases_count	90
latest_release_tag	vcs-versioning-v2.2.3
releases_from_tags	否
days_since_latest_release	6
mean_days_between_releases	4

已排除计分（无数据或不适用）：OpenSSF Scorecard：Signed-Releases。其余权重已重新归一化。

社区与采用

项目是否拥有用户、下载量与关注度，并具备欢迎贡献者参与的配置？

68良好 · 占总体的 17%

流行度与采用

75良好

评分方式

48.3/60	星标 — 950 个星标
19.9/25	复刻 — 242 个复刻
7.2/15	关注者 — 21 位关注者

所用输入

forks	242
stars	950
watchers	21
growth_state	organic
growth_factor_pct	100

社区健康

60中等

评分方式

22.5/22.5	README
0/22.5	许可证 — 未检测到许可证文件
18/18	CONTRIBUTING 指南
13.5/13.5	行为准则
0/7.2	议题模板
0/6.3	PR 模板

所用输入

has_readme	是
has_license	否
readme_badges	0
has_contributing	是
has_issue_template	否
has_code_of_conduct	是
readme_badge_services	—
has_pull_request_template	否

可持续性与治理

项目能否在其成员之外延续——巴士系数、响应能力、由谁支持，以及软件包的维护状况？

75良好 · 占总体的 23%

维护者韧性（巴士系数）

37薄弱

评分方式

9/54	巴士系数 — 1 位贡献者贡献了半数提交
4.3/22.5	提交分布 — 头号贡献者编写了 81% 的提交
13.5/13.5	贡献者广度 — 96 位贡献者
10/10	OpenSSF Scorecard：Contributors — project has 106 contributing companies or organizations

所用输入

bus_factor	1
contributors_sampled	96
top_contributor_share	0.807

议题与 PR 响应能力

75良好

评分方式

40.9/42	议题解决 — 97% 的议题已关闭
26.1/30	PR 接受 — 已裁定的 PR 中 672/771 已合并
6.5/13	Newcomer PR acceptance — 30 天内首次贡献者的 PR 已合并 1/2
1.5/15	OpenSSF Scorecard：Code-Review — Found 1/6 approved changesets -- score normalized to 1

所用输入

merged_prs	672
open_issues	19
closed_issues	689
prs_merged_7d	3
prs_decided_7d	3
prs_merged_30d	4
prs_decided_30d	5
issue_closed_ratio	0.973
closed_unmerged_prs	99
first_time_authors_30d	2
first_time_prs_merged_30d	1
first_time_prs_decided_30d	2

所有权与托管责任

99卓越

评分方式

30/30	所有权背书 — 组织持有
0/20	已验证域名 — 未读取该组织的域名验证状态
24.3/25	所有者影响力 — pypa 有 2,394 位关注者
24.9/25	既往记录 — 59 个公开仓库，账户约 15 年

所用输入

followers	2,394
owner_type	Organization
is_verified	—
owner_login	pypa
public_repos	59
account_age_days	5,634

已排除计分（无数据或不适用）：已验证域名。其余权重已重新归一化。

软件包维护

100卓越

评分方式

25/25	已发布且可解析 — pypi 上有 2 个软件包
35/35	发布时效 — 最近一次发布于 6 天前
20/20	版本历史 — 106 个已发布版本
20/20	未被弃用 — 活跃，未被弃用或撤回

所用输入

packages	setuptools-scm, vcs-versioning
ecosystems	pypi
any_deprecated	否
min_days_since_publish	6

工程质量

基础的工程与文档实践是否到位？

92优秀 · 占总体的 19%

工程实践

94卓越

评分方式

24/24	CI 工作流 — 6 个工作流
24/24	存在测试
16/16	Linter 配置
9.6/9.6	Pre-commit 钩子
0/6.4	.editorconfig
20/20	OpenSSF Scorecard：CI-Tests — 14 out of 14 merged PRs checked by a CI test -- score normalized to 10

所用输入

has_ci	是
has_tests	是
has_editorconfig	否
has_linter_config	是
has_precommit_config	是

文档

90优秀

评分方式

30/30	README
25/25	文档目录
15/15	文档 / 主页站点 — https://setuptools-scm.readthedocs.io/en/latest/
10/10	仓库描述
10/10	主题标签 — 4 个主题标签
0/10	Wiki

所用输入

topics	metadata, packaging, python, version-control
has_wiki	否
homepage	https://setuptools-scm.readthedocs.io/en/latest/
docs_site	https://setuptools-scm.readthedocs.io/en/latest/
has_readme	是
has_docs_dir	是
has_description	是

安全

可见的安全与供应链实践是否稳固，且不存在未解决的高风险司法辖区暴露？

61中等 · 占总体的 16%

安全态势

51中等

评分方式

7.5/7.5	Binary-Artifacts — no binaries found in the repo
2.2/7.5	Branch-Protection — branch protection is not maximal on development and all release branches
2.5/2.5	CI-Tests — 14 out of 14 merged PRs checked by a CI test -- score normalized to 10
0/2.5	CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0.8/7.5	Code-Review — Found 1/6 approved changesets -- score normalized to 1
2.5/2.5	Contributors — project has 106 contributing companies or organizations
10/10	Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5	Dependency-Update-Tool — update tool detected
0/5	Fuzzing — project is not fuzzed
0/2.5	许可证 — license file not detected
7.5/7.5	Maintained — 30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10
5/5	Packaging — packaging workflow detected
4.5/5	Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 9
0/5	SAST — SAST tool is not run on all commits -- score normalized to 0
0/5	Security-Policy — security policy file not detected
0/7.5	Signed-Releases — 无数据
0/7.5	Token-Permissions — detected GitHub workflow tokens with excessive permissions
0/7.5	Vulnerabilities — 29 existing vulnerabilities detected

所用输入

source	openssf_scorecard
checks_evaluated	17
scorecard_version	v5.5.0
checks_inconclusive	1
scorecard_aggregate	5.1

已排除计分（无数据或不适用）：Signed-Releases。其余权重已重新归一化。

依赖安全公告

100卓越

评分方式

35/35	直接依赖不含已知公告 — 没有直接依赖携带已知公告
25/25	间接依赖不含已知公告 — 没有间接依赖携带已知公告
0/40	没有长期未处理的公告 — 没有公告带有发布日期

所用输入

source	osv
advisories	0
affected_packages	0
assessed_packages	3
unassessed_packages	0
affected_by_severity	none
direct_affected_packages	0

已排除计分（无数据或不适用）：没有长期未处理的公告。其余权重已重新归一化。比对的是 pypi:setuptools-scm@10.2.1 的运行时依赖闭包——安装已发布的软件包时真正被拉取进来的内容——共 3 个软件包。未对可达性进行分析。

AI 就绪度

该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件？权重刻意设小（4%）：代理工具链是一项真实的维护信号，但完全不具备的仓库仍可达到 100/100。

85优秀 · 占总体的 4%

AI 代理上下文与指引

85优秀

评分方式

45/45	代理指令 — CLAUDE.md
0/15	机器可读文档（llms.txt）
40/40	可读的提交历史 — 82 次人类提交中有 80 次说明了意图（结构化标题或解释性正文）

所用输入

has_llms_txt	否
llms_txt_url	—
legible_history_share	0.976
agent_instruction_files	CLAUDE.md
agent_instruction_max_bytes	4,620

验证循环（构建 / 测试 / 类型检查）

81优秀

评分方式

0/18	一条命令的引导启动
22/22	自动化测试
11/11	Lint / 格式化配置
11/11	静态类型检查 — setuptools-scm/src/setuptools_scm/py.typed, vcs-versioning/src/vcs_versioning/py.typed
10/10	可复现环境 — lockfile
10/10	已体现的代理实践 — 最近 100 次提交中有 8 次由代理编写或署名代理
8/8	自动化维护 — 最近 100 次提交中有 5 次为自动依赖更新
9/10	OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 9

所用输入

has_nix	否
has_tests	是
lockfiles	uv.lock
has_dockerfile	否
typed_language	否
bootstrap_files	—
has_devcontainer	否
has_linter_config	是
typecheck_configs	setuptools-scm/src/setuptools_scm/py.typed, vcs-versioning/src/vcs_versioning/py.typed
agent_commit_share	0.08
toolchain_manifests	—
dependency_bot_commit_share	0.05

面向模型的代码可读性

82优秀

评分方式

27/45	可类型检查的代码 — Python，已配置类型检查（setuptools-scm/src/setuptools_scm/py.typed, vcs-versioning/src/vcs_versioning/py.typed）
54.6/55	可控的文件大小 — 采样的 124 个源文件中有 1 个超过 60KB

所用输入

primary_language	Python
largest_source_bytes	62,567
source_files_sampled	124
oversized_source_files	1

机器可读接口

100卓越

评分方式

0/40	API 模式（OpenAPI/GraphQL/proto） — 不适用于此类软件
0/20	MCP 服务器 — 不适用于此类软件
40/40	可运行示例 — examples

所用输入

example_dirs	examples
has_mcp_signal	否
api_schema_files	—
interfaces_expected_of	—

已排除计分（无数据或不适用）：API 模式（OpenAPI/GraphQL/proto）, MCP 服务器。其余权重已重新归一化。

关键数据

950GitHub 星标

96贡献者

646最近 12 个月提交数

1距最近推送天数

90发布版本数

1巴士系数（bus factor）

19开放议题

PyPI软件包生态系统数

数据采集警告

Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
Star history carried forward from 2026-07-04: GitHub restricted the stargazers API to repository admins, so it can no longer be collected. The repository has 950 stars today.
Could not fetch pypi package 'vcs-versioning.workspace' from its registry

更多细节

Star 与 Fork 历史 950 ★ / 242 ⇿

950Star

242Fork

88发布

每颗 star 和每个 fork 的添加时间，来自 GitHub 并按天汇总。累计增长位于其构成来源——每日新增——的正上方，二者可相互对照：稳定的自然增长与短暂的突增形态截然不同。当这一差别可被衡量时，它会作为增长真实性予以报告。

星标历史显示的是 2026-07-04 采集时的状态。GitHub 已于 2026 年 7 月将 stargazers API 限制为仓库管理员，因此该序列无法再延续；上方的星标总数仍然实时更新。

主版本 7次版本 19修订 39

每个点涵盖 11 天。

OpenSSF Scorecard 5.1 / 10

5.1综合

来自开源项目 OpenSSF Scorecard 的独立、工具无关的安全评估。每项检查奖励的是安全实践本身，而非特定供应商的工具。Scorecard 无法判定的检查项标记为 不适用，并从安全评分中剔除（绝不按零分计）。Scorecard v5.5.0 · 2026-08-04 19:45 UTC

10	Binary-Artifacts	no binaries found in the repo
3	Branch-Protection	branch protection is not maximal on development and all release branches
10	CI-Tests	14 out of 14 merged PRs checked by a CI test -- score normalized to 10
0	CII-Best-Practices	no effort to earn an OpenSSF best practices badge detected
1	Code-Review	Found 1/6 approved changesets -- score normalized to 1
10	Contributors	project has 106 contributing companies or organizations
10	Dangerous-Workflow	no dangerous workflow patterns detected
10	Dependency-Update-Tool	update tool detected
0	Fuzzing	project is not fuzzed
0	License	license file not detected
10	Maintained	30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10
10	Packaging	packaging workflow detected
9	Pinned-Dependencies	dependency not pinned by hash detected -- score normalized to 9
0	SAST	SAST tool is not run on all commits -- score normalized to 0
0	Security-Policy	security policy file not detected
不适用	Signed-Releases	no releases found
0	Token-Permissions	detected GitHub workflow tokens with excessive permissions
0	Vulnerabilities	29 existing vulnerabilities detected

直接依赖 10

注册表	软件包	版本约束	清单文件
PyPI	vcs-versioning	`—`	pyproject.toml
PyPI	setuptools-scm	`—`	pyproject.toml
PyPI	vcs-versioning	`>=2.2.2,<3`	setuptools-scm/pyproject.toml
PyPI	packaging	`>=20`	setuptools-scm/pyproject.toml
PyPI	setuptools	`—`	setuptools-scm/pyproject.toml
PyPI	tomli	`>=1`	setuptools-scm/pyproject.toml
PyPI	typing-extensions	`>=4.1`	setuptools-scm/pyproject.toml
PyPI	packaging	`>=26.2`	vcs-versioning/pyproject.toml
PyPI	tomli	`>=1`	vcs-versioning/pyproject.toml
PyPI	typing-extensions	`>=4.1`	vcs-versioning/pyproject.toml

全部依赖 141

来自 GitHub 依赖图的完整解析依赖集合：12 个直接依赖与 129 个间接（传递）软件包。仓库提交锁文件时，传递闭包才是完整的。

注册表	软件包	版本	关系
PyPI	packaging	`—`	直接
PyPI	packaging	`26.2`	直接
PyPI	setuptools	`—`	直接
PyPI	setuptools	`75.3.4`	直接
PyPI	setuptools	`80.9.0`	直接
PyPI	setuptools	`82.0.1`	直接
PyPI	tomli	`2.3.0`	直接
PyPI	tomli	`2.4.1`	直接
PyPI	typing-extensions	`4.13.2`	直接
PyPI	typing-extensions	`4.15.0`	直接
PyPI	vcs-versioning	`—`	直接
PyPI	vcs-versioning	`2.2.2`	直接
PyPI	ast-serialize	`0.4.0`	间接
PyPI	ast-serialize	`0.5.0`	间接
PyPI	babel	`2.17.0`	间接
PyPI	babel	`2.18.0`	间接
PyPI	backrefs	`6.1`	间接
PyPI	backrefs	`7.0`	间接
PyPI	bracex	`2.6`	间接
PyPI	build	`1.2.2.post1`	间接
PyPI	build	`1.4.4`	间接
PyPI	build	`1.5.0`	间接
PyPI	certifi	`2025.11.12`	间接
PyPI	certifi	`2026.6.17`	间接
PyPI	cffi	`1.17.1`	间接
PyPI	cffi	`2.0.0`	间接
PyPI	charset-normalizer	`3.4.4`	间接
PyPI	charset-normalizer	`3.4.7`	间接
PyPI	click	`8.1.8`	间接
PyPI	click	`8.3.1`	间接
PyPI	click	`8.4.2`	间接
PyPI	colorama	`0.4.6`	间接
PyPI	cryptography	`47.0.0`	间接
PyPI	cryptography	`48.0.1`	间接
PyPI	exceptiongroup	`1.3.1`	间接
PyPI	execnet	`2.1.2`	间接
PyPI	flake8	`5.0.4`	间接
PyPI	flake8	`7.1.2`	间接
PyPI	flake8	`7.3.0`	间接
PyPI	ghp-import	`2.1.0`	间接
PyPI	griffe	`2.1.0`	间接
PyPI	griffe-public-wildcard-imports	`0.3.1`	间接
PyPI	griffecli	`2.1.0`	间接
PyPI	griffelib	`2.1.0`	间接
PyPI	idna	`3.15`	间接
PyPI	idna	`3.18`	间接
PyPI	importlib-metadata	`8.5.0`	间接
PyPI	importlib-metadata	`8.7.0`	间接
PyPI	importlib-metadata	`8.7.1`	间接
PyPI	importlib-metadata	`9.0.0`	间接
PyPI	importlib-resources	`6.4.5`	间接
PyPI	importlib-resources	`6.5.2`	间接
PyPI	iniconfig	`2.1.0`	间接
PyPI	iniconfig	`2.3.0`	间接
PyPI	jinja2	`3.1.6`	间接
PyPI	librt	`0.11.0`	间接
PyPI	markdown	`3.10`	间接
PyPI	markdown	`3.10.2`	间接
PyPI	markdown-it-py	`3.0.0`	间接
PyPI	markdown-it-py	`4.0.0`	间接
PyPI	markdown-it-py	`4.2.0`	间接
PyPI	markupsafe	`2.1.5`	间接
PyPI	markupsafe	`3.0.3`	间接
PyPI	mccabe	`0.7.0`	间接
PyPI	mdurl	`0.1.2`	间接
PyPI	mergedeep	`1.3.4`	间接
PyPI	mkdocs	`1.6.1`	间接
PyPI	mkdocs-autorefs	`1.4.3`	间接
PyPI	mkdocs-autorefs	`1.4.4`	间接
PyPI	mkdocs-get-deps	`0.2.0`	间接
PyPI	mkdocs-get-deps	`0.2.2`	间接
PyPI	mkdocs-include-markdown-plugin	`7.3.0`	间接
PyPI	mkdocs-material	`9.7.6`	间接
PyPI	mkdocs-material-extensions	`1.3.1`	间接
PyPI	mkdocstrings	`1.0.4`	间接
PyPI	mkdocstrings	`1.0.5`	间接
PyPI	mkdocstrings-python	`2.0.0`	间接
PyPI	mkdocstrings-python	`2.0.5`	间接
PyPI	mypy	`1.14.1`	间接
PyPI	mypy	`1.19.1`	间接
PyPI	mypy	`2.1.0`	间接
PyPI	mypy-extensions	`1.1.0`	间接
PyPI	paginate	`0.5.7`	间接
PyPI	pathspec	`1.1.1`	间接
PyPI	pip	`25.0.1`	间接
PyPI	pip	`26.0.1`	间接
PyPI	pip	`26.1.2`	间接
PyPI	platformdirs	`4.10.0`	间接
PyPI	platformdirs	`4.5.0`	间接
PyPI	pluggy	`1.5.0`	间接
PyPI	pluggy	`1.6.0`	间接
PyPI	pycodestyle	`2.12.1`	间接
PyPI	pycodestyle	`2.14.0`	间接
PyPI	pycodestyle	`2.9.1`	间接
PyPI	pycparser	`2.23`	间接
PyPI	pyflakes	`2.5.0`	间接
PyPI	pyflakes	`3.2.0`	间接
PyPI	pyflakes	`3.4.0`	间接
PyPI	pygithub	`2.8.1`	间接
PyPI	pygithub	`2.9.0`	间接
PyPI	pygments	`2.19.2`	间接
PyPI	pygments	`2.20.0`	间接
PyPI	pyjwt	`2.13.0`	间接
PyPI	pyjwt	`2.9.0`	间接
PyPI	pymdown-extensions	`11.0`	间接
PyPI	pynacl	`1.6.2`	间接
PyPI	pyproject-hooks	`1.2.0`	间接
PyPI	pytest	`8.3.5`	间接
PyPI	pytest	`8.4.2`	间接
PyPI	pytest	`9.1.1`	间接
PyPI	pytest-timeout	`2.4.0`	间接
PyPI	pytest-xdist	`3.6.1`	间接
PyPI	pytest-xdist	`3.8.0`	间接
PyPI	python-dateutil	`2.9.0.post0`	间接
PyPI	pyyaml	`6.0.3`	间接
PyPI	pyyaml-env-tag	`1.1`	间接
PyPI	requests	`2.32.4`	间接
PyPI	requests	`2.32.5`	间接
PyPI	requests	`2.33.0`	间接
PyPI	requests	`2.34.2`	间接
PyPI	rich	`13.9.4`	间接
PyPI	rich	`14.3.4`	间接
PyPI	rich	`15.0.0`	间接
PyPI	ruff	`0.15.20`	间接
PyPI	six	`1.17.0`	间接
PyPI	towncrier	`24.8.0`	间接
PyPI	towncrier	`25.8.0`	间接
PyPI	types-setuptools	`75.8.0.20250110`	间接
PyPI	types-setuptools	`81.0.0.20260209`	间接
PyPI	types-setuptools	`82.0.0.20260518`	间接
PyPI	urllib3	`2.2.3`	间接
PyPI	urllib3	`2.6.3`	间接
PyPI	urllib3	`2.7.0`	间接
PyPI	vcs-versioning-workspace	`0.1+private`	间接
PyPI	watchdog	`3.0.0`	间接
PyPI	watchdog	`6.0.0`	间接
PyPI	wcmatch	`10.1`	间接
PyPI	zipp	`3.20.2`	间接
PyPI	zipp	`3.23.0`	间接
PyPI	zipp	`3.23.1`	间接
PyPI	zipp	`4.1.0`	间接

依赖安全公告 0

安装 pypi:setuptools-scm@10.2.1 会引入 3 个包（直接与传递）：其中 0 个存在已知公告，0 个为直接依赖。

没有已知公告影响已评估的依赖。

公告表示依赖图中记录的版本落入某条公告的受影响范围。可达性未经分析，且依赖图包含开发与测试的版本固定——某项发现可能只涉及工具链而非交付的软件。

原始 JSON 报告机器可读

反馈

发现这份报告有不准确之处，或有想法要分享？错误的测量、未识别的工具、建议、疑问——都欢迎提出。每条消息都会被阅读并得到回复。

评分是信号，而非担保。 评分反映的是 GitHub 上公开可见的实践——不是代码审计，也不是安全保证。

缺失数据将被剔除并重新归一化权重，绝不按零分计。方法论已版本化并公开：指标 v2.10.0、模式 v0.31.0—— 完整方法论 · 指标知识库.

单项结果在整体记录中的位置：汇总统计 — PyPI.

软件健康指数

评分画像

所有权

软件包生态系统

按类别列示的指标

关键数据

数据采集警告

更多细节

反馈

相关记录