前言¶
DeepSeek Harness(DSH)默認從文件系統加載技能,例如 ~/.agents/skills 或項目級別的 .dsh/skills。然而,DSH 沒有提供查看已安裝技能或切換其狀態的界面。dsh-skill-manager 通過提供列出技能、查看其狀態以及即時啓用/禁用的能力來填補這一空白。
功能¶
該插件提供以下能力:
- 列出技能:列出文件系統中的所有技能及其啓用狀態和一行描述。
- 即時切換:啓用或禁用任何技能,無需重啓 DSH 進程。
- 設置 UI:內置“技能”頁面,允許通過 UI 進行切換。
- 禁用機制:通過將
SKILL.md重命名爲SKILL.md.disabled來禁用技能。禁用的技能會立即從模型可見的目錄中消失。
安裝¶
該插件是 dsh bundle(聲明瞭 dsh.bundle.patch),因此安裝方式與其他配置文件插件相同。
前置條件¶
- Node.js ≥ 22.19(檢查版本:
node --version) - 一個 dsh web 配置文件(
dsh plugin命令指向配置文件目錄,例如--profile web)
安裝步驟¶
安裝前請注意:
- 名稱衝突警告:存在一個同名的 npm 包(由不同作者發佈)。必須從該倉庫安裝。
- pnpm workspace:配置文件目錄是 pnpm workspace 根目錄。安裝命令必須包含
-w標誌。
安裝命令:
dsh plugin --profile web add -w Thomas-key/dsh-skill-manager
如果從本地檢出安裝:
- 進入插件目錄。
- 安裝依賴項:
npm install
- 返回上一級目錄並安裝插件:
cd ..
dsh plugin --profile web add -w ./dsh-skill-manager
使用¶
安裝後,重啓 dsh web,然後通過以下方式使用:
- 設置 UI:打開 設置 → 技能。這將列出所有技能並允許切換。
- 代理命令:詢問代理:
- “List my skills.”
- “Disable the skill
read.”
代理將調用 skills_list 或 skills_toggle 工具。切換會立即生效;你可以再次詢問代理以驗證技能列表的變化。
工作原理與邊界¶
工作流程¶
- 代理調用
skills_list或skills_toggle。 - 主機插件通過
node -e橋接(stdin: JSON 操作,stdout: JSON 結果)。 - 插件掃描技能根目錄或重命名
SKILL.md<->SKILL.md.disabled。 - DSH 的文件系統技能提供程序檢測到變化,並立即更新模型可見的目錄。
邊界¶
- 掃描範圍:僅掃描四個標準技能根目錄;其他位置被忽略。
- 內容修改:僅重命名
SKILL.md或SKILL.md.disabled文件;不讀取、編輯或刪除技能內容。 - 可見性:禁用僅隱藏技能;文件保持存在,因此禁用是可逆的。
注意事項¶
- 維護狀態:此插件由 AI deepseek-v4-flash 構建。沒有計劃更新;它只是爲了解決個人痛點而構建的。歡迎 PR。
- 權限:插件在 DSH 進程的權限下運行。
- 源代碼檢查:安裝前檢查源代碼和許可證。
結語¶
dsh-skill-manager 解決了 DSH 在技能管理方面的空白。要了解更多信息或提交更改,請訪問 GitHub 倉庫。