公开记录
软件健康报告模式 0.34.0 · 指标 2.10.0 · 2026-09-18 11:24 UTC

mgd43b / manicule

Self-hosted retrieval infrastructure for AI assistants. MCP-first search and grounded answers over a private corpus, with citations that resolve to a real location in a real document — a page, a heading, a line, a cell.

PythonMIT★ 0 星标⑂ 0 复刻始于 2026年8月在 GitHub 上查看 ↗
类型命令行工具插件网络服务如何判定

mgd43b/manicule 的健康指数为 100 分中的 69 分,处于「良好」区间。 其得分最高的类别是Engineering Quality(90/100),最低的是Community & Adoption(33/100)。 最近一次更新在 1 天前。 近期的大部分工作由 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)。

所有权

mgd43b个人账户
4 关注者11 个公开仓库始于 2012年1月

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

软件包生态系统

注册表软件包版本月下载量版本数最近发布标签
PyPImanicule0.2.7-311 天前citationsdocumentsragsearchself-hosted

按类别列示的指标

活力

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

71良好 · 占总体的 21%
评分方式
36/36推送新近度最近一次推送于 1 天前
4.2/36提交节奏52 周中有 6 周有提交
18/18提交量最近一年 294 次提交
0/10OpenSSF Scorecard:Maintainedproject was created within the last 90 days. Please review its contents carefully
所用输入
commits_last_year294
human_commit_share0.59
days_since_last_push1
active_weeks_last_year6

发布纪律

90优秀
评分方式
27/27有发布版本已发布 32 个发布版本
36/36发布时效最近一次发布版本于 1 天前
27/27发布节奏约每 0.2 天发布一次
0/10OpenSSF Scorecard:Signed-ReleasesProject has not signed or included provenance with any releases.
所用输入
releases_count32
latest_release_tagv0.2.7
releases_from_tags
days_since_latest_release1
mean_days_between_releases0.2

社区与采用

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

33存在风险 · 占总体的 17%
评分方式
0/60星标0 个星标
0/25复刻0 个复刻
0/15关注者0 位关注者
所用输入
forks0
stars0
watchers0
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_badges5
has_contributing
has_issue_template
has_code_of_conduct
readme_badge_servicesgithub.com, shields.io
has_pull_request_template

可持续性与治理

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

53中等 · 占总体的 23%
评分方式
9/54巴士系数1 位贡献者贡献了半数提交
0/22.5提交分布头号贡献者编写了 100% 的提交
1.4/13.5贡献者广度1 位贡献者
0/10OpenSSF Scorecard:Contributorsproject has 0 contributing companies or organizations -- score normalized to 0
所用输入
bus_factor1
contributors_sampled1
top_contributor_share1
评分方式
36.7/42议题解决87% 的议题已关闭
28.8/30PR 接受已裁定的 PR 中 273/284 已合并
0/13Newcomer PR acceptance30 天内没有首次贡献者的 PR 得到裁决
0/15OpenSSF Scorecard:Code-ReviewFound 0/20 approved changesets -- score normalized to 0
所用输入
merged_prs273
open_issues14
closed_issues97
prs_merged_7d33
prs_decided_7d33
prs_merged_30d33
prs_decided_30d33
issue_closed_ratio0.874
closed_unmerged_prs11
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
已排除计分(无数据或不适用):Newcomer PR acceptance。 其余权重已重新归一化。
评分方式
10/30所有权背书个人(用户)账户
0/20已验证域名不适用于个人账户
5/25所有者影响力mgd43b 有 4 位关注者
19.9/25既往记录11 个公开仓库,账户约 14 年
所用输入
followers4
owner_typeUser
is_verified
owner_loginmgd43b
public_repos11
account_age_days5,368
已排除计分(无数据或不适用):已验证域名。 其余权重已重新归一化。
评分方式
25/25已发布且可解析pypi 上有 1 个软件包
35/35发布时效最近一次发布于 1 天前
20/20版本历史31 个已发布版本
20/20未被弃用活跃,未被弃用或撤回
所用输入
packagesmanicule
ecosystemspypi
any_deprecated
min_days_since_publish1

