acpx快速上手教程:5步跑通你的第一个AI编码持久会话(从安装到JSON输出)

发布时间:2026/11/23 5:31:07

acpx快速上手教程:5步跑通你的第一个AI编码持久会话(从安装到JSON输出) acpx快速上手教程5步跑通你的第一个AI编码持久会话从安装到JSON输出【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpxacpx 是一个运行在命令行里的headless ACPAgent Client Protocol客户端让你用一条命令就能创建持久会话、调用 Codex / Claude Code 等 AI 编码智能体并输出机器可读的 JSON 事件流。本教程用 5 步带你从安装到 JSON 输出完整跑通你的第一个 acpx 持久会话。1. 安装 acpx一条命令完成acpx 以 npm 包形式发布要求Node.js ≥ 22.13无需守护进程、无需托管服务所有会话状态保存在~/.acpx/目录下。npm install -g acpxlatest acpx --version不想全局安装所有命令都支持npx acpxlatest …临时运行。更多安装细节见 docs/install.md。2. 选择你的 AI 编码智能体acpx 内置了二十多个智能体适配器最常用的两个智能体命令示例适配方式CodexOpenAIacpx codex …npx首次使用时自动拉取Claude Codeacpx claude …npx首次使用时自动拉取Gemini / Cursor / Copilot 等acpx gemini …等需自行安装上游 CLI验证适配器是否可用acpx codex --help完整内置智能体清单见 docs/agents.md自定义注册方式见 docs/custom-agents.md。3. 创建并发送第一个持久会话acpx 要求显式创建会话避免自动化中意外发起对话然后会话会按当前仓库目录作用域持久化cd ~/repos/your-project acpx codex sessions new # 创建会话记录写入 ~/.acpx/sessions/ acpx codex 找到最慢的测试并解释原因你会看到结构化的 ACP 事件流助手文本、[tool]工具调用块、计划更新以及结尾的[done] end_turn。关键来了——会话是持久的。继续追问它会接着上文对话acpx codex 现在为最慢的那个测试提一个一行修复方案 acpx codex 应用修复并重新运行该测试即使你处在src/或docs/子目录acpx 也会向上查找 git 根目录自动恢复同一个会话。会话的作用域规则(agentCommand, cwd, name)三元组见 docs/sessions.md。4. 并行会话与无状态一次性执行命名会话可以把同一仓库拆成并行工作流acpx codex sessions new --name backend acpx codex sessions new --name docs acpx codex -s backend 修复 checkout 超时 acpx codex -s docs 根据最近的提交起草发布说明如果只是想问一个不留状态的一次性问题用exec——它永不读写会话记录非常适合脚本acpx codex exec 用5个要点总结这个仓库是做什么的5. 输出 JSON让脚本消费你的会话 acpx 提供三种输出模式完整说明见 docs/output-formats.md模式命令适用场景text默认acpx codex …人类终端交互jsonacpx --format json codex …自动化管道每行一条 ACP JSON-RPC 消息quietacpx --format quiet codex …只要最终助手文本管道到jq过滤事件acpx --format json codex exec 审查改动文件中的风险模式 \ | jq -r select(.methodsession/update)脚本里只取最终答案SUMMARY$(acpx --format quiet codex exec 一句话总结当前分支)加--json-strict可保证 stdout 只有 JSON、stderr 保持安静是全自动消费管道的最佳组合。顺手配置权限 ⚡默认策略是读操作自动批准、写操作询问。想让智能体自动改文件加--approve-all纯分析场景可用--deny-allacpx --approve-all codex 应用补丁并运行测试完整权限策略表见 docs/permissions.md退出码含义见 docs/exit-codes.md。下一步去哪儿 会话管理排队、取消、导出/导入、清理docs/sessions.md提示词输入方式stdin、--file、--no-waitdocs/prompting.md完整 CLI 参考docs/CLI.md多步骤 TypeScript 工作流 Flowsdocs/flows.md示例见 examples/flows/从零到持久会话的官方快速上手docs/quickstart.md5 步走完你已经掌握了 acpx 的核心循环安装 → 选智能体 → 建持久会话 → 多轮对话 → JSON 自动化。剩下的就是让它帮你写代码吧。【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpx创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/21 16:16:13

Jev模型深度实测:从原理到部署的老照片修复全指南

1. Jev模型到底是什么:这次刷屏不是营销这几天不管在哪个AI社区,都能看到Jev模型的消息。从最初一个平平无奇的模型卡页面,到各路博主晒修复效果,再到GitHub上一堆衍生的聊天助手和接入教程,整个扩散模型圈子像是被这个…

