插件普查 java-hue/dsh-census

dsh-census

DeepSeek Harness 的插件普查工具：加载了什么、开销多大、哪里冲突 —— 一次只读工具调用全部给出。

社区插件确实带来了实打实的能力，但没人告诉你每个插件从上下文窗口里吃掉多少、两个插件会不会撞车、它们是否还声明着当初构建时对应的 harness 版本。Census 把这三个问题确定性地回答清楚，全程不改动任何东西。

安装

dsh plugin --profile <name> add dsh-census

或者从本地检出安装（仓库插件风格，必须用绝对路径）：

dsh plugin --profile <name> add link:/absolute/path/to/dsh_plugin

census 工具

一个工具，一次调用，不占提示词段落开销。报告包含：

- 清单 —— 每个加载器条目（id、模块说明符、启用状态、fiber 阶段），投影语义与官方 pluginInventory/list Remote 一致；失败的条目会以错误形式出现，不会静默消失。
- 发现项 —— 失败的条目、相对说明符（仓库插件要求绝对路径）、同一次装配中重复的系统提示词段落名、被多个层同时寻址的补丁行（补丁会替换整行配置 —— 后写覆盖先写），以及声明的 dsh 目标与当前运行的 harness 不匹配的第三方插件。
- 上下文后缀开销 —— 针对一次装配，按段落、按工具 schema 估算 token 数（固定 4 字符/token 启发式），并在模型路由公布上下文窗口时给出它占已解析窗口的比例。

传 verbose: true 可查看逐条目清单和逐模块兼容性表格。

范围与非目标

- 只读 —— census 从不启用、禁用、打补丁或修复任何东西。恢复流程在别处已有（dsh-doctor）；census 刻意不与它们竞争。
- 0.1 只覆盖宿主侧 —— 客户端 UI 的挂载路径冲突发生在浏览器侧，需要客户端那一半；暂未覆盖。
- 启发式开销 —— 估算器沿用官方 dsh-token-meter 的固定启发式（4 字符/token），也继承了它已知的短板：CJK 文本和 JSON schema 会严重低估。所有数字都只当估算看。

模型体验

没有。Census 只注册一个工具（census），自身不贡献任何段落、上下文或提示词文本。只有真正发起调用时，它的输出才会到达模型。

KV 缓存影响

工具自身的 schema 只有一条短条目。调用 census 会往会话表面追加一条工具结果；它不注册持久消息，也不注册运行时上下文。这份报告的目的是让其他插件的 KV 缓存开销变得可见：按段落、按工具的 token 估算，精确量化每个插件的提示词贡献在每次请求中追加了多少后缀。

开发

npm install
npm run check # typecheck
npm test # unit + real-cordis integration tests
npm run build # emit lib/
npm pack --dry-run
集成测试会启动真实的 @deepseek-ai/cordis 上下文，加载官方 dsh-system-prompt 和 dsh-tools 插件，注册 census，再通过真实工具管线执行它。

许可证

MIT