公开记录
软件健康报告模式 0.31.0 · 指标 2.10.0 · 2026-08-05 05:16 UTC

teng-lin / notebooklm-py

Unofficial Python API and agentic skill for Google Gemini Notebook. Full programmatic access to NotebookLM's features—including capabilities the web UI doesn't expose—via Python, CLI, and AI agents like Claude Code, Codex, and OpenClaw.

PythonMIT★ 18,463 星标⑂ 2,478 复刻始于 2026年1月在 GitHub 上查看 ↗
类型命令行工具库如何判定
#api#claude#python#sdk#skills#google-notebooklm#notebooklm#notebooklm-api#podcast-generator#python-api#agentic-skill#claude-skills#openclaw-skills#notebooklm-skill#gemini-notebook

teng-lin/notebooklm-py 的健康指数为 100 分中的 94 分，处于「卓越」区间。 其得分最高的类别是Engineering Quality（92/100），最低的是Sustainability & Governance（62/100）。 最近一次更新在今天。 近期的大部分工作由 1 位贡献者完成。

94
总分 / 100
卓越

软件健康指数

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

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

评分画像

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

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

所有权

Teng Lin个人账户
681 关注者8 个公开仓库始于 2011年4月XtalPi Inc.

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

软件包生态系统

注册表软件包版本月下载量版本数最近发布标签
PyPInotebooklm-py0.8.0-301 天前aiapiautomationclientgooglenotebooklmrpc

按类别列示的指标

活力

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

86优秀 · 占总体的 21%

开发活跃度

83优秀
评分方式
36/36推送新近度 — 最近一次推送于 0 天前
19.4/36提交节奏 — 52 周中有 28 周有提交
18/18提交量 — 最近一年 1,909 次提交
10/10OpenSSF Scorecard：Maintained — 30 commit(s) and 26 issue activity found in the last 90 days -- score normalized to 10
所用输入
commits_last_year1,909
human_commit_share0.95
days_since_last_push0
active_weeks_last_year28

发布纪律

90优秀
评分方式
27/27有发布版本 — 已发布 27 个发布版本
36/36发布时效 — 最近一次发布版本于 1 天前
27/27发布节奏 — 约每 3.2 天发布一次
0/10OpenSSF Scorecard：Signed-Releases — Project has not signed or included provenance with any releases.
所用输入
releases_count27
latest_release_tagv0.8.0
releases_from_tags否
days_since_latest_release1
mean_days_between_releases3.2

社区与采用

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

87优秀 · 占总体的 17%

流行度与采用

96卓越
评分方式
60/60星标 — 18,463 个星标
25/25复刻 — 2,478 个复刻
10.5/15关注者 — 80 位关注者
所用输入
forks2,478
stars18,463
watchers80
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

社区健康

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

可持续性与治理

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

62中等 · 占总体的 23%

维护者韧性（巴士系数）

29存在风险
评分方式
9/54巴士系数 — 1 位贡献者贡献了半数提交
0.9/22.5提交分布 — 头号贡献者编写了 96% 的提交
13.5/13.5贡献者广度 — 28 位贡献者
6/10OpenSSF Scorecard：Contributors — project has 2 contributing companies or organizations -- score normalized to 6
所用输入
bus_factor1
contributors_sampled28
top_contributor_share0.959

议题与 PR 响应能力

72良好
评分方式
39.5/42议题解决 — 94% 的议题已关闭
27.7/30PR 接受 — 已裁定的 PR 中 1,369/1,483 已合并
5.2/13Newcomer PR acceptance — 30 天内首次贡献者的 PR 已合并 2/5
0/15OpenSSF Scorecard：Code-Review — Found 1/27 approved changesets -- score normalized to 0
所用输入
merged_prs1,369
open_issues34
closed_issues536
prs_merged_7d37
prs_decided_7d37
prs_merged_30d50
prs_decided_30d54
issue_closed_ratio0.94
closed_unmerged_prs114
first_time_authors_30d3
first_time_prs_merged_30d2
first_time_prs_decided_30d5

所有权与托管责任

62中等
评分方式
10/30所有权背书 — 个人（用户）账户
0/20已验证域名 — 不适用于个人账户
20.4/25所有者影响力 — teng-lin 有 681 位关注者
18.9/25既往记录 — 8 个公开仓库，账户约 15 年
所用输入
followers681
owner_typeUser
is_verified—
owner_loginteng-lin
public_repos8
account_age_days5,587
已排除计分（无数据或不适用）：已验证域名。 其余权重已重新归一化。

