什么是acpx一文看懂统一操控20 AI编码代理的无头ACP客户端全景图【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpxacpx是一个无头HeadlessACP 命令行客户端让你用一条统一的命令操控 20 款 AI 编码代理Codex、Claude Code、Gemini、Cursor 等。它把有状态的 ACP 会话、一次性任务、权限审批、机器可读输出收敛成同一套接口是自动化流水线里连接 AI 编码代理的终极瑞士军刀 。一、acpx 是什么先讲人话acpx 就是一个AI 编码代理的统一遥控器。过去你每接一个 AI 编码工具Codex、Claude Code、Kiro……就要学一套交互方式想做自动化时很多人只能靠抓取终端输出这种脆弱手段。acpx 基于 Agent Client Protocol (ACP) 这个开放协议直接以结构化 JSON-RPC 与代理对话特性传统做法使用 acpx通信方式抓终端/PTY 文本标准 ACP 协议事件流式输出会话管理每个工具各自为政统一持久会话跨命令恢复上下文并行任务难以实现命名会话多工作流并行自动化输出解析终端转义符--format json输出 NDJSON 事件权限控制不可控批准/拒绝/按工具细分策略核心代码入口在 src/cli.ts 与 src/cli-core.ts内置代理注册表位于 src/agent-registry.ts。二、为什么需要无头 ACP 客户端代理之间要对话acpx 的主用户其实是另一个 AI 或编排器人类可以直接驱动但它是为自动化而生的见 VISION.md。上下文不丢失持久会话让多轮对话跨越进程存活追问时自动恢复上下文。可嵌入npm 包导出acpx/runtime与acpx/flows应用不必重复造轮子直接复用会话存储、队列与生命周期管理。机器可读--format json每行一条 ACP JSON-RPC 消息管道接jq就能做流水线。三、如何一键安装 acpx最快 30 秒上手1️⃣ 要求Node.js 22.13然后全局安装npm install -g acpxlatest2️⃣ 不想全局安装每条命令前加npx acpxlatest即可。3️⃣ 想从源码构建克隆仓库后执行pnpm install与pnpm run buildgit clone https://gitcode.com/gh_mirrors/ac/acpx完整安装细节见 docs/install.md。四、acpx 三步速通教程建会话、发提示、看结果以 Codex 为例其他代理命令形状完全一致acpx codex sessions new # 第1步创建会话 acpx codex 找到最慢的测试并解释原因 # 第2步发送提示 acpx codex 再给出一个一行修复方案 # 第3步上下文自动延续你会看到结构化的事件流助手文本、[tool]工具调用块、计划更新以及最终的[done] end_turn。两个高频技巧一次性任务acpx codex exec 用5句话总结这个仓库—— 不读不写任何保存的会话脚本友好。排队不阻塞上一轮还在跑时acpx codex --no-wait …会把新提示排队到运行中的会话上fire-and-forget。更完整的入门路径参考 docs/quickstart.md。五、如何统一操控 20 AI 编码代理acpx 内置了一份友好的代理注册表25 个预置名字每个都解析为对应的 ACP 适配器命令全部支持同一套命令面prompt/exec/cancel/sessions/status代理调用方式代理调用方式Codexacpx codex …Cursoracpx cursor …Claude Codeacpx claude …GitHub Copilotacpx copilot …Gemini CLIacpx gemini …Devinacpx devin …Kiroacpx kiro …Qwen Codeacpx qwen …Junieacpx junie …Kimiacpx kimi …完整清单见 docs/agents.md每个代理的适配说明放在 agents/ 目录如 agents/Claude.md、agents/Codex.md。隐藏福利——横向对比命令同一个提示词丢给多个代理输出并排摘要acpx compare codex claude gemini 总结这次改动详见 docs/compare.md。自定义代理则用acpx --agent command …配置指南在 docs/custom-agents.md。六、持久会话上下文跨进程存活还能并行开多路会话按(代理命令, 绝对目录, 可选名称)作为作用域键持久化在~/.acpx/下目录内自动恢复在src/子目录发提示会自动恢复仓库根目录创建的会话体验上就像我一直在这个仓库里和 codex 聊天。命名会话并行-s backend修 API、-s docs写发布说明两条工作流互不干扰。完整生命周期sessions子命令支持 list / new / show / history / export / import / prune 等详见 docs/sessions.md 与 docs/session-control.md。七、权限管控与机器可读输出自动化的安全阀ACP 代理在执行写文件、跑命令前会请求权限acpx 用清晰的模式替你裁决标志行为--approve-reads默认模式读/搜索放行其余请求审批--approve-all全部批准适合沙箱环境--deny-all全部拒绝适合只读审查进阶玩法是用--permission-policy做按工具细分的策略autoApprove / autoDeny / escalate规则细节见 docs/permissions.md。输出格式三选一文本默认、quiet只要最终答案、jsonNDJSON 全量 ACP 事件格式说明在 docs/output-formats.md退出码语义见 docs/exit-codes.md。八、Flows把多步 AI 工作流写成 TypeScript 模块当一个提示词不够用时acpx 的 Flows实验性功能登场用 TypeScript 定义工作流混合ACP 对话节点 / shell 动作 / 计算 / 决策 / 检查点运行状态持久化在~/.acpx/flows/runs/每一步可检查、可重放。acpx flow run ./my-flow.ts --input-file ./input.json官方示例包括 PR 分诊流水线可参考 examples/flows/ 与 examples/flows/README.md架构设计文档在 docs/2026-03-25-acpx-flows-architecture.md。若你的应用需要与 CLI 共享同一个本地会话属主可用createSharedAcpRuntime()见 docs/shared-sessions.md。九、项目结构导览核心模块在哪里模块路径职责CLI 入口src/cli.ts命令行解析与分发ACP 客户端src/acp/进程管理、JSON-RPC、错误归一化运行时引擎src/runtime/engine/会话生命周期、回合调度会话持久化src/session/事件日志、队列属主、租约存储Flows 运行时src/flows/工作流定义、执行、存储合规测试conformance/ACP 协议一致性用例与 runner文档体系以 docs/ 为主CLI 参考、提示词指南、配置说明。十、总结一张图记住 acpx一个协议ACP摆脱终端抓取和适配胶水代码一个接口20 AI 编码代理共享同一命令面随时切换、随时对比两种形态既是人类可操作的 CLI也是可嵌入acpx/runtime的会话后端三大场景多轮持久会话、无状态一次性exec、多步 Flows 工作流。acpx 目前处于 1.0 之前接口仍在演进MIT 协议见 LICENSE。如果你想让 CI、编排器或另一个 AI 稳定地指挥一堆编码代理它就是那个完整、简单又免费的统一入口 —— 现在就试试你的第一条acpx命令吧 【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
Codex 401 Unauthorized 错误排查：从 config.toml 到认证链路全解析 1. 项目概述：Codex 更新后返回401 Unauthorized: Invalid token的本质是什么？Codex 不是 OpenAI 官方产品，而是由第三方开发者维护的本地化 AI 工具链，常用于在 VS Code、JetBrains 等 IDE 中集成代码补全、自然语言转代码、文档生… · 2026/9/26 19:43:59
Chrome浏览器下载安装、扩展管理与DevTools调试全攻略 1. 从热搜词里读出的真实需求：大家到底在折腾Chrome什么 先把这批热搜词摊开看一遍，你会发现它们其实不是零散的，而是能归成几大类的。第一类是 下载与版本 ：chrome下载、chrome浏览器下载、chrome 109、chrome 109 win7、chrom… · 2026/9/26 19:43:52
微信小程序云开发免费额度详解：独立开发者如何零成本搭建小程序 1. 这次免费到底改了什么，为什么独立开发者最该关注微信小程序云开发推出免费额度这件事，我在几个开发者群里看到的第一反应是“终于等到了”，第二反应是“具体免到什么程度”。作为一个从2018年就开始用云开发做小项目、也帮朋友做过几个上线… · 2026/9/26 19:43:46
零基础转行IT网络来得及吗？30+学习路线与证书实用指南 "31岁，干了八年销售，手里一个客户资源都带不走，想转行学IT网络，零基础，来得及吗？"这是我在后台收到的一条私信。说真的，我隔三差五就会收到类似的提问，只是年龄换成"… · 2026/9/26 20:24:54
30+零基础转行IT网络：考证路线图与实战避坑指南 转行IT网络、零基础、30，还能靠考证逆袭吗？先说结论：能，但有一条硬前提——你得把“考证”当成路线图，而不是免死金牌。我见过35岁从汽修厂出来、靠一本HCIA摸进IDC机房的人，也见过考完HCIE依然不敢投简历、… · 2026/9/26 20:24:54
HTML5 PACS阅片Demo实战：从DICOM解析到Canvas渲染 简介：一套面向医疗影像方向的HTML5在线阅片演示，基于开源JavaScript库Cornerstone构建，解决医生与开发者在浏览器中直接查看PACS系统内DICOM影像并进行缩放、平移、窗宽窗位调节和长度测量等需求。压缩包共278个文件，其中188个js脚… · 2026/9/26 20:24:54
无后端基础如何快速搭建后台管理系统？四条实用路径与若依实战 做软件创业这些年，我最大的感触就是：懂业务不一定懂后台，但不懂后台一定做不了产品。尤其是没系统学过后端开发的创业者，一提到“后台管理系统”几个字就开始头大。用户管理、订单列表、内容发布、数据统计……这些看不见摸不着的… · 2026/9/26 20:24:54
flannel v0.11.0 ARM64离线包实战：K8s内网环境网络插件部署指南 简介：这是 Kubernetes 集群网络插件 Flannel 在 Linux ARM64 架构下的一个发行包，标题为 flannel-v0.11.0-linux-arm64.tar.gz，重点解决跨节点容器之间的网络互通问题。包内共包含 3 个文件：flanneld 主程序负责运行 Flannel 守护… · 2026/9/26 20:24:54
minimaxH3+ComfyUI构建三维高斯重建流水线 1. 项目概述：这不是“又一个AI视频工具”，而是一套可复现、可调试、可落地的三维内容生产流水线你有没有试过，对着一张静态人像图，想让它转个身、换个角度、甚至绕着自己走一圈？过去这得靠建模师花几天时间搭骨架、贴材… · 2026/9/26 20:24:44
数据库课后习题答案别硬背：当测试用例集刷，效率翻倍 简介：万常选版《数据库原理与设计》课后习题答案资源，覆盖第2至6章及第9章，适合正在学习关系模型、数据库建模、关系数据理论与模式求精的本科生、自学者作为复习与自测材料。压缩包共7个文件，含3个doc参考答案、2个sql示例脚本、… · 2026/9/26 0:00:21
OpenClaw 替代品？Hermes Agent 踩坑实录：macOS 飞书接入 TaoToken 配置 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/26 0:00:40
向下兼容与向上兼容：接口设计中的兼容性策略与工程实践 一次版本升级事故，是很多团队绕不过去的坎。线上环境里，服务端明明已经上线了新版接口，老的移动端还在照着旧文档传参数。请求一到网关，校验直接拒绝，用户操作失败，客服群炸了锅，开发群里开始互… · 2026/9/26 0:00:46
