公开记录
软件健康报告模式 0.11.0 · 指标 2.10.0 · 2026-07-17 01:00 UTC

spatialaudio / nbsphinx

:ledger: Sphinx source parser for Jupyter notebooks

Python · TeXMIT★ 471 星标⑂ 139 复刻始于 2015年11月在 GitHub 上查看 ↗
类型库笔记本如何判定
#jupyter-notebook#sphinx-doc#sphinx-extension

spatialaudio/nbsphinx 的健康指数为 100 分中的 69 分，处于「良好」区间。 其得分最高的类别是Community & Adoption（76/100），最低的是AI Readiness（29/100）。 最近一次更新在 2 天前。 近期的大部分工作由 1 位贡献者完成。

69
总分 / 100
良好

软件健康指数

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

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

评分画像

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

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

所有权

spatialaudio.net组织
162 关注者61 个公开仓库始于 2014年5月

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

软件包生态系统

注册表软件包版本月下载量版本数最近发布标签
PyPInbsphinx0.9.81,658,20057230 天前sphinxjupyternotebook

按类别列示的指标

活力

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

65良好 · 占总体的 21%

开发活跃度

62中等
评分方式
36/36推送新近度 — 最近一次推送于 2 天前
6.9/36提交节奏 — 52 周中有 10 周有提交
13.8/18提交量 — 最近一年 33 次提交
5/10OpenSSF Scorecard：Maintained — 7 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 5
所用输入
commits_last_year33
human_commit_share—
days_since_last_push2
active_weeks_last_year10

发布纪律

70良好
评分方式
27/27有发布版本 — 已发布 57 个发布版本
16.2/36发布时效 — 最近一次发布版本于 230 天前
19.8/27发布节奏 — 约每 116 天发布一次
0/10OpenSSF Scorecard：Signed-Releases — 无数据
所用输入
releases_count57
latest_release_tag0.9.8
releases_from_tags否
days_since_latest_release230
mean_days_between_releases116
已排除计分（无数据或不适用）：OpenSSF Scorecard：Signed-Releases。 其余权重已重新归一化。

社区与采用

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

76良好 · 占总体的 17%

流行度与采用

66良好
评分方式
43.3/60星标 — 471 个星标
17.8/25复刻 — 139 个复刻
4.7/15关注者 — 8 位关注者
所用输入
forks139
stars471
watchers8
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

社区健康

70良好
评分方式
22.5/22.5README
22.5/22.5许可证 — 可识别的许可证（MIT）
18/18CONTRIBUTING 指南
0/13.5行为准则
0/7.2议题模板
0/6.3PR 模板
所用输入
has_readme是
has_license是
readme_badges—
has_contributing是
has_issue_template否
has_code_of_conduct否
readme_badge_services—
has_pull_request_template否

生态采用（下载量）

100卓越
评分方式
80/80月度下载量 — pypi 合计每月 1,658,200 次下载
0/20注册表被依赖数 — 该生态系统不报告此项
所用输入
packagesnbsphinx
dependents—
ecosystemspypi
total_downloads—
monthly_downloads1,658,200
unverified_packages_excluded—
已排除计分（无数据或不适用）：注册表被依赖数。 其余权重已重新归一化。

可持续性与治理

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

67良好 · 占总体的 23%

维护者韧性（巴士系数）

35薄弱
评分方式
9/54巴士系数 — 1 位贡献者贡献了半数提交
2.3/22.5提交分布 — 头号贡献者编写了 90% 的提交
13.5/13.5贡献者广度 — 51 位贡献者
10/10OpenSSF Scorecard：Contributors — project has 15 contributing companies or organizations
所用输入
bus_factor1
contributors_sampled51
top_contributor_share0.898

议题与 PR 响应能力

65良好
评分方式
30.3/42议题解决 — 72% 的议题已关闭
26.5/30PR 接受 — 已裁定的 PR 中 445/504 已合并
0/13Newcomer PR acceptance — 30 天内没有首次贡献者的 PR 得到裁决
0/15OpenSSF Scorecard：Code-Review — Found 1/12 approved changesets -- score normalized to 0
所用输入
merged_prs445
open_issues99
closed_issues257
prs_merged_7d—
prs_decided_7d—
prs_merged_30d—
prs_decided_30d—
issue_closed_ratio0.722
closed_unmerged_prs59
first_time_authors_30d—
first_time_prs_merged_30d—
first_time_prs_decided_30d—
已排除计分（无数据或不适用）：Newcomer PR acceptance。 其余权重已重新归一化。

所有权与托管责任

