前言¶
DeepSeek Harness（DSH）採用插件化架構。在開發智能體或管理技能時，直接維護 ~/.dsh/skills 目錄下的文件需要手動操作。此插件在 DSH 的設置頁面提供了一個管理界面，支持批量導入技能目錄，並利用 AI 模型自動解析技能名稱與描述，解決了技能命名不規範和重複導入的問題。
核心功能¶
技能列表¶
插件會列出 ~/.dsh/skills 下已導入的目錄束（包含 SKILL.md 的目錄）與扁平 Markdown 技能文件。列表展示技能名稱、描述、有效性以及來源目錄。
多目錄導入¶
在導入時，可以同時選擇多個技能目錄。插件會讀取目錄內的文件（自動跳過 .git 等系統文件），並通過 RPC 傳輸到 DSH 進程。
AI 名稱解析¶
導入前可選擇已配置的 AI 模型（默認爲 harness 默認模型）。模型會解析技能的名稱與一句話描述。解析結果會強制規範化爲 DSH 對話框支持的命名格式。
目錄自動重命名¶
導入後，如果目錄名與解析出的名稱不一致，插件會將目錄重命名爲規範化的名稱（小寫 kebab-case）。同時重寫 SKILL.md 的 frontmatter，保證名稱、描述與目錄名一致。
同名保護¶
導入時會檢查目標目錄。如果已存在同名技能，導入會自動跳過，不會覆蓋已有內容。
安裝¶
使用 DSH 的插件安裝命令。如果當前 profile 不是 web，請替換命令中的 --profile web。
dsh plugin add github:tianLee-gitter/lt-lt-lt-dsh-skill-manager --profile web
安裝完成後，需要重啓 dsh web 並刷新瀏覽器頁面。
使用¶
- 打開 DSH 設置頁面，進入「技能管理」。
- 選擇用於解析名稱的 AI 模型（可選，默認使用 harness 默認模型）。
- 點擊「導入技能…」，在文件選擇器中一次選中多個技能目錄。
- 查看導入結果。成功項顯示名稱、描述和目錄重命名情況；失敗項會列出原因（如缺少
SKILL.md、同名已存在、名稱無法規範化等）。 - 導入成功後，在對話框中使用
/名稱引用該技能。
配置¶
插件的配置位於包內的 cordis.patch.yml 文件中。以下是默認配置項：
dshHome：技能根目錄，默認爲~/.dsh。maxAiInputBytes：AI 解析時的輸入截斷大小，默認 6000。maxAiOutputTokens：AI 輸出 token 上限，默認 300。aiTimeoutMs：AI 請求超時時間，默認 30000。
注意事項¶
- 命名規範：技能名稱必須匹配正則
^[a-z0-9]+(?:-[a-z0-9]+)*$，即小寫 kebab-case。AI 解析結果會強制符合此規範。 - 同名處理：同名技能不會覆蓋，只會跳過。
- Profile 依賴：安裝命令默認使用
webprofile，若環境不同需自行修改。 - 安全性：導入時瀏覽器讀取文件經 RPC 傳輸，請確保文件來源安全。
- 停用插件：如需停用，可取消
cordis.patch.yml中# disabled: true行的註釋，然後重啓dsh web。