2026/11/23 5:28:44

2018电工证分几种网上查询不迷路 电工证怎么考才不吃亏

2018电工证分几种网上查询不迷路 电工证怎么考才不吃亏 你是不是也遇到过这种情况?想考个电工证,却不知道哪一家靠谱,怕被中介骗钱,怕证书不被认可,怕报名流程复杂,怕考试不过,怕花了钱还白忙一场?其实, 2018电工证分几种…

2026/11/23 5:28:44

电工证未按期复审吗 上岗必备的流程和注意事项

电工证未按期复审吗 上岗必备的流程和注意事项 之前考的证在外省能不能转过来?这是很多从事电工工作的朋友最关心的问题之一,尤其是在多地奔波、跨省工作的特种作业人员,电工证的管理问题尤为突出。而一旦涉及到“电工证未按期复审吗”这样的问题,不仅影…

2026/11/23 5:28:44

襄阳哪里有办电工证的,含金量到底值不值得考?

襄阳哪里有办电工证的,含金量到底值不值得考? 之前考的证在外省能不能转过来?这是很多从业者的共同困扰,尤其是像你这样在焦作从事建筑行业的工友。其实,特种作业证的 含金量…

2026/11/23 5:28:44

电工证损坏照片怎么处理?郑州报考避坑指南教你一步到位

电工证损坏照片怎么处理?郑州报考避坑指南教你一步到位 电工证损坏照片怎么办?别急,这事儿真不难,但如果不了解流程,轻则耽误工作,重则影响收入。最近,三门峡的一位建筑工人老李就遇到了类似问题,他正在准备上岗,结果发现自己的电工证照片损坏,证件…

2026/11/23 5:23:43

工地太忙根本没时间复习考试 官方回应北京电工证考试时间怎么安排

工地太忙根本没时间复习考试 官方回应北京电工证考试时间怎么安排 工地太忙根本没时间复习考试,这事儿我懂,我是济源一家中小施工企业负责人,去年年底就因为赶工期,差点错过高压电工证的复审,当时急得连饭都吃不下。后来通过河南政务服务网查到官方回应…

2026/11/22 0:09:40

高压电工证还能年审吗良心建议来了,学历不高也能考!

高压电工证还能年审吗良心建议来了,学历不高也能考! 你是不是也担心,自己学历不高,根本报不上高压电工证?其实不然,现在政策已经非常明确, 高压电工证还能年审 ,而且只要符合条件, 学历不是门槛 , 良心建议…

2026/11/23 2:38:11

吴江的电工证免费培训怎么报名?官方报名入口全解析

吴江的电工证免费培训怎么报名?官方报名入口全解析 你急需特种作业证才能上岗找工作,但不知道从哪里下手?别急,现在就给你讲明白【吴江的电工证免费培训】到底怎么操作,以及怎么通过 官方报名入口…

2026/11/23 0:26:19

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱 不知道去哪报名怕被中介坑?这几乎是每个需要办理或复审电工证的人的真实经历。尤其在肃州区,信息不透明、流程复杂、中介收费高又不靠谱,让很多电工从业者感到头疼。作为一个在应急管理和特种作…

2026/11/23 0:01:38

南宁哪里可以学电工证值不值得考?怕被中介坑?看这篇就够了

南宁哪里可以学电工证值不值得考?怕被中介坑?看这篇就够了 不知道去哪报名怕被中介坑?南宁哪里可以学电工证值不值得考?这是很多想考电工证的朋友最关心的问题。现实中,不少人在选择培训机构时被各种五花八门的广告信息搞得晕头转向,甚至被坑了钱还没拿…

2026/11/23 0:01:38

建设局特种工证怎么查全国通用的复审流程

建设局特种工证怎么查全国通用的复审流程 证书过期了不知道怎么复审延期,这是很多特种作业从业者常遇到的问题。尤其是在洛阳涧西区从事水利工程工作的你,特种作业操作证不仅是上岗的“通行证”,更是保障安全作业的法律底线。如果操作证过期了,不仅影响工…

2026/11/23 0:01:38

电工证跨考政策值不值得考?学历不高也能考的真相

电工证跨考政策值不值得考?学历不高也能考的真相 你是不是也觉得学历不够,报电工证怕被拒?别急,国家安全生产考试网明文规定, 电工证跨考政策 对学历门槛没有硬性限制,只要你年满18岁,身体健康,能通过实操考试,就能报考。关键是, 值不值得考…

2026/11/22 9:39:14

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/22 5:39:03

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