DeepSeek Harness 技能中心插件

在 DeepSeek Harness（DSH）的插件生態中，管理和發現 Agent Skills 往往缺乏統一的入口。開發者通常需要在多個目錄中手動查找，且安裝時難以預知技能是否存在非法命名、文件不完整或引用缺失等問題。本插件在 DSH 側邊欄增加了一個“技能中心”入口，提供從搜索、體檢到安裝、管理的全鏈路能力。

插件定位¶

名稱: tuoluosuan/dsh-skill-center
維護者: tuoLuoSuan
核心價值: 在側邊欄直接搜索並安裝 Agent Skills，在安裝前進行體檢（檢查名字合法性、完整性、引用衝突），安裝的是特定 Commit 而非分支。

核心功能¶

側邊欄搜索與安裝
支持中英文關鍵詞搜索、分類和星標排序。點擊安裝前會展示詳情頁，包含目錄樹、SKILL.md 原文及預覽。
安裝前體檢
在安裝前檢查以下內容：
- 名字合法性: 檢查 name 是否合法（DSH 會靜默跳過非法名稱），防止安裝後不可見。
- 完整性: 檢查文件是否完整，防止因 429 或超時導致的下載不完整。
- 引用缺件: 檢測 SKILL.md 中引用的腳本或文件是否存在於取回目錄。
- 同名衝突: 檢測目標目錄是否已存在技能，提供覆蓋、改名或跳過選項。
Commit 級安裝
安裝讀取的是特定 Commit SHA，而非分支名。這避免了因 CDN 緩存導致安裝舊版本的問題，確保每次安裝的都是確定的“快照”。
本地狀態與調用統計
- 讀取本地狀態: 讀取本地已安裝技能的狀態，包括來源、文件數、校驗結果和調用次數。
- 統計調用次數: 通過解析 ~/.dsh/sessions/session.v4.jsonl.zstd 日誌統計調用次數（注意：日誌爲多幀 zstd 壓縮，需手動切幀處理）。
本機導入
掃描 35 個其他 Agent 技能目錄（用戶級和項目級），將 DSH 看不見的技能導進來，並按來源分組。
安全刪除與備份
刪除技能時移進 .trash 目錄（可撤銷），覆蓋同名文件時完整備份至 .backup 目錄。
熱掛載
若 cordis.patch.yml 爲純 insert，支持熱掛載無需重啓。

安裝與啓用¶

安裝命令¶

使用官方 CLI 安裝：

dsh plugin --profile <你的 profile> add dsh-skill-center

指定版本安裝¶

剛發版後的 24 小時內，建議指定版本號以避免解析到錯誤的 latest 版本：

dsh plugin --profile <你的 profile> add dsh-skill-center@0.4.0

從源碼安裝¶

如果需要修改代碼或運行本地檢查：

dsh plugin --profile <你的 profile> add "<倉庫路徑>"

桌面版注意¶

在桌面版中，需使用 Electron 自帶的 dsh.cmd 或應用內界面進行安裝，普通 CLI 拒絕 --profile desktop 參數。

典型用法¶

查看技能來源
安裝完成後，側邊欄底部會出現“技能中心”按鈕。點擊後，在“發現”標籤頁可以看到聚合的技能來源。
安裝前體檢
在安裝面板上，如果存在衝突或壞法，會直接顯示警告。點擊詳情頁可確認文件結構完整後再安裝。
管理技能開關
在“已安裝”列表中，點擊開關可禁用/啓用技能。這會修改技能的 disable-model-invocation 字段，技能文件不會被刪除或移動，僅阻止模型調用。
查看 API 狀態
訪問 http://127.0.0.1:<端口>/dsh-skill-center/api/sources 可查看原始數據。

配置項¶

在 profile 的插件配置中，可設置以下參數（默認值通常已滿足需求）：

dshHome: 技能根目錄父目錄（默認 $DSH_HOME 或 ~/.dsh）。
cacheDir: 上游響應緩存目錄（默認 <dshHome>/skill-center/cache）。
trustedHosts: 反代/隧道場景下放行的 Host 列表（默認 []）。

適用場景與注意¶

宿主版本: 插件依賴宿主 @deepseek-ai/dsh 版本 >=0.2.0-rc.2，低版本會被版本門禁攔截。
日誌解析: 技能調用次數統計依賴解析 zstd 多幀壓縮日誌，Node 原生解壓只解第一幀，插件內部已處理切幀邏輯。
熱掛載限制: 熱掛載功能生效的前提是 cordis.patch.yml 配置爲純 insert。
關閉技能: 關閉技能只是禁用，技能文件保留在原位，恢復時無數據丟失風險。

總結¶

該插件解決了 DSH 生態中技能發現難、安裝盲區多、管理分散的問題。通過側邊欄統一入口，提供體檢、Commit 錨定、本地掃描和調用統計等功能，降低了使用其他 Agent 技能的門檻。

GitHub: https://github.com/tuoLuoSuan/dsh-skill-center
目錄頁: https://www.skillhub.cn/plugins/tuoLuoSuan/dsh-skill-center