89优秀
评分方式
30/30所有权背书 — 组织持有
0/20已验证域名 — 未读取该组织的域名验证状态
15.9/25所有者影响力 — spatialaudio 有 162 位关注者
25/25既往记录 — 61 个公开仓库，账户约 12 年
所用输入
followers162
owner_typeOrganization
is_verified—
owner_loginspatialaudio
public_repos61
account_age_days4,455
已排除计分（无数据或不适用）：已验证域名。 其余权重已重新归一化。

软件包维护

91优秀
评分方式
25/25已发布且可解析 — pypi 上有 1 个软件包
26/35发布时效 — 最近一次发布于 230 天前
20/20版本历史 — 57 个已发布版本
20/20未被弃用 — 活跃，未被弃用或撤回
所用输入
packagesnbsphinx
ecosystemspypi
any_deprecated否
min_days_since_publish230

工程质量

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

66良好 · 占总体的 19%

工程实践

50中等
评分方式
24/24CI 工作流 — 4 个工作流
0/24存在测试
0/16Linter 配置
0/9.6Pre-commit 钩子
6.4/6.4.editorconfig
20/20OpenSSF Scorecard：CI-Tests — 25 out of 25 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/30README
25/25文档目录
15/15文档 / 主页站点 — https://nbsphinx.readthedocs.io/
10/10仓库描述
10/10主题标签 — 3 个主题标签
0/10Wiki
所用输入
topicsjupyter-notebook, sphinx-doc, sphinx-extension
has_wiki否
homepagehttps://nbsphinx.readthedocs.io/
docs_sitehttps://nbsphinx.readthedocs.io/
has_readme是
has_docs_dir是
has_description是

安全

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

42薄弱 · 占总体的 16%

安全态势

42薄弱
评分方式
7.5/7.5Binary-Artifacts — no binaries found in the repo
0/7.5Branch-Protection — branch protection not enabled on development/release branches
2.5/2.5CI-Tests — 25 out of 25 merged PRs checked by a CI test -- score normalized to 10
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0/7.5Code-Review — Found 1/12 approved changesets -- score normalized to 0
2.5/2.5Contributors — project has 15 contributing companies or organizations
10/10Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5Dependency-Update-Tool — update tool detected
0/5Fuzzing — project is not fuzzed
2.5/2.5许可证 — license file detected
3.8/7.5Maintained — 7 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 5
5/5Packaging — packaging workflow detected
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 — 无数据
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
0/7.5Vulnerabilities — 35 existing vulnerabilities detected
所用输入
sourceopenssf_scorecard
checks_evaluated17
scorecard_versionv5.5.0
checks_inconclusive1
scorecard_aggregate4.2
已排除计分（无数据或不适用）：Signed-Releases。 其余权重已重新归一化。

AI 就绪度

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

29存在风险 · 占总体的 4%

AI 代理上下文与指引

1危急
评分方式
0/45代理指令 — 没有 CLAUDE.md / AGENTS.md / 编辑器规则
0/15机器可读文档（llms.txt）
0/40可读的提交历史 — 无数据
所用输入
has_llms_txt否
llms_txt_url—
legible_history_share—
agent_instruction_files—
agent_instruction_max_bytes—
已排除计分（无数据或不适用）：可读的提交历史。 其余权重已重新归一化。

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

17危急
评分方式
0/18一条命令的引导启动
0/22自动化测试
0/11Lint / 格式化配置
0/11静态类型检查
10/10可复现环境 — lockfile
0/10已体现的代理实践 — 无数据
5/8自动化维护 — 已配置依赖自动化，但在抽样提交中未观察到
0/10OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
所用输入
has_nix否
has_tests否
lockfilesuv.lock
has_dockerfile否
typed_language否
bootstrap_files—
has_devcontainer否
has_linter_config否
typecheck_configs—
agent_commit_share—
toolchain_manifests—
dependency_bot_commit_share0
已排除计分（无数据或不适用）：已体现的代理实践。 其余权重已重新归一化。

面向模型的代码可读性

47薄弱
评分方式
0/45可类型检查的代码 — Python，未配置类型检查
47.1/55可控的文件大小 — 采样的 7 个源文件中有 1 个超过 60KB
所用输入
primary_languagePython
largest_source_bytes78,270
source_files_sampled7
oversized_source_files1

机器可读接口

100卓越
评分方式
0/40API 模式（OpenAPI/GraphQL/proto） — 不适用于此类软件
0/20MCP 服务器 — 不适用于此类软件
40/40可运行示例 — notebooks
所用输入
example_dirsnotebooks
has_mcp_signal否
api_schema_files—
interfaces_expected_of—
已排除计分（无数据或不适用）：API 模式（OpenAPI/GraphQL/proto）, MCP 服务器。 其余权重已重新归一化。

关键数据

471GitHub 星标
51贡献者
33最近 12 个月提交数
2距最近推送天数
57发布版本数
1巴士系数（bus factor）
99开放议题
PyPI软件包生态系统数

更多细节

