65f81de52b
通过 4 阶段 workflow（分析 → 计划 → 重构 → 验证）将 3 个超大的 ACP 源文件拆分为 28 个模块化子文件，每个均严格小于 500 行，且完整保留 所有公共 API（barrel 模式重导出）。 变更概要： - packages/acp-link/src/server.ts: 1800 → 20 行（barrel），新增 11 个子模块 （server/types、payload-decode、permission-mode、runtime-state、dispatch、 handlers-agent、handlers-session、acp-client、client-send、start-server、 testing-internals） - src/services/acp/agent.ts: 1297 → 33 行（barrel），新增 9 个子模块 （agent/AcpAgent、sessionTypes、permissionMode、configOptions、promptQueue、 internalAccessors、createSessionMethod、sessionLifecycle、promptFlow） - src/services/acp/bridge.ts: 1516 → 29 行（barrel），新增 8 个子模块 （bridge/types、paths、contentBlocks、toolInfo、toolResults、modelUsage、 notifications、forwarding） 验证： - bun run precheck 全通过（typecheck + lint + 5851 tests） - ACP service tests: 176 pass / 0 fail - ACP link tests: 47 pass / 0 fail - 所有外部消费者（entry.ts、permissions.ts、__tests__/）的 import 路径不变 - 测试文件零修改 迁移计划详见 docs/acp-refactor-plan.md。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
acp-link
ACP proxy server that bridges WebSocket clients to ACP (Agent Client Protocol) agents.
Source code adapted from chrome-acp.
Installation
From source
# From monorepo root
bun install
Usage
# Via global install
acp-link /path/to/agent
# Via source
bun src/cli/bin.ts /path/to/agent
Examples
# Basic usage
acp-link /path/to/agent
# With custom port and host
acp-link --port 9000 --host 0.0.0.0 /path/to/agent
# With debug logging
acp-link --debug /path/to/agent
# Enable HTTPS with self-signed certificate
acp-link --https /path/to/agent
# Disable authentication (dangerous)
acp-link --no-auth /path/to/agent
# Register to RCS with a specific channel group
acp-link --group my-team /path/to/agent
# Pass arguments to the agent (use -- to separate)
acp-link /path/to/agent -- --verbose --model gpt-4
CLI Reference
USAGE
acp-link [--port value] [--host value] [--debug] [--no-auth] [--https] [--group value] <command>...
acp-link --help
acp-link --version
FLAGS
[--port] Port to listen on [default = 9315]
[--host] Host to bind to [default = localhost]
[--debug] Enable debug logging to file
[--no-auth] Disable authentication (dangerous)
[--https] Enable HTTPS with self-signed cert
[--group] Channel group ID for RCS registration (letters, digits, hyphens, underscores only)
-h --help Print help information and exit
-v --version Print version information and exit
ARGUMENTS
command... Agent command followed by its arguments
How It Works
- Listens for WebSocket connections from clients
- When a "connect" message is received, spawns the configured ACP agent as a subprocess
- Bridges messages between the WebSocket (client) and stdin/stdout (agent via ACP protocol)
- Supports session management: create, load, resume, list sessions
- Handles permission approval flow and heartbeat keepalive
Authentication
By default, a random token is auto-generated on startup. Connect to the WebSocket endpoint without putting the token in the URL:
ws://localhost:9315/ws
Set ACP_AUTH_TOKEN env var to use a fixed token, or use --no-auth to
disable (not recommended). Clients that cannot send an Authorization header
must send the token in a WebSocket subprotocol named
rcs.auth.<base64url-token>.
RCS Upstream
acp-link can register to a Remote Control Server (RCS) for remote access. Set the following environment variables:
| Variable | Description |
|---|---|
ACP_RCS_URL |
RCS server URL (e.g. http://rcs.example.com:3000) |
ACP_RCS_TOKEN |
API token for RCS authentication |
ACP_RCS_GROUP |
Channel group ID to lock the agent into (letters, digits, -, _ only) |
You can also use --group <id> on the CLI. The CLI flag takes priority over the env var.
Manager UI
通过 --manager flag 启动独立的管理服务（不启动代理）：
# 启动 Manager（默认端口 9315）
acp-link --manager
# 指定端口
acp-link --manager --port 3210
在浏览器打开 http://localhost:<port> 即可访问管理界面，创建、停止、删除多个 acp-link 子进程实例并实时查看日志。
通过 Manager UI 创建的子进程会自动跳过 Manager UI。
License
MIT