前言¶
在本地开发中，通过终端直接操作 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 的浏览器生态。通过统一的键盘快捷键、权限管理和会话视图，它提供了一种不离开浏览器即可管理本地智能体的工作流。
