前言¶

在 DeepSeek Harness（DSH）的插件生態中，skill 可以出現在多個層面。隨着可用 skill 增多，需要頻繁決定：某個 skill 是否全局啓用，新對話默認加載哪些，當前會話臨時啓用哪些，哪些用戶 skill 需要刪除。

dsh-skill-manager 是一個面向 DeepSeek Harness 的 Skill 管理插件。它把上述操作集中到界面和少量接口裏，方便在對話前、對話中和設置頁管理 skill 可見性。

插件定位¶

• 名稱：dsh-skill-manager
• 版本：0.1.0
• 許可證：MIT
• 倉庫：https://github.com/CLAPEILL/dsh-skill-manager
• 依賴聲明：peerDependencies 包含 react ^18.2.0 和 @deepseek-ai/cordis ^4.0.1

該插件用於全局啓用/禁用 skill、按工作區設置新對話默認加載的 skill、在對話中調整當前會話 skill，以及刪除用戶 skill。

核心功能¶

下面介紹已覈實的幾項能力。

新對話前選擇 skill¶

新對話屏幕會在 composer 上方顯示“對話 Skill” chip。可以先選擇本次會話可加載的 skill，再輸入第一條消息。

可選操作包括：

• follow workspace default
• enable everything
• choose exactly which skills this conversation may load

選擇後保存，再開始對話。

全局啓用或禁用 skill¶

可以在設置中全局啓用/禁用任意 skill。

被禁用的 skill 會從以下位置消失：

• 模型會話 skill 目錄
• / 輸入觸發
• skill 工具
• /name gesture

禁用操作不觸碰 skill 文件，重新啓用後立即恢復。

按工作區設置默認 skill¶

可以在 Settings → Skill 管理 中爲工作區設置新對話默認值：

• all available
• only these skills

該工作區的新對話會按所選默認值開始。

對話中調整 skill¶

對話頭部有 Skill 按鈕。點擊後可查看當前會話有效 skill 集合，並選擇：

• follow workspace default
• enable everything
• choose exactly which skills this chat may load

調整後，下一條消息會自動重新發佈會話 skill 目錄。

刪除用戶 skill¶

可以刪除用戶 skill，並永久移除以下路徑中的 skill 文件：

• ~/.dsh/skills
• ~/.agents/skills

project、custom 和 bundled skills 不能通過此插件刪除。

展示 skill 的中文說明¶

插件會從 skill 自身的 SKILL.md frontmatter 的 metadata 中讀取並展示：

• intro
• detail

安裝與依賴¶

安裝命令爲：

pnpm install

插件的 package.json 聲明瞭以下 peerDependencies：

{
  "react": "^18.2.0",
  "@deepseek-ai/cordis": "^4.0.1"
}

由於插件會以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。

典型用法¶

在設置中設置工作區默認¶

1、打開 Settings → Skill 管理。
2、爲目標工作區選擇 all available 或 only these skills。
3、保存設置。

在新對話前選擇 skill¶

1、進入新對話屏幕。
2、在 composer 上方的“對話 Skill” chip 中選擇 follow workspace default、enable everything 或 choose exactly which skills this conversation may load。
3、保存選擇，然後輸入第一條消息。

在對話中調整 skill¶

1、在對話頭部點擊 Skill 按鈕。
2、查看當前會話有效 skill 集合。
3、選擇 follow workspace default、enable everything 或 choose exactly which skills this chat may load。
4、發送下一條消息，使會話 skill 目錄重新發布。

通過接口管理¶

以下修改類接口需要請求頭：

x-dsh-skill-manager: 1

替換全局禁用集合：

POST /plugins/dsh-skill-manager/global
body: { names }

設置工作區新對話默認：

POST /plugins/dsh-skill-manager/workspace
body: { cwd, mode, selected }

覆蓋單個會話 skill 集合：

POST /plugins/dsh-skill-manager/session
body: { sessionId, mode, selected }

刪除用戶 skill：

POST /plugins/dsh-skill-manager/delete
body: { name }

在 SKILL.md 中提供說明¶

在 SKILL.md frontmatter 的 metadata 中提供：

metadata:
  intro: <一句話中文簡介，列表展示>
  detail: |-
    <詳細中文介紹，詳情彈窗展示：用途/適用場景/工作流程/典型觸發語/產出物>

狀態與限制¶

插件狀態保存在：

<dshHome>/plugin-data/skill-manager/state.json

禁用 skill 不會修改 skill 文件；刪除操作只作用於用戶 skill。project、custom 和 bundled skills 不在可刪除範圍內。

適用場景¶

dsh-skill-manager 適合需要頻繁調整 skill 可見性的 DeepSeek Harness 使用者，例如：

• 在不同工作區使用不同默認 skill
• 在單次對話中臨時只啓用部分 skill
• 全局關閉不再使用的 skill
• 清理用戶 skill

使用注意：

• 刪除用戶 skill 會永久移除對應文件，操作前確認目標 skill。
• 修改類接口要求 x-dsh-skill-manager: 1 請求頭。
• 安裝前應檢查源碼與許可證。

獲取¶

dsh-skill-manager 的價值在於把 skill 的全局、工作區和會話級管理放到同一界面。已覈實事實中未提供目錄頁地址；GitHub 倉庫地址爲：

https://github.com/CLAPEILL/dsh-skill-manager