在 DeepSeek Harness (DSH) 的使用过程中，确认运行中的 Harness 版本以及已挂载插件的包版本，是排查环境不一致或依赖冲突的基础步骤。现有的插件列表仅显示模块名称、启用状态和 Fiber 状态，并不包含版本信息。dsh-version-inventory 插件在 Web UI 中补充了这一空白，提供可视化的版本展示与导出功能。
插件简介¶
该插件由 kristol07 维护，遵循 MIT 许可证。它的核心作用是在 DSH Web UI 中读取并展示运行中的 Harness 版本，以及每个已挂载插件的包版本。
核心能力¶
1. 双平面版本读取
插件同时读取 Harness 的两个挂载平面：
* 全局平面：基于配置文件（如 cordis.patch.yml）的 Loader 树。
* 预设平面：基于每个 Agent 预设的 composition（agent.<preset>.yml）。
对于在两个平面都挂载的插件，会分别列出，并显示其所属平面。
2. 配置摘要与脱敏
每个挂载点会显示配置摘要。系统会自动折叠嵌套值，并屏蔽敏感字段（如 key、token、secret、password 等）的值。对于预设配置，由于不包含运行时挂载的配置，会显示“config not visible”。
3. 版本合并与标识
插件通过解析模块规范符，读取 package.json 中的 name 和 version。它会按包目录进行合并，而不是按包名，以便能够检测同一包的不同版本实例。推断出的版本会标记为 (inferred)。
4. 导出与复制
- 单行复制：点击某一行，可复制
name@version格式的字符串，便于在终端或搜索框中使用。 - 报告复制：点击表头，可复制一份完整的、安全的环境报告。该报告包含 Harness 版本、Node 版本、平台信息、第三方插件列表等，但不包含文件路径、
DSH_HOME和用户配置。
5. 会话工具集成
插件注册为 dsh_version_inventory 工具，Agent 可以在会话中直接调用该工具读取环境信息。
使用方法¶
-
在 Web UI 中查看
在 DSH Web UI 中导航至Settings->Plugins->Versions。该标签页位于系统自带的插件列表旁。 -
通过会话工具读取
在 Agent 会话中，可以直接调用dsh_version_inventory工具获取环境信息。 -
复制版本信息
- 点击具体插件行的任意位置，可复制
插件名@版本号。 - 点击表头，可复制完整的环境报告。
- 点击具体插件行的任意位置，可复制
注意事项¶
- 版本来源：Cordis 内置功能没有版本信息，插件会将其显示为 Cordis builtins。
- 报告安全：导出的环境报告仅包含可共享的元数据，不包含本地文件路径和敏感配置。
- 推断标记：如果无法从
package.json获取 Harness 版本，系统会根据已加载的@deepseek-ai/*包推断，并标记为(inferred)。 - 许可证：使用需遵守 MIT 许可证。
参考资源¶
- GitHub: https://github.com/kristol07/dsh-version-inventory
- 插件目录: https://www.skillhub.cn/plugins/kristol07/dsh-version-inventory