工程质量

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

90优秀 · 占总体的 19%

工程实践

84优秀
评分方式
24/24CI 工作流5 个工作流
24/24存在测试
16/16Linter 配置pyproject.toml ([tool.ruff])
0/9.6Pre-commit 钩子
0/6.4.editorconfig
20/20OpenSSF Scorecard:CI-Tests30 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

文档

100卓越
评分方式
30/30README
25/25文档目录
15/15文档 / 主页站点https://pypi.org/project/manicule/
10/10仓库描述
10/10主题标签17 个主题标签
10/10Wiki
所用输入
topicsair-gapped, citations, confluence, document-search, embeddings, lancedb, mcp, mcp-server, model-context-protocol, python, rag, retrieval-augmented-generation, self-hosted, semantic-search, sqlite, tree-sitter, vector-search
has_wiki
homepagehttps://pypi.org/project/manicule/
docs_sitehttps://pypi.org/project/manicule/
has_readme
has_docs_dir
has_description

安全

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

61中等 · 占总体的 16%

安全态势

51中等
评分方式
7.5/7.5Binary-Artifactsno binaries found in the repo
0/7.5Branch-Protection无数据
2.5/2.5CI-Tests30 out of 30 merged PRs checked by a CI test -- score normalized to 10
0/2.5CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
0/7.5Code-ReviewFound 0/20 approved changesets -- score normalized to 0
0/2.5Contributorsproject has 0 contributing companies or organizations -- score normalized to 0
10/10Dangerous-Workflowno dangerous workflow patterns detected
7.5/7.5Dependency-Update-Toolupdate tool detected
0/5Fuzzingproject is not fuzzed
2.5/2.5许可证license file detected
0/7.5Maintainedproject was created within the last 90 days. Please review its contents carefully
5/5Packagingpackaging workflow detected
0/5Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0/5SASTSAST tool is not run on all commits -- score normalized to 0
0/5Security-Policysecurity policy file not detected
0/7.5Signed-ReleasesProject has not signed or included provenance with any releases.
7.5/7.5Token-PermissionsGitHub workflow tokens follow principle of least privilege
7.5/7.5Vulnerabilities0 existing vulnerabilities detected
所用输入
sourceopenssf_scorecard
checks_evaluated17
scorecard_versionv5.5.0
checks_inconclusive1
scorecard_aggregate5.1
已排除计分(无数据或不适用):Branch-Protection。 其余权重已重新归一化。
评分方式
35/35直接依赖不含已知公告没有直接依赖携带已知公告
25/25间接依赖不含已知公告没有间接依赖携带已知公告
0/40没有长期未处理的公告没有公告带有发布日期
所用输入
sourceosv
advisories0
affected_packages0
assessed_packages9
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
已排除计分(无数据或不适用):没有长期未处理的公告。 其余权重已重新归一化。 比对的是 pypi:manicule@0.2.7 的运行时依赖闭包——安装已发布的软件包时真正被拉取进来的内容——共 9 个软件包。 未对可达性进行分析。

AI 就绪度

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

