公开记录
软件健康报告模式 0.34.0 · 指标 2.10.0 · 2026-09-12 07:55 UTC

masci / banks

LLM prompt language based on Jinja. Banks provides tools and functions to build prompts text and chat messages from generic blueprints. It allows attaching metadata to prompts to ease their management, and versioning is first-class citizen. Banks provides ways to store prompts on disk along with their metadata.

PythonMIT★ 128 星标⑂ 21 复刻始于 2023年6月在 GitHub 上查看 ↗
类型库如何判定

masci/banks 的健康指数为 100 分中的 80 分,处于「优秀」区间。 其得分最高的类别是Engineering Quality(84/100),最低的是Security(50/100)。 最近一次更新在 1 天前。 近期的大部分工作由 1 位贡献者完成。

80
总分 / 100
优秀

软件健康指数

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

80
卓越93-100公开记录中的最高层级(约前 5%);基本满足所有检验标准
优秀80-92各方面均表现强劲;仅有少量不足
良好65-79健康;不足之处有限且可控
中等50-64可接受,但存在明显不足;建议进行审查
薄弱35-49多个领域存在实质性薄弱环节
存在风险20-34存在重大薄弱环节;采用时应保持审慎
危急1-19问题严重(项目被弃置、仅有单一维护者、缺乏基本工程规范)
活力社区与采用可持续性与治理工程质量安全AI 就绪度

评分画像

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

加权总体分 68 经校准后在公布的指数量表上为 80(记录校准 2026-08-02)。

所有权

Massimiliano Pippi个人账户
0 关注者79 个公开仓库始于 2008年4月

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

软件包生态系统

注册表软件包版本月下载量版本数最近发布
PyPIbanks2.5.16,101,295381 天前

按类别列示的指标

活力

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

73良好 · 占总体的 21%
评分方式
36/36推送新近度 — 最近一次推送于 1 天前
7.6/36提交节奏 — 52 周中有 11 周有提交
12.9/18提交量 — 最近一年 26 次提交
9/10OpenSSF Scorecard:Maintained — 11 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 9
所用输入
commits_last_year26
human_commit_share0.92
days_since_last_push1
active_weeks_last_year11

发布纪律

83优秀
评分方式
27/27有发布版本 — 已发布 34 个发布版本
36/36发布时效 — 最近一次发布版本于 1 天前
19.8/27发布节奏 — 约每 46.5 天发布一次
0/10OpenSSF Scorecard:Signed-Releases — Project has not signed or included provenance with any releases.
所用输入
releases_count34
latest_release_tagv2.5.1
releases_from_tags否
days_since_latest_release1
mean_days_between_releases46.5

社区与采用

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

74良好 · 占总体的 17%
评分方式
34.1/60星标 — 128 个星标
10.8/25复刻 — 21 个复刻
1.7/15关注者 — 3 位关注者
所用输入
forks21
stars128
watchers3
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

社区健康

85优秀
评分方式
22.5/22.5README
22.5/22.5许可证 — 可识别的许可证(MIT)
18/18CONTRIBUTING 指南
13.5/13.5行为准则
0/7.2议题模板
0/6.3PR 模板
所用输入
has_readme是
has_license是
readme_badges9
has_contributing是
has_issue_template否
has_code_of_conduct是
readme_badge_servicescoveralls.io, github.com, shields.io
has_pull_request_template否
评分方式
80/80月度下载量 — pypi 合计每月 6,101,295 次下载
0/20注册表被依赖数 — 该生态系统不报告此项
所用输入
packagesbanks
dependents—
ecosystemspypi
total_downloads—
monthly_downloads6,101,295
unverified_packages_excluded—
已排除计分(无数据或不适用):注册表被依赖数。 其余权重已重新归一化。

可持续性与治理

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

