前言¶
DeepSeek Harness (DSH) 插件化生態強調按需擴展。在開發智能體或執行復雜任務時，本地環境擅長取證、代碼修改和測試，但高成本的推理任務往往需要調用外部模型。dsh-reasoning-bridge 插件解決這個分割問題：它把高成本推理交給網頁版 AI（默認 ChatGPT 網頁版，目標可切換；當前內置 chatgpt 與 arena），把取證、採納、修改、測試全部留在 dsh 本地。插件基於契約化 Context Packet / Reasoning Result 交接、版本化風險授權門、可執行的瀏覽器傳輸驅動和 SHA-256 運行回執。
核心功能¶
插件主要提供以下能力：
1. 推理與執行的分離：將高成本推理交給網頁版 AI，本地負責證據收集、方案採納、代碼修改和測試驗證。
2. 契約化交接：通過 Context Packet 和 Reasoning Result 進行結構化交接。
3. 版本化風險授權：首次運行前展示風險聲明，用戶顯式同意後寫入授權文件，非 READY 狀態下傳輸層會攔截操作。
4. 可執行的瀏覽器傳輸驅動：支持通過瀏覽器傳輸驅動與網頁 AI 交互，支持多目標（chatgpt, arena）。
5. SHA-256 運行回執：生成包含脫敏元數據、產物哈希和隱私審查字段的回執。
安裝與啓用¶
該插件依賴 DeepSeek Harness (dsh) 環境。安裝命令如下：
dsh plugin --profile web add dsh-reasoning-bridge
安裝完成後，重啓 dsh web 服務，技能目錄中會出現 reasoning-bridge。
典型用法¶
在 dsh 會話中直接發起任務，插件會自動處理推理請求與本地執行的交接：
$reasoning-bridge 從第一性原理診斷這個性能回退，驗證修復後交付。
$reasoning-bridge 審查這個架構決策，基於本地證據選定方案並完成實現。
約束與邊界¶
插件在代碼層面和流程層面設置了不同的約束，開發者需明確區分：
代碼機制（強制執行）¶
- 發送前拒絕未授權：
consent非READY時，open/probe/send/fetch/launch直接失敗。 - 只接受已支持目標：
--site必須是chatgpt或arena之一，否則報錯。 - 發送前拒絕疑似憑據：
send讀取 request 文件後進行憑據形狀掃描，命中即拒發（可用--allow-unscanned顯式放行）。 complete閘門復掃：不信任隱私審查的自述布爾，重新掃描 packet/result/evidence 內容。- 拒絕編碼繞過：非 UTF-8 的 request 文件先解碼再掃描。
- 不讀敏感 API：頁面表達式禁觸 Cookie、Storage 等敏感 API。
工作流紀律（非代碼機制）¶
- 採納門：網頁建議必須本地重開文件/符號取證後分類爲 accepted/rejected/deferred。插件無法攔截模型對
pwsh/edit/write的調用，最終是否遵守取決於模型是否照做。 - 語義隱私審查：正則掃描之外需人工判斷業務祕密，插件無法理解業務語義。
- 憑據掃描侷限性：僅基於形狀啓發式（如 PEM、JWT、API Key 形式），無法攔截被拆行、編碼或隱藏在散文中的業務祕密。
環境注意事項¶
- Windows 兜底啓動：dsh 內置
browser_launch僅支持 macOS。Windows 用戶需使用transport.mjs launch啓動專用獨立 profile，或手動配置 Chrome 調試端口。 - 版本號差異：資料中 README 封面顯示版本 0.4.0，package.json 顯示 0.5.0，安裝時請以實際環境爲準。