OpenSSF Scorecard 4.2 / 10
4.2综合

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

10Binary-Artifactsno binaries found in the repo
0Branch-Protectionbranch protection not enabled on development/release branches
10CI-Tests25 out of 25 merged PRs checked by a CI test -- score normalized to 10
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
0Code-ReviewFound 1/12 approved changesets -- score normalized to 0
10Contributorsproject has 15 contributing companies or organizations
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
5Maintained7 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 5
10Packagingpackaging workflow 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
不适用Signed-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
0Vulnerabilities35 existing vulnerabilities detected
直接依赖 6
注册表软件包版本约束清单文件
PyPIdocutils>=0.18.1pyproject.toml
PyPIjinja2—pyproject.toml
PyPInbconvert>=5.3,!=5.4pyproject.toml
PyPInbformat—pyproject.toml
PyPIsphinx>=1.8,!=8.2.0,!=8.2.1pyproject.toml
PyPItraitlets>=5pyproject.toml
全部依赖 174

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

注册表软件包版本关系
PyPIdocutils0.19直接
PyPIdocutils0.20.1直接
PyPIjinja23.1.6直接
PyPInbconvert5.6.1直接
PyPInbconvert7.16.6直接
PyPInbformat5.10.4直接
PyPIsphinx5.3.0直接
PyPIsphinx8.1.3直接
PyPIsphinx8.2.3直接
PyPItraitlets5.14.3直接
PyPIalabaster0.7.13间接
PyPIalabaster0.7.16间接
PyPIalabaster1.0.0间接
PyPIappnope0.1.4间接
PyPIasttokens3.0.0间接
PyPIattrs25.3.0间接
PyPIbabel2.17.0间接
PyPIbackcall0.2.0间接
PyPIbeautifulsoup44.13.5间接
PyPIbeautifulsoup44.6.3间接
PyPIbleach6.1.0间接
PyPIbleach6.2.0间接
PyPIcertifi2025.8.3间接
PyPIcffi1.17.1间接
PyPIcharset-normalizer3.4.3间接
PyPIcolorama0.4.6间接
PyPIcomm0.2.3间接
PyPIcontourpy1.3.2间接
PyPIcontourpy1.3.3间接
PyPIcycler0.12.1间接
PyPIdebugpy1.8.16间接
PyPIdecorator5.2.1间接
PyPIdefusedxml0.7.1间接
PyPIentrypoints0.4间接
PyPIexceptiongroup1.3.0间接
PyPIexecuting2.2.0间接
PyPIfastjsonschema2.21.2间接
PyPIfonttools4.60.2间接
PyPIidna3.15间接
PyPIimagesize1.4.1间接
PyPIimportlib-metadata8.5.0间接
PyPIimportlib-metadata8.7.0间接
PyPIimportlib-resources6.4.5间接
PyPIipykernel—间接
PyPIipykernel4.2.2间接
PyPIipykernel6.30.1间接
PyPIipympl—间接
PyPIipympl0.1.1间接
PyPIipympl0.8.4间接
PyPIipympl0.9.7间接
PyPIipython8.12.3间接
PyPIipython8.18.1间接
PyPIipython8.37.0间接
PyPIipython9.4.0间接
PyPIipython-pygments-lexers1.1.1间接
PyPIipywidgets—间接
PyPIipywidgets8.1.7间接
PyPIjedi0.19.2间接
PyPIjsonschema4.23.0间接
PyPIjsonschema4.25.1间接
PyPIjsonschema-specifications2023.12.1间接
PyPIjsonschema-specifications2025.4.1间接
PyPIjupyter-client5.2.1间接
PyPIjupyter-client8.6.3间接
PyPIjupyter-core5.8.1间接
PyPIjupyterlab—间接
PyPIjupyterlab-pygments0.3.0间接
PyPIjupyterlab-widgets3.0.15间接
PyPIjupytext—间接
PyPIjupytext1.17.1间接
PyPIjupytext1.17.2间接
PyPIkiwisolver1.4.7间接
PyPIkiwisolver1.4.9间接
PyPIlatexcodec3.0.0间接
PyPIlatexcodec3.0.1间接
PyPImarkdown-it-py3.0.0间接
PyPImarkdown-it-py4.0.0间接
PyPImarkupsafe2.1.5间接
PyPImarkupsafe3.0.2间接
PyPImatplotlib—间接
PyPImatplotlib3.10.5间接
PyPImatplotlib3.2.2间接
PyPImatplotlib-inline0.1.7间接
PyPImdit-py-plugins0.4.2间接
PyPImdit-py-plugins0.5.0间接
PyPImdurl0.1.2间接
PyPImistune0.8.4间接
PyPImistune3.3.0间接
PyPInbclient0.10.2间接
PyPInest-asyncio1.6.0间接
PyPInumpy—间接
PyPInumpy1.24.4间接
PyPInumpy2.0.2间接
PyPInumpy2.2.6间接
PyPInumpy2.3.2间接
PyPIpackaging25.0间接
PyPIpandas—间接
PyPIpandas2.0.3间接
PyPIpandas2.3.2间接
PyPIpandocfilters1.5.1间接
PyPIparso0.8.5间接
PyPIpexpect4.9.0间接
PyPIpickleshare0.7.5间接
PyPIpillow12.2.0间接
PyPIpkgutil-resolve-name1.3.10间接
PyPIplatformdirs4.3.6间接
PyPIplatformdirs4.3.8间接
PyPIprompt-toolkit3.0.51间接
PyPIpsutil7.0.0间接
PyPIptyprocess0.7.0间接
PyPIpure-eval0.2.3间接
PyPIpybtex0.25.1间接
PyPIpybtex-docutils1.0.3间接
PyPIpycparser2.22间接
PyPIpygments2.19.2间接
PyPIpyparsing3.1.4间接
PyPIpyparsing3.2.3间接
PyPIpython-dateutil2.9.0.post0间接
PyPIpytz2025.2间接
PyPIpywin32311间接
PyPIpyyaml6.0.2间接
PyPIpyzmq27.0.2间接
PyPIreferencing0.35.1间接
PyPIreferencing0.36.2间接
PyPIrequests2.15.1间接
PyPIrequests2.32.4间接
PyPIroman-numerals-py3.1.0间接
PyPIrpds-py0.20.1间接
PyPIrpds-py0.27.0间接
PyPIsetuptools—间接
PyPIsix1.17.0间接
PyPIsnowballstemmer3.0.1间接
PyPIsoupsieve2.8.4间接
PyPIsphinx-codeautolink—间接
PyPIsphinx-codeautolink0.12.1间接
PyPIsphinx-codeautolink0.15.2间接
PyPIsphinx-codeautolink0.17.5间接
PyPIsphinx-last-updated-by-git—间接
PyPIsphinx-last-updated-by-git0.3.8间接
PyPIsphinxcontrib-applehelp1.0.4间接
PyPIsphinxcontrib-applehelp2.0.0间接
PyPIsphinxcontrib-bibtex—间接
PyPIsphinxcontrib-bibtex2.5.0间接
PyPIsphinxcontrib-bibtex2.6.5间接
PyPIsphinxcontrib-devhelp1.0.2间接
PyPIsphinxcontrib-devhelp2.0.0间接
PyPIsphinxcontrib-htmlhelp2.0.1间接
PyPIsphinxcontrib-htmlhelp2.1.0间接
PyPIsphinxcontrib-jsmath1.0.1间接
PyPIsphinxcontrib-qthelp1.0.3间接
PyPIsphinxcontrib-qthelp2.0.0间接
PyPIsphinxcontrib-serializinghtml1.1.5间接
PyPIsphinxcontrib-serializinghtml2.0.0间接
PyPIsphinxcontrib-svg2pdfconverter—间接
PyPIsphinxcontrib-svg2pdfconverter1.3.0间接
PyPIstack-data0.6.3间接
PyPItestpath0.6.0间接
PyPItinycss21.4.0间接
PyPItomli2.2.1间接
PyPItornado6.5.7间接
PyPItyping-extensions4.13.2间接
PyPItyping-extensions4.15.0间接
PyPItzdata2025.2间接
PyPIurllib32.7.0间接
PyPIwcwidth0.2.13间接
PyPIwebencodings0.5.1间接
PyPIwidgetsnbextension4.0.14间接
PyPIxarray—间接
PyPIxarray2023.1.0间接
PyPIxarray2024.7.0间接
PyPIxarray2025.6.1间接
PyPIxarray2025.8.0间接
PyPIzipp3.20.2间接
PyPIzipp3.23.0间接
原始 JSON 报告 机器可读

反馈

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

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

相关记录

与 spatialaudio/nbsphinx 共享目录标签或生态系统的已检测仓库。 并排阅读 →

96jupyter/notebookJupyter Interactive Notebook卓越88mgaitan/sphinxcontrib-mermaidMermaid diagrams in yours sphinx powered docs优秀87mljar/mercuryImpress your boss and turn a Jupyter notebook into a beautiful, shareable web app — no callbacks, no frontend, no rewrite.优秀84executablebooks/myst-nbParse and execute ipynb files in Sphinx优秀81jupyter-lsp/jupyterlab-lspCoding assistance for JupyterLab (code navigation + hover suggestions + linters + autocompletion + rename) using Language Server Protocol优秀80nbQA-dev/nbQARun ruff, isort, pyupgrade, mypy, pylint, flake8, and more on Jupyter Notebooks优秀

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

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

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