软件健康报告模式 0.12.0 · 指标 2.10.0 · 2026-07-18 05:10 UTC

connectrpc / connect-python

The Python implementation of Connect: Protobuf RPC that works.

Python自定义许可证★ 139 星标⑂ 14 复刻始于 2025年9月在 GitHub 上查看 ↗

类型网络服务如何判定

#connectrpc #grpc #protobuf #python #protocol-buffers

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

总分 / 100

卓越

软件健康指数

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

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

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

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

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

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

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

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

评分画像

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

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

所有权

Connect组织

659 关注者26 个公开仓库始于 2022年1月

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

软件包生态系统

注册表	软件包	版本	月下载量	版本数	最近发布	标签
PyPI	connectrpc-grpcreflect指向其他仓库——不计分	0.1.0	189	1	8 天前	connect-py connectrpc grpc
PyPI	connectrpc-otel指向其他仓库——不计分	0.2.0	4,535	3	10 天前	connect-py connectrpc middleware observability opentelemetry otel tracing
PyPI	example指向其他仓库——不计分	0.1.0	9,927	1	4511 天前	—
PyPI	protoc-gen-connectrpc指向其他仓库——不计分	0.11.1	8,733	5	2 天前	code-generation compiler connect connect-protocol connect-py connect-rpc connectrpc plugin protobuf protoc protocol-buffers rpc
PyPI	connectrpc指向其他仓库——不计分	0.11.1	306,084	6	2 天前	connect grpc http protobuf rpc

按类别列示的指标

活力

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

95卓越 · 占总体的 21%

开发活跃度

98卓越

评分方式

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

所用输入

commits_last_year	345
human_commit_share	—
days_since_last_push	2
active_weeks_last_year	49

发布纪律

90优秀

评分方式

27/27	有发布版本 — 已发布 15 个发布版本
36/36	发布时效 — 最近一次发布版本于 2 天前
27/27	发布节奏 — 约每 18.8 天发布一次
0/10	OpenSSF Scorecard：Signed-Releases — Project has not signed or included provenance with any releases.

所用输入

releases_count	15
latest_release_tag	v0.11.1
releases_from_tags	否
days_since_latest_release	2
mean_days_between_releases	18.8

社区与采用

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

61中等 · 占总体的 17%

流行度与采用

46薄弱

评分方式

34.7/60	星标 — 139 个星标
9.3/25	复刻 — 14 个复刻
1.7/15	关注者 — 3 位关注者

所用输入

forks	14
stars	139
watchers	3
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

社区健康

79良好

评分方式

22.5/22.5	README
16.9/22.5	许可证 — 存在许可证文件，但不是可识别的许可证
18/18	CONTRIBUTING 指南
13.5/13.5	行为准则
0/7.2	议题模板
0/6.3	PR 模板

所用输入

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

可持续性与治理

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

81优秀 · 占总体的 23%

维护者韧性（巴士系数）

61中等

评分方式

25.2/54	巴士系数 — 2 位贡献者贡献了半数提交
12.7/22.5	提交分布 — 头号贡献者编写了 44% 的提交
13.5/13.5	贡献者广度 — 14 位贡献者
10/10	OpenSSF Scorecard：Contributors — project has 6 contributing companies or organizations

所用输入

bus_factor	2
contributors_sampled	14
top_contributor_share	0.435

议题与 PR 响应能力

98卓越

评分方式

42/42	议题解决 — 100% 的议题已关闭
28/30	PR 接受 — 已裁定的 PR 中 254/272 已合并
0/13	Newcomer PR acceptance — 30 天内没有首次贡献者的 PR 得到裁决
15/15	OpenSSF Scorecard：Code-Review — all changesets reviewed

所用输入

merged_prs	254
open_issues	0
closed_issues	27
prs_merged_7d	—
prs_decided_7d	—
prs_merged_30d	—
prs_decided_30d	—
issue_closed_ratio	1
closed_unmerged_prs	18
first_time_authors_30d	—
first_time_prs_merged_30d	—
first_time_prs_decided_30d	—

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

所有权与托管责任

87优秀

评分方式

30/30	所有权背书 — 组织持有
0/20	已验证域名 — 未读取该组织的域名验证状态
20.3/25	所有者影响力 — connectrpc 有 659 位关注者
19.5/25	既往记录 — 26 个公开仓库，账户约 4 年

所用输入