58中等 · 占总体的 23%
评分方式
9/54巴士系数 — 1 位贡献者贡献了半数提交
1.6/22.5提交分布 — 头号贡献者编写了 93% 的提交
12.2/13.5贡献者广度 — 9 位贡献者
0/10OpenSSF Scorecard:Contributors — project has 0 contributing companies or organizations -- score normalized to 0
所用输入
bus_factor1
contributors_sampled9
top_contributor_share0.929
评分方式
39.4/42议题解决 — 94% 的议题已关闭
29/30PR 接受 — 已裁定的 PR 中 61/63 已合并
0/13Newcomer PR acceptance — 30 天内没有首次贡献者的 PR 得到裁决
1.5/15OpenSSF Scorecard:Code-Review — Found 5/30 approved changesets -- score normalized to 1
所用输入
merged_prs61
open_issues1
closed_issues15
prs_merged_7d1
prs_decided_7d1
prs_merged_30d1
prs_decided_30d1
issue_closed_ratio0.938
closed_unmerged_prs2
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
已排除计分(无数据或不适用):Newcomer PR acceptance。 其余权重已重新归一化。
评分方式
10/30所有权背书 — 个人(用户)账户
0/20已验证域名 — 不适用于个人账户
0/25所有者影响力 — masci 有 0 位关注者
25/25既往记录 — 79 个公开仓库,账户约 18 年
所用输入
followers0
owner_typeUser
is_verified—
owner_loginmasci
public_repos79
account_age_days6,724
已排除计分(无数据或不适用):已验证域名。 其余权重已重新归一化。
评分方式
25/25已发布且可解析 — pypi 上有 1 个软件包
35/35发布时效 — 最近一次发布于 1 天前
20/20版本历史 — 38 个已发布版本
20/20未被弃用 — 活跃,未被弃用或撤回
所用输入
packagesbanks
ecosystemspypi
any_deprecated否
min_days_since_publish1

工程质量

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

84优秀 · 占总体的 19%

工程实践

80优秀
评分方式
24/24CI 工作流 — 3 个工作流
24/24存在测试
16/16Linter 配置 — pyproject.toml ([tool.ruff], [tool.pylint])
0/9.6Pre-commit 钩子
0/6.4.editorconfig
16/20OpenSSF Scorecard:CI-Tests — 15 out of 17 merged PRs checked by a CI test -- score normalized to 8
所用输入
has_ci是
has_tests是
has_editorconfig否
has_linter_config是
has_precommit_config否

文档

90优秀
评分方式
30/30README
25/25文档目录
15/15文档 / 主页站点 — https://masci.github.io/banks/
10/10仓库描述
10/10主题标签 — 6 个主题标签
0/10Wiki
所用输入
topicschatgpt, llm, nlp, openai, prompt-engineering, prompt-toolkit
has_wiki否
homepagehttps://masci.github.io/banks/
docs_sitehttps://masci.github.io/banks/
has_readme是
has_docs_dir是
has_description是

安全

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

50中等 · 占总体的 16%

安全态势

37薄弱
评分方式
7.5/7.5Binary-Artifacts — no binaries found in the repo
0/7.5Branch-Protection — branch protection not enabled on development/release branches
2/2.5CI-Tests — 15 out of 17 merged PRs checked by a CI test -- score normalized to 8
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0.8/7.5Code-Review — Found 5/30 approved changesets -- score normalized to 1
0/2.5Contributors — project has 0 contributing companies or organizations -- score normalized to 0
10/10Dangerous-Workflow — no dangerous workflow patterns detected
0/7.5Dependency-Update-Tool — no update tool detected
0/5Fuzzing — project is not fuzzed
2.5/2.5许可证 — license file detected
6.8/7.5Maintained — 11 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 9
0/5Packaging — 无数据
0/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5SAST — SAST tool is not run on all commits -- score normalized to 0
0/5Security-Policy — security policy file not detected
0/7.5Signed-Releases — Project has not signed or included provenance with any releases.
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
7.5/7.5Vulnerabilities — 0 existing vulnerabilities detected
所用输入
sourceopenssf_scorecard
checks_evaluated17
scorecard_versionv5.5.0
checks_inconclusive1
scorecard_aggregate3.7
已排除计分(无数据或不适用):Packaging。 其余权重已重新归一化。
评分方式
35/35直接依赖不含已知公告 — 没有直接依赖携带已知公告
25/25间接依赖不含已知公告 — 没有间接依赖携带已知公告
0/40没有长期未处理的公告 — 没有公告带有发布日期
所用输入
sourceosv
advisories0
affected_packages0
assessed_packages15
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
已排除计分(无数据或不适用):没有长期未处理的公告。 其余权重已重新归一化。 比对的是 pypi:banks@2.5.1 的运行时依赖闭包——安装已发布的软件包时真正被拉取进来的内容——共 15 个软件包。 未对可达性进行分析。

