前言¶
在 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）