软件包维护

100卓越
评分方式
25/25已发布且可解析 — pypi 上有 1 个软件包
35/35发布时效 — 最近一次发布于 1 天前
20/20版本历史 — 30 个已发布版本
20/20未被弃用 — 活跃，未被弃用或撤回
所用输入
packagesnotebooklm-py
ecosystemspypi
any_deprecated否
min_days_since_publish1

工程质量

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

92优秀 · 占总体的 19%

工程实践

94卓越
评分方式
24/24CI 工作流 — 12 个工作流
24/24存在测试
16/16Linter 配置
9.6/9.6Pre-commit 钩子
0/6.4.editorconfig
20/20OpenSSF 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/30README
25/25文档目录
15/15文档 / 主页站点 — https://github.com/teng-lin/notebooklm-py
10/10仓库描述
10/10主题标签 — 15 个主题标签
0/10Wiki
所用输入
topicsapi, claude, python, sdk, skills, google-notebooklm, notebooklm, notebooklm-api, podcast-generator, python-api, agentic-skill, claude-skills, openclaw-skills, notebooklm-skill, gemini-notebook
has_wiki否
homepagehttps://github.com/teng-lin/notebooklm-py
docs_sitehttps://github.com/teng-lin/notebooklm-py
has_readme是
has_docs_dir是
has_description是

安全

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

74良好 · 占总体的 16%

安全态势

68良好
评分方式
7.5/7.5Binary-Artifacts — no binaries found in the repo
2.2/7.5Branch-Protection — branch protection is not maximal on development and all release branches
2.5/2.5CI-Tests — 30 out of 30 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/27 approved changesets -- score normalized to 0
1.5/2.5Contributors — project has 2 contributing companies or organizations -- score normalized to 6
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
7.5/7.5Maintained — 30 commit(s) and 26 issue activity found in the last 90 days -- score normalized to 10
5/5Packaging — packaging workflow detected
2/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 4
5/5SAST — SAST tool is run on all commits
5/5Security-Policy — security policy file detected
0/7.5Signed-Releases — Project has not signed or included provenance with any releases.
6/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
7.5/7.5Vulnerabilities — 0 existing vulnerabilities detected
所用输入
sourceopenssf_scorecard
checks_evaluated18
scorecard_versionv5.5.0
checks_inconclusive0
scorecard_aggregate6.8

依赖安全公告

100卓越
评分方式
35/35直接依赖不含已知公告 — 没有直接依赖携带已知公告
0/25间接依赖不含已知公告 — 在此范围内，传递依赖集合无法与开发和测试依赖区分
0/40没有长期未处理的公告 — 没有公告带有发布日期
所用输入
sourceosv
advisories0
affected_packages0
assessed_packages123
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
已排除计分（无数据或不适用）：间接依赖不含已知公告, 没有长期未处理的公告。 其余权重已重新归一化。 已将 123 个已解析依赖与 OSV 比对。 该仓库未发布任何索引可解析的软件包，因此改为评估仓库依赖图。该图将开发与测试版本固定同交付的依赖混在一起，因此仅对声明的运行时依赖计分；传递性发现仅作为背景信息列出，不计入评分。 未对可达性进行分析。

AI 就绪度

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

90优秀 · 占总体的 4%

AI 代理上下文与指引

85优秀
评分方式
45/45代理指令 — AGENTS.md, CLAUDE.md
0/15机器可读文档（llms.txt）
40/40可读的提交历史 — 95 次人类提交中有 94 次说明了意图（结构化标题或解释性正文）
所用输入
has_llms_txt否
llms_txt_url—
legible_history_share0.989
agent_instruction_filesAGENTS.md, CLAUDE.md
agent_instruction_max_bytes6,105

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

94卓越
评分方式
18/18一条命令的引导启动 — deploy/Makefile
22/22自动化测试
11/11Lint / 格式化配置
11/11静态类型检查 — src/notebooklm/py.typed
10/10可复现环境 — Dockerfile, lockfile
10/10已体现的代理实践 — 最近 100 次提交中有 86 次由代理编写或署名代理
8/8自动化维护 — 最近 100 次提交中有 5 次为自动依赖更新
4/10OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 4
所用输入
has_nix否
has_tests是
lockfilesuv.lock
has_dockerfile是
typed_language否
bootstrap_filesdeploy/Makefile
has_devcontainer否
has_linter_config是
typecheck_configssrc/notebooklm/py.typed
agent_commit_share0.86
toolchain_manifests—
dependency_bot_commit_share0.05