AI 就绪度

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

66良好 · 占总体的 4%
评分方式
45/45代理指令 — AGENTS.md, CLAUDE.md
15/15机器可读文档(llms.txt) — 项目网站提供 llms.txt(https://docs.litellm.ai/llms.txt)
26.1/40可读的提交历史 — 92 次人类提交中有 45 次说明了意图(结构化标题或解释性正文)
所用输入
has_llms_txt是
llms_txt_urlhttps://docs.litellm.ai/llms.txt
legible_history_share0.489
agent_instruction_filesAGENTS.md, CLAUDE.md
agent_instruction_max_bytes8,213
评分方式
0/18一条命令的引导启动
22/22自动化测试
11/11Lint / 格式化配置 — pyproject.toml ([tool.ruff], [tool.pylint])
0/11静态类型检查
0/10可复现环境
10/10已体现的代理实践 — 最近 100 次提交中有 5 次由代理编写或署名代理
0/8自动化维护 — 未观察到自动依赖更新
0/10OpenSSF Scorecard:Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
所用输入
has_nix否
has_tests是
lockfiles—
has_dockerfile否
typed_language否
bootstrap_files—
has_devcontainer否
has_linter_config是
typecheck_configs—
agent_commit_share0.05
toolchain_manifests—
dependency_bot_commit_share0
评分方式
0/45可类型检查的代码 — Python,未配置类型检查
55/55可控的文件大小 — 采样的 50 个源文件中有 0 个超过 60KB
所用输入
primary_languagePython
largest_source_bytes13,518
source_files_sampled50
oversized_source_files0
评分方式
0/40API 模式(OpenAPI/GraphQL/proto) — 不适用于此类软件
0/20MCP 服务器 — 不适用于此类软件
40/40可运行示例 — cookbook, notebooks
所用输入
example_dirscookbook, notebooks
has_mcp_signal否
api_schema_files—
interfaces_expected_of—
已排除计分(无数据或不适用):API 模式(OpenAPI/GraphQL/proto), MCP 服务器。 其余权重已重新归一化。

关键数据

128GitHub 星标
9贡献者
26最近 12 个月提交数
1距最近推送天数
34发布版本数
1巴士系数(bus factor)
1开放议题
PyPI软件包生态系统数

数据采集警告

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

更多细节

Star 与 Fork 历史 0 ★ / 21 ⇿
0Star
21Fork
33发布

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

0481216202022023-062025-012026-09
主版本 2次版本 18修订 13

每个点涵盖 3 天。

OpenSSF Scorecard 3.7 / 10
3.7综合

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

10Binary-Artifactsno binaries found in the repo
0Branch-Protectionbranch protection not enabled on development/release branches
8CI-Tests15 out of 17 merged PRs checked by a CI test -- score normalized to 8
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
1Code-ReviewFound 5/30 approved changesets -- score normalized to 1
0Contributorsproject has 0 contributing companies or organizations -- score normalized to 0
10Dangerous-Workflowno dangerous workflow patterns detected
0Dependency-Update-Toolno update tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
9Maintained11 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 9
不适用Packagingpackaging workflow not detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
0Signed-ReleasesProject has not signed or included provenance with any releases.
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
10Vulnerabilities0 existing vulnerabilities detected
直接依赖 8
注册表软件包版本约束清单文件
PyPIgriffe—pyproject.toml
PyPIjinja2—pyproject.toml
PyPIpydantic—pyproject.toml
PyPIdeprecated—pyproject.toml
PyPIeval-type-backport—pyproject.toml
PyPItyping-extensions—pyproject.toml
PyPIplatformdirs—pyproject.toml
PyPIfiletype>=1.2.0pyproject.toml
全部依赖 1

来自 GitHub 依赖图的完整解析依赖集合:1 个直接依赖与 0 个间接(传递)软件包。仓库提交锁文件时,传递闭包才是完整的。

注册表软件包版本关系
PyPIfiletype—直接
依赖安全公告 0

安装 pypi:banks@2.5.1 会引入 15 个包(直接与传递):其中 0 个存在已知公告,0 个为直接依赖。

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

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

原始 JSON 报告 机器可读

反馈

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

登录过程中消息不会丢失。

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

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

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