# ACP Bridge > packages/acp-bridge/ 负责守护进程 HTTP 层与 ACP 子进程之间的边界。它被 packages/cli/src/serve/（即 qwen serve 守护进程）消费，并在 #4175 F1 第 3 步中被提取出来… - 网址：https://funcoding.ai/agents/qwen-code/developers/daemon/03-acp-bridge/ - 来源：Qwen Code 官方文档原文（中文），Apache-2.0 许可，同步于 2026-10-11 - 官方原文：https://qwenlm.github.io/qwen-code-docs/zh/developers/daemon/03-acp-bridge --- ## 概述 `packages/acp-bridge/` 负责守护进程 HTTP 层与 ACP 子进程之间的边界。它被 `packages/cli/src/serve/`（即 `qwen serve` 守护进程）消费，并在 #4175 F1 第 3 步中被提取出来，以便未来的消费者（如 `channels/base/AcpBridge.ts`、VS Code IDE 伴侣插件）能够使用相同的 bridge 核心，而无需深入 CLI 包。 每个活跃的 `WorkspaceRuntime` 拥有一个 `HttpAcpBridge` 实例。生产环境会尝试预热受信任的主子进程以保证兼容性；受信任的次级运行时在首个运行时命令或 Session 时打开其 `AcpChannel`，不受信任的次级运行时无法启动 ACP。遗留主路由保留其现有的兼容性行为。在 runtime 内部，bridge 通过 channel 提供多路复用的 session、每个 session 的 `EventBus`、一个 `MultiClientPermissionMediator`、一个 `BridgeFileSystem` 适配器，以及面向 ACP 的辅助函数（`spawnOrAttach`、`loadSession`、`resumeSession`、`sendPrompt`、`cancelSession`、`respondToPermission`，以及用于 workspace 状态和 MCP 重启的 extMethod RPC）。Bridge 和子进程绝不会在 workspace runtime 之间共享。 ## 职责 - 通过可插拔的 `ChannelFactory` 启动或附加到 ACP 子进程。默认 factory：`defaultSpawnChannelFactory`（子进程 `qwen --acp`）。测试中注入 `inMemoryChannel`。 - 维护 `aliveChannels`（channel 注册表）和 `byId`（session 注册表）。 - 通过 `connection.newSession()` 将 N 个 HTTP 侧 session 多路复用到一个 ACP 子进程上。 - 通过 `promptQueue` 序列化每个 session 的 prompt（ACP 强制每个 session 只能有一个活跃的 prompt）。 - 为 `setSessionModel` 调用提供每个 session 的 FIFO 队列，防止使用不同模型的并发附加操作与 agent 产生竞争。 - 每个 session 的 `EventBus` 驱动 `GET /session/:id/events`（参见 [`10-event-bus.md`](https://funcoding.ai/agents/qwen-code/developers/daemon/10-event-bus/)）。 - 权限流程：`BridgeClient.requestPermission` → `MultiClientPermissionMediator.request` → 扇出（fan-out） → 投票收集 → ACP 响应（参见 [`04-permission-mediation.md`](https://funcoding.ai/agents/qwen-code/developers/daemon/04-permission-mediation/)）。 - 文件 I/O：`BridgeFileSystem` 适配器用于处理 ACP 的读取和写入；同主机 daemon runtime 会广播 `readTextFile: false`，使常规文本读取留在子进程中，而最终的文本写入仍通过委托完成（参见 [`07-workspace-filesystem.md`](https://funcoding.ai/agents/qwen-code/developers/daemon/07-workspace-filesystem/)）。 - 用于 workspace 级别状态（`/workspace/mcp`、`/workspace/skills`、`/workspace/providers`）、MCP 重启以及可选的私有托管 Tool Guard 回调的 extMethod RPC。 - 生命周期：优雅的 `shutdown()`，每个 channel 的超时时间为 `KILL_HARD_DEADLINE_MS`（10 秒）；同步的 `killAllSync()` 用于二次信号强制退出。 ## 架构 **公共入口**：`packages/acp-bridge/src/bridge.ts` 中的 `createHttpAcpBridge(opts: BridgeOptions): HttpAcpBridge`。 **核心类型**： | 类型 | 文件 | 角色 | | ------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `HttpAcpBridge` | `bridgeTypes.ts` | 公共接口：`spawnOrAttach`、`loadSession`、`resumeSession`、`sendPrompt`、`cancelSession`、`subscribeEvents`、`respondToPermission`、`getWorkspaceMcpStatus`、`restartMcpServer`、`shutdown`、`killAllSync` 等。 | | `BridgeSession` | `bridgeTypes.ts` | 返回给 HTTP handler 的 `{ sessionId, workspaceCwd, attached, clientId?, createdAt? }`。 | | `BridgeOptions` | `bridgeOptions.ts` | 构造时配置（参见[配置](#配置)）。 | | `AcpChannel` | `channel.ts` | `{ stream, kill(), killSync(), exited }` — 单个 ACP NDJSON channel。 | | `ChannelFactory` | `channel.ts` | `(workspaceCwd, childEnvOverrides?) => Promise`。 | | `BridgeClient` | `bridgeClient.ts` | 封装单个 ACP `ClientSideConnection`；实现 ACP `Client`（`requestPermission`、`readTextFile`、`writeTextFile`、`sessionUpdate`、`extNotification`）。 | | `EventBus` | `eventBus.ts` | 每个 session 的内存中发布/订阅。参见 [`10-event-bus.md`](https://funcoding.ai/agents/qwen-code/developers/daemon/10-event-bus/)。 | | `MultiClientPermissionMediator` | `permissionMediator.ts` | 四策略 mediator。参见 [`04-permission-mediation.md`](https://funcoding.ai/agents/qwen-code/developers/daemon/04-permission-mediation/)。 | **内部状态（由 `createHttpAcpBridge` 闭包捕获）**： | 状态 | 类型 | 用途 | | --------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `aliveChannels` | `Map` | 以 channel id 为键的 channel 注册表。每个 `ChannelInfo` 包含 `channel`、`connection`、`client`（每个 channel 一个 `BridgeClient`）、`sessionIds: Set`、`pendingRestoreIds`、`statusClosedReject?`、`isDying: boolean`。 | | `byId` | `Map` | 以 sessionId 为键的 session 注册表。每个 `SessionEntry` 包含 `channel`、`connection`、`events: EventBus`、`promptQueue: Promise`、`modelChangeQueue: Promise`、`pendingPermissionIds: Set`、`clientIds: Map`、`activePromptOriginatorClientId?`、`attachCount`、`spawnOwnerWantedKill`、`restoreState?`、`sessionLastSeenAt?`、`clientLastSeenAt: Map`。 | | `defaultEntry` | `SessionEntry \| null` | 当 `sessionScope: 'single'` 时使用的“单一” session。 | | `defaultPolicy` | `PermissionPolicy` | 通过 `BridgeOptions.permissionPolicy` 配置。 | | `mediator` | `MultiClientPermissionMediator` | 每个 bridge 实例一个。 | | Constants | — | `DEFAULT_INIT_TIMEOUT_MS = 10_000`、`MCP_RESTART_TIMEOUT_MS = 300_000`、`DEFAULT_MAX_SESSIONS = 32`、`MAX_EVENT_RING_SIZE = 1_000_000`、`DEFAULT_PERMISSION_TIMEOUT_MS = 0`、`DEFAULT_MAX_PENDING_PER_SESSION = 64`。 | **`isDying` 不变量**：任何 teardown 路径都必须在 await `channel.kill()` **之前**同步设置 `ChannelInfo.isDying = true`。`ensureChannel` 将 dying channel 视为不存在并生成一个新的。如果没有这个标志，在 SIGTERM 宽限期（最长 10 秒）内到达的并发 `spawnOrAttach` 将会附加到一个即将关闭的 transport 上，并且调用者的 sessionId 在后续每次操作中都会返回 404。Teardown 包括初始化失败、空 channel 生成失败、workspace 空闲过期和 shutdown；关闭最后一个 Session 仅释放其租约并调度 workspace 空闲策略。 **`channelInfo` 保留不变量**：在设置 `isDying = true` 时**不要**清除 `channelInfo`。`killAllSync` 在 SIGTERM 宽限期内仍必须能找到该 channel，以便在 `process.exit(1)` 时触发 SIGKILL。`aliveChannels` 会保留 dying 条目，直到 `channel.exited` 触发。 **BridgeClient 有界缓冲**：到达 `BridgeClient` 的 ACP `extNotification` 帧，如果其 sessionId 尚未在 `byId` 中（因为 `connection.newSession` 的响应尚未返回，但 `newSession` 内部的 MCP 发现已经触发了预算事件），将被缓冲到一个早期事件队列中。该队列受 `MAX_EARLY_EVENT_SESSIONS = 64` × `MAX_EARLY_EVENTS_PER_SESSION = 32` × `EARLY_EVENT_TTL_MS = 60_000` 限制。最坏情况下大约占用 400 KB 堆内存。如果没有缓冲，新 session 的第一个 SSE 重放环槽位将会丢失在其创建期间触发的事件。 ## 工作流 ### `spawnOrAttach`（主入口） ```mermaid sequenceDiagram autonumber participant R as 路由 handler participant B as createHttpAcpBridge 闭包 participant CF as ChannelFactory participant CH as AcpChannel participant ACP as ACP 子进程 participant M as Mediator R->>B: spawnOrAttach({cwd?, sessionScope?, clientId?}) B->>B: 验证 cwd 与 boundWorkspace
(WorkspaceMismatchError) alt sessionScope=single 且 defaultEntry 存在 B->>B: 增加 attachCount
注册 clientId B-->>R: {sessionId, attached: true, restoreState?} else 冷路径 B->>CF: factory(workspaceCwd, childEnvOverrides) CF->>ACP: 启动 qwen --acp + pipes CF-->>B: AcpChannel B->>ACP: ACP initialize (timeout=DEFAULT_INIT_TIMEOUT_MS) ACP-->>B: initialize 响应 B->>ACP: connection.newSession({cwd}) ACP-->>B: {sessionId} B->>B: 构建 SessionEntry
注册到 byId / defaultEntry B-->>R: {sessionId, attached: false} end ``` 关键点： - 当 `sessionScope='single'` 且存在 `defaultEntry` 时，仅增加 `attachCount`，注册 `clientId`，并返回 `attached: true`。 - 冷路径运行 ChannelFactory，执行 ACP `initialize`（`DEFAULT_INIT_TIMEOUT_MS=10s`），调用 `connection.newSession({cwd})`，然后注册新的 `SessionEntry`。 - 当 `byId.size >= maxSessions` 时抛出 `SessionLimitExceededError`。 - 如果 `X-Qwen-Client-Id` 不在 `[A-Za-z0-9._:-]{1,128}` 范围内，则抛出 `InvalidClientIdError`。 - `server.ts` 中的断连清理器通过 `attachCount`/`spawnOwnerWantedKill` 跟踪 spawn 所有者，以避免在 spawn 所有者断连但其他客户端已附加时 teardown session（参见 #3889 BQ9tV）。 ### Prompt 序列化 ```mermaid sequenceDiagram autonumber participant R as Route participant E as SessionEntry participant Q as promptQueue (FIFO) participant BC as BridgeClient participant ACP as ACP 子进程 R->>E: sendPrompt(sessionId, body, clientId) E->>E: 设置 activePromptOriginatorClientId = clientId E->>Q: 链接到已解析的尾部 Q->>BC: client.sendPrompt(sessionId, body) BC->>ACP: ACP prompt JSON-RPC ACP-->>BC: 响应（可能在多次 requestPermission 往返之后） BC-->>E: result E->>E: 清除 activePromptOriginatorClientId E-->>R: result ``` 队列尾部的失败会被**吞没（swallowed）**，这样前一个 prompt 的拒绝不会污染后续的 prompt；原始调用者仍会在其返回的 promise 中收到拒绝。缓存在 session 上的 `transportClosedReject` 会让 prompt promise 与 `channel.exited` 竞争，因此崩溃的子进程会立即暴露，而不是挂起。 ### 权限流程（高层） ```mermaid sequenceDiagram autonumber participant ACP as ACP 子进程 (agent) participant BC as BridgeClient.requestPermission participant E as SessionEntry participant M as Mediator participant EB as EventBus ACP->>BC: requestPermission(requestId, options) BC->>E: 在 pendingPermissionIds 中记录 requestId BC->>M: request({requestId, sessionId, originatorClientId, allowedOptionIds}, timeoutMs) M->>EB: 发布 permission_request（扇出到订阅者） Note over M: 等待投票 / 超时 / 取消 M-->>BC: PermissionResolution BC-->>ACP: RequestPermissionResponse（已选择或已取消） BC->>E: 清除 requestId ``` 在 mediator 之前，如果 wire 投票试图通过普通的 `optionId` 字段注入 `CANCEL_VOTE_SENTINEL`，则会抛出 `InvalidPermissionOptionError` — 该 sentinel 是 bridge 唯一的逃生舱，用于将请求短路为 `cancelled / agent_cancelled`，绝不能意外地从 wire 访问。参见 [`04-permission-mediation.md`](https://funcoding.ai/agents/qwen-code/developers/daemon/04-permission-mediation/)。 ### Shutdown ```mermaid sequenceDiagram autonumber participant Op as runQwenServe participant B as Bridge participant CHs as Channels participant M as Mediator Op->>B: shutdown() B->>CHs: 标记每个 ChannelInfo isDying = true（批量） B->>M: 为每个 sessionId 调用 forgetSession（pending → cancelled/session_closed） par 每个 channel B->>CHs: channel.kill()（最多 await KILL_HARD_DEADLINE_MS = 10s） CHs-->>B: exited end B-->>Op: done Note over Op,B: 第二次信号 → killAllSync()
（同步向每个存活的子进程触发 SIGKILL） ``` ## Channel factory `AcpChannel`（`channel.ts`）是 bridge 的 transport 抽象。生产环境使用 `spawnChannel.ts` 中的 `defaultSpawnChannelFactory`，它将 `qwen --acp` 作为子进程运行，并带有一对 stdio pipe。测试注入 `inMemoryChannel` 以在进程内运行 agent。bridge 对底层机制一无所知 — 它只需要 `{ stream, kill, killSync, exited }`。 `ChannelFactory` 接受 `childEnvOverrides`，因此每个守护进程句柄都可以传递自己的 MCP 预算环境变量（`QWEN_SERVE_MCP_CLIENT_BUDGET`、`QWEN_SERVE_MCP_BUDGET_MODE`），而无需修改 `process.env`（当两个嵌入式守护进程在同一个 Node 进程中运行时，修改 `process.env` 会产生竞争）。 ## 状态与生命周期 - Bridge 构造是同步的。调用者可以在第一个 session 之前预热 channel；否则第一次 `spawnOrAttach` 会冷启动 ACP 子进程。预热失败后，首次使用时可以自由重试。 - `defaultEntry` 是 `sessionScope: 'single'` 下可复用的逻辑 Session。Session 关闭仅移除其 Session 租约。在所有 Session、恢复、workspace 控制、发现、认证和运行时操作工作 drain 完毕且没有显式 ensure 保活窗口待处理后，省略或为零的 `channelIdleTimeoutMs` 会立即回收子进程。单纯的预热会为首次使用保留，且不会单独触发该立即回收器。正值或活跃的保活窗口会延迟回收；剩余延迟时间越长优先级越高。 - `MAX_EVENT_RING_SIZE = 1_000_000` 是 `BridgeOptions.eventRingSize` 的软上限，用于在导致每个 session 约 500 MB 的 OOM 之前捕获操作员的拼写错误。 - `DEFAULT_PERMISSION_TIMEOUT_MS = 0` 默认允许人工权限处理和提问无限期等待。`permissionResponseTimeoutMs` 在运维人员需要时启用挂钟上限；投票者取消、会话取消和关闭在不使用它时仍然可用。 - `DEFAULT_MAX_PENDING_PER_SESSION = 64` 镜像了 `DEFAULT_MAX_SUBSCRIBERS`；超出的 `requestPermission` 调用会被解析为 cancelled，并附带 stderr 警告。 ## 依赖 | 上游 | 下游 | | -------------------------------------------------------------------------------------------- | ---------------------------------------------- | | `@agentclientprotocol/sdk` — `ClientSideConnection`、`PROTOCOL_VERSION`、ACP 类型 | `packages/cli/src/serve/`（守护进程） | | `@qwen-code/qwen-code-core` — `ApprovalMode`、`TrustGateError` | `packages/channels/base/`（计划中，F4） | | `node:crypto`、`node:fs`、`node:path` | `packages/vscode-ide-companion/`（计划中，F4） | ## 配置 `BridgeOptions`（`bridgeOptions.ts`）： | 键 | 默认值 | 用途 | | --------------------------------------------- | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | `boundWorkspace` | （必填） | bridge 强制执行的规范 workspace 路径。 | | `sessionScope` | `'single'` | `'single'` 在所有客户端之间共享一个 session；`'thread'` 为每个对话线程创建独立的 session。 | | `channelFactory` | `defaultSpawnChannelFactory` | 可插拔的 ACP 子进程 factory。 | | `initializeTimeoutMs` | `DEFAULT_INIT_TIMEOUT_MS = 10_000` | ACP `initialize` 握手超时时间。 | | `sessionRestoreTimeoutMs` | `60_000` | ACP `loadSession` / `unstable_resumeSession` 超时时间；默认 60 秒，显式配置的 initialize 超时可以提高但不能降低此值。 | | `maxSessions` | `DEFAULT_MAX_SESSIONS = 32` | `byId.size` 的上限。`0` / `Infinity` = 无限制；NaN/负数会抛出异常。 | | `eventRingSize` | `DEFAULT_RING_SIZE`（来自 `eventBus.ts`） | 每个 session 的事件环；软上限为 `MAX_EVENT_RING_SIZE`。 | | `permissionResponseTimeoutMs` | `DEFAULT_PERMISSION_TIMEOUT_MS = 0` | mediator 的每个请求挂钟上限；`0` 禁用。 | | `maxPendingPermissionsPerSession` | `DEFAULT_MAX_PENDING_PER_SESSION = 64` | 针对高并发 agent 的背压控制。 | | `childEnvOverrides` | `{}` | 每个句柄为 ACP 子进程添加/清理的环境变量。 | | `externalToolGuard` | （无） | 可选的私有子进程到父进程的预执行决策处理器。Bridge 仅接受来自当前活跃 Prompt 所属 channel 的该处理器。 | | `persistApprovalMode`、`persistDisabledTools` | — | Wave 4 mutation 路由的设置写入钩子。 | | `statusProvider` | （无） | 守护进程宿主预检单元（`DaemonStatusProvider`）。 | | `delegateReadTextFileToClient` | `true` | 仅对同主机 runtime 设为 `false`，使子进程的所有 `FileSystemService.readTextFile` 消费者使用常规 CLI 文件系统服务。 | | `fileSystem` | （无） | 用于 ACP `readTextFile` / `writeTextFile` 的 `BridgeFileSystem` 适配器。 | | `permissionPolicy` | 来自 `settings.json` 的 `policy.permissionStrategy` | `first-responder` / `designated` / `consensus` / `local-only` 之一。 | | `permissionConsensusQuorum` | 来自 `settings.json` | consensus 策略的 N 值。 | | `permissionAudit` | `createNoOpPermissionAuditPublisher()` | 连接到 `PermissionAuditRing` 以获取审计跟踪。 | | `channelIdleTimeoutMs` | `0` | 自动回收延迟；单纯预热在其首次状态读取后存活，且活跃保活可能延长它。 | 超时的 restore 在当前 ACP SDK 中不可取消。因此 bridge 会保持结算围栏和容量准入，直到真实请求结算或其 transport 关闭。迟到的结果仅会被精确关闭一次且不会被注册。清理不确定性仅隔离该 workspace 上的新 session 工作；现有的 session 和 workspace 控制流量继续运行，直到 channel drain 并被回收。 ## 额外的 bridge 方法 除了核心的 `spawnOrAttach`、`sendPrompt`、`cancelSession`、`respondToPermission`、`loadSession` 和 `resumeSession` 调用外，`HttpAcpBridge` 接口现在还包括以下面向 daemon 的辅助方法： | 方法 | 用途 | | ------------------------------------------------------------ | --------------------------------------------- | | `generateSessionRecap(sessionId, context?)` | 生成单行会话摘要。 | | `generateSessionBtw(sessionId, question, signal?, context?)` | 回答旁支问题 / btw 提示。 | | `executeShellCommand(sessionId, command, signal?, context?)` | 在 daemon 主机上运行 shell 命令。 | | `getSessionContextUsageStatus(sessionId, opts?)` | 返回上下文窗口使用情况。 | | `getSessionSupportedCommandsStatus(sessionId)` | 返回可用的斜杠命令。 | | `getSessionTasksStatus(sessionId)` | 返回后台任务快照。 | | `getSessionStatsStatus(sessionId)` | 返回会话使用统计信息。 | | `setSessionApprovalMode(sessionId, mode, opts, context?)` | 更新会话的审批模式。 | | `detachClient(sessionId, clientId?)` | 显式分离客户端。 | | `addRuntimeMcpServer(name, config, originatorClientId)` | 在运行时添加 MCP 服务器。 | | `removeRuntimeMcpServer(name, originatorClientId)` | 在运行时移除 MCP 服务器。 | | `manageMcpServer(serverName, action, originatorClientId)` | 启用 / 禁用 / 认证 / 清除认证。 | | `generateWorkspaceAgent(description, originatorClientId)` | 使用 AI 生成子代理定义。 | | `preheat()` | 在第一个会话之前预热 ACP 子进程。 | | `getSessionLastEventId(sessionId)` | 读取会话的单调递增事件 ID。 | | `getWorkspaceToolsStatus()` | 返回内置工具注册表快照。 | | `getWorkspaceMcpToolsStatus(serverName)` | 返回特定 MCP 服务器的工具。 | `BridgeSpawnRequest.sessionScope` 已从 `'per-client'` 重命名为 `'thread'`。`BridgeRestoredSession` 现在包含 `compactedReplay`、`liveJournal` 和 `lastEventId`。这些重放字段是活跃会话的有界内存窗口，上限由 `BridgeOptions.compactedReplayMaxBytes`（默认 4 MiB，硬上限 256 MiB）控制。正在进行的 `liveJournal` 由 `BridgeOptions.maxJournalEvents`（默认 10 000 条重放条目）和 `BridgeOptions.maxJournalBytes`（默认 8 MiB 的序列化源事件）单独限制。连续的兼容文本或思考 chunk 共享一个重放条目，每个条目最多 256 个源事件；其他事件和归属边界保持不变。如果较旧的保留重放被丢弃，`compactedReplay[0]` 是无 id 的 `history_truncated` 标记；如果日志条目被丢弃，`liveJournal[0]` 携带 `scope: 'live_journal'` 的 `history_truncated` 标记。其 retained 和 truncated 计数描述的是源事件，而非重放条目。完整的持久化转录保留在磁盘上，不由此 bridge 响应暴露。 `BridgeClientRequestContext` 是贯穿 bridge 调用的请求上下文；它包含 `clientId`、`fromLoopback: boolean` 和 `promptId`。 ## 注意事项与已知限制 - `MCP_RESTART_TIMEOUT_MS = 300_000`（5 分钟）—— `/workspace/mcp/:server/restart` 的 bridge 超时时间故意设置得较长，因为对于 stdio 服务器，`McpClientManager.MAX_DISCOVERY_TIMEOUT_MS` 最长可达 5 分钟。较短的截止时间会导致误报超时，而此时 ACP 子进程仍在后台持续重连。 - `BridgeOptions.eventRingSize > 1_000_000` 会在构造时抛出异常。 - `connection.unstable_resumeSession` 通过稳定的 `session_resume` daemon 能力暴露；`unstable_session_resume` 仍作为已弃用的兼容别名提供给旧版 SDK。客户端应进行特性检测以使用 `session_resume`。 - bridge 包为 `@qwen-code/acp-bridge`。当前代码直接从包的子路径导入 event-bus 和 status 基础组件；`serve/acp-session-bridge.ts` 仍作为 CLI 本地的兼容门面，用于支持更广泛的 bridge 接口。 ## 参考资料 - `packages/acp-bridge/src/bridge.ts`（特别是第 350 行及之后的 `createHttpAcpBridge`） - `packages/acp-bridge/src/bridgeClient.ts` - `packages/acp-bridge/src/bridgeTypes.ts` - `packages/acp-bridge/src/bridgeOptions.ts` - `packages/acp-bridge/src/channel.ts` - `packages/acp-bridge/src/spawnChannel.ts` - `packages/acp-bridge/src/bridgeErrors.ts` - 相关 Issue：[#3803](https://github.com/QwenLM/qwen-code/issues/3803)、[#4175](https://github.com/QwenLM/qwen-code/issues/4175)。