前言¶

在 DeepSeek Harness（DSH）裏，技能（Skill）往往分散在用戶目錄、工作區 .agents/skills 或 .dsh/skills 裏，來源可能是 GitHub 提交、well-known 市場或手工編寫。僅靠文件管理器或命令行，很難統一查看有效性、對比上游版本，並在更新前保留可回滾的副本。社區插件 @skillre/dsh-plugin-skills-manager（Skills Manager）在 DSH 左側欄增加原生 React「技能」入口，把檢索、安裝、來源追蹤、批量更新、備份與移動/重命名收進同一界面，且不依賴 iframe 或獨立網頁。

這是什麼¶

@skillre/dsh-plugin-skills-manager 當前版本爲 0.1.7（README 標註 experimental），由 skillre 維護，分類爲工作流。它解決的是：在 DSH 宿主內以界面和可選模型工具 skills_manager 管理本地與登記工作區內的技能目錄，並對有可靠來源記錄的技能做更新檢查與安全替換。

插件包由 DSH Plugins 管理器安裝進 profile（例如 ~/.dsh/profiles/<profile>/node_modules/@skillre/dsh-plugin-skills-manager）；技能文件本身仍寫在 $DSH_AGENTS_HOME/skills、$DSH_HOME/skills 或工作區對應目錄，與插件安裝位置無關。

核心功能¶

下面按 README 已列能力歸納，便於對照界面標籤頁使用。

本地技能與詳情¶

• 查看用戶級與已登記工作區內的技能，按名稱、描述、來源和位置篩選；展示有效性、調用策略及 SKILL.md 指令內容。
• 點擊名稱、卡片或「詳情」可看到絕對路徑（可複製）、來源與提交、更新狀態、模型/用戶調用權限、完整指令與資源清單；只讀技能在文件可讀時也會列出資源。

更新檢查與安裝來源¶

• 「檢查更新」只發起檢查，不自動更新；摘要區分可更新、已是最新、無來源、只讀和檢查失敗；無來源不會被誤報爲「已是最新」。
• 識別 Skills CLI 記錄的 GitHub 與 well-known（如文檔中提到的 open.feishu.cn）來源；well-known 技能用目錄摘要檢查並更新，其他第三方來源顯示真實標籤但標記爲不可自動更新。
• GitHub 來源固定到查看過的提交，比較完整技能目錄的 Git tree 哈希；well-known 讀取 /.well-known/agent-skills/index.json 並校驗 catalog 的 sha256 歸檔，在內存中嚴格解析 tar.gz，不執行下載腳本。

安裝與檢索¶

• 「技能檢索」可搜索公共 skills.sh 目錄；「從倉庫安裝」支持 owner/repo 或完整 GitHub URL，分支/標籤選填，默認 HEAD。
• 安裝前需勾選信任確認；不會覆蓋既有目錄。擴展來源還支持本地 .tar.gz/.tgz/.zip 歸檔（內存解析、不執行腳本）以及 well-known HTTPS 目錄安裝。

更新、刪除、備份與遷移¶

• 單技能更新可固定到所選提交、校驗 blob 與目錄樹；更新對話框展示新增/刪除/修改/未變文件；更新前保存舊版本到備份。
• 刪除將入口移至完整備份，支持恢復（不覆蓋已存在同名技能）；可選「同時永久刪除備份」並二次警告。
• 「全部更新」需先檢查更新；逐項重新校驗來源，本地修改默認跳過，可顯式允許覆蓋；結果按成功/跳過/失敗彙總。
• 備份位於各技能根下 .skills-manager/backups/<id>/content；支持單條刪除與「保留最新 N 份」清理，默認不自動清理。
• 「移動 / 重命名」可把技能移到另一可寫位置或改目錄名；跨位置移動先複製校驗，原入口保留爲備份，同名衝突時拒絕。

模型工具¶

註冊 skills_manager，與界面共用同一核心服務；寫操作必須取得本次用戶批准，不接受授權布爾參數（可通過配置 enableAgentTool 關閉）。

安裝與啓用¶

尚未發佈 npm。在 DSH Plugins / 插件 裏由用戶自行添加來源並確認信任，安裝後重啓 Desktop。倉庫已含構建產物 lib/，跟隨 Git 安裝時 pnpm 不需要執行構建腳本。

