软件健康报告模式 0.34.0 · 指标 2.10.0 · 2026-09-09 16:38 UTC

ahamez / protox

A reasonably fast, easy to use and 100% conformant Elixir library for Google Protocol Buffers (aka protobuf)

ElixirMIT★ 296 星标⑂ 22 复刻始于 2017年2月在 GitHub 上查看 ↗

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

#protobuf #elixir #protocol-buffers #protobuf-message #protobuf-runtime #protoc

ahamez/protox 的健康指数为 100 分中的 84 分，处于「优秀」区间。其得分最高的类别是Vitality（87/100），最低的是Sustainability & Governance（62/100）。最近一次更新在 2 天前。近期的大部分工作由 1 位贡献者完成。

总分 / 100

优秀

软件健康指数

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

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

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

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

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

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

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

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

评分画像

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

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

所有权

Alexandre Hamez个人账户

51 关注者70 个公开仓库始于 2010年2月

该仓库由个人账户拥有。相较于组织支持的项目，单一所有者项目的延续性风险更高。

软件包生态系统

注册表	软件包	版本	月下载量	版本数	最近发布
Hex	protox	2.0.10	23,458	75	26 天前

按类别列示的指标

活力

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

87优秀 · 占总体的 21%

开发活跃度

83优秀

评分方式

36/36	推送新近度 — 最近一次推送于 2 天前
19.4/36	提交节奏 — 52 周中有 28 周有提交
18/18	提交量 — 最近一年 122 次提交
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	122
human_commit_share	0.81
days_since_last_push	2
active_weeks_last_year	28

发布纪律

92优秀

评分方式

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

所用输入

releases_count	54
latest_release_tag	v2.0.10
releases_from_tags	否
days_since_latest_release	26
mean_days_between_releases	57.1

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

社区与采用

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

64中等 · 占总体的 17%

流行度与采用

53中等

评分方式

40.1/60	星标 — 296 个星标
11/25	复刻 — 22 个复刻
1.7/15	关注者 — 3 位关注者

所用输入

forks	22
stars	296
watchers	3
growth_state	unverified
growth_factor_pct	100
growth_unverified_reason	no_history

社区健康

70良好

评分方式

22.5/22.5	README
22.5/22.5	许可证 — 可识别的许可证（MIT）
18/18	CONTRIBUTING 指南
0/13.5	行为准则
0/7.2	议题模板
0/6.3	PR 模板

所用输入

has_readme	是
has_license	是
readme_badges	4
has_contributing	是
has_issue_template	否
has_code_of_conduct	否
readme_badge_services	coveralls.io, github.com, shields.io
has_pull_request_template	否

生态采用（下载量）

73良好

评分方式

58.3/80	月度下载量 — hex 合计每月 23,458 次下载
0/20	注册表被依赖数 — 该生态系统不报告此项

所用输入

packages	protox
dependents	—
ecosystems	hex
total_downloads	1,950,926
monthly_downloads	23,458
unverified_packages_excluded	—

已排除计分（无数据或不适用）：注册表被依赖数。其余权重已重新归一化。

可持续性与治理

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

62中等 · 占总体的 23%

维护者韧性（巴士系数）

23存在风险

评分方式

9/54	巴士系数 — 1 位贡献者贡献了半数提交
0.4/22.5	提交分布 — 头号贡献者编写了 98% 的提交
13.5/13.5	贡献者广度 — 17 位贡献者
0/10	OpenSSF Scorecard：Contributors — project has 0 contributing companies or organizations -- score normalized to 0

所用输入

bus_factor	1
contributors_sampled	17
top_contributor_share	0.981

议题与 PR 响应能力

83优秀

评分方式

42/42	议题解决 — 100% 的议题已关闭
28.1/30	PR 接受 — 已裁定的 PR 中 262/280 已合并
13/13	Newcomer PR acceptance — 30 天内首次贡献者的 PR 已合并 1/1
0/15	OpenSSF Scorecard：Code-Review — Found 0/28 approved changesets -- score normalized to 0

所用输入

merged_prs	262
open_issues	0
closed_issues	33
prs_merged_7d	2
prs_decided_7d	2
prs_merged_30d	11
prs_decided_30d	11
issue_closed_ratio	1
closed_unmerged_prs	18
first_time_authors_30d	1
first_time_prs_merged_30d	1
first_time_prs_decided_30d	1

