前言¶
DeepSeek Harness（DSH）採用插件化架構。dsh-essential-tools（DET）是 LLYlab 維護的一個永久插件，旨在將 DSH 轉變爲一個具備工程化能力的控制台。它通過瀏覽器控制、項目運行、版本快照、虛擬對話樹（VTD）等功能，解決智能體在真實代碼開發中上下文斷裂、缺乏執行環境、無法回溯歷史操作等痛點。
核心功能¶
瀏覽器控制¶
DET 通過一個基於 Manifest V3 的瀏覽器擴展（Edge 或 Chrome）與 DSH 主機通信。擴展通過本地 WebSocket 橋接連接，默認端口爲 127.0.0.1:9123，允許模型操作用戶已登錄的瀏覽器實例。
- 權限控制：用戶通過擴展彈窗控制權限旋鈕，模型只能讀取當前設定的權限狀態。
關閉 off：無任何權限。只讀 read：可讀取頁面文本、DOM、截圖、URL 和標題。只寫 write：可導航、點擊、填表、運行程序，但無法讀取頁面內容。啓用 on：完整讀寫權限。
- 安全機制：模型需具備網絡權限等級 4 才能啓動連接；非完整權限模式下，瀏覽器操作需經過 DSH 的
tools/pre-execute審批流程。
虛擬對話樹 (VTD)¶
VTD 允許在對話中創建和管理分支，無需複製粘貼到新會話。
- 分支操作：編輯或重試任意用戶消息會創建一個真實的子分支會話（
origin: vtd-fork），原線程保持不變。使用<N>選擇器可在分支間切換。 - 消息小版本：記錄
baseline/edit/retry/auto-switch等微版本，支持回溯。 - 實時渲染：流式生成時刷新率約 700ms，空閒時約 2.5s，自動滾動。
工程化工具¶
在 DSH 右側工具欄提供項目級操作。
- 運行 (Run)：自動尋找入口點（如
main、entry/run或.sln文件），使用 MSBuild 進行編譯和運行。 - 文件樹：顯示工作區文件結構，支持預覽和編輯。
- 快照與回退：對程序代碼進行快照備份。快照僅包含代碼文件。支持手動快照、回退（自動備份後）和刪除。
全局插件管理器¶
提供跨會話的插件管理能力。
- 多級啓用策略：插件具有 5 種級別：
全局啓用、對話AI可自行決定啓用、對話內AI需審批啓用、不再會有新啓用、全局禁用。 - 來源與安全：支持從運行中的對話提升插件、從商店搜索或導入 Manifest URL。支持直接下載或通過 AI 重寫源碼（
det_global_plugin_github_rebuild），重寫後的代碼不會被執行，僅用於安全檢查。 - 引導與防護：插件加載器支持熱插拔。內置 Boot Guard 機制，限制連續啓動失敗次數（默認 2 次），防止惡意插件導致系統無法啓動。
記憶層與審計¶
- MDA (Mixing Dialogue Agent)：提供
native、workspace和model分組記憶。 - CDM (Cross Dialogue Memory)：支持跨對話記憶的列表與搜索。
- 安全審計：提供審計日誌和安全開關。
使用說明¶
運行項目¶
在 DSH 右側工具欄點擊 ▶ 運行，插件會自動檢測 main、entry 或 .sln 文件，調用 MSBuild 進行編譯並啓動程序。
對話分支與重試¶
- 在對話中長按任意消息，選擇
編輯或重試。 - AI 修改內容後，會生成一個新的隱藏分支。
- 使用
<N>切換到該分支查看結果，原對話不受影響。
管理插件¶
- 在右側工具欄點擊
🧩 插件進入全局插件管理器。 - 使用
det_global_plugin_set_enabled切換插件啓用狀態，或使用det_global_plugin_github_rebuild從 GitHub 安全導入插件。
注意事項¶
- 零配置：插件在未配置項目路徑時即可運行對話樹、消息編輯等核心功能。
- 瀏覽器依賴：使用瀏覽器控制功能需要安裝擴展並確保
127.0.0.1:9123橋接正常工作。 - 權限等級：網絡權限等級必須達到 4 才能啓動瀏覽器控制功能。
- 快照範圍：程序快照僅包含代碼文件，不包含二進制輸出或環境配置。