面向模型的代码可读性

81优秀
评分方式
27/45可类型检查的代码 — Python，已配置类型检查（src/notebooklm/py.typed）
53.7/55可控的文件大小 — 采样的 990 个源文件中有 23 个超过 60KB
所用输入
primary_languagePython
largest_source_bytes141,417
source_files_sampled990
oversized_source_files23

机器可读接口

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

关键数据

18,463GitHub 星标
28贡献者
1,909最近 12 个月提交数
0距最近推送天数
27发布版本数
1巴士系数（bus factor）
34开放议题
PyPI软件包生态系统数

数据采集警告

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
  • deps.dev does not index pypi:notebooklm-py@0.8.0; advisories assessed against the repository dependency graph instead

更多细节

Star 与 Fork 历史 0 ★ / 2,478 ⇿
0Star
2,478Fork
19发布

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

仅显示最近的历史——该仓库超出采集窗口，因此未采集最早的历史记录。

1,0001,5002,0002,5002,478482026-042026-062026-08
主版本 0次版本 5修订 4
OpenSSF Scorecard 6.8 / 10
6.8综合

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

10Binary-Artifactsno binaries found in the repo
3Branch-Protectionbranch protection is not maximal on development and all release branches
10CI-Tests30 out of 30 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/27 approved changesets -- score normalized to 0
6Contributorsproject has 2 contributing companies or organizations -- score normalized to 6
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 26 issue activity found in the last 90 days -- score normalized to 10
10Packagingpackaging workflow detected
4Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 4
10SASTSAST tool is run on all commits
10Security-Policysecurity policy file detected
0Signed-ReleasesProject has not signed or included provenance with any releases.
8Token-Permissionsdetected GitHub workflow tokens with excessive permissions
10Vulnerabilities0 existing vulnerabilities detected
直接依赖 4
注册表软件包版本约束清单文件
PyPIhttpx>=0.27.0,<0.29pyproject.toml
PyPIclick>=8.0.0,<9pyproject.toml
PyPIrich>=13.0.0,<16pyproject.toml
PyPIfilelock>=3.13,<4pyproject.toml
全部依赖 123

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

