前言¶
DeepSeek Harness (DSH) 的設計理念之一是插件化。團隊 Skill Base 是集中存放和管理 Skills 的中心，但在實際開發中，從 Skill Base 獲取並安裝 Skills 往往需要手動操作或藉助外部工具。internal-skill-workshop 是一個 DSH Web 插件，它通過提供可視化的目錄界面，解決了在 DSH 環境中直接瀏覽、登錄和安裝團隊 Skills 的需求。
是什麼¶
這是一個團隊目錄客戶端插件。它通過 DSH 的 Settings 界面連接到配置的 Skill Base 服務器，提供以下能力：
* 配置管理：提供 DSH 設置入口，用於管理團隊 Skill Base 的地址。
* 默認地址：管理員可在配置文件中預設共享的服務器地址，團隊成員無需每次手動輸入。
* 公共瀏覽：無需賬號即可瀏覽公開目錄中的 Skills。
* 私有訪問：通過驗證碼機制登錄，訪問私有 Skills。
* 一鍵安裝：將 Skills 下載並安裝到 DSH 的用戶 Skill 目錄。
* 元數據展示：顯示作者、版本、可見性、類型、兼容工具及標籤等信息。
安裝與啓用¶
使用官方安裝命令將插件添加到 DSH Web。
dsh plugin --profile web add internal-skill-workshop
安裝完成後，需要重啓 DSH Web，然後在界面中打開 Settings -> Internal Skill Workshop。
配置與使用¶
基礎配置¶
管理員可以在 DSH 的 cordis.patch.yml 配置文件中爲該插件預設默認的 Skill Base 地址。
- id: internal-skill-workshop
config:
baseUrl: https://skills.company.example
成員也可以在插件界面中保存個人的地址，個人配置會覆蓋默認配置。
使用流程¶
- 打開 Settings -> Internal Skill Workshop。
- 確認或輸入 Skill Base 的根地址（注意不要包含
/api後綴）。 - 此時可以立即搜索並瀏覽公開的 Skills。
- 若要查看私有 Skills，選擇 Get code。系統會跳轉至 Skill Base 頁面，登錄後複製生成的驗證碼，再粘貼回插件中。
- 選擇目標 Skill，點擊 Install 即可完成安裝。
安全與憑證¶
該插件從不要求輸入 Skill Base 密碼。它通過一個安全流程來獲取訪問令牌：
- 驗證碼機制：插件生成一個 5 分鐘內有效的一次性驗證碼，用戶在 Skill Base 頁面登錄並使用該代碼換取 Skill Base 的個人訪問令牌（PAT）。
- 存儲位置：DSH 主機將 PAT 存儲在
$DSH_HOME/internal-skill-workshop/credentials中。 - 權限控制：存儲文件僅在平臺支持的地方設置爲僅所有者可讀。
- 安全邊界：瀏覽器僅通過 Loopback DSH RPC 與主機通信。主機驗證 Skill Base URL，拒絕遠程 HTTP、憑證、查詢字符串、片段和重定向。安裝過程爲暫存後原子性重命名。
限制與注意事項¶
該插件對資源和請求有限制，具體如下：
- 文件大小：下載的壓縮包限制爲 50 MB，解壓後限制爲 100 MB，文件條目限制爲 2,000 個。
- 響應限制：Skill Base 的 JSON 響應限制爲 5 MB。
- 兼容性：需要 Node.js 版本 >= 18。
- 更新機制：當前版本不支持更新或替換已存在且包含本地修改的 Skills。安裝前會檢查目標目錄是否存在，若存在則拒絕覆蓋。
- 協議要求：連接遠程服務器必須使用 HTTPS，本地開發環境除外。
該插件專注於客戶端目錄瀏覽與安裝，不包含或部署 Skill Base 服務器本身。
