weacpx 0.4.4 → 0.4.5

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`。
@@ -176,6 +176,9 @@ weacpx restart
 | `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 管理
 
 | 命令 | 说明 |
@@ -356,6 +387,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_wait` / `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
     };
   }