followers	659
owner_type	Organization
is_verified	—
owner_login	connectrpc
public_repos	26
account_age_days	1,653

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

工程质量

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

77良好 · 占总体的 19%

工程实践

68良好

评分方式

24/24	CI 工作流 — 8 个工作流
24/24	存在测试
0/16	Linter 配置
0/9.6	Pre-commit 钩子
0/6.4	.editorconfig
20/20	OpenSSF Scorecard：CI-Tests — 30 out of 30 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://connectrpc.com/docs/python/getting-started/
10/10	仓库描述
10/10	主题标签 — 5 个主题标签
0/10	Wiki

所用输入

topics	connectrpc, grpc, protobuf, python, protocol-buffers
has_wiki	否
homepage	https://connectrpc.com/docs/python/getting-started/
docs_site	https://connectrpc.com/docs/python/getting-started/
has_readme	是
has_docs_dir	是
has_description	是

安全

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

76良好 · 占总体的 16%

安全态势

76良好

评分方式

7.5/7.5	Binary-Artifacts — no binaries found in the repo
0/7.5	Branch-Protection — 无数据
2.5/2.5	CI-Tests — 30 out of 30 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
7.5/7.5	Code-Review — all changesets reviewed
2.5/2.5	Contributors — project has 6 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
2.2/2.5	许可证 — license file detected
7.5/7.5	Maintained — 30 commit(s) and 4 issue activity found in the last 90 days -- score normalized to 10
5/5	Packaging — packaging workflow detected
5/5	Pinned-Dependencies — all dependencies are pinned
5/5	SAST — SAST tool is run on all commits
4.5/5	Security-Policy — security policy file detected
0/7.5	Signed-Releases — Project has not signed or included provenance with any releases.
0/7.5	Token-Permissions — detected GitHub workflow tokens with excessive permissions
7.5/7.5	Vulnerabilities — 0 existing vulnerabilities detected

所用输入

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

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

AI 就绪度

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

73良好 · 占总体的 4%

AI 代理上下文与指引

75良好

评分方式

45/45	代理指令 — AGENTS.md, CLAUDE.md
0/15	机器可读文档（llms.txt）
0/40	可读的提交历史 — 无数据

所用输入

has_llms_txt	否
llms_txt_url	—
legible_history_share	—
agent_instruction_files	AGENTS.md, CLAUDE.md
agent_instruction_max_bytes	460

已排除计分（无数据或不适用）：可读的提交历史。其余权重已重新归一化。

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

65良好

评分方式

0/18	一条命令的引导启动
22/22	自动化测试
0/11	Lint / 格式化配置
11/11	静态类型检查 — connectrpc-otel/connectrpc_otel/py.typed, src/connectrpc/py.typed
10/10	可复现环境 — lockfile
0/10	已体现的代理实践 — 无数据
0/8	自动化维护 — 无数据
10/10	OpenSSF Scorecard：Pinned-Dependencies — all dependencies are pinned

所用输入

has_nix	否
has_tests	是
lockfiles	uv.lock
has_dockerfile	否
typed_language	否
bootstrap_files	—
has_devcontainer	否
has_linter_config	否
typecheck_configs	connectrpc-otel/connectrpc_otel/py.typed, src/connectrpc/py.typed
agent_commit_share	—
toolchain_manifests	—
dependency_bot_commit_share	—

已排除计分（无数据或不适用）：已体现的代理实践, 自动化维护。其余权重已重新归一化。

面向模型的代码可读性

82优秀

评分方式

27/45	可类型检查的代码 — Python，已配置类型检查（connectrpc-otel/connectrpc_otel/py.typed, src/connectrpc/py.typed）
55/55	可控的文件大小 — 采样的 117 个源文件中有 0 个超过 60KB

所用输入

primary_language	Python
largest_source_bytes	40,508
source_files_sampled	117
oversized_source_files	0

机器可读接口

80优秀

评分方式

40/40	API 模式（OpenAPI/GraphQL/proto） — example/proto/connectrpc/eliza/v1/eliza.proto, test/proto/connectrpc/example/haberdasher.proto
0/20	MCP 服务器
40/40	可运行示例 — example

所用输入

example_dirs	example
has_mcp_signal	否
api_schema_files	example/proto/connectrpc/eliza/v1/eliza.proto, test/proto/connectrpc/example/haberdasher.proto
interfaces_expected_of	network-service

