acpx提示技巧清单exec、stdin、--file、--no-wait队列的6种正确姿势【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpxacpx 是用于有状态 ACPAgent Client Protocol会话的 Headless 命令行客户端为 Codex、Claude、Cursor 等编码智能体提供统一的 CLI 入口。它只有一个核心操作把提示prompt发给智能体并流式接收响应——而选对exec还是prompt、用 stdin 还是--file、阻塞等待还是--no-wait排队直接决定脚本是否稳定、上下文是否丢失。下面是 6 种可直接照抄的正确姿势 姿势1exec无状态一次性调用 —— 脚本自动化首选当你需要无状态答案时用execSUMMARY$(acpx --format quiet codex exec summarize this repo in 3 bullets)适合选exec的三种场景在脚本中取一次性结果不想意外分叉出一个持久会话需要机器可读的 JSON 输出配--format json且不希望后续轮次混入其中临时配置如--config-option reasoning_efforthigh不应被保存。exec不重放已保存会话、不写会话历史、也不感知队列——它用完即弃最干净。 姿势2prompt/ 直接传文本 —— 持久化多轮会话当对话需要记住之前的轮次时用prompt或不写子命令直接传文本两者等价acpx codex trace the checkout timeout acpx codex -s release collect changes since v0.6.0按作用域或-s命名自动恢复已保存会话历史会写回会话记录下次调用无缝续聊支持队列感知提交cancel/set-mode等会话控制也作用于同一会话。 姿势3stdin 管道输入 —— 把 diff 和日志直接喂给 AI不必把提示词敲在终端里任何上游输出都能直接管道进来git diff | acpx codex prompt git log --oneline -n 20 | acpx codex pick the 3 most important changesUnicode 是安全的即使管道输入被分块传输acpx 也能保证文本完整不乱码输入解析见 src/cli/prompt-input.ts 的readPromptInput。 姿势4--file文件输入 —— 长提示词不塞命令行长提示词塞进命令行会被 shell 截断、转义混乱直接写成文件acpx codex --file ./brief.md acpx codex prompt -f ./brief.md小提示--file与位置参数可以叠加——文件内容与命令行文本会以空行分隔后拼接成一个完整提示。 姿势5--file -组合拳 —— 管道内容 追加一句指令最被低估的姿势--file -从 stdin 读取内容结尾还能追加一条短指令git diff | acpx codex --file - and call out anything risky特别适合把 diff / 日志 / changelog 等上下文交给智能体再补一句要求的场景一次调用搞定。 姿势6--no-wait队列提交 —— 后续任务排队不阻塞当目标会话正在跑一个轮次时acpx不会再启动第二个适配器进程而是通过本地 IPC 把提示提交给运行中的队列所有者queue owner。提交方有两种行为默认阻塞一直等到排队的提示完成并流式回放事件--no-wait队列所有者一确认入队就立即返回。acpx codex run the full test suite and triage failures acpx codex --no-wait after that, summarize root cause in 3 bullets acpx codex --no-wait and propose 1 minimal fix三条队列机制要知道排队的提示按提交顺序依次执行--no-wait只对当前这一次生效下一次不带该参数的调用会照常阻塞等待队列排空后owner 进程会保留一段空闲 TTL默认 300 秒--ttl可调快速追问不用重复付启动成本。⚖️ 速查表exec vs prompt 怎么选命令重用已保存会话写入会话历史感知队列prompt/ 裸文本是——按作用域恢复会更新历史是exec否——临时会话否否一句话记法给机器用exec给对话用prompt。 两个容易踩的坑CtrlC 的正确姿势等待运行中或排队中的提示时按 CtrlCacpx 会先发送 ACPsession/cancel、等待取消完成只有在智能体无响应时才强制杀进程——不用手动找进程。用--timeout兜底acpx --timeout 90 codex investigate…可限制等待智能体响应的最长时间若到点仍未收到完整响应acpx 以退出码3退出部分文本不算完成。 延伸阅读提示输入完整指南5 种形式、队列、超时docs/prompting.md会话作用域、队列所有权与崩溃恢复docs/sessions.mdcancel/set-mode/set会话控制docs/session-control.md提示内权限策略默认放行读取、写入需确认docs/permissions.md输出格式text / quiet / jsondocs/output-formats.md【免费下载链接】acpxHeadless CLI client for stateful Agent Client Protocol (ACP) sessions项目地址: https://gitcode.com/gh_mirrors/ac/acpx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考