acp-bridge：面向隔离网络的开源 ACP 本地 AI 编程适配器

acp-bridge 是一款基于 Rust 开发的开源适配器，为 Agent Client Protocol（ACP）提供零云端依赖的离线 AI 编程连接能力。通过约 5MB 的单文件二进制程序，它能够帮助编辑器在隔离网络中无缝联动 Ollama、llama.cpp 和 vLLM 等本地推理引擎。

在严格的企业合规与物理隔离（Air-Gapped）网络环境中，基于云端的 AI 编程助手难以直接使用。acp-bridge 是一个基于 Rust 构建的开源项目，作为 Agent Client Protocol（ACP）的本地适配器，它提供了零云端、零依赖的离线连接方案 [1]。

该工具将复杂的模型代理协议转换为轻量化的本地桥梁，使得开发人员能够在无需外网连接和云端 API 密钥的情况下，安全地在私有环境中体验 AI 辅助编程 [1]。

根据官方代码库与协议更新信息，acp-bridge 具有以下核心特性与进展：

轻量与零依赖：项目编译为仅约 5MB 的独立二进制文件，无需任何额外的运行库依赖，完全满足严苛的企业离线合规要求 [1]。
协议实现与通信：v0.7.8 版本通过 JSON-RPC 标准的 stdin/stdout 传输协议，实现了 ACP 服务端的核心方法，包括 initialize、session/new、session/prompt 以及 session/end [1]。
本地引擎原生集成：内置对 Ollama 的原生支持，能够自动识别本地实例，利用 /api/chat 进行 NDJSON 流式响应传输，并提供模型信息查询和 VRAM 显存状态监控 [1]。
生态与工具链消除泄漏：解决以往依赖云端 agent 搭配 llama.cpp 或 vLLM 等本地引擎时出现的离线工具调用故障与网络数据泄漏问题 [1]。
ACP 协议生态演进：ACP 官方在 2026 年年中发布了 Rust 与 TypeScript SDK 的 1.0.0 正式版以及 ACP v2 草案 [2]。新版协议进一步稳定了会话恢复（session/resume）、请求取消（$/cancel_request）、布尔值配置选项及结构化用户引导交互等特性 [2]。

开发者只需下载或编译单一二进制文件，并将其配置为 ACP 兼容编辑器（如 Zed、Neovim、VS Code）的 ACP 服务端扩展。

在使用 acp-bridge 时，需关注以下限制与适配细节：

规格覆盖进度：当前 v0.7.8 仅支持 ACP 协议的核心子集，完全符合规格（如 session/resume 和 session/set_mode）计划于 2026 年第三季度末实现 [1]。
推理模板适配：对于带有思考过程（Thinking-on）的本地大模型（如 DeepSeek-R1 与 Qwen3），在本地推理时可能需要专门处理工具调用的模板解析 [1]。
传输协议稳定性：基于本地 stdin/stdout 的 JSON-RPC 传输已完全稳定，但基于 Streamable HTTP 和 WebSocket 的远程传输仍处于草案制定阶段 [1, 2]。

acp-bridge：面向断网环境与私有部署的 ACP 本地 AI 编程适配器