weacpx 0.4.4 → 0.4.6

package/README.md

@@ -11,7 +11,7 @@
 
 ## 这是什么
 
-`weacpx` 是一个可以通过微信、飞书或元宝直接控制 Codex / Claude Code / Gemini / OpenCode 的工具。它把聊天消息通过 `acpx` 连接到 Agent CLI 会话上，让你直接在手机里：
+`weacpx` 是一个可以通过微信、飞书或元宝直接控制 Codex / Claude Code / Gemini / OpenCode 等 ACP Agent 的工具。它把聊天消息通过 `acpx` 连接到 Agent CLI 会话上，让你直接在手机里：
 
 - 新建和切换会话
 - 让 Agent 继续在指定项目目录里工作
@@ -34,7 +34,7 @@
 开始前，你至少需要：
 
 - Node.js 22+ 或 Bun
-- 已可用的 Codex / Claude Code / Gemini / OpenCode
+- 已可用的 Codex / Claude Code / Gemini / OpenCode 等你要使用的 Agent CLI
 - 一台装了微信、飞书或元宝的手机
 
 > 微信频道基于 `weixin-agent-sdk` 工作，飞书频道使用飞书自建应用凭据，元宝频道使用 `appKey` / `appSecret`；底层 Agent 会话由 `acpx` 驱动。正常情况下，你不需要额外全局安装 `acpx`。
@@ -169,13 +169,16 @@ weacpx restart
 | `weacpx status` | 查看后台状态、PID、配置路径、日志路径 |
 | `weacpx stop` | 停止后台实例 |
 | `weacpx restart` | 重启后台实例，让频道配置变更生效 |
-| `weacpx update [--all|<name>]` | 检查并更新 weacpx 与已安装插件；安装了插件时会交互式选择更新项 |
+| `weacpx update [--all\|<name>]` | 检查并更新 weacpx 与已安装插件；安装了插件时会交互式选择更新项 |
 | `weacpx channel list` | 查看已配置的消息频道 |
 | `weacpx plugin known` | 查看官方插件清单（飞书/元宝包名） |
 | `weacpx plugin add @ganglion/weacpx-channel-feishu && weacpx channel add feishu` | 安装并添加飞书频道，会提示输入飞书应用凭据 |
 | `weacpx plugin add @ganglion/weacpx-channel-yuanbao && weacpx channel add yuanbao` | 安装并添加元宝频道，会提示输入元宝 appKey/appSecret |
 | `weacpx doctor` | 运行环境诊断 |
 | `weacpx version` | 查看当前版本 |
+| `weacpx agent list` | 查看本机已注册的 agent |
+| `weacpx agent add <name>` | 从内置模板添加 agent；已存在且配置不同的同名 agent 不会被覆盖 |
+| `weacpx agent rm <name>` | 删除 agent |
 | `weacpx workspace list` | 查看本机已注册的 workspace |
 | `weacpx workspace add [name]` | 把当前目录注册成 workspace；不传 `name` 时使用当前目录名 |
 | `weacpx workspace rm <name>` | 删除 workspace |
@@ -223,6 +226,26 @@ weacpx ws rm frontend
 
 注意：`workspace add` 总是注册**当前终端所在目录**；如果不传名称，会用当前目录名作为 workspace 名称。
 
+### `agent` CLI 怎么用
+
+`weacpx agent` 用来在电脑本机维护 `~/.weacpx/config.json` 里的 `agents` 配置；`agents` 是同等别名。
+
+| 命令 | 说明 |
+|------|------|
+| `weacpx agent list` | 列出已注册的 agent |
+| `weacpx agent templates` | 列出可添加的内置模板 |
+| `weacpx agent add <name>` | 从内置模板添加 agent，例如 `kimi`、`opencode` |
+| `weacpx agent rm <name>` | 删除指定 agent |
+
+常见用法：
+
+```bash
+weacpx agent templates
+weacpx agent add kimi
+weacpx agents list
+weacpx agent rm kimi
+```
+
 ### `doctor` 怎么用
 
 ```bash
@@ -245,9 +268,7 @@ weacpx doctor --smoke --agent codex --workspace backend
 
 ### Agent 管理
 
-已内置常用的 Codex 与 Claude Code；
-
-可以使用 `/agent add opencode` 添加你所需要的 agents。
+默认配置通常已包含 `codex` 与 `claude`。如果你要使用其它 acpx 支持的 agent，可以先用 `/agent add <name>` 从内置模板添加。
 
 | 命令 | 说明 |
 |------|------|
@@ -256,6 +277,16 @@ weacpx doctor --smoke --agent codex --workspace backend
 | `/agent add opencode` | 添加 `OpenCode` Agent |
 | `/agent rm <name>` | 删除 agent |
 
+当前内置模板与 acpx 的 built-in agents 对齐：
+
+```text
+codex, claude, pi, openclaw, gemini, cursor, copilot, droid,
+factory-droid, factorydroid, iflow, kilocode, kimi, kiro,
+opencode, qoder, qwen, trae
+```
+
+这些模板只写入 `driver`，实际启动命令交给 acpx 解析；例如 `/agent add kimi` 会保存 `{ "driver": "kimi" }`。完整命令说明见 [docs/commands.md](./docs/commands.md)，配置字段见 [docs/config-reference.md](./docs/config-reference.md)。
+
 ### Workspace 管理
 
 | 命令 | 说明 |
@@ -320,22 +351,15 @@ README 里只保留用户视角的最常用命令。
 | 命令 | 说明 |
 |------|------|
 | `/dg <agent> <task>` | 快速委派一个子任务 |
-| `/group new <title>` | 创建任务组 |
-| `/group add <groupId> <agent> <task>` | 往任务组里加子任务 |
-| `/groups` | 查看任务组列表 |
-| `/group <id>` | 查看单个任务组 |
-| `/group cancel <groupId>` | 取消组内未结束任务 |
 | `/tasks` | 查看当前主线下的任务 |
 | `/task <id>` | 查看单个任务详情 |
 | `/task approve <id>` | 批准 `needs_confirmation` 任务 |
-| `/task cancel <id>` | 取消任务 |
+| `/task cancel <id>` | 取消任务；取消一个尚未批准的任务等同于拒绝 |
 
 最常见例子：
 
 ```text
 /dg claude 审查当前方案的 3 个高风险点