所有权与托管责任

59中等

评分方式

10/30	所有权背书 — 个人（用户）账户
0/20	已验证域名 — 不适用于个人账户
12.3/25	所有者影响力 — ahamez 有 51 位关注者
25/25	既往记录 — 70 个公开仓库，账户约 16 年

所用输入

followers	51
owner_type	User
is_verified	—
owner_login	ahamez
public_repos	70
account_age_days	6,057

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

软件包维护

100卓越

评分方式

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

所用输入

packages	protox
ecosystems	hex
any_deprecated	否
min_days_since_publish	26

工程质量

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

71良好 · 占总体的 19%

工程实践

68良好

评分方式

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

所用输入

has_ci	是
has_tests	是
has_editorconfig	否
has_linter_config	否
has_precommit_config	否

文档

75良好

评分方式

30/30	README
25/25	文档目录
0/15	文档 / 主页站点
10/10	仓库描述
10/10	主题标签 — 6 个主题标签
0/10	Wiki

所用输入

topics	protobuf, elixir, protocol-buffers, protobuf-message, protobuf-runtime, protoc
has_wiki	否
homepage	—
docs_site	—
has_readme	是
has_docs_dir	是
has_description	是

安全

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

71良好 · 占总体的 16%

安全态势

71良好

评分方式

7.5/7.5	Binary-Artifacts — no binaries found in the repo
0/7.5	Branch-Protection — branch protection not enabled on development/release branches
2.5/2.5	CI-Tests — 5 out of 5 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/7.5	Code-Review — Found 0/28 approved changesets -- score normalized to 0
0/2.5	Contributors — project has 0 contributing companies or organizations -- score normalized to 0
10/10	Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5	Dependency-Update-Tool — update tool detected
5/5	Fuzzing — project is fuzzed
2.5/2.5	许可证 — license file detected
7.5/7.5	Maintained — 30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10
0/5	Packaging — 无数据
3/5	Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 6
5/5	SAST — SAST tool is run on all commits
0/5	Security-Policy — security policy file not detected
0/7.5	Signed-Releases — 无数据
7.5/7.5	Token-Permissions — GitHub workflow tokens follow principle of least privilege
7.5/7.5	Vulnerabilities — 0 existing vulnerabilities detected

所用输入

source	openssf_scorecard
checks_evaluated	16
scorecard_version	v5.5.0
checks_inconclusive	2
scorecard_aggregate	7.1

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

AI 就绪度

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

78良好 · 占总体的 4%

AI 代理上下文与指引

85优秀

评分方式

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

所用输入

has_llms_txt	否
llms_txt_url	—
legible_history_share	1
agent_instruction_files	AGENTS.md
agent_instruction_max_bytes	2,483

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

74良好

评分方式

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

所用输入

has_nix	否
has_tests	是
lockfiles	mix.lock
has_dockerfile	否
typed_language	否
bootstrap_files	.config/mise.toml
has_devcontainer	否
has_linter_config	否
typecheck_configs	—
agent_commit_share	0.31
toolchain_manifests	mix.exs
dependency_bot_commit_share	0.18

面向模型的代码可读性

55中等

评分方式

0/45	可类型检查的代码 — Elixir，未配置类型检查
55/55	可控的文件大小 — 采样的 92 个源文件中有 0 个超过 60KB

所用输入

primary_language	Elixir
largest_source_bytes	24,084
source_files_sampled	92
oversized_source_files	0

机器可读接口

100卓越

评分方式

