前言¶
在 DSH 中，技能可能來自多個目錄，模型可見的技能目錄也會隨來源變化。日常使用中，常見的問題不只是“有沒有某個技能”，而是要在同一個 dsh web 環境裏快速導入技能、停用某個技能、按組切換技能目錄。
下面介紹 dsh-skill-manager。這是一個由 Mvyvn 維護、MIT 許可的 DSH 技能管理器插件，隨 dsh web 啓動自動加載（無需審批）。
插件定位¶
dsh-skill-manager 爲 DSH 提供技能掃描、導入、上傳、分組啓停和默認組切換能力。它把技能管理放進 dsh web 的設置界面，同時提供 skillmg_* 模型工具，讓 AI 可以自主完成全部管理操作。
核心功能¶
掃描 / 導入 / 上傳¶
插件可以列出以下來源目錄中的全部技能：
~/.agents/skills$DSH_HOME/skills
你可以把列出的技能一鍵複製進 $DSH_HOME/skills，也可以通過瀏覽器上傳 .zip / 文件夾。
分組啓停¶
插件支持建組、把技能加入分組、在組內停用某個技能。
停用某個技能時，插件會把 SKILL.md 原子改名爲 SKILL.md.disable。這個過程是零內容寫入、併發安全的。
默認組¶
默認組控制所有會話的模型技能目錄。插件保留 id __all_off__，表示全部禁用。
會話級選擇器¶
聊天輸入欄左側會出現「技能組：」下拉，用於爲當前會話單獨指定分組。
需要注意：會話級覆蓋（perSessionGroups）當前僅記錄，模型目錄仍由默認組決定。
界面與 AI 管理¶
插件提供全中文 UI，使用官方 DSH 主題 token。skillmg_* 模型工具讓 AI 可以自主完成全部管理。
安裝與啓用¶
前置條件：已經啓動過一次 dsh web，即已生成 web profile。
在 Windows 上執行下面命令：
# Windows
git clone https://github.com/Mvyvn/dsh-skill-manager.git
cd dsh-skill-manager
powershell -ExecutionPolicy Bypass -File scripts/install.ps1
安裝後需要完全重啓 dsh web：結束進程後重新打開，不是刷新頁面。
經過上面的步驟後，可以做兩項驗證：
- 設置裏出現「Skill 管理」側欄；
- 聊天輸入欄左側出現「技能組：」下拉。
典型用法¶
先導入技能，再建立分組，最後設置默認組：
1、設置 → Skill 管理 → 技能導入：勾選技能，點「導入所選」。
2、切到 分組管理：新建分組，把技能加入。
3、點「設爲默認」，所有會話的技能目錄立即切換爲該分組。
4、如果希望 AI 自己管理，可以直接對它說「把 xxx 技能分到 xxx 組」。
適用場景與注意¶
適合在 dsh web 中管理技能目錄、按組切換技能、或希望讓模型通過工具完成導入與分組操作的 DSH 用戶。
使用前注意以下幾點：
- 瀏覽器上傳僅支持文本文件（SKILL.md 場景），單文件 ≤ 2MB，總內容 ≤ 16MB。
- 多根加載會繞過分組啓停。若發現切換分組不生效，可按
docs/how-it-works.md啓用skill-only預設。 - 會話級覆蓋（
perSessionGroups）當前僅記錄，模型目錄仍由默認組決定。 - 全部配置保存在
$DSH_HOME/skill-mgmt.json，寫入受跨進程鎖保護。 - 項目主要在 Windows 開發測試；macOS/Linux 路徑使用
~與$DSH_HOME語義。 - 許可證爲 MIT © 2026 沐雲 (Mvyvn)。插件會以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。
結尾¶
dsh-skill-manager 的價值在於把 DSH 的技能目錄管理變成可視、可分組、可停用、可被模型調用的操作，減少手工改文件帶來的不一致。
項目地址：https://github.com/Mvyvn/dsh-skill-manager