58中等 · 占总体的 4%
评分方式
0/45代理指令没有 CLAUDE.md / AGENTS.md / 编辑器规则
0/15机器可读文档(llms.txt)
40/40可读的提交历史59 次人类提交中有 59 次说明了意图(结构化标题或解释性正文)
所用输入
has_llms_txt
llms_txt_url
legible_history_share1
agent_instruction_files
agent_instruction_max_bytes
评分方式
0/18一条命令的引导启动
22/22自动化测试
11/11Lint / 格式化配置pyproject.toml ([tool.ruff])
11/11静态类型检查packages/manicule-mlx/src/manicule_mlx/py.typed, packages/manicule-ollama/src/manicule_ollama/py.typed, packages/manicule-plugin-example/src/manicule_plugin_example/py.typed, packages/manicule-plugin-hostile/src/manicule_plugin_hostile/py.typed, packages/manicule-plugin-wikilinks/src/manicule_plugin_wikilinks/py.typed, src/manicule/py.typed
10/10可复现环境Dockerfile, lockfile
2/10已体现的代理实践最近 100 次提交中有 1 次由代理编写或署名代理
8/8自动化维护最近 100 次提交中有 14 次为自动依赖更新
0/10OpenSSF Scorecard:Pinned-Dependenciesdependency 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_configspackages/manicule-mlx/src/manicule_mlx/py.typed, packages/manicule-ollama/src/manicule_ollama/py.typed, packages/manicule-plugin-example/src/manicule_plugin_example/py.typed, packages/manicule-plugin-hostile/src/manicule_plugin_hostile/py.typed, packages/manicule-plugin-wikilinks/src/manicule_plugin_wikilinks/py.typed, src/manicule/py.typed
agent_commit_share0.01
toolchain_manifests
dependency_bot_commit_share0.14
评分方式
27/45可类型检查的代码Python,已配置类型检查(packages/manicule-mlx/src/manicule_mlx/py.typed, packages/manicule-ollama/src/manicule_ollama/py.typed, packages/manicule-plugin-example/src/manicule_plugin_example/py.typed, packages/manicule-plugin-hostile/src/manicule_plugin_hostile/py.typed, packages/manicule-plugin-wikilinks/src/manicule_plugin_wikilinks/py.typed, src/manicule/py.typed)
51.5/55可控的文件大小采样的 659 个源文件中有 42 个超过 60KB
所用输入
primary_languagePython
largest_source_bytes418,580
source_files_sampled659
oversized_source_files42

关键数据

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

数据采集警告

  • pypi download statistics for 'manicule' unavailable this scan (stats endpoint failed after retries); adoption may be under-evidenced

更多细节

OpenSSF Scorecard 5.1 / 10
5.1综合

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

10Binary-Artifactsno binaries found in the repo
不适用Branch-Protectioninternal 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
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 0/20 approved changesets -- score normalized to 0
0Contributorsproject has 0 contributing companies or organizations -- score normalized to 0
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
0Maintainedproject was created within the last 90 days. Please review its contents carefully
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
0Signed-ReleasesProject has not signed or included provenance with any releases.
10Token-PermissionsGitHub workflow tokens follow principle of least privilege
10Vulnerabilities0 existing vulnerabilities detected
直接依赖 5
注册表软件包版本约束清单文件
PyPIpydantic>=2.9pyproject.toml
PyPIpydantic-settings>=2.6pyproject.toml
PyPIpackaging>=24.0pyproject.toml
PyPIpython-dotenv>=1.0pyproject.toml
PyPItomli-w>=1.0pyproject.toml
全部依赖 221

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

