前言¶
DeepSeek Harness（DSH）的 Profile 会运行多个智能体预设，每个预设声明完整的子插件列表，从而决定会话可用的工具、技能和 MCP 服务器。但当前三个痛点让这些信息不透明：
- GUI 选择器只展示预设名称，看不到内部组件。
- 请求头中列出工具名称，却无法知道它们来自哪个预设。
- 以 bundle 形式安装的插件会在宿主层挂载，其工具会出现在每个预设中，静默且消耗每个会话的 token。
dsh-preset-inspector 面向这些问题，提供了一套可读的视图与命令行工具，让预设内容一目了然。
插件定位¶
dsh-preset-inspector 是一个客户端插件，为 DeepSeek Harness 提供实时的预设内容清单。它不注册任何工具，不增加会话的 tool schema 开销。插件由 anonamerjaxon-dev 维护，核心价值是回答“预设 X 实际包含了什么”。
核心功能¶
- Web 矩阵面板：在 Web GUI 中展示能力与预设的交叉矩阵，包括工具、条件工具、MCP 服务器、技能。
- 预设级视图：按预设列出工具、条件工具及其未保证的原因、MCP 服务器端点、技能根目录及其数量与名称，以及所有组合行的状态。
- 实时性：数据来自运行中的预设注册表，挂载失败的预设会显示诊断信息，而不是隐藏。
- 命令行工具：提供与 Web 面板相同视角的 CLI，并可对插件进行预设移动等操作。
安装与启用¶
使用官方安装命令添加插件到当前 Profile：
dsh plugin --profile web add github:anonamerjaxon-dev/dsh-preset-inspector
从本地检出目录安装：
dsh plugin --profile web add /path/to/dsh-preset-inspector
添加后，将 dsh-preset-inspector 加入 dsh.profile.bundles 配置（位置为 ~/.dsh/profiles/web/package.json），然后重启 dsh web。GUI 右下角会出现 ▦ Presets 按钮。
典型用法¶
Web 界面¶
点击 ▦ Presets 按钮，即可查看当前 Profile 下所有预设的能力矩阵与详细内容。
命令行工具¶
插件未安装时，也可直接使用其 bin 目录下的脚本（需 Node >= 22）：
# 预设清单（含工具/技能/MCP 数量）
dsh-presets list
# 查看指定预设的所有内容
dsh-presets show creative
# 能力 × 预设矩阵
dsh-presets matrix
# 对比两个预设的差异
dsh-presets diff standard web
# 机器可读快照
dsh-presets json
插件管理工具（移动插件挂载位置）：
# 列出所有插件及其挂载位置
dsh-preset-plugin list
# 查看某个插件在哪些预设中挂载
dsh-preset-plugin where <plugin>
# 将插件限定到指定预设
dsh-preset-plugin move <plugin> creative,web
# 将插件恢复到所有会话（默认行为）
dsh-preset-plugin everywhere <plugin>
# 取消插件挂载
dsh-preset-plugin off <plugin>
这些命令读取 dsh --profile <name> --dump-config，在会话运行时即可使用，不会触发端口绑定。
适用场景与注意¶
- 适合需要梳理 Profile 中预设配置、排查工具来源、审计 bundle 挂载行为的开发者。
- 插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
- 需要确保 DeepSeek Harness 版本为 0.2.1-rc.2 以上，以兼容预设注册表 API。
小结¶
dsh-preset-inspector 将预设内部组件透明化，帮助开发者理解并管理 DSH Profile 的预设组合。更多细节与源码，请访问：
- 插件目录页：https://www.skillhub.cn/plugins/anonamerjaxon-dev/dsh-preset-inspector
- GitHub 仓库：https://github.com/anonamerjaxon-dev/dsh-preset-inspector
