ACP UI 支持 Web 客户端！在浏览器中连接任何远程 ACP 代理

Source: Dev.to

概览

关于 ACP UI 副项目的快速更新：UI 现在可以直接在任何网页浏览器中运行。无需安装，也无需应用商店——只需打开 URL，即可通过 WebSocket 连接到任何远程兼容 ACP 的代理。

URL:

功能

• 连接到任何兼容 ACP 的代理（Copilot、Claude Code、Codex、Gemini、Qwen、Auggie、Qoder、OpenCode、OpenClaw 等）。
• 在桌面浏览器、移动浏览器、原生桌面应用、iOS 和 Android 上使用相同的 UI。
• 支持 ws://（局域网）和 wss://（任意网络）连接。
• 管理多个会话、切换代理模式、选择模型，并实时查看工具调用。
• 内置流量监视器，用于观察原始 ACP 协议以进行调试。
• $ /ping 心跳保持 WebSocket 在 NAT 和代理空闲超时期间仍然活跃。

平台

一个客户端，六个平台——相同的聊天、相同的会话、相同的代理。

连接选项

由于托管站点使用 HTTPS，浏览器会阻止普通的 ws:// 连接（混合内容规则）。请选择以下方式之一：

1. 简易（安全） – 为本地代理提供一个 wss:// URL。Microsoft Dev Tunnels 提供免费安全隧道。
2. 仅局域网 – 克隆仓库并在本地运行 npm run preview:web。随后通过 ws://<host>:3000/ 进行连接。

两种流程均在仓库中有文档说明。

架构

UI 使用 Vue 构建。相同的前端代码在以下环境中复用：

• Web – 在普通浏览器标签页中运行。
• Desktop – 使用 Tauri 打包，提供原生外壳和系统 WebView。
• Mobile – 使用 WKWebView（iOS）或 Android WebView。

Web 版本省略了本地子进程代码路径，全部通过 WebSocket 与远程代理通信。

源代码

• GitHub（MIT 许可证）：

欢迎提交 Issue、Pull Request 和星标。祝你在任何地方都能愉快地连接到喜欢的代理！