SuperAPI AI 工具集

acpx

智能体与模型

查看项目

更新于 10-15 21:46

技能介绍

用途:acpx 是面向 Agent Client Protocol 的无头、可脚本化 CLI 客户端,专为智能体间命令行通信设计,避免 PTY 抓屏。

主要能力:每个仓库/cwd 的持久多轮会话;一次性执行模式(exec);多智能体对比(compare);命名并行会话(-s/--session);幂等会话创建(sessions ensure);会话保留控制(sessions prune,含时间过滤与历史清理);跨机器会话导出/导入;带队列感知的提示提交与 --no-wait 即发即忘;协作式取消(cancel);中断时经 ACP session/cancel 优雅取消;会话控制方法(set-mode、set key value);子进程失效后的重连/恢复;stdin 或 --file 输入提示;全局与项目合并的配置文件及 config show|init;通过 --mcp-config 加载会话级 MCP 服务器;会话元数据/历史查看;本地智能体进程状态检查(status);结构化流式输出(text、json、quiet)与 --suppress-reads;内置智能体注册表及 --agent 原始命令入口;--allowed-tools 工具白名单、--max-turns 轮次上限、--prompt-retries 失败重试;多智能体流程 acpx flow run。

安装:npm i -g acpx。常规会话复用建议全局安装而非 npx。

使用方式:prompt 为默认动作;可运行 acpx [global_options] [prompt_text...]、exec 一次性执行、compare 多智能体对比、cancel、set-mode、status、sessions 及 config 等子命令。提示文本省略且 stdin 有管道输入时,acpx 从 stdin 读取。默认智能体为 codex;内置名称映射到对应命令。

限制:在 Claude Code 内加载时,须在隔离的 SubAgent 中运行,禁止调用 claude 适配器;结果需由独立空白 SubAgent 复核。系统提示覆盖仅 Claude 适配器支持,非 Claude 适配器忽略;持久会话会拒绝 MCP 配置变更直至关闭。其余细节未在资料中提供。