注册表软件包版本关系
PyPIpackaging26.3直接
PyPIpydantic2.13.5直接
PyPIpydantic-settings2.15.0直接
PyPIpython-dotenv1.2.3直接
PyPItomli-w1.2.0直接
PyPIaiofile3.12.3间接
PyPIaiohappyeyeballs2.7.1间接
PyPIaiohttp3.14.3间接
PyPIaiosignal1.4.0间接
PyPIaiosqlite0.22.1间接
PyPIalembic1.20.0间接
PyPIannotated-doc0.0.5间接
PyPIannotated-types0.8.0间接
PyPIanyio4.14.2间接
PyPIattrs26.1.0间接
PyPIauthlib1.7.2间接
PyPIbeartype0.22.9间接
PyPIboto31.43.83间接
PyPIbotocore1.43.83间接
PyPIcachetools7.1.7间接
PyPIcaio0.12.2间接
PyPIcertifi2026.7.22间接
PyPIcffi2.1.1间接
PyPIcharset-normalizer3.4.9间接
PyPIclick8.4.2间接
PyPIcolorama0.4.6间接
PyPIcoverage7.16.0间接
PyPIcryptography50.0.0间接
PyPIcuda-bindings13.3.1间接
PyPIcuda-pathfinder1.6.0间接
PyPIcuda-toolkit13.0.3.0间接
PyPIcyclopts4.22.5间接
PyPIdeprecation2.1.0间接
PyPIdistro1.9.0间接
PyPIdnspython2.8.0间接
PyPIdocstring-parser0.18.0间接
PyPIemail-validator2.3.0间接
PyPIet-xmlfile2.0.0间接
PyPIexceptiongroup1.3.1间接
PyPIexecnet2.1.2间接
PyPIfastapi0.141.1间接
PyPIfastjsonschema2.22.1间接
PyPIfastmcp4.0.3间接
PyPIfastmcp-slim4.0.3间接
PyPIfastuuid0.14.0间接
PyPIfilelock3.32.2间接
PyPIflatbuffers25.12.19间接
PyPIfrozenlist1.8.0间接
PyPIfsspec2026.7.0间接
PyPIgreenlet3.5.5间接
PyPIgriffelib2.1.0间接
PyPIgrpcio1.83.1间接
PyPIh110.16.0间接
PyPIh24.4.1间接
PyPIhf-xet1.6.0间接
PyPIhpack4.2.0间接
PyPIhttpcore1.0.9间接
PyPIhttpcore22.12.0间接
PyPIhttpx间接
PyPIhttpx0.28.1间接
PyPIhttpx22.12.0间接
PyPIhttpx2-jsfetch1.0间接
PyPIhuggingface-hub1.31.0间接
PyPIhyperframe6.1.0间接
PyPIidna3.18间接
PyPIimportlib-metadata8.9.0间接
PyPIiniconfig2.3.0间接
PyPIjaraco-classes3.4.0间接
PyPIjaraco-context6.1.2间接
PyPIjaraco-functools4.6.0间接
PyPIjeepney0.9.0间接
PyPIjinja23.1.6间接
PyPIjiter0.16.0间接
PyPIjmespath1.1.0间接
PyPIjoblib1.5.3间接
PyPIjoserfc1.7.4间接
PyPIjsonref1.1.0间接
PyPIjsonschema4.26.0间接
PyPIjsonschema-path0.5.0间接
PyPIjsonschema-specifications2025.9.1间接
PyPIjupyter-core5.9.1间接
PyPIkeyring25.7.0间接
PyPIlance-namespace0.9.0间接
PyPIlance-namespace-urllib3-client0.9.0间接
PyPIlancedb0.38.0间接
PyPIlitellm1.100.1间接
PyPIllguidance1.7.6间接
PyPIlxml6.1.1间接
PyPImako1.4.1间接
PyPImanicule间接
PyPImanicule0.2.7间接
PyPImanicule-mlx0.2.7间接
PyPImanicule-ollama0.2.7间接
PyPImanicule-plugin-example0.1.0间接
PyPImanicule-plugin-hostile0.1.0间接
PyPImanicule-plugin-wikilinks0.1.0间接
PyPImarkdown-it-py4.2.0间接
PyPImarkupsafe3.0.3间接
PyPImcp2.2.0间接
PyPImcp-types2.2.0间接
PyPImdurl0.1.2间接
PyPIminiaudio1.71间接
PyPImlx0.32.0间接
PyPImlx-audio0.4.8间接
PyPImlx-embeddings间接
PyPImlx-embeddings0.1.0间接
PyPImlx-lm0.31.3间接
PyPImlx-metal0.32.0间接
PyPImlx-vlm0.6.10间接
PyPImore-itertools11.1.0间接
PyPImpmath1.3.0间接
PyPImultidict6.7.1间接
PyPInarwhals2.24.0间接
PyPInbformat5.11.1间接
PyPInetworkx3.6.1间接
PyPInodeenv1.10.0间接
PyPInumpy间接
PyPInumpy2.5.3间接
PyPInvidia-cublas13.1.1.3间接
PyPInvidia-cuda-cupti13.0.85间接
PyPInvidia-cuda-nvrtc13.0.88间接
PyPInvidia-cuda-runtime13.0.96间接
PyPInvidia-cudnn-cu139.20.0.48间接
PyPInvidia-cufft12.0.0.61间接
PyPInvidia-cufile1.15.1.6间接
PyPInvidia-curand10.4.0.35间接
PyPInvidia-cusolver12.0.4.66间接
PyPInvidia-cusparse12.6.3.3间接
PyPInvidia-cusparselt-cu130.8.1间接
PyPInvidia-nccl-cu132.29.7间接
PyPInvidia-nvjitlink13.3.33间接
PyPInvidia-nvshmem-cu133.4.5间接
PyPInvidia-nvtx13.0.85间接
PyPIolefile0.47间接
PyPIonnxruntime1.30.0间接
PyPIopenai2.53.0间接
PyPIopenapi-pydantic0.5.1间接
PyPIopencv-python5.0.0.93间接
PyPIopenpyxl3.1.5间接
PyPIopentelemetry-api1.44.0间接
PyPIpathable0.6.0间接
PyPIpillow12.3.0间接
PyPIplatformdirs4.11.2间接
PyPIplaywright1.62.0间接
PyPIpluggy1.6.0间接
PyPIportalocker3.2.0间接
PyPIpropcache0.5.2间接
PyPIprotobuf7.35.1间接
PyPIpsutil7.2.2间接
PyPIpy-key-value-aio0.4.5间接
PyPIpyarrow25.0.1间接
PyPIpycparser3.0间接
PyPIpydantic-core2.46.5间接
PyPIpyee13.0.1间接
PyPIpygments2.20.0间接
PyPIpyjwt2.13.0间接
PyPIpypdfium25.13.0间接
PyPIpyperclip1.11.0间接
PyPIpyright1.1.414间接
PyPIpytest9.1.1间接
PyPIpytest-asyncio1.4.0间接
PyPIpytest-cov7.1.0间接
PyPIpytest-split0.11.0间接
PyPIpytest-xdist3.8.0间接
PyPIpython-calamine0.8.2间接
PyPIpython-dateutil2.9.0.post0间接
PyPIpython-docx1.2.0间接
PyPIpython-multipart0.0.32间接
PyPIpython-pptx1.0.2间接
PyPIpywin32312间接
PyPIpywin32-ctypes0.2.3间接
PyPIpyyaml6.0.3间接
PyPIqdrant-client1.19.0间接
PyPIreferencing0.37.0间接
PyPIregex2026.7.19间接
PyPIreportlab5.0.1间接
PyPIrequests2.34.2间接
PyPIrich15.0.0间接
PyPIrich-rst2.1.0间接
PyPIrpds-py2026.6.3间接
PyPIruamel-yaml0.19.1间接
PyPIruff0.16.7间接
PyPIs3transfer0.19.2间接
PyPIsafetensors0.8.0间接
PyPIscikit-learn1.9.0间接
PyPIscipy1.18.0间接
PyPIsecretstorage3.5.0间接
PyPIselectolax0.4.11间接
PyPIsentence-transformers6.0.1间接
PyPIsentencepiece0.2.2间接
PyPIsetuptools84.0.0间接
PyPIshellingham1.5.4间接
PyPIsix1.17.0间接
PyPIsniffio1.3.1间接
PyPIsounddevice0.5.5间接
PyPIsqlalchemy2.0.51间接
PyPIsse-starlette3.4.8间接
PyPIstarlette1.6.0间接
PyPIsympy1.14.0间接
PyPIthreadpoolctl3.6.0间接
PyPItiktoken0.14.0间接
PyPItokenizers0.23.2间接
PyPItorch2.13.0间接
PyPItqdm4.70.0间接
PyPItraitlets5.16.1间接
PyPItransformers5.16.1间接
PyPItree-sitter0.26.0间接
PyPItree-sitter-language-pack1.17.0间接
PyPItriton3.7.1间接
PyPItruststore0.10.4间接
PyPItyper0.27.2间接
PyPItyping-extensions4.16.0间接
PyPItyping-inspection0.4.3间接
PyPIuncalled-for0.4.0间接
PyPIurllib32.7.0间接
PyPIuvicorn0.52.4间接
PyPIwatchfiles1.2.0间接
PyPIwebsockets17.1间接
PyPIxlsxwriter3.2.9间接
PyPIyarl1.24.5间接
PyPIzipp4.1.0间接
依赖安全公告 0

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

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

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

原始 JSON 报告 机器可读

反馈

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

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

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

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

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