前言¶

在 DeepSeek Harness（DSH）「一切皆插件」的模型下，web app 裏的 agent skills 可能來自多個來源：user .agents、user .dsh、project roots、custom、bundled。dsh-skill-panel 爲 DSH web app 提供一個 Skill management panel，把這些技能集中到 Settings → Skills 頁面和側邊欄 Skills 按鈕，便於瀏覽、搜索、過濾、啓停、卸載。下面介紹它的定位、功能、安裝方式和入口配置。

這是什麼¶

dsh-skill-panel 是 dsh web app 的 Skill management panel，由 nianchen8 維護，許可證爲 MIT。

它沒有 fork，不使用內部 API，也沒有構建步驟（pure JS）。運行時依賴限定爲 harness-provided @deepseek-ai/dsh-storage-domain 和 zod（declared as dependencies）。

核心功能¶

• Skill list：展示 name、description、source label，以及 per-source counts。
• 搜索與來源過濾：支持 user .agents、user .dsh、project roots、custom、bundled。
• Model / User invocation switches：改寫 SKILL.md frontmatter；未指定的 switches 保留。
• Disable / Enable：完全禁用一個 skill，並記住其 previous state；啓用時恢復 exactly that state。
• Uninstall：two-step confirm，刪除 skill directory；bundled skills 受保護。
• Detail view：展示 whenToUse、on-disk path 和 SKILL.md body。
• Skill groups：創建 / 重命名 / 刪除分組，按分組管理成員（add / remove skills），按分組瀏覽；通過 official ctx.storageDomain 持久化，不使用 self-made storage files。
• Reads：所有讀取均爲 session-scoped，面板顯示當前 session 提供的 catalog。
• Writes：寫操作同步 invalidate discovery，並通過 official forwarded events 刷新 slash-menu cache。

安裝與啓用¶

要求：

• DeepSeek Harness 0.1.0-rc.6+（web profile）
• pnpm 可用（corepack enable provides it）

以下命令提供 npm 和 GitHub 兩種來源；執行 dsh web 重啓以加載包。

corepack enable                                   # once per machine
dsh plugin --profile web add dsh-skill-panel     # from npm
# or: dsh plugin --profile web add github:nianchen8/dsh-skill-panel
dsh web                                           # restart to load the package

重啓後，面板會出現在 Settings → Skills 和側邊欄的 Skills 按鈕。

典型用法¶

1、打開入口：進入 Settings → Skills，或點擊側邊欄 Skills 按鈕。

2、查找技能：使用搜索，或按來源過濾（user .agents、user .dsh、project roots、custom、bundled）。

3、調整調用開關：切換 Model / User invocation switch；插件會改寫 SKILL.md frontmatter，並保留未指定的 switches。

4、臨時停用：點擊 Disable / Enable；插件會記住 previous state，啓用時恢復。

5、刪除技能：點擊 Uninstall 並完成 two-step confirm；bundled skills 受保護。

6、管理分組：創建、重命名、刪除 Skill groups，添加或移除分組中的 skill，再按分組瀏覽。

7、查看細節：在 detail view 中查看 whenToUse、on-disk path 和 SKILL.md body。

配置 UI 入口¶

三個 UI entries（sidebar button、overlay、settings page）可以通過 loader entry 的 config 單獨覆蓋。文件路徑示例：profiles/<name>/cordis.patch.yml。

- id: skill-panel
  config:
    entries:
      sidebar:
        enabled: true        # show the sidebar button (default true)
        order: 5             # explicit position; omit = dynamic tail
        # slot: conversation.session.header.actions   # optional relocation
      overlay:
        enabled: true
        order: 10
      settings:
        enabled: false       # hide the settings page

配置含義：

• entries.sidebar.enabled：是否註冊 sidebar button，默認 true。
• entries.sidebar.order：顯式位置；省略表示 dynamic tail。
• entries.sidebar.slot：可選 relocation。
• entries.overlay.enabled 與 entries.overlay.order：控制 overlay。
• entries.settings.enabled：例如設爲 false 可隱藏 settings page。

適用場景與注意¶

• 適合在 DSH web profile 中集中管理 SKILL.md 技能的使用者。
• 需要 DeepSeek Harness 0.1.0-rc.6+（web profile）和可用 pnpm。
• 寫操作會改寫 SKILL.md frontmatter 或刪除 skill directory；bundled skills 受保護。
• 當 storage 不可用時，面板會降級爲 read-only group view。
• 當 endpoint 不可用（例如重啓前），browser half 會回退到上述默認入口配置。
• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼和 MIT 許可。

相關鏈接¶

GitHub 倉庫：dsh-skill-panel。目錄頁 URL 未在已覈實材料中給出，可先查看上述倉庫中的 README、安裝命令和許可證。