前言¶
在 DeepSeek Harness（DSH）里接插件、配 MCP、挂 Skill 之后，智能体「理论上能用什么」和「当前进程里实际可见什么」经常对不上：工具没进 scope、模型目录拉不全、工作区或会话持久化异常，排查时只能逐项翻配置和日志。DSH Capability Inspector 面向这类问题，提供一次调用即可汇总的只读诊断，相当于在 Harness 侧做 capability matrix 与 runtime health check，且不改动配置、不自动修故障。
这是什么¶
DSH Capability Inspector 是 DeepSeek Harness 的只读运行时诊断与健康检查插件。它向调用方智能体注册 inspect_dsh 工具，说明当前 agent 实际可用的能力集合，并标出可能存在的配置或运行时问题。社区目录归类为 admin-security；仓库在 GitHub 上维护（README 中 GitHub 安装源为 github:tree201/dsh-capability-inspector，与部分目录页的 tree-freedom 命名空间并存时，安装命令以 README 原文为准）。许可证为 MIT，package 版本为 0.1.0。
插件不会返回 API Key 等凭证明文，不会改配置，也不会自动修复失败项。
核心功能¶
inspect_dsh 基于 Harness 支持的只读枚举 API，首版检查范围包括：
- 运行环境：Node.js 版本、操作系统、架构、当前工作目录。
- 工具：调用 agent scope 内可见的工具列表。
- 模型：LLM provider 及其 model catalog。
- Skill：Skill 目录、provider 与调用模式。
- 工作区：已注册工作区、目录状态及关联 session 数量。
- 会话：session 持久化是否可用。
- 缺口与错误：缺失的能力项，以及单项检查失败时的错误信息（单项失败不会拖垮整份报告）。
若你在搜 DeepSeek Harness Doctor、DSH diagnostics、MCP troubleshooting 或 plugin readiness checker，该插件的定位与上述关键词一致。
设计边界¶
使用前宜了解其刻意不做的事：
- 不检查 Cordis 私有 reflection 状态。
- 不暴露凭证值。
- 无法诊断在本插件加载之前就已失败的其他插件。
- 只报告问题，不提供自动修复。
安装与启用¶
DeepSeek Harness 目前处于 developer preview。若通过 Git 安装时 pnpm 要求 build-script 授权，应按 DSH 插件安装指引审阅来源后再授权。
从 GitHub 安装（命令来自官方 README）：
dsh plugin --profile web add github:tree201/dsh-capability-inspector
dsh web
从本地目录安装：
dsh plugin --profile web add /absolute/path/to/dsh-capability-inspector
dsh web
安装后需重启 DSH（或按你的 profile 流程重新拉起 web 进程），插件才会注册 inspect_dsh。
典型用法¶
重启 DSH 后，可直接用自然语言让 agent 调用诊断，例如：
Inspect the current DSH runtime and summarize available capabilities and warnings.
更聚焦的提示同样有效：
List the tools and skills available to this agent.
Check model providers and model catalogs.
Check workspace and session persistence health.
agent 调用 inspect_dsh 时可指定 scope：
| scope | 含义 |
|---|---|
summary |
完整报告（默认） |
tools |
工具目录 |
models |
provider 与 model catalog |
skills |
Skill 目录 |
workspaces |
工作区健康状态 |
sessions |
会话持久化健康状态 |
适用场景与注意¶
适合：本地或 web profile 下调试 DSH 插件生态、核对 MCP/Skill/模型是否对当前 agent 可见、排查工作区与会话持久化、做插件就绪性自检。
注意：
- 插件以当前 DSH 进程权限运行；从 GitHub 或本地路径安装前，应自行审阅源码与 MIT 许可证，仅信任你认可的来源。
- 只读诊断不能替代安全审计；admin-security 分类表示其偏管理与可观测，而非替代权限模型。
- 依赖
@deepseek-ai/cordis与@deepseek-ai/dsh-tools的 peer 版本范围，需与所用 Harness 版本匹配。
开发侧自检可使用：
pnpm install
pnpm run check
check 会依次执行 TypeScript 类型检查、单元测试与构建。
结尾¶
DSH Capability Inspector 把工具、模型、Skill、工作区与会话等能力收成一份只读报告，方便在「配好了但 agent 用不了」时快速对齐 runtime 真相。更多索引与说明见仓库内 llms.txt。
- 社区目录：https://www.skillhub.cn/plugins/tree-freedom/dsh-capability-inspector
- GitHub：https://github.com/tree-freedom/dsh-capability-inspector（README 安装源：
tree201/dsh-capability-inspector）
