前言¶
在本地開發中，通過終端直接操作 Claude Code 或 Codex 是常見場景。然而，DeepSeek Harness（DSH）主要提供瀏覽器端的控制界面。頻繁在瀏覽器和終端之間切換，會打斷開發心流。
dsh-plugin-local-agent-bridge 插件解決了這個問題。它將本地已安裝的 Claude Code 和 Codex 會話引入 DSH 的瀏覽器 UI，讓你在同一個界面中管理所有操作，無需離開瀏覽器。
插件定位¶
這是一個由用戶 Leshm0321 維護的客戶端插件，提供 DeepSeek Harness 瀏覽器控制面，用於控制 Host 上的原生 Codex 和 Claude Code 會話。
核心價值¶
插件不充當 LLM 適配器，也不調用模型的 HTTP API。它通過本地進程橋接，讓瀏覽器作爲 UI 界面，而實際的認證和執行都在 Host 終端完成。
核心功能¶
插件在瀏覽器端提供了以下能力：
- 統一面板管理：側邊欄出現
Local Agents入口，按工作目錄管理會話。 - 鍵盤操作流：支持
Enter發送、Shift+Enter換行、↑回看歷史消息、Esc中斷當前回合。 - 權限模式控制：提供 Auto、Manual、Accept edits、Plan、Bypass 五種權限模式，映射到原生產品的實際支持範圍。
- 可展開的執行詳情：支持展開工具調用和思考過程，查看每一步的輸入輸出。
- 上下文監控：當會話過長時，會顯示上下文使用警告。
- 原生工具批准：瀏覽器會彈出與終端一致的原生工具批准提示，而非寫入配置文件。
- 會話續接與切換：可以在瀏覽器中繼續終端中的會話，或在同一臺機器、同一目錄下切換使用 Claude Code 或 Codex。
- 界面一致性：支持多語言，並跟隨 Harness 的主題（亮色/暗色）。
安裝與啓用¶
安裝前請確保已安裝 DeepSeek Harness 的內置 web profile。
使用官方命令安裝¶
執行以下命令將插件添加到 web profile：
dsh plugin --profile web add github:Leshm0321/dsh-plugin-local-agent-bridge
驗證安裝¶
安裝完成後，可以通過以下命令檢查配置是否生效：
dsh --profile web --dump-config
啓動 Harness web 界面：
dsh web
典型用法¶
完成安裝後，按以下步驟開始使用：
- 確認環境：在啓動 Harness 的終端中確認
claude --version和codex --version命令可用。 - 打開面板：在瀏覽器界面左側找到
Local Agents入口。 - 添加工作目錄：
- 在面板中輸入 Host 上的絕對路徑。
- 或點擊
Browse…按鈕選擇目錄。
- 創建會話：
- 選擇產品（Claude Code 或 Codex）。
- 選擇對應目錄。
- 點擊
Create session。
環境要求與注意事項¶
插件對 Host 環境有特定依賴，且存在安全邊界。
系統要求¶
- DeepSeek Harness：需 0.1.6-alpha.2 或以上。
- Node.js：^22.19.0 或 >=24.0.0。
- pnpm：11.7.0。
- Claude Code：>=2.1.220 <2.2.0（可選）。
- Codex：>=0.147.0 <0.156.0（可選）。
- 操作系統：Windows 10/11 x64, macOS 13+, Linux x64/arm64。
安全與權限¶
- 無憑證傳輸：瀏覽器永遠不會登錄 Anthropic 或 OpenAI，也從不接收供應商 cookies、OAuth 令牌、API 密鑰或原生會話標識符。所有認證和執行均在 Host 的終端進程中進行。
- 版本兼容：默認拒絕不支持或無法識別的產品版本。插件會列出已安裝版本和允許的範圍，可以通過本地配置覆蓋
allowExperimentalVersions（但這不構成官方兼容性聲明）。
限制¶
- 必須登錄：Host 上必須已安裝並登錄 Claude Code 或 Codex，插件沒有登錄界面。
- pnpm 限制：如果直接通過 Git URL 安裝，pnpm 需要在配置文件中添加對應的 commit hash 到
allowBuilds列表。 - 僅限 Web Profile：必須使用內置的
webprofile，否則不會顯示瀏覽器 UI。
總結¶
dsh-plugin-local-agent-bridge 允許你將 Claude Code 和 Codex 的本地執行能力接入 DeepSeek Harness 的瀏覽器生態。通過統一的鍵盤快捷鍵、權限管理和會話視圖，它提供了一種不離開瀏覽器即可管理本地智能體的工作流。
