前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的装配方式：系统提示、工具、补丁往往来自多个 loader 条目。条目一多，很难在不动配置的前提下回答三件事——当前究竟加载了什么、各段 prompt 与 tool schema 占多少上下文后缀（与 KV cache 相关）、以及是否存在重复 section 名、补丁被多层覆盖、或与运行中 harness 版本声明不一致等问题。官方已有 inventory 类 Remote 与 dsh-doctor 等修复路径，但缺少一次只读、Deterministic 的汇总调用。dsh-census 提供单一工具 census，一次调用输出清单、发现项与 token 估算，且不修改任何插件状态。
这是什么¶
dsh-census 是社区维护的 DSH 插件（维护者 java-hue，仓库 java-hue/dsh-census），在 SkillHub 目录中归类为模型推理。定位用 README 原话概括：what is loaded, what it costs, what collides——在一次只读 tool call 里说明加载项、上下文后缀成本与冲突/异常。
核心功能¶
插件只注册一个工具 census，不贡献 system prompt section、context 或额外 prompt 文本；只有主动调用时，结果才会进入会话面。
Inventory（清单）¶
与官方 pluginInventory/list Remote 相同的投影语义，列出每个 loader 条目：id、module specifier、启用状态、fiber phase。加载失败的条目以错误形式 surfaced，而不是静默忽略。
Findings（发现项）¶
报告包括但不限于：失败条目；相对路径 specifier（仓库类插件要求绝对路径）；同一 assembly 内重复的 system-prompt section 名；被多于一层 patch 指向的行（patch 会替换整行配置，后写覆盖先写）；第三方插件声明的 dsh target 与当前运行 harness 不匹配。
Context suffix cost（上下文后缀成本）¶
针对一个 assembly，按 section 与 per-tool schema 给出 token 估算（固定 4 字符/token 启发式，与官方 dsh-token-meter 一致）；若模型路由声明了 context window，还会给出占 resolved 窗口的比例。
传入 verbose: true 时，可得到逐条 inventory 与逐模块兼容表。
范围与非目标¶
- 只读：不 enable、disable、patch 或 repair；恢复流程留给
dsh-doctor等现有工具。 - 0.1 仅 host 侧：客户端 UI mount-path 冲突在浏览器侧，需 client 半部，当前未覆盖。
- 成本为估算：CJK 与 JSON schema 会明显低估，数字应视为参考而非精确计费。
安装与启用¶
在指定 profile 下从 registry 添加（命令来自仓库 README）：
dsh plugin --profile <name> add dsh-census
若使用本地 checkout（repository-plugin 风格，须绝对路径）：
dsh plugin --profile <name> add link:/absolute/path/to/dsh_plugin
package.json 标明运行时需 Node >= 24，当前包版本 0.1.0，许可证 MIT。
典型用法¶
在已加载 census 的 DSH 会话中，通过工具管道调用 census。默认返回 Inventory、Findings 与 Context suffix cost 三块内容。
需要更细的清单与兼容表时，在调用参数中设置：
{
"verbose": true
}
（具体字段以 harness 侧 tool 入参 schema 为准；README 仅说明 verbose: true 的语义。）
适用场景与注意¶
适合：装配多个社区插件后，想在改配置前先看清加载拓扑、潜在冲突，以及各插件对每次请求 suffix（KV cache 压力）的大致贡献；与 dsh-doctor 分工明确——census 诊断，doctor 修复。
注意：
- 插件以当前 dsh 进程的权限运行；安装前应阅读源码与 MIT 许可证，确认来源为 GitHub 仓库。
- census 自身 tool schema 很短；调用一次会在会话面追加一条 tool result，但不注册持久 message 或 runtime context。其价值在于让其他插件的 suffix 成本可见。
- SkillHub 目录（java-hue/dsh-census）为社区索引，与 DeepSeek / 幻方无官方从属关系；安装命令以 README 为准，勿自行拼接未文档化的
github:owner/repo形式。
结尾¶
经过上面的步骤，你可以在不动插件配置的前提下，用一次 census 对齐「装了什么、贵在哪里、哪里会撞车」。目录页：SkillHub - dsh-census；源码与说明：github.com/java-hue/dsh-census。
