前言¶
在 DeepSeek Harness (DSH) 的開發流程中，技能通常以 SKILL.md 文件的形式存在於本地文件系統或官方註冊表中。當需要對技能進行調試、修改配置或檢查狀態時，開發者往往需要在終端或文件管理器中手動查看和編輯這些文件。dsh-skill-studio 將技能管理器直接集成到了 Web 設置面板中，允許開發者通過瀏覽器界面瀏覽、查看全文、編輯配置，並控制技能的調用狀態。
它是什麼¶
這是一個由 zhengjy01 維護的工作流類插件。它通過 Web 設置面板，讓用戶能夠查看 DSH 發現的所有技能，閱讀完整的 SKILL.md 文件，直接編輯文件內容，並通過開關控制技能的啓用狀態以及模型/用戶的調用權限。
核心功能¶
該插件主要提供以下能力：
- Web 管理界面：在“設置 → Skill 管理器”中，可以列出所有技能的名稱、描述、源根目錄、嵌套標誌以及模型/用戶調用狀態。點擊任意技能可查看完整內容，編輯後保存會寫回文件，並通過開關啓用/禁用技能或調整調用接口。
- 命令行工具：插件暴露了
skillmgr_list、skillmgr_get、skillmgr_save和skillmgr_policy等工具，支持在 Agent 腳本中調用。 - 混合目錄掃描：插件同時掃描標準根目錄（如項目
.dsh/skills或用戶~/.dsh/skills，支持一層嵌套）和官方註冊表ctx.skills。即使主機平面文件系統提供程序被禁用，磁盤上的技能也能被顯示。 - 配置修改機制：啓用/禁用功能通過修改
SKILL.md的前幾行（disable-model-invocation/user-invocable）實現，其他前幾行內容保持不變。修改會被 DSH 在重新發現時自動讀取。 - 安全限制：僅對有真實文件路徑的技能提供編輯功能（運行時或打包技能顯示爲只讀），且路由僅限迴環訪問。
安裝與啓用¶
安裝該插件需要使用 DSH 的 Web 配置文件。執行以下命令：
dsh plugin --profile web add github:zhengjy01/dsh-skill-studio
安裝完成後，需要重啓 dsh web 進程以激活插件。該插件不依賴構建步驟，lib/ 目錄包含純 ESM 代碼。
典型用法¶
Web 界面操作：進入 Web 設置頁面的“設置 → Skill 管理器”，可以看到帶有來源徽章和調用狀態的技能列表。點擊技能可查看正文並編輯（保存後寫回文件），通過切換按鈕控制啓用/模型可調用/用戶可調用狀態。
Agent 指令：也可以直接向 Agent 下達指令，利用 skillmgr_* 工具完成任務。例如：
* 列出所有 skill，並告訴我哪些被禁用了
* 幫我禁用 session-knowledge 技能
注意事項¶
- 前幾行格式：
SKILL.md的前幾行name字段必須與技能名稱匹配（kebab-case），破壞前幾行格式可能導致 DSH 在重新發現時跳過該技能。 - 編輯範圍：編輯僅限於技能註冊表報告的文件路徑，插件不接受任意路徑輸入。
- 依賴與權限：除 DSH 對等包外無額外運行時依賴。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
結尾¶
經過上面的步驟，即可在 Web 界面完成對 DSH 技能的集中管理。該插件爲技能開發與調試提供了更直觀的途徑。
