Arena 本地桥接 analystsandeep/Opencode-Arena

Opencode Arena

一个本地 OpenAI 兼容桥接服务，让 OpenCode 桌面应用通过你自己已登录的浏览器会话，在 Windows 上使用 Arena Direct Chat 模型。这是个人软件：除了你在自己浏览器里通过 Arena 发送的内容，其他数据都不会离开你的电脑。

概述

桥接服务在 localhost（127.0.0.1:47147）上运行一个小型 HTTP 服务器，使用 OpenAI chat completions 协议。OpenCode 向它发送请求，桥接服务则用你已登录的 Arena 会话，在真实安装的浏览器（Microsoft Edge 或 Google Chrome，通过 Playwright 驱动）里操作 Arena 网站。你的 Arena 登录信息用 Windows DPAPI 加密，只保存在这台电脑上。

支持两种对话通道：

- Arena Agent（AI 智能体模式），通过 Arena 智能体页面。
- Arena Max Direct Chat，只通过页面上可见的控件驱动，包括具名的 Direct Chat 模型，例如 arena-max:gemini-3-flash。

本地 DeepSeek Harness 文本工具在你的电脑上运行。Arena 自带的云端工具（网页搜索、浏览器、云 shell 与代码执行、文件工具、连接器）在 Arena 云端运行，可用于不需要访问你文件的工作。

功能

- 仅限 localhost 的 OpenAI 兼容 /v1/models 和 /v1/chat/completions（支持流式与非流式）
- 每个 /v1 路由都做本地 bearer token 认证
- 使用你自己的 Arena 账号建立真实浏览器会话；不需要 API key，也不用粘贴 token
- 保存的会话用 Windows DPAPI 加密
- 本地工具协议：围栏 JSON 工具调用由 DeepSeek Harness 智能体在本地执行
- 本地控制面板，用于登录和选择 Direct Chat 模型
- Windows 安装脚本：Install.cmd、Arena Login.cmd、Check Arena.cmd、Start Arena Bridge.cmd、Stop Arena Bridge.cmd、Uninstall.cmd
- 离线测试套件和离线自检

前置条件

- Windows 10 或 11
- Node.js 22.19.0 或更新版本
- 已安装 Microsoft Edge 或 Google Chrome
- 一个 Arena 账号
- OpenCode 桌面应用

安装

1. 下载或克隆本项目。
2. 双击 Install.cmd。它会安装依赖（npm ci）、运行离线自检，并把 arena 服务商加入你的 OpenCode 配置（%USERPROFILE%\.config\opencode\opencode.json）。该服务商使用 OpenCode 的 {file:...} token 间接引用，从 %USERPROFILE%\.opencode-arena\bridge-token 读取桥接 token，因此 token 本身永远不会写进 OpenCode 配置文件。
3. 双击 Arena Login.cmd，在浏览器窗口里登录你的 Arena 账号。任何验证都由你自己完成；桥接服务绝不会替你点击登录框。
4. 双击 Check Arena.cmd，确认登录、加密会话存储和模型访问都正常。
5. 如果 OpenCode 正在运行，重启它。

配置

桥接服务在 http://127.0.0.1:47147/v1 上处理请求。端口保存在 %USERPROFILE%\.opencode-arena\bridge.json。

可选环境变量：

| 变量 | 含义 |
| OPENCODE_ARENA_HOME | 存放 token、已保存会话和日志的状态目录（默认 %USERPROFILE%\.opencode-arena） |
| DSH_PROFILE_DIR | Playwright 使用的浏览器配置档目录（默认 %OPENCODE_ARENA_HOME%\profiles\web） |
| ARENA_BROWSER_TESTS | 设为 1 可运行浏览器测试组 |
| ARENA_BROWSER_CHANNEL | 浏览器测试使用的浏览器通道，例如 chrome 或 msedge |

可复制的模板见 .env.example。.env 文件本身已加入 gitignore。

用法

1. 双击 Start Arena Bridge.cmd。使用 OpenCode 期间保持窗口打开。
2. 在 OpenCode 中，与 Arena 服务商开始聊天。模型选择器会显示 Arena Agent（AI 智能体模式）和 Arena Max Direct Chat 模型。
3. 照常发送消息。本地工具请求会以围栏 JSON 块的形式出现，桥接程序会校验这些请求并在本地执行。
4. 停止：关闭桥接窗口，或双击 Stop Arena Bridge.cmd。
5. 从 OpenCode 中移除服务商：双击 Uninstall.cmd。已保存的登录信息和 token 会保留，除非你选择清除它们。

开发命令

npm test Run the offline test suite
node tools/self-check.mjs Offline module and configuration checks
npm run bridge Start the bridge manually
npm run benchmark Run the local SSE / page benchmark

测试使用 Node 内置的测试运行器。浏览器测试需手动开启：

ARENA_BROWSER_TESTS=1 ARENA_BROWSER_CHANNEL=chrome node --test test/*.test.mjs

安全

- 桥接程序只绑定 127.0.0.1，并拒绝不带本地 bearer token 的请求。
- 提示词、token 和回复都不会写入日志；活动日志只记录大小。
- Arena 会话在当前 Windows 账户下用 Windows DPAPI 加密，且从不显示。
- 桥接程序绝不会替你完成验证、条款或登录框。
- 不要与任何人分享桥接 token、已保存会话或你的 Arena 登录信息。

许可证

MIT