前言¶
DeepSeek Harness (DSH) 採用插件化架構。在使用過程中，直接操作文件或配置往往會導致“文件已啓用”與“當前會話可用”狀態混淆，且難以統一管理 Skill 的生命週期。dsh-skill-manager 通過官方擴展點介入設置頁面，在不修改 Harness 核心流程的前提下，提供了一套獨立的 Skill 管理方案。
是什麼¶
dsh-skill-manager 是一個非侵入式的 Skill 生命週期管理器插件。它由用戶 mhdfy1988 維護，旨在管理官方文件系統 Skill 提供器支持的用戶技能目錄，解決 Skill 安裝、更新、卸載過程中的狀態追蹤與文件管理問題。
核心功能¶
- 會話可用 Skill 查看：在“設置 → 技能”頁面，通過官方
skill.list接口查看當前選中會話實際可調用的 Skill。 - 本地安裝：支持從本地文件夾或 ZIP 包安裝包含
SKILL.md的 Skill。 - 生命週期管理：對由管理器安裝的 Skill 執行更新、啓用、停用和卸載操作。
- 狀態分區顯示：界面將“會話可用 Skill”與“管理器擁有的用戶 Skill”分開展示，避免混淆文件啓用狀態與實際調用結果。
- 安全操作機制：
- 安裝拒絕同名覆蓋。
- 更新前自動備份舊版本，再替換新版本。
- 卸載將文件移入管理器回收區，不直接永久刪除。
- 低侵入性：官方文件系統 Skill 提供器負責熱刷新；普通 Skill 操作不修改 Profile，也不強制要求重啓 Harness。
安裝與啓用¶
插件通過官方 dsh plugin 流程安裝。安裝完成後需重啓 Harness。
dsh plugin --profile web add D:\deepseek\dsh-skill-manager\artifacts\dsh-skill-manager-0.1.4.tgz
重啓 dsh web 後，進入“設置 → 技能”即可看到管理界面。
典型用法¶
Skill 包格式¶
Skill 包可以是文件夾或 ZIP，必須包含 SKILL.md。SKILL.md 中需聲明 name 字段（小寫 kebab-case），安裝後的目錄名會統一爲 name。
示例結構：
my-skill/
├─ SKILL.md
├─ references/
└─ scripts/
SKILL.md 示例¶
---
name: my-skill
description: 何時使用這個技能
---
# 使用說明
...
適用場景與注意¶
適用對象：需要頻繁管理、測試或維護自定義 Skill 的 DSH 開發者或管理員。
重要邊界：
1. 管理範圍：管理器僅擁有帶 .dsh-skill-manager.json 標記的 Skill 目錄。項目 Skill、手工安裝的用戶 Skill（位於 <DSH_HOME>\skills）、.agents Skill、預設內置 Skill 以及其他插件提供的 Skill 均不屬於此管理器。
2. 狀態優先級：頁面上“當前會話可用技能”直接複用官方結果，只讀展示；“用戶目錄已啓用”僅表示文件存在，不保證在會話中勝出（項目或預設中的同名 Skill 可能按官方優先級覆蓋）。
3. 插件安裝：管理器插件本身仍通過官方流程安裝、更新或移除，安裝後需重啓 Harness。
4. 第一版限制：暫不支持 GitHub 地址安裝、在線市場、自動更新源、圖形化恢復界面、跨歷史會話批量枚舉及管理任意插件。
結語¶
dsh-skill-manager 爲 DSH 插件生態提供了一個輕量級的 Skill 管理工具，通過清晰的分區和安全的生命週期操作，簡化了 Skill 的維護工作。更多細節可參考項目主頁或使用手冊。
- 項目主頁：GitHub
- 插件目錄：skillhub.cn
