前言¶
在 DeepSeek Harness（DSH）的开发与调试过程中，依赖管理往往比较隐晦。开发者在排查问题时，常需要确认当前 Harness、插件及其依赖的精确版本，以及依赖声明范围与实际解析版本是否一致。此插件通过在设置面板提供可视化的版本信息，解决了这一痛点。
这是什么¶
dsh-version-inspector 是一个由 NEVSTOP-LAB 维护的插件，旨在 DSH 设置面板中新增「版本信息」页面，以紧凑的多列树状结构展示 Harness、插件及其依赖的版本详情。插件遵循 MIT 许可证。
核心功能¶
该插件在设置面板中新增一个独立页面，主要提供以下能力：
-
树状结构展示
将依赖项分为三组：- DeepSeek Harness（dsh）：展示 Harness 版本及顶层依赖。
- 插件：展示其他已挂载插件及其版本（不含本插件）。
- 当前插件：展示本插件自身的版本、
dependencies及peerDependencies子树。
节点支持展开与折叠。
-
详细信息
每个依赖项展示以下字段：- 名称（包名）
- 已解析版本（安装的真实版本）
- 声明范围（如
^x.y.z） - 所属 section（依赖 / 对等依赖 / 可选依赖）
- 解析路径
-
异常感知
对于宿主解析不到的依赖（例如客户端专用的react或未安装的可选依赖），以警示色标注，并显示其声明范围。 -
布局与交互
- 紧凑多列布局：使用自适应网格布局（
auto-fill），长列表横向铺开，减少滚动。 - 搜索过滤：支持按包名或版本过滤，结果按分组显示并计数。
- 主题适配：自动适配 day / dark 模式，使用 DSH 主题变量。
- 紧凑多列布局：使用自适应网格布局（
安装与启用¶
安装前请确保已安装并运行 dsh CLI（版本 0.1.0-rc.6 及以上）。
从 GitHub 仓库安装：
dsh plugin --profile web add github:NEVSTOP-LAB/dsh-version-inspector
建议锁定提交以避免后续更新改变内容：
dsh plugin --profile web add github:NEVSTOP-LAB/dsh-version-inspector#<commit-sha>
也可以从 Releases 下载 tarball 安装：
dsh plugin --profile web add ./dsh-version-inspector-0.1.2.tgz
安装后，打开 DSH 设置面板，「版本信息」页面会出现在导航列表的最后一个位置（order 1000）。可以通过以下命令确认插件已生效：
dsh --profile web --dump-config
注意事项¶
- 权限说明：插件通过 Host 侧的只读接口收集数据，并通过同源路由
GET /version-info提供给客户端，不会执行敏感操作。 - 依赖要求：需要 dsh CLI 0.1.0-rc.6 及以上版本支持。
结语¶
该插件为 DSH 插件开发与调试提供了一个直观的版本查检工具，通过树状结构与多列布局，能够快速定位依赖问题。更多详情与源码可参考其 GitHub 仓库。
