前言¶
DeepSeek Harness (DSH) 的生態理念是“一切皆插件”。在開發和調試智能體時,經常需要在多個技能之間切換,或臨時禁用某些技能以測試特定邏輯。雖然技能通常通過 SKILL.md 的 frontmatter 來控制模型側的調用行爲,但直接編輯文件並不直觀,且在 Web UI 中缺乏便捷的交互入口。
插件介紹¶
dsh-plugin-skill-manager 是一個由用戶 xhvdhczd 維護的 DSH Web UI 插件。它通過在對話視圖的 slot 註冊一個 Skills Tab,讓用戶可以直接在 Web 界面管理技能狀態,無需手動修改文件。
核心功能¶
- 技能視圖集成:在對話視圖註冊 Skills Tab,與 Chat 和 Trajectory 並列。
- 過濾搜索:提供搜索框,支持按技能名稱或描述過濾。
- 批量開關:支持一鍵啓用或禁用所有可見技能。
- 模型側控制:通過修改 SKILL.md 的 frontmatter 來寫入
disable-model-invocation: true,實現模型側的調用攔截。
安裝與啓用¶
安裝該插件需要指定 DSH profile(示例使用 web profile)。
- 在插件源碼目錄下執行安裝命令:
dsh plugin --profile web add file:./dsh-plugin-skill-manager
- 將插件添加到 profile 的 bundle 層中。編輯
~/.dsh/profiles/web/package.json,在dsh.profile.bundles數組中增加dsh-plugin-skill-manager:
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-plugin-marketplace",
"dsh-plugin-skill-manager"
]
}
}
}
- 安裝或更新插件後,必須重啓 DSH 並刷新 Web UI,Skills Tab 纔會顯示。
使用說明¶
啓動 DSH 後,在對話視圖頂部會出現 Skills Tab。在該 Tab 中,你可以:
* 使用搜索框快速定位技能。
* 點擊技能旁的開關來啓用或禁用單個技能。
* 使用底部的“全部啓用”或“全部禁用”開關批量操作。
禁用技能的操作會直接寫入 SKILL.md 文件的 frontmatter 中,添加 disable-model-invocation: true。這會讓模型側的技能目錄失效,但用戶界面的技能列表保持可見,方便隨時重新啓用。
注意事項¶
- 依賴處理:
file:依賴會被複制到 pnpm store。如果修改了插件源碼,需要重新運行安裝命令(pnpm --dir "$HOME/.dsh/profiles/web" remove ... && pnpm --dir ... add --force file:./...)並重啓 DSH。 - 重啓要求:安裝、更新或修改配置後,必須重啓 DSH 進程,Web UI 才能感知到變化。
- 目錄失效:目錄失效後會自動更新,無需重啓目錄本身。
結尾¶
該插件通過 Web UI 提供了更直觀的技能管理方式,降低了調試智能體時的操作成本。