前言¶
在使用 DeepSeek Harness Web 進行智能體開發時，管理全局技能通常需要直接操作文件系統。如果需要頻繁切換不同的技能配置，手動創建或刪除符號鏈接（Junction）會變得繁瑣且容易出錯。dsh-skill-switch 插件通過 Windows Junction 技術提供了一套自動化方案，解決了在 $DSH_HOME/skills 目錄中管理全局技能的需求。
是什麼¶
這是由 hzthzt 維護的一個插件，屬於「趣味換裝」類別。它利用 Windows Junction 機制，在 $DSH_HOME/skills 目錄中創建指向中央目錄的快捷方式，從而實現對用戶全局技能的快速切換。插件遵循 MIT 許可證，目前倉庫暫無星標。
核心功能¶
- 基於 Junction 的管理：在
$DSH_HOME/skills中創建和移除 Windows Junction。 - 自動識別：通過
SKILL.md文件的 frontmatter 識別技能，name字段作爲唯一標識。 - 中央目錄掃描：管理位於中央目錄中的用戶全局技能，僅通過 Junction 暴露。
- 安全機制：擁有記錄存儲在
manifest.json中，使用嚴格的序列化隊列防止競爭條件。 - 衝突處理：檢測外部管理的目錄與同名技能的衝突，來源技能永不移除。
安裝與啓用¶
先通過官方命令安裝插件到指定 Profile，然後啓動 Web 界面進行配置。
- 安裝插件：
dsh plugin --profile <profile> add github:hzthzt/dsh-skill-switch#<commit-sha>
- 啓動 DeepSeek Harness Web：
dsh --profile <profile> web
- 打開 DSH 設置，進入 Skills 面板。
典型用法¶
- 準備中央目錄（默認爲
~/.cc-switch/skills），在其中創建技能文件夾，如example-skill-main。 - 在該文件夾下創建
SKILL.md，並在 frontmatter 中定義技能名稱：
---
name: example-skill
description: A non-empty description.
---
- 在 DSH 設置中選中該技能進行啓用。
- 如需更改中央目錄，先使用 Disable all，再重新選擇。
適用場景與注意¶
- 平臺限制：僅支持 Windows 系統。
- 目錄限制：中央目錄和
$DSH_HOME/skills不能包含彼此。 - 環境變量：配置路徑中的環境變量（如
%USERPROFILE%）不會被展開，請使用絕對路徑或~。 - 依賴要求：需要 Node.js 24 和 pnpm@11.7.0。
- 來源技能：插件管理的來源技能目錄不會被移除，僅管理 Junction。
結尾¶
該插件爲 DSH 用戶提供了基於文件系統的全局技能管理能力，適合需要在 Windows 環境下統一管理技能配置的開發者。更多細節可參考項目目錄頁或源碼。
