前言¶
在 DeepSeek Harness（DSH）裏用久了，技能數量一多，「記得文件名」和「記得用途」往往會脫節。官方技能中心側重文件與提供者的目錄視圖，按用途檢索、批量整理、導入後順手歸類，通常要自己在腦子裏或外部表格裏維護一套映射。
dsh-skill-categories 把工作流裏的這幾件事收進統一的技能頁：自定義分類與標籤、聯合篩選、導入成功後的歸類提示，以及輸入框裏按分類引用技能。下面按維護者文檔說明定位、能力與安裝邊界。當前爲預覽版 0.4.0：已完成構建、自動測試和獨立瀏覽器示例驗證，完整已登錄宿主驗收仍需自行完成。
這是什麼¶
- 插件名稱：
dsh-skill-categories（npm 包名同左） - 維護者：wuzeno
- 社區目錄分類：工作流
- 一句話定位：面向 DSH 的社區技能中心增強——自定義分類與標籤、導入後歸類、會話範圍內按分類引用技能；在統一「技能」頁合併原技能管理與分類整理，而不再維護兩套列表。
- 倉庫與目錄：GitHub · SkillHub 目錄頁
技能管理能力基於上游 @linxin666/dsh-client-ui-skill-explorer 0.4.8（BSD-3-Clause）；本插件原創的分類、統一視圖、引用與測試部分爲 MIT，許可以倉庫 LICENSE 與 THIRD_PARTY_NOTICES.md 爲準。
核心功能¶
統一技能頁¶
「技能」頁左側選分類，右側保留原有文件與提供者目錄，以及啓用、編輯、刪除、複製模板等操作；「創建」「導入」仍爲獨立頁籤，編輯時出現編輯頁籤。不再把「技能」和「分類整理」拆成兩份列表。
自定義分類與標籤¶
可新建、重命名、排序、刪除分類。刪除分類只會取消歸類，技能文件與標籤保留。可爲技能打標籤；批量歸類時標籤默認保留，僅在明確選擇「替換」後才覆蓋。
批量整理與聯合篩選¶
勾選多項後執行批量分類；當前篩選或摺疊組裏未顯示的勾選項不會進入批量處理。可按分類、工作區、來源、啓用狀態、文件標記縮小列表；搜索同時匹配技能名稱、描述、標籤與分類名。
分類以技能邏輯名稱爲鍵：同名技能在不同工作區或路徑下共用一份分類與標籤，列表仍保留各行文件與操作。非標準命名的技能可繼續瀏覽管理，但暫不支持分類。「工作區」在此僅爲列表篩選器，不會切換當前使用的工作區，也不是 Agent 預設選擇器。
導入後歸類¶
在插件「導入」頁選擇本地目錄或 ZIP。導入成功後，根據本次響應裏實際成功的項目彈出歸類提示，無需等待後臺輪詢。跳過歸類不會撤銷導入；分類保存失敗也不會把已成功導入記爲失敗或回滾技能文件。
可開關「發現新增技能後提示分類」。經其他插件、手工複製或預設變化出現的新名稱，約每 10 秒做一次完整目錄檢測；後臺頁或其他模態可能延遲提示。首次讀取只建立基線，不會一次性彈出全部舊技能。
會話內的分類引用¶
輸入框增加獨立的「分類引用」按鈕（不替換原技能市場插件的「＋技能」）。可選全部分類、未分類或自定義分類，也可搜分類名、標籤、技能名或描述。候選來自當前會話的可引用目錄，遵守該會話的預設與工作區範圍；與管理頁文件視圖數量不一致不一定是錯誤。
選中後通過宿主安全插入接口，在當前光標處寫入 /技能名稱，不自動發送消息，也不整份覆蓋草稿。宿主拒絕插入時會報錯，不以覆蓋草稿兜底。Esc 關閉彈窗並恢復按鈕焦點。
子代理會話暫不顯示該按鈕；缺少可選會話服務時不掛載，缺少安全輸入接口時禁用。搜索結果超過 200 條時需繼續輸入關鍵詞縮小範圍。
明確不做的事¶
分類不限制 Agent 能調用哪些技能，也不會自動加載一整類。當前無 AI 自動分類、多級分類、跨設備同步或分類導入導出。分類元數據寫入插件 skill_categories 存儲域，不移動技能目錄、不改技能正文。
安裝與啓用¶
兼容要求¶
DeepSeek Harness：>=0.2.1-rc.3 且 <0.3.0
Node.js：>=22.13.0
從源碼構建：pnpm，並使用倉庫鎖文件
以上爲文檔聲明範圍，不代表每個宿主版本與第三方插件組合均已驗收。
與原技能中心的關係¶
安裝整合版前，請在官方插件管理器中停用 @linxin666/dsh-client-ui-skill-explorer，避免重複入口與管理路由。原插件可保留安裝以便回退。不要同時啓用原技能中心與本插件。
本項目尚未發佈到 npm，文檔不提供未經驗證的遠程 npm 安裝命令。安裝路徑爲：源碼構建後，經 DSH 官方插件管理器安裝本地項目目錄；不要手工改用戶 profile，也不要單獨起 Web 服務。
從源碼構建¶
在倉庫根目錄執行（命令來自項目 README）：
git clone https://github.com/wuzeno/dsh-skill-categories.git
cd dsh-skill-categories
pnpm install --frozen-lockfile --ignore-scripts
npm run build
npm run check
npm test
隨後在官方插件管理器中選擇本地 dsh-skill-categories 目錄完成安裝。本地目錄安裝通常以鏈接方式生效，源碼目錄須先裝好依賴（否則宿主可能無法解析 zod）。安裝後刷新 DSH 頁面；若宿主提示重啓，按其說明操作。管理器中的校驗結果與激活結果應分別確認。
若提示 already-installed，先用管理器移除舊 bundle，再安裝更新後的本地目錄。卸載後分類數據保留策略由宿主決定，重要數據請先備份。回退時先停用本插件，再啓用原技能中心並刷新，仍勿同時啓用兩者。
典型用法¶
1. 在技能頁整理存量技能¶
- 打開統一「技能」頁，左側新建或選擇分類。
- 用聯合篩選或搜索縮小列表，勾選目標技能。
- 點擊「批量分類」，或在單行使用「分類與標籤」。
- 需要改標籤時，批量操作裏僅在確認替換後再覆蓋既有標籤。
2. 導入目錄或 ZIP 並歸類¶
- 切換到「導入」頁，選擇本地目錄或 ZIP。
- 導入成功後，在提示中爲本次成功項選擇分類；可跳過，跳過不撤銷文件。
- 若希望後續自動提示，在設置中打開「發現新增技能後提示分類」。
3. 在對話裏引用技能¶
- 在支持的主會話輸入框點擊「分類引用」。
- 按分類瀏覽或輸入關鍵詞篩選（注意 200 條上限）。
- 選中技能，確認插入
/技能名稱後再自行編輯或發送消息。
本地 UI 預覽（非已登錄宿主）可構建後執行：
node scripts/preview.mjs
瀏覽器打開生成的 preview/index.html，使用示例數據，不能代替真實宿主上的導入、編輯與持久化驗收。
適用場景與注意¶
適合誰：長期在 DSH 中積累大量技能、需要按用途檢索與批量歸類的開發者；希望在導入後立刻歸類、在會話裏按分類插入技能引用的工作流用戶。
權限與安全：插件以當前 DSH 進程權限運行，分類 API 僅接受當前已認證瀏覽器用戶的規定格式請求，工作區路徑須屬於宿主登記目錄。安裝前建議閱讀倉庫源碼、SECURITY.md 與許可證；反饋問題勿提交登錄鏈接、令牌或敏感技能正文。
驗證狀態（0.4.0）：自動測試 80 項通過；獨立瀏覽器示例覆蓋分類、聯合列表、導入提示與引用流程。開發期自動化未完成宿主登錄，不等同真實環境完整驗收。正式使用前請在已登錄 DSH 中自行驗證導入、編輯、分類持久化與會話引用。
生態說明：DSH 奉行「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。本插件不代表上游作者或 DeepSeek 官方。
結尾¶
dsh-skill-categories 把分類、標籤、導入後歸類和會話引用接到一塊技能管理界面上，減輕「技能多了卻找不到用途」的維護成本。當前仍爲預覽版，並存原技能中心前務必按文檔停用上游 Explorer 插件。
- 目錄頁：https://www.skillhub.cn/plugins/wuzeno/dsh-skill-categories
- GitHub：https://github.com/wuzeno/dsh-skill-categories
