前言¶
DeepSeek Harness 的核心設計理念是「一切皆插件」。在開發或調試過程中,智能體技能往往分散在項目的 .dsh 目錄、.agents 目錄、用戶目錄或運行時配置中。如果不具備統一的瀏覽和檢索入口,定位某個技能的 SKILL.md 全文或其作用域會變得繁瑣。
是什麼¶
dsh-skills-manager 是一個 DeepSeek Harness 客戶端插件,它通過讀取宿主的 ctx.skills 註冊表,在設置頁新增「技能管理」視圖。該視圖直接展示當前環境中合併後的全部 agent skill 信息,不依賴手動維護列表。
核心功能¶
該插件提供了以下能力:
- 技能目錄概覽:列出當前環境合併後的全部技能,包含名稱、描述、來源(項目/用戶/內置/運行時)、提供方、調用策略以及作用域。
- 搜索與篩選:支持按名稱、描述或適用場景進行實時搜索;支持按「全部 / 模型可用 / 用戶可用」進行篩選。
- 詳情查看:點擊技能後,詳情面板會在卡片下方展開,展示
whenToUse、文件路徑、資源目錄、metadata以及完整的SKILL.md正文。 - 一鍵複製:提供按鈕一鍵複製技能正文或本地路徑。
- 自動刷新:頁面每 30 秒輪詢一次技能狀態,同時支持手動刷新。當技能來源發現不完整時會顯示提示。
- 主題適配:支持亮色/暗色主題自適應,使用 DSH 原生風格。
安裝與啓用¶
通過命令行安裝該插件:
dsh plugin --profile web add github:zhangzheng25/dsh-skills-manager
安裝完成後重啓 DSH,打開 設置 → 技能管理 即可看到該頁面。
典型用法¶
- 在技能列表中輸入關鍵詞進行搜索。
- 使用篩選器查看特定類型的技能。
- 點擊技能卡片,在下方展開詳情面板閱讀
SKILL.md內容。 - 點擊複製按鈕,將技能正文或路徑複製到剪貼板。
適用場景與注意¶
該插件目前僅作爲只讀管理界面使用。
- 權限限制:當前版本無法通過本插件啓用、禁用或編輯已有技能。DSH 的 skill 註冊表由各提供方(主要是
dsh-skill-filesystem)擁有,註冊表本身不提供刪除或禁用已有技能的能力。 - 圖標限制:設置頁導航圖標由
dsh-client-ui-settings-general硬編碼,非內置 ID 統一顯示齒輪圖標。 - 開發建議:在安裝前,建議檢查源碼與許可證。
總結¶
dsh-skills-manager 解決了在多源技能環境下難以快速定位和查閱 SKILL.md 正文的問題。它通過讀取宿主註冊表實現輕量級的技能瀏覽與管理,適合需要在 DSH 中集中管理大量 agent 技能的開發者。