-/group new review
-/group add review claude 审查接口设计
 /tasks
 /task approve task_123
 ```
@@ -345,9 +369,9 @@ README 里只保留用户视角的最常用命令。
 - 当前会话就是主控会话
 - 被委派出去的是独立子任务会话
 - agent 发起的委派请求默认需要人工确认
-- group 适合把 2~3 个独立子任务并行派出去，再把结果汇总回主线
+- 如果你在用外部 MCP host（Codex / Claude Code），用 `delegate_batch` 一次派发多个并行子任务：传一个 `tasks` 数组，底层自动建组，全部结果一次性回注，无需手动维护 groupId
 
-如果你想先理解什么时候该用 delegate、什么时候该开 group，请看：
+如果你想先理解什么时候该用 delegate、什么时候应该并行派出多个子任务，请看：
 
 - [docs/weacpx-group-usage-guide.md](./docs/weacpx-group-usage-guide.md)
 
@@ -356,6 +380,8 @@ README 里只保留用户视角的最常用命令。
 
 如果你想让 Codex、Claude Code 等外部 MCP host 直接使用 weacpx 的多 Agent 编排能力，可以把 `weacpx mcp-stdio` 配成一个 stdio MCP server。
 
+`delegate_request` 支持 MCP Tasks：支持该能力的 host 可以让委派请求立即返回原生 task handle，之后通过 `tasks/get` / `tasks/result` / `tasks/cancel` 获取状态、结果或取消任务；worker 输出的 `[PROGRESS] ...` 会显示在 `tasks/get` / `tasks/list` 的 `statusMessage` 里；`input_required` 状态下的 `tasks/result` 会返回下一步操作提示并结束本次 result stream，而不是长时间阻塞；client 按提示调用 `task_get` / `task_approve` / `coordinator_answer_question` 等工具后，再继续 `tasks/get` / `tasks/result` 轮询。不支持 MCP Tasks 的 host 仍可使用兼容工具 `task_get` / `task_list` / `task_watch` / `task_cancel`。
+
 先启动 daemon：
 
 ```bash

package/dist/bridge/bridge-main.js

@@ -111,38 +111,24 @@ function extractPromptFailureMessage(result) {
 function extractPromptOutput(output) {
   const lines = output.split(`
 `).map((line) => line.trim()).filter((line) => line.length > 0);
-  const messageSegments = [];
-  let currentSegment = "";
+  let text = "";
   let hasAgentMessage = false;
   for (const line of lines) {
+    let event;
     try {
-      const event = JSON.parse(line);
-      const isMessageChunk = event.method === "session/update" && event.params?.update?.sessionUpdate === "agent_message_chunk" && event.params.update.content?.type === "text" && typeof event.params.update.content.text === "string";
-      if (isMessageChunk) {
-        hasAgentMessage = true;
-        const chunk = event.params.update.content.text ?? "";
-        if (chunk.length > 0) {
-          currentSegment += chunk;
-        }
-        continue;
-      }
-      if (currentSegment.trim().length > 0) {
-        messageSegments.push(currentSegment.trim());
-      }
-      currentSegment = "";
+      event = JSON.parse(line);
     } catch {
-      if (currentSegment.trim().length > 0) {
-        messageSegments.push(currentSegment.trim());
-        currentSegment = "";
-      }
+      continue;
+    }
+    const isMessageChunk = event.method === "session/update" && event.params?.update?.sessionUpdate === "agent_message_chunk" && event.params.update.content?.type === "text" && typeof event.params.update.content.text === "string";
+    if (isMessageChunk) {
+      hasAgentMessage = true;
+      text += event.params.update.content.text ?? "";
     }
   }
-  if (currentSegment.trim().length > 0) {
-    messageSegments.push(currentSegment.trim());
-  }
-  if (messageSegments.length > 0) {
+  if (hasAgentMessage && text.trim().length > 0) {
     return {
-      text: messageSegments[messageSegments.length - 1],
+      text: text.trim(),
       hasAgentMessage
     };
   }
@@ -176,8 +162,12 @@ function extractJsonRpcErrorMessages(output) {
 `).map((line) => line.trim()).filter((line) => line.length > 0).flatMap((line) => {
     try {
       const payload = JSON.parse(line);
-      if (typeof payload.error?.message === "string" && payload.error.message.length > 0) {
-        return [payload.error.message];
+      const err = payload.error;
+      const dataMsg = typeof err?.data?.message === "string" && err.data.message.length > 0 ? err.data.message : undefined;
+      const baseMsg = typeof err?.message === "string" && err.message.length > 0 ? err.message : undefined;
+      const chosen = dataMsg && dataMsg !== baseMsg ? dataMsg : baseMsg;
+      if (chosen) {
+        return [chosen];
       }
     } catch {
       return [];