40/40	API 模式（OpenAPI/GraphQL/proto） — benchmark/protos/edge.proto, benchmark/protos/maps.proto, benchmark/protos/synthetic_10.proto, benchmark/protos/synthetic_100.proto, benchmark/protos/synthetic_20.proto, benchmark/protos/synthetic_200.proto, benchmark/protos/synthetic_5.proto, benchmark/protos/synthetic_50.proto, benchmark/protos/vendor/google/benchmark_message1_proto2.proto, benchmark/protos/vendor/google/benchmark_message1_proto3.proto, benchmark/protos/vendor/google/benchmarks.proto, benchmark/protos/vendor/otel/opentelemetry/proto/common/v1/common.proto, benchmark/protos/vendor/otel/opentelemetry/proto/resource/v1/resource.proto, benchmark/protos/vendor/otel/opentelemetry/proto/trace/v1/trace.proto, benchmark/protos/vendor/prometheus/remote.proto, benchmark/protos/vendor/prometheus/types.proto, test/samples/case.proto, test/samples/custom_file_options.proto, test/samples/directory/directory_message_1.proto, test/samples/directory/directory_message_2.proto, test/samples/directory/sub_directory/sub_directory_message.proto, test/samples/google/test_messages_proto2.proto, test/samples/google/test_messages_proto3.proto, test/samples/invalid.proto, test/samples/java_bar.proto, test/samples/java_foo.proto, test/samples/message_as_file_option.proto, test/samples/nested_extensions.proto, test/samples/no_uf_name_clash.proto, test/samples/optional.proto, test/samples/protobuf2.proto, test/samples/use_message_as_file_option.proto
0/20	MCP 服务器 — 不适用于此类软件
40/40	可运行示例 — samples

所用输入

example_dirs	samples
has_mcp_signal	否
api_schema_files	benchmark/protos/edge.proto, benchmark/protos/maps.proto, benchmark/protos/synthetic_10.proto, benchmark/protos/synthetic_100.proto, benchmark/protos/synthetic_20.proto, benchmark/protos/synthetic_200.proto, benchmark/protos/synthetic_5.proto, benchmark/protos/synthetic_50.proto, benchmark/protos/vendor/google/benchmark_message1_proto2.proto, benchmark/protos/vendor/google/benchmark_message1_proto3.proto, benchmark/protos/vendor/google/benchmarks.proto, benchmark/protos/vendor/otel/opentelemetry/proto/common/v1/common.proto, benchmark/protos/vendor/otel/opentelemetry/proto/resource/v1/resource.proto, benchmark/protos/vendor/otel/opentelemetry/proto/trace/v1/trace.proto, benchmark/protos/vendor/prometheus/remote.proto, benchmark/protos/vendor/prometheus/types.proto, test/samples/case.proto, test/samples/custom_file_options.proto, test/samples/directory/directory_message_1.proto, test/samples/directory/directory_message_2.proto, test/samples/directory/sub_directory/sub_directory_message.proto, test/samples/google/test_messages_proto2.proto, test/samples/google/test_messages_proto3.proto, test/samples/invalid.proto, test/samples/java_bar.proto, test/samples/java_foo.proto, test/samples/message_as_file_option.proto, test/samples/nested_extensions.proto, test/samples/no_uf_name_clash.proto, test/samples/optional.proto, test/samples/protobuf2.proto, test/samples/use_message_as_file_option.proto
interfaces_expected_of	—

已排除计分（无数据或不适用）：MCP 服务器。其余权重已重新归一化。

关键数据

296GitHub 星标

17贡献者

122最近 12 个月提交数

2距最近推送天数

54发布版本数

1巴士系数（bus factor）

0开放议题

Hex软件包生态系统数

数据采集警告

Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token

反馈

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

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

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

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

10	Binary-Artifacts	no binaries found in the repo
0	Branch-Protection	branch protection not enabled on development/release branches
10	CI-Tests	5 out of 5 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
0	Code-Review	Found 0/28 approved changesets -- score normalized to 0
0	Contributors	project has 0 contributing companies or organizations -- score normalized to 0
10	Dangerous-Workflow	no dangerous workflow patterns detected
10	Dependency-Update-Tool	update tool detected
10	Fuzzing	project is fuzzed
10	License	license file detected
10	Maintained	30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10
不适用	Packaging	packaging workflow not detected
6	Pinned-Dependencies	dependency not pinned by hash detected -- score normalized to 6
10	SAST	SAST tool is run on all commits
0	Security-Policy	security policy file not detected
不适用	Signed-Releases	no releases found
10	Token-Permissions	GitHub workflow tokens follow principle of least privilege
10	Vulnerabilities	0 existing vulnerabilities detected

软件健康指数

评分画像

所有权

软件包生态系统

按类别列示的指标

关键数据

数据采集警告

更多细节

反馈

相关记录