关键数据

139GitHub 星标

14贡献者

345最近 12 个月提交数

2距最近推送天数

15发布版本数

2巴士系数（bus factor）

0开放议题

PyPI软件包生态系统数

数据采集警告

pypi package 'connectrpc-grpcreflect' points at a different repository (https://github.com/connectrpc/connect-py); excluded from ecosystem scoring
pypi package 'connectrpc-otel' points at a different repository (https://github.com/connectrpc/connect-py); excluded from ecosystem scoring
pypi package 'example' points at a different repository (http://github.com/mansam/example); excluded from ecosystem scoring
pypi package 'protoc-gen-connectrpc' points at a different repository (https://github.com/connectrpc/connect-py); excluded from ecosystem scoring
pypi package 'connectrpc' points at a different repository (https://github.com/connectrpc/connect-py); excluded from ecosystem scoring

更多细节

OpenSSF Scorecard 7.6 / 10

7.6综合

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

10	Binary-Artifacts	no binaries found in the repo
不适用	Branch-Protection	internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
10	CI-Tests	30 out of 30 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
10	Code-Review	all changesets reviewed
10	Contributors	project has 6 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
9	License	license file detected
10	Maintained	30 commit(s) and 4 issue activity found in the last 90 days -- score normalized to 10
10	Packaging	packaging workflow detected
10	Pinned-Dependencies	all dependencies are pinned
10	SAST	SAST tool is run on all commits
9	Security-Policy	security policy file detected
0	Signed-Releases	Project has not signed or included provenance with any releases.
0	Token-Permissions	detected GitHub workflow tokens with excessive permissions
10	Vulnerabilities	0 existing vulnerabilities detected

直接依赖 10

注册表	软件包	版本约束	清单文件
PyPI	connectrpc	`>=0.11.0`	connectrpc-grpcreflect/pyproject.toml
PyPI	opentelemetry-api	`>=1.39.1`	connectrpc-otel/pyproject.toml
PyPI	opentelemetry-instrumentation	`>=0.60b1`	connectrpc-otel/pyproject.toml
PyPI	connectrpc	`—`	example/pyproject.toml
PyPI	flask	`==3.1.3`	example/pyproject.toml
PyPI	protobuf-py	`>=0.1.1`	example/pyproject.toml
PyPI	starlette	`==1.3.1`	example/pyproject.toml
PyPI	protobuf-py	`==0.1.1`	protoc-gen-connectrpc/pyproject.toml
PyPI	protobuf-py	`==0.1.1`	pyproject.toml
PyPI	pyqwest	`>=0.5.1`	pyproject.toml

全部依赖 104

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

注册表	软件包	版本	关系
PyPI	connectrpc	`—`	直接
PyPI	connectrpc	`0.11.0`	直接
PyPI	connectrpc	`0.11.1`	直接
PyPI	flask	`3.1.3`	直接
PyPI	opentelemetry-api	`—`	直接
PyPI	opentelemetry-api	`1.43.0`	直接
PyPI	opentelemetry-instrumentation	`—`	直接
PyPI	opentelemetry-instrumentation	`0.64b0`	直接
PyPI	protobuf-py	`—`	直接
PyPI	protobuf-py	`0.1.1`	直接
PyPI	pyqwest	`0.6.2`	直接
PyPI	starlette	`1.3.1`	直接
PyPI	anyio	`4.14.1`	间接
PyPI	asgiref	`3.11.1`	间接
PyPI	backports-asyncio-runner	`1.2.0`	间接
PyPI	blinker	`1.9.0`	间接
PyPI	brotli	`1.2.0`	间接
PyPI	buf-bin	`1.71.0`	间接
PyPI	click	`8.4.2`	间接
PyPI	colorama	`0.4.6`	间接
PyPI	connect-python-example	`—`	间接
PyPI	connectrpc-grpcreflect	`0.1.0`	间接
PyPI	connectrpc-grpcreflect	`0.2.0`	间接
PyPI	connectrpc-otel	`0.2.0`	间接
PyPI	coverage	`7.15.0`	间接
PyPI	deepmerge	`2.1.0`	间接
PyPI	envoy-server	`1.38.3`	间接
PyPI	example	`0.1.0`	间接
PyPI	exceptiongroup	`1.3.1`	间接
PyPI	find-libpython	`0.5.1`	间接
PyPI	ghp-import	`2.1.0`	间接
PyPI	granian	`2.7.9`	间接
PyPI	griffelib	`2.1.0`	间接
PyPI	grpcio	`1.82.1`	间接
PyPI	grpcio-tools	`1.82.1`	间接
PyPI	gunicorn	`26.0.0`	间接
PyPI	h11	`0.16.0`	间接
PyPI	h2	`4.3.0`	间接
PyPI	hpack	`4.2.0`	间接
PyPI	hypercorn	`0.18.0`	间接
PyPI	hyperframe	`6.1.0`	间接
PyPI	idna	`3.18`	间接
PyPI	iniconfig	`2.3.0`	间接
PyPI	itsdangerous	`2.2.0`	间接
PyPI	jinja2	`3.1.6`	间接
PyPI	markdown	`3.10.2`	间接
PyPI	markupsafe	`3.0.3`	间接
PyPI	mergedeep	`1.3.4`	间接
PyPI	mkdocs	`1.6.1`	间接
PyPI	mkdocs-autorefs	`1.4.4`	间接
PyPI	mkdocs-get-deps	`0.2.2`	间接
PyPI	mkdocstrings	`1.0.4`	间接
PyPI	mkdocstrings-python	`2.0.5`	间接
PyPI	opentelemetry-instrumentation-asgi	`0.64b0`	间接
PyPI	opentelemetry-instrumentation-wsgi	`0.64b0`	间接
PyPI	opentelemetry-sdk	`1.43.0`	间接
PyPI	opentelemetry-semantic-conventions	`0.64b0`	间接
PyPI	opentelemetry-util-http	`0.64b0`	间接
PyPI	packaging	`26.2`	间接
PyPI	pastel	`0.2.1`	间接
PyPI	pathspec	`1.1.1`	间接
PyPI	platformdirs	`4.10.0`	间接
PyPI	pluggy	`1.6.0`	间接
PyPI	poethepoet	`0.48.0`	间接
PyPI	priority	`2.0.0`	间接
PyPI	protobuf	`—`	间接
PyPI	protobuf	`7.35.1`	间接
PyPI	protobuf-py-ext	`0.1.1`	间接
PyPI	protoc-gen-connectrpc	`0.11.0`	间接
PyPI	protoc-gen-connectrpc	`0.11.1`	间接
PyPI	protoc-gen-grpc-py	`0.1.1`	间接
PyPI	protoc-gen-py	`0.1.1`	间接
PyPI	pygments	`2.20.0`	间接
PyPI	pymdown-extensions	`11.0.1`	间接
PyPI	pytest	`9.1.0`	间接
PyPI	pytest	`9.1.1`	间接
PyPI	pytest-asyncio	`1.4.0`	间接
PyPI	pytest-cov	`7.1.0`	间接
PyPI	pytest-timeout	`2.4.0`	间接
PyPI	python-dateutil	`2.9.0.post0`	间接
PyPI	pyvoy	`0.4.2`	间接
PyPI	pyyaml	`6.0.3`	间接
PyPI	pyyaml-env-tag	`1.1`	间接
PyPI	ruff	`0.15.21`	间接
PyPI	setuptools	`83.0.0`	间接
PyPI	six	`1.17.0`	间接
PyPI	taskgroup	`0.2.2`	间接
PyPI	tombi	`1.2.0`	间接
PyPI	tomli	`2.4.1`	间接
PyPI	ty	`0.0.59`	间接
PyPI	types-grpcio	`1.82.1.20260711`	间接
PyPI	types-protobuf	`7.34.1.20260518`	间接
PyPI	typing-extensions	`4.16.0`	间接
PyPI	uv-build	`—`	间接
PyPI	uvicorn	`0.51.0`	间接
PyPI	uvloop	`0.22.1`	间接
PyPI	watchdog	`6.0.0`	间接
PyPI	werkzeug	`3.1.8`	间接
PyPI	wheel	`0.47.0`	间接
PyPI	winloop	`0.6.3`	间接
PyPI	wrapt	`2.2.2`	间接
PyPI	wsproto	`1.3.2`	间接
PyPI	zensical	`0.0.50`	间接
PyPI	zstandard	`0.25.0`	间接

原始 JSON 报告机器可读

反馈

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

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

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

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

软件健康指数

评分画像

所有权

软件包生态系统

按类别列示的指标

关键数据

数据采集警告

更多细节

反馈

相关记录