前言¶
DeepSeek Harness 的核心理念是“一切皆插件”。隨着插件數量的增加，手動管理社區目錄、當前 Profile 的包清單以及 Loader 的運行態變得繁瑣且容易出錯。dsh-plugin-console 是一個安裝在 DeepSeek Harness Web profile 中的插件管理器，它將社區目錄同步、Profile 包清單、Loader 運行態查看、安裝前驗證、隔離試運行以及 Harness 一鍵更新功能整合到了 Settings 的“插件管理”頁面中，並通過官方的 dsh plugin 命令完成底層操作。
該插件由 AlexYin-Tongji 維護，遵循 MIT 協議。它不提供營銷式的“賦能”，而是通過具體的步驟和校驗機制，幫助開發者安全、可控地管理插件生態。
核心功能¶
該插件主要包含以下功能模塊：
* 插件商店：默認同步 awesome-dsh-plugin 目錄，支持搜索、分類、分頁和本地緩存。
* 安裝前驗證：在安裝前檢查 npm 包的合法 SemVer、repository、HTTPS tarball、SHA-512 integrity、dsh.bundle.patch 和生命週期腳本；GitHub 包固定到 commit。
* 已安裝清單：讀取 profile 的 direct dependencies、bundle 順序、解析後的 package manifest、Loader entry/Fiber phase 和 Web client 能力。
* 使用說明：支持 Markdown、MDX、RST、TXT 和無擴展名 README，支持源碼視圖。
* 快捷更新：不自動安裝，點擊確認後執行，支持社區目錄和 npm 包的版本升級。
* 快捷刪除：只允許刪除 direct dependency，清理 bundle 配置。
* 暫停使用：通過 profile Loader patch 持久化 disabled 狀態。
* 隔離試運行：在臨時 DSH_HOME 中啓動完整 profile 以發現插件間或 DSH/Cordis 初始化衝突。
* 變更確認：生成 5 分鐘有效的 plan，校驗 profile 指紋和 artifact integrity。
* DSH 一鍵更新：左側邊欄入口，支持檢查各通道最新版本並一鍵更新 Harness 本體。
安裝與啓用¶
在 DSH 所在環境安裝該插件，需要使用官方的 dsh plugin 命令。
dsh plugin --profile web add dsh-plugin-console@latest
安裝完成後，進入 DeepSeek Harness 的 Settings 頁面，即可在“插件管理”欄目中看到該插件的控制面板。
主要操作說明¶
1. 插件商店與搜索¶
插件商店默認同步 awesome-dsh-plugin 目錄。支持對插件進行搜索、分類瀏覽和分頁操作。爲了提升響應速度，目錄內容會被緩存到本地。
2. 安裝前驗證¶
在安裝或更新插件時，系統會進行嚴格的預校驗：
* 包合法性：檢查 npm 包的合法 SemVer 版本號。
* 完整性：驗證 HTTPS tarball 和 SHA-512 integrity。
* 依賴檢查：確認 dsh.bundle.patch 和生命週期腳本是否存在。
* 來源鎖定：GitHub 來源的包會固定到具體的 40 位 commit，防止供應鏈攻擊。
3. 已安裝清單與詳情¶
在插件管理界面，可以查看當前 Profile 的詳細狀態：
* 依賴關係：讀取 direct dependencies。
* 加載順序：查看 bundle 順序。
* 運行態：解析後的 package manifest、Loader entry、Fiber phase 以及 Web client 能力。
* 文檔閱讀：點擊插件卡片可查看 README，支持 Markdown、MDX、RST、TXT 格式，且包含源碼視圖模式。
4. 更新與刪除¶
- 更新：插件管理器發現新版本後，只顯示更新按鈕，不會自動執行。用戶點擊確認後，系統會執行更新操作。社區目錄中的包按已驗證 artifact 更新；npm 包只有在同名、同 repository、合法升級版本和 integrity 都成立時纔可更新。
- 刪除：爲了保護系統穩定性，只允許刪除 direct dependency，系統 bundle 受保護。刪除會同步清理
dsh.profile.bundles中的對應層配置。
5. 隔離試運行與變更確認¶
- 隔離試運行：在安裝或更新後，系統會在臨時
DSH_HOME、隨機端口和隔離環境中啓動完整 Web profile。這能提前發現插件間或 DSH/Cordis 初始化的衝突。如果目標 bundle 的 Loader 條目、包版本、bundle 語法或 HTTP 資源校驗不通過，系統會自動恢復舊版本。 - 變更確認：所有寫操作會先生成一個 5 分鐘有效的 plan。執行前會重新校驗 profile 指紋、當前包狀態和 artifact integrity。
6. DSH 一鍵更新¶
在左側邊欄底部新增 Harness 更新入口。
* 版本檢查：支持檢查各通道（如 latest/next）的最新版本，面板會顯示運行中/已安裝/最新版本。
* 更新執行：點擊更新後，支持一鍵更新 Harness 本體。更新只支持 npm 全局安裝方式，並會執行精確校驗和隔離驗證，確保所有插件兼容後才生效。
安全與限制¶
- 刪除限制：只允許刪除 direct dependency，系統 bundle 受保護。
- 安全邊界：瀏覽器 API 僅接受 typed install/update/remove/pause/resume，子進程使用參數數組且 shell: false。
- Harness 更新：只支持 npm 全局安裝方式。
總結¶
dsh-plugin-console 是 DeepSeek Harness 插件生態中重要的管理工具。它通過嚴格的校驗機制、隔離試運行環境和規範的變更確認流程，解決了插件管理中的安全和穩定性問題。對於需要管理 Profile 和 Loader 的開發者，該工具提供了從發現到安裝、再到運行態監控的完整閉環。
