gitnexus-plus：为 DeepSeek Harness 揭示 GitNexus 索引盲区的 DSH plugin

它是做什么的？

GitNexus Plus 是 DeepSeek Harness（DSH）的索引可见性插件，专门回答 GitNexus 自己说不清的问题：这次索引到底漏掉了什么。gitnexus analyze 遇到大文件会静默跳过，只在 stderr 打一行提示，既不返回也不持久化，终端一滚就没了。这个插件把那行提示变成可查询的数据、工具和界面，让你看清被跳过的文件、索引新鲜度，以及 Git 活动与索引之间的缺口。

核心功能

• 跳过文件清单：列出被忽略的大文件路径、体积及其在所属语言中的占比，并用单行压缩启发式和构建产物路径启发式两条独立信号解释「为什么它不是源码」，二进制资源单独识别、不会被误判为压缩文件。
• 索引新鲜度：把索引对应的提交与 HEAD 对比，按 current / behind / diverged / unknown 分类，同时给出未提交改动数量。
• 图谱构成与查询能力：从 manifest 读取节点、边、社区、流程、嵌入与每节点边数，并说明图谱检索、关键词检索、语义检索各自是否可用及不可用的原因。
• Git 活动三向判定：把近期提交、作者（机器人会标注）、分支、最常改动文件与索引交叉，每个文件给出「已索引」「按设计排除」「索引缺失」三种结论，只有第三种会触发警告。
• 语言字节分布与解析置信度：按字节把语言分成 GitNexus 可解析、仅识别格式、其他三类，并报告未标注接收者位置，提示 impact 与 context 的结果只是下界。

怎么使用这个插件？

在 DSH 中启用后，直接运行覆盖率报告即可得到一份完整的索引体检结果，也可以指定仓库目录来检查某个项目。插件是只读的：它不会触发 analyze、不写 .gitnexus/、不抢索引锁，因此查状态永远不会意外启动一次耗时重建。判断「哪些文件被跳过」时它复用 GitNexus 自身的忽略过滤与语言识别逻辑，而不是近似重写；若上游模块结构变化，会退化为有文档说明的兜底扫描，而不是给出错误数字。对于缺少覆盖信息的旧索引，体积上限会如实标为未知并附注，绝不套用今天的默认值。

报错怎么排查？

如果报告显示扫描结果为兜底模式，说明上游 GitNexus 的模块结构已变化，插件无法复用其原生扫描逻辑，此时数字仍可用但需按文档说明理解。若旧索引没有覆盖信息，体积上限会显示为未知，这是预期行为而非错误，不要据此判断文件被跳过。