注册表软件包版本关系
PyPIclick8.4.2直接
PyPIfilelock3.25.2直接
PyPIhttpx0.28.1直接
PyPIrich14.2.0直接
PyPIaiofile3.11.1间接
PyPIaiofile3.9.0间接
PyPIannotated-doc0.0.4间接
PyPIannotated-types0.7.0间接
PyPIanyio4.12.1间接
PyPIattrs26.1.0间接
PyPIauthlib1.7.2间接
PyPIbackports-asyncio-runner1.2.0间接
PyPIbackports-tarfile1.2.0间接
PyPIbeartype0.22.9间接
PyPIbeautifulsoup44.14.3间接
PyPIcachetools7.1.4间接
PyPIcaio0.9.25间接
PyPIcertifi2026.1.4间接
PyPIcffi2.0.0间接
PyPIcfgv3.5.0间接
PyPIcharset-normalizer3.4.7间接
PyPIcolorama0.4.6间接
PyPIcoverage7.13.1间接
PyPIcryptography50.0.0间接
PyPIcurl-cffi0.15.0间接
PyPIcyclopts4.16.1间接
PyPIdistlib0.4.0间接
PyPIdnspython2.8.0间接
PyPIdocstring-parser0.18.0间接
PyPIemail-validator2.3.0间接
PyPIexceptiongroup1.3.1间接
PyPIexecnet2.1.2间接
PyPIfastapi0.136.3间接
PyPIfastmcp3.4.2间接
PyPIfastmcp-slim3.4.2间接
PyPIgpsoauth2.0.0间接
PyPIgreenlet3.3.0间接
PyPIgriffelib2.1.0间接
PyPIh110.16.0间接
PyPIhttpcore1.0.9间接
PyPIhttptools0.8.0间接
PyPIhttpx-sse0.4.3间接
PyPIidentify2.6.17间接
PyPIidna3.15间接
PyPIimportlib-metadata9.0.0间接
PyPIiniconfig2.3.0间接
PyPIjaraco-classes3.4.0间接
PyPIjaraco-context6.1.2间接
PyPIjaraco-functools4.5.0间接
PyPIjeepney0.9.0间接
PyPIjoserfc1.7.1间接
PyPIjsonref1.1.0间接
PyPIjsonschema4.26.0间接
PyPIjsonschema-path0.5.0间接
PyPIjsonschema-specifications2025.9.1间接
PyPIkeyring25.7.0间接
PyPIlibrt0.7.7间接
PyPImarkdown-it-py4.0.0间接
PyPImarkdownify1.2.2间接
PyPImcp1.29.0间接
PyPImdurl0.1.2间接
PyPImore-itertools11.1.0间接
PyPImypy1.19.1间接
PyPImypy-extensions1.1.0间接
PyPInodeenv1.10.0间接
PyPInotebooklm-py0.8.0间接
PyPIopenapi-pydantic0.5.1间接
PyPIopentelemetry-api1.42.1间接
PyPIpackaging25.0间接
PyPIpathable0.6.0间接
PyPIpathspec1.0.3间接
PyPIplatformdirs4.9.4间接
PyPIplaywright1.57.0间接
PyPIpluggy1.6.0间接
PyPIpre-commit4.5.1间接
PyPIpy-key-value-aio0.4.5间接
PyPIpycparser3.0间接
PyPIpycryptodomex3.23.0间接
PyPIpydantic2.13.4间接
PyPIpydantic-core2.46.4间接
PyPIpydantic-settings2.14.2间接
PyPIpyee13.0.0间接
PyPIpygments2.20.0间接
PyPIpyjwt2.13.0间接
PyPIpyperclip1.11.0间接
PyPIpytest9.0.3间接
PyPIpytest-asyncio1.3.0间接
PyPIpytest-cov7.0.0间接
PyPIpytest-httpx0.36.0间接
PyPIpytest-rerunfailures16.1间接
PyPIpytest-timeout2.4.0间接
PyPIpytest-xdist3.8.0间接
PyPIpython-discovery1.1.3间接
PyPIpython-dotenv1.2.2间接
PyPIpython-multipart0.0.32间接
PyPIpywin32312间接
PyPIpywin32-ctypes0.2.3间接
PyPIpyyaml6.0.3间接
PyPIreferencing0.37.0间接
PyPIrequests2.34.2间接
PyPIrich-rst2.0.1间接
PyPIrookiepy0.5.6间接
PyPIrpds-py0.30.0间接
PyPIrpds-py2026.5.1间接
PyPIruff0.16.1间接
PyPIsecretstorage3.5.0间接
PyPIsix1.17.0间接
PyPIsoupsieve2.8.4间接
PyPIsse-starlette3.4.4间接
PyPIstarlette1.3.1间接
PyPItomli2.3.0间接
PyPItyping-extensions4.15.0间接
PyPItyping-inspection0.4.2间接
PyPIuncalled-for0.3.2间接
PyPIurllib32.7.0间接
PyPIuvicorn0.49.0间接
PyPIuvloop0.22.1间接
PyPIvcrpy8.2.1间接
PyPIvirtualenv21.2.0间接
PyPIwatchfiles1.2.0间接
PyPIwebsockets16.0间接
PyPIwrapt2.0.1间接
PyPIzipp4.1.0间接
依赖安全公告 0

该仓库未发布可被索引解析的包，因此评估的是其自身的依赖图——共 123 个包，其中也包含从不交付的开发与测试版本固定：0 个存在已知公告，0 个为直接依赖。

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

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

原始 JSON 报告 机器可读

反馈

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

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

相关记录

与 teng-lin/notebooklm-py 共享目录标签或生态系统的已检测仓库。 并排阅读 →

99quantumlib/CirqPython framework for creating, editing, and running Noisy Intermediate-Scale Quantum (NISQ) circuits.卓越98mem0ai/mem0Universal memory layer for AI Agents卓越99microsoft/agent-frameworkA framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Python and .NET.卓越99IBM/mcp-context-forgeAn AI Gateway, registry, and proxy that sits in front of any MCP, A2A, or REST/gRPC APIs, exposing a unified endpoint with centralized discovery, guardrails and management. Optimizes Agent & Tool calling, and supports plugins.卓越98Significant-Gravitas/AutoGPTAutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.卓越100open-telemetry/opentelemetry-pythonOpenTelemetry Python API and SDK 卓越

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

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

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