xacpx你的 Agent，就在聊天里

xacpx 是什么？ ​

xacpx 是一个聊天频道控制台，用于远程控制 acpx Agent 会话。它充当聊天应用与运行在本机上的 Agent CLI 之间的桥梁，让你无需离开手机便能启动、切换和取消 Agent 任务。

你可以通过 xacpx 驱动 Codex、Claude Code、Gemini、OpenCode 以及 acpx 所支持的任何其他 Agent——全部在熟悉的消息界面中完成。

适用场景 ​

如果你需要轻量、随时随地访问长时间运行的 Agent 会话，xacpx 正是你所需的工具。典型场景包括：

• 离开工位时监控或重定向 Agent。
• 在单个聊天对话中管理多个并行会话，涵盖不同项目。
• 无需打开终端即可将子任务委托给其他 Agent。

如果你的工作流完全在本地终端中进行，则无需使用 xacpx——它的价值体现在聊天频道层。

核心工作流 ​

典型流程分为四步：

1. 启动后台守护进程 — xacpx start
2. 创建或切换会话 — /ss codex -d /path/to/project 或 /use <alias>
3. 发送纯文本提示词 — 任何不以 / 开头的消息都会被转发到当前会话
4. 查看状态或取消 — /status、/cancel

会话模型。 xacpx 维护两个独立的会话状态层。逻辑会话由 xacpx 管理，保存别名、所选 Agent、工作区绑定以及每用户的聊天上下文。传输会话是实际运行在后端的 acpx 命名会话。/session new（简写 /ss）会同时创建这两者。/session attach 则只创建逻辑会话并绑定到一个已存在的传输会话——当你在后端已有独立运行的 acpx 会话，且希望在不干扰现有对话的前提下挂载 xacpx 聊天层时，这一命令非常有用。

支持的频道 ​

xacpx 内置微信作为默认频道。其他频道以官方插件包形式分发：

第三方频道遵循相同的插件接口。使用 xacpx plugin add <package> 安装频道插件，使用 xacpx channel add <name> 配置，然后重启守护进程。

下一步 ​

• 快速开始 — 安装 xacpx、登录并运行第一个会话
• 命令参考 — 聊天命令完整列表（/ss、/use、/cancel 等）
• 配置说明 — 配置文件字段、传输选项以及工作区和 Agent 注册
• 插件开发 — 构建你自己的频道插件