前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的架構，允許用戶通過擴展增強功能。在缺乏統一目錄和生命週期管理工具的情況下，手動管理插件來源、權限和版本容易引入安全風險。DSH Store 是一個運行在 DSH 設置頁中的第三方插件商城與安全生命週期管理器，旨在爲 DSH 提供受控的插件發現、安裝、更新與回滾機制。
核心功能¶
DSH Store 依託標準 DSH Bundle + Host Plugin + Client Bundle 結構，在設置頁內提供以下能力：
- 插件商城：提供第三方插件瀏覽、權限查看和安裝入口，支持 Catalog 分層索引，按頁懶加載詳情。
- 自動化管理：提供自動提交入口，自動讀取必要文件，無需手動填寫 Catalog。
- 安全守護：提供 Guardian 進程，驗證 Profile 與 Boot ID，監控健康狀態。Guardian 是 DSH web Profile 的唯一啓動所有者。
- 精確回滾：提供安全修復器，支持 Catalog 固定 Commit 的精確回滾。
安裝與啓用¶
安裝前需滿足以下條件：目標 Profile 已啓用 Web 客戶端（例如 web），且本地環境安裝了 Node.js ^22.19.0 或 >=24.0.0。
1. 備份配置文件¶
由於首次安裝尚未運行 Guardian，沒有自動備份和健康檢查保護，請先手動備份目標 Profile 的以下文件：
* package.json
* pnpm-lock.yaml
* pnpm-workspace.yaml
* cordis.patch.yml（文件存在時）
2. 安裝商城¶
通過 DSH 官方 CLI 使用固定 GitHub Commit 安裝。不要使用浮動分支：
dsh plugin --profile web add 'git+https://github.com/AI-Scarlett/DSH-Store.git#0bc733064bfc8ff16f6e8144188a7ac563092e12'
3. 驗證配置¶
運行以下命令確認配置可以成功合成：
dsh --profile web --dump-config
4. 安裝 Guardian¶
在商城中使用獨立計劃安裝隨包提供的 DSH Guardian。Guardian 由 macOS launchd 在 DSH 進程外運行，負責驗證心跳、啓動 Host 並監控健康狀態。
典型用法¶
安裝完成後，所有插件操作（安裝、更新、遷移、停用、啓用、卸載）將進入一次性計劃、精確確認、前置哈希校驗、備份和失敗回滾流程。
首次安裝流程¶
- 執行安裝命令。
- 合成配置並驗收。
- 在商城中安裝 Guardian。
- 確認 Guardian 心跳正常後，生成
RESTART DSH <profile>計劃並重啓。
安全修復¶
當商城或其他插件更新出現錯誤時，修復頁只有在 Catalog Pin 完成後纔會顯示命令。此時可利用商城提供的修復器進行精確回滾。
注意事項與適用場景¶
- Commit 固定：安裝時必須使用具體的 GitHub Commit ID，不要換成
main等浮動分支。 - Guardian 獨佔：Guardian 是唯一啓動所有者，啓動第二個實例會因爭搶
127.0.0.1:3080而以EADDRINUSE退出。安裝 Guardian 後不要再手工運行dsh web或pnpm dsh web。 - 手動操作風險：商城只展示 Catalog 固定 Commit 與 GitHub 手動命令，該操作不受商城備份和健康檢查保護。
- 腳本處理：所有插件更新都會加
--ignore-scripts，只有 Catalog 明確列出的腳本才使用僅限該包的--allow-build=<package>。 - 外部目錄：外部目錄僅提供待審候選，不直接提供安裝。
總結¶
DSH Store 爲 DSH 用戶提供了從插件發現到安全維護的一站式基礎設施，確保了插件管理的可追溯性和安全性。
