dsh-skill-manage：DeepSeek Harness 技能管理插件

前言¶

DeepSeek Harness (DSH) 支持通過配置文件或 .zip 包管理技能，但官方工具鏈中缺少對技能的啓用、停用和刪除控制。在現有方案下，開發者通常需要手動編輯文件來隱藏或禁用技能，操作繁瑣且容易出錯。dsh-skill-manage 插件爲 DSH 補全了這一缺失的閉環，提供了可視化的設置面板以及供智能體直接調用的工具接口。

插件簡介¶

這是一個面向 DeepSeek Harness (dsh) 的客戶端插件，由開發者 lijian-ui 維護。它允許用戶在設置面板中查看、啓用、停用、刪除技能，或通過 .zip 文件導入新技能。同時，它註冊了一個名爲 skill_manage 的智能體工具，支持在會話中通過代碼創建、修改或刪除技能文件。

所屬分類：客戶端
許可證：MIT
GitHub 地址：https://github.com/lijian-ui/dsh-skill-manage

核心功能¶

該插件實現了以下核心能力：

技能列表與搜索：按全局或工作區範圍分組展示技能，支持搜索過濾。
啓用/停用控制：提供開關切換，無需重啓應用即可實時生效。
刪除技能：通過確認對話框永久移除技能文件。
添加技能：支持上傳 .zip 壓縮包，自動解壓並安裝到全局技能目錄。
技能詳情：渲染技能內容爲 Markdown，並展示前置元數據表。
Agent 工具 skill_manage：LLM 可直接調用的工具，支持 create、modify 和 delete 操作，並指定作用域（global 或 workspace）。

安裝與啓用¶

安裝此插件需要 DSH 版本 >= 0.1.6-alpha.1。

確保你的 DSH Web 應用或官方桌面應用已更新至上述版本。
執行安裝命令。注意 --profile 參數用於區分 Web 和桌面環境，插件是按配置文件隔離的。

dsh plugin --profile web add @lijian-ui/dsh-skill-manage

安裝完成後，請重啓 DSH 應用以加載插件。

典型用法¶

1. 通過設置面板操作¶

安裝完成後，打開 DSH（Web 或桌面端），進入 Settings → Skill Manage。

啓用/停用：點擊技能卡片上的開關，即可在“啓用”和“停用”狀態間切換。插件通過重命名 SKILL.md 爲 SKILL.md.disabled 來實現這一邏輯，DSH 的官方文件掃描機制會因此忽略該文件。
刪除：點擊刪除按鈕，按確認移除技能。
查看詳情：點擊技能卡片，查看其渲染後的 Markdown 內容及元數據。
搜索與導入：使用搜索框過濾技能，點擊 “Add skill” 並選擇 .zip 歸檔文件即可導入。

2. 通過 Agent 工具操作¶

在 DSH 的智能體會話中，LLM 可以調用 skill_manage 工具進行編程化操作。該工具的參數如下：

參數	類型	必需	描述
`action`	`create` \| `modify` \| `delete`	是	執行的操作類型
`name`	string	是	技能名稱（僅允許小寫字母、數字和連字符）
`description`	string	僅 create	技能描述
`when_to_use`	string	否	技能觸發條件
`content`	string	僅 create	技能正文（Markdown 格式）
`scope`	`global` \| `workspace`	否（默認 `global`）	作用域：`global` 寫入 `~/.dsh/skills`，`workspace` 寫入項目目錄

delete：複用了 GUI 的刪除邏輯。
workspace 作用域：插件會從當前會話的工作目錄向上遍歷，尋找包含 .git 目錄的項目根目錄，並將技能寫入 <project>/.dsh/skills。

適用場景與注意¶

版本兼容性：插件 0.2.0 版本包含破壞性變更，RPC 協議已對齊官方 create 工廠，依賴項已移至 peerDependencies。如果你的環境使用的是舊版 dsh-desktop 0.5.0，可能存在兼容性問題。
配置文件隔離：Web 和桌面是兩個獨立的配置文件，插件安裝後僅對當前激活的 Profile（web 或 desktop）可見。
權限與安全：插件以當前 DSH 進程的權限運行，讀寫技能文件。建議在安裝前查看源碼並確認許可證。

總結¶

dsh-skill-manage 解決了 DSH 在技能管理上的核心痛點，將原本需要手動編輯文件的操作轉化爲直觀的 UI 交互和標準的 LLM 工具調用。對於需要精細化管理技能鏈路或通過智能體自動部署技能的開發者而言，這是一個實用的工具。