方式 A：Git 倉庫地址（跟隨默認分支 main）

在 Add plugin / 添加插件 輸入：

https://github.com/skillre/dsh-plugin-skills-manager

方式 B：Release tarball（固定 v0.1.7）

從 GitHub Release v0.1.7 下載 skillre-dsh-plugin-skills-manager-0.1.7.tgz，在 Add plugin 中輸入該文件的完整本地絕對路徑。

步驟：

1. 打開左側 Plugins / 插件。
2. 選擇 Add plugin / 添加插件。
3. 粘貼倉庫 URL 或 tarball 絕對路徑，查看信任提示並確認安裝。
4. 啓用後從左側 技能 / Skills 進入。

版本注意： 0.1.0 已作廢，不要新裝或回滾到該版；若曾安裝 0.1.0，需先在插件頁關閉或卸載並確認宿主恢復，再安裝 0.1.1 及以上（可原地升級，技能與備份保留）。宿主要求見 package.json：dsh >=0.2.1-rc.5 <0.3.0，Node ^22.19.0 || >=24.0.0。許可證 MIT。

典型用法¶

日常維護流程¶

1. 打開「本地技能」，必要時在工具欄左上角使用刷新圖標僅重掃本地目錄（不訪問網絡）。
2. 點擊頁頭「檢查更新」訪問來源並對比上游；在「可用更新」或列表中對可更新項執行更新，或勾選後使用「全部更新」。
3. 手動改過技能文件後，用本地刷新重讀；需要 upstream 狀態時再跑「檢查更新」。更新其中一個技能後，其餘技能的檢查結果會保留，無需整頁重檢。

新技能入庫¶

1. 在「技能檢索」輸入任務或技術關鍵詞，或「從倉庫安裝」填寫 owner/repo。
2. 「查看並安裝」先檢查來源，勾選信任並選擇寫入目標（彈窗會顯示目標根目錄絕對路徑，如默認 ~/.agents/skills）。
3. 安裝完成後，DSH 本地技能掃描器會在觀察到文件變化後更新目錄；已有對話裏已加載的指令不會被追溯重寫，必要時重新加載技能或開新會話。

配置（可選）¶

配置寫在用戶 Cordis 覆蓋層，勿改安裝包內文件。示例：

- id: skillre-skills-manager
  config:
    allowMutations: true
    enableAgentTool: true
    includeDefaultRoots: true
    dshHome: /absolute/path/to/dsh-home
    agentsHome: /absolute/path/to/agents-home
    customSkillDirs: []
    readOnlySkillDirs: []
    requestTimeoutMs: 15000
    operationTimeoutMs: 300000
    maxSkills: 500
    maxFileBytes: 2097152
    maxBundleBytes: 104857600
    maxBundleFiles: 20000
    maxRepositoryEntries: 30000
    checkConcurrency: 3

覆蓋 config 會整塊替換，schema 會補齊默認字段；目錄項必須爲絕對路徑。將 allowMutations 設爲 false 時，所有目錄只讀。

管理範圍與適用注意¶

適合需要在 DSH Desktop 內集中維護多來源技能、並希望在更新/刪除前保留備份的開發者。插件以當前 DSH 進程權限訪問配置的技能目錄；網絡僅面向 skills.sh、api.github.com、raw.githubusercontent.com 及已記錄 well-known 來源，不讀取 GitHub token 或執行 npx/Git/下載腳本。安裝前應自行查看 GitHub 源碼與 LICENSE，並理解 README 中的併發與變更期間勿用其他安裝器同時改同一根目錄等限制。

社區目錄 skillhub.cn 插件頁 與 GitHub 倉庫爲獨立生態信息源，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

Skills Manager 把 DSH 裏分散的技能目錄、來源記錄與更新校驗接到同一原生界面，並在破壞性操作前默認保留備份。若你已在用 DSH 0.2.1-rc.5 及以上並需要可視化的安裝與批量更新流程，可按上文兩種方式添加插件並從左側「技能」進入。

• 目錄頁：https://www.skillhub.cn/plugins/skillre/dsh-plugin-skills-manager
• 倉庫：https://github.com/skillre/dsh-plugin-skills-manager