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