DeepSeek Harness 插件：smart-dsh-market 生產力中樞

前言¶

DeepSeek Harness（DSH）的核心理念是「一切皆插件」。面對社區中成千上萬的插件，開發者通常面臨兩個痛點：一是難以在海量生態中精準發現適配當前項目階段的工具，二是缺乏統一的安全管理機制。現有的插件分發方式往往依賴外部網絡或缺乏對本地項目狀態的感知。

smart-dsh-market 是一個旨在解決上述問題的本地化插件中樞。它集成了海量插件索引、項目生命週期感知推薦與極簡交互界面，致力於提供本地優先、零數據上傳的安全插件管理體驗。

插件定位¶

該插件由開發者 wsifan31-bit 維護，是一個基於 MIT 許可證的 DSH 插件市場。它不僅是一個插件索引庫，更是一個集成了雙引擎發現機制、安全分級體系與智能推薦功能的 DSH 生產力中樞。其核心價值在於將原本滯後的 2,786 款插件索引擴展至 12,435+ 款，並能在本地根據 Git 狀態智能推薦插件。

核心功能¶

插件提供了以下主要能力：

雙引擎發現與海量索引
插件通過動態接入本地 DSH Desktop 緩存，打破原先 2,786 款插件的檢索侷限。它實現了全網最新插件生態的實時同步，支持雙引擎發現機制，確保開發者能獲取到最新的插件資源。
雙軌安全分級體系
市場對插件實行分級管理：
- 官方嚴選：針對 2,786 款已驗證插件，採用 SHA Commit 鎖定與無侵入靜態審計，支持一鍵靜默秒裝。
- 社區探索：針對 9,649 款社區插件，自動分流至 Agent 隔離沙箱安裝，防止未經覈驗的代碼直接侵入系統。
26px Nano HUD 會話底欄
在 DSH 的會話輸入欄下方掛載了一個超輕量的 26px 浮動條。它會實時探測本地 Git 倉庫狀態（分支、髒工作區、提交頻率）與項目生命週期階段，並在氣泡中就地推薦適配的插件，不佔用主要聊天空間。
項目生命週期智能推導
插件能從本地 Git 歷史與測試佔比推斷項目階段（如架構、原型、實現、測試、打磨、維護）。基於證據化打分（匹配度、質量、增長、新鮮度、兼容性），它能對插件進行排序推薦。
本地優先與隱私保護
所有打分、階段檢測與緩存索引均支持 100% 離線運行。插件不會調用外部模型，也不會上傳任何私有代碼數據。

安裝與啓用¶

可以通過以下三種方式安裝該插件：

方式一：使用 DSH CLI 安裝（推薦）
在終端執行以下命令，將插件實體安裝在當前 Profile 的 node_modules 作用域內：

dsh plugin --profile web add github:wsifan31-bit/smart-dsh-market

桌面端同樣支持該命令。

方式二：一鍵安裝腳本
* Windows：直接雙擊運行倉庫根目錄的 install.bat，或在 PowerShell 中執行 powershell -ExecutionPolicy Bypass -File scripts/install-desktop.ps1。
* Linux / macOS：在終端執行 bash install.sh。

方式三：Agent 安裝
針對複雜構建或配置需求，可選擇 Agent 安裝模式。

安裝完成後，啓動 DSH 並進入 設置 → 插件 → 插件市場 即可使用。

使用指南¶

進入插件市場後，包含三個主要子頁面：

插件市場：用於搜索、分類、排序插件，查看驗證信息並執行安裝。
已安裝插件：過濾、檢查更新、卸載或停用當前 Profile 的插件。
管理與診斷：支持手動命令安裝、選擇自定義安裝位置以及執行衝突診斷。

安裝模式說明
市場支持三種安裝模式：
1. 一鍵安裝：適用於精確 GitHub commit 或 npm 版本已通過檢查的場景。
2. 手動命令安裝：用戶粘貼官方 DSH 命令，市場解析並鎖定 commit 後安全安裝。
3. Agent 安裝：針對需要構建授權、生命週期腳本或額外核驗的插件，創建隔離會話執行。

自建 Registry
插件支持配置自定義 Registry。默認使用中心化 Registry，若遠程不可用，市場會自動回退使用包內快照。配置方式包括環境變量或插件配置項中的 registryUrl。

注意事項¶

依賴與安裝位置
插件運行依賴兩個 Host 端協議包（@deepseek-ai/dsh-typert-protocol、@deepseek-ai/dsh-app-boot）。這些包被設計爲 peerDependency，必須由 DSH 運行時從 hoisted 存儲提供，不要將它們改爲 dependencies 或打入 bundle，否則會導致服務靜默失效。安裝必須確保插件實體落在 Profile 的 node_modules 作用域內。
Agent 工作區
Agent 默認綁定工作區路徑爲 $DSH_HOME/marketplace/agent-workspace。自定義工作區必須預先存在且可讀寫。
衝突診斷
市場內置的衝突診斷面板會對已啓用插件進行啓發式靜態檢測（如重複的 Bundle ID、Cordis 服務註冊形式），作爲啓動崩潰的前置防線。

結語¶

smart-dsh-market 通過雙引擎發現、安全分級與本地化智能推薦，爲 DSH 用戶提供了一個從發現、安裝到管理的完整閉環。它降低了尋找合適插件的成本，並通過隔離機制保障了安全性，是構建本地化 DSH 開發環境的實用工具。