weacpx 0.3.0 → 0.3.1

package/README.md

@@ -11,21 +11,21 @@
 
 ## 这是什么
 
-`weacpx` 是一个可以通过微信直接控制 Codex / Claude Code / Gemini / OpenCode 的工具。它把微信消息通过 `acpx` 连接到 Agent CLI 会话上，让你直接在手机里：
+`weacpx` 是一个微信控制台。它把微信消息接到 `acpx` 会话上，让你直接在手机里：
 
-- 新建和切换会话
+- 新建和切换 Codex / Claude Code 会话
 - 让 Agent 继续在指定项目目录里工作
 - 查看流式回复、最终结果和工具调用摘要
 - 调整权限策略
-- 在需要时做多 Agent 编排
+- 在需要时做最小可用的多 Agent 编排
 
-如果你需要临时远程编码或办公，`weacpx` 提供的是一个方便快捷的**远程入口**，让你在微信里就能随时随地干活。
+如果你已经习惯在本地终端里用 `acpx`，`weacpx` 提供的是一个**远程入口**，而不是另一套全新的工作流。
 
 ## 适合谁
 
-`weacpx` 适合轻量临时使用多 Agent 办公的用户。你可以用微信盯任务、发指令、看结果，并在同一个聊天里管理多个会话。
+`weacpx` 适合已经在用 Codex、Claude Code 或其他 `acpx` driver 的开发者。你可以用微信盯任务、发指令、看结果，并在同一个聊天里管理多个会话。
 
-> `weacpx` 的会话是跟本地隔离的，它目前还不能使用 CLI 已有的会话，你在 weacpx 也无法看到本地的 CLI 会话记录。
+它不是云端 IDE，也不是可视化编排平台。
 
 ## 5 分钟快速开始
 
@@ -34,7 +34,7 @@
 开始前，你至少需要：
 
 - Node.js 22+ 或 Bun
-- 已可用的 Codex / Claude Code / Gemini / OpenCode
+- 已可用的 Codex、Claude Code 或其他 `acpx` driver
 - 一台装了微信的手机
 
 > `weacpx` 基于 `weixin-agent-sdk` 和 `acpx` 工作。正常情况下，你不需要额外全局安装 `acpx`。
@@ -42,7 +42,7 @@
 ### 安装
 
 ```bash
-npm install -g weacpx --registry=https://registry.npmjs.org
+npm install -g weacpx
 # 或
 bun add -g weacpx
 ```
@@ -53,7 +53,7 @@ bun add -g weacpx
 weacpx login
 ```
 
-终端会显示二维码，请继续用微信扫码登录。
+终端会显示二维码。你用微信扫码登录。
 
 ### 启动服务
 
@@ -85,7 +85,7 @@ hello
 1. **启动后台服务**：`weacpx start`
 2. **创建或切换会话**：`/ss ...`、`/use ...`
 3. **直接发普通文本**：让当前会话继续工作
-4. **必要时查看状态或取消当前任务**：`/status`、`/cancel`
+4. **必要时查看状态或取消**：`/status`、`/cancel`
 
 ### 1) 创建会话
 
@@ -95,7 +95,7 @@ hello
 /ss codex -d /absolute/path/to/your/repo
 ```
 
-它会使用 `codex`，绑定这个工作目录，并自动切换到新会话。
+它会使用 `codex`，绑定这个目录，并自动切换到新会话。
 
 ### 2) 发普通消息
 
@@ -109,9 +109,9 @@ hello
 
 `weacpx` 支持三种常用回复模式：
 
-- `stream`：流式返回中间文本
+- `stream`：默认，流式返回中间文本
 - `final`：只返回最终结果
-- `verbose`：默认，在流式文本之外，额外显示工具调用摘要
+- `verbose`：在流式文本之外，额外显示工具调用摘要
 
 例如 `verbose` 模式下，你会看到：
 
@@ -145,6 +145,50 @@ hello
 | `weacpx stop` | 停止后台实例 |
 | `weacpx doctor` | 运行环境诊断 |
 | `weacpx version` | 查看当前版本 |
+| `weacpx workspace list` | 查看本机已注册的 workspace |
+| `weacpx workspace add [name]` | 把当前目录注册成 workspace；不传 `name` 时使用当前目录名 |
+| `weacpx workspace rm <name>` | 删除 workspace |
+
+`workspace` 也可以简写为 `ws`：
+
+```bash
+weacpx ws add
+weacpx ws list
+weacpx ws rm backend
+```
+
+### `workspace` CLI 怎么用
+
+`weacpx workspace` 用来在电脑本机维护 `~/.weacpx/config.json` 里的 `workspaces` 配置。它适合先在终端里注册常用项目目录，然后在微信里用 `--ws <name>` 直接引用。
+
+| 命令 | 说明 |
+|------|------|
+| `weacpx workspace list` | 列出已注册的 workspace 及其路径 |
+| `weacpx workspace add` | 把当前目录注册为 workspace，名称默认取当前目录名 |
+| `weacpx workspace add <name>` | 把当前目录注册为指定名称 |
+| `weacpx workspace rm <name>` | 删除指定 workspace |
+
+常见用法：
+
+```bash
+cd /absolute/path/to/backend
+weacpx workspace add backend
+
+cd /absolute/path/to/frontend
+weacpx ws add frontend
+
+weacpx ws list
+weacpx ws rm frontend
+```
+
+注册后，你可以在微信里直接使用：
+
+```text
+/ss codex --ws backend
+/ss new claude --ws frontend
+```
+
+注意：`workspace add` 总是注册**当前终端所在目录**；如果不传名称，会用当前目录名作为 workspace 名称。
 
 ### `doctor` 怎么用
 
@@ -164,19 +208,17 @@ weacpx doctor --smoke --agent codex --workspace backend
 
 ## 常用微信命令
 
+下面这部分保留一份**中等长度**的日常手册。够你上手和日常使用，但不把 README 写成完整参考手册。
+
 完整微信命令参考见：[docs/commands.md](./docs/commands.md)。
 
 ### Agent 管理
 
-已内置常用的 Codex 与 Claude Code；
-
-可以使用 `/agent add opencode` 添加你所需要的 agents。
-
 | 命令 | 说明 |
 |------|------|
 | `/agents` | 查看 agent 列表 |
-| `/agent add gemini` | 添加 `Gemini` Agent |
-| `/agent add opencode` | 添加 `OpenCode` Agent |
+| `/agent add codex` | 添加 `codex` |
+| `/agent add claude` | 添加 `claude` |
 | `/agent rm <name>` | 删除 agent |
 
 ### Workspace 管理
@@ -184,7 +226,7 @@ weacpx doctor --smoke --agent codex --workspace backend
 | 命令 | 说明 |
 |------|------|
 | `/workspaces` / `/workspace` / `/ws` | 查看 workspace 列表 |
-| `/ws new <name> -d <path>` | 添加 workspace，`path` 是电脑上的绝对路径，Windows 不用区分正反斜杠 |
+| `/ws new <name> -d <path>` | 添加 workspace，`path` 是电脑上的绝对路径 |
 | `/workspace rm <name>` | 删除 workspace |
 
 ### Session 会话
@@ -204,7 +246,7 @@ weacpx doctor --smoke --agent codex --workspace backend
 | `/replymode reset` | 回退到全局默认 reply mode |
 | `/session reset` | 重置当前会话上下文 |
 | `/clear` | `/session reset` 的快捷别名 |
-| `/cancel` / `/stop` | 停止当前任务 |
+| `/cancel` / `/stop` | 取消当前会话 |
 
 建议你优先记住这三个：
 

package/dist/bridge/bridge-main.js

@@ -354,6 +354,7 @@ var init_streaming_prompt = __esm(() => {
 
 // src/recovery/discover-parent-package-paths.ts
 import { spawn } from "node:child_process";
+import { createRequire as createRequire2 } from "node:module";
 import { access } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
@@ -426,8 +427,8 @@ async function defaultFsExists(path) {
 }
 function defaultResolveFromCwd(name, cwd) {
   try {
-    const pkgJson = __require.resolve(`${name}/package.json`, {
-      paths: [cwd, ...__require.resolve.paths(name) ?? []]
+    const pkgJson = require2.resolve(`${name}/package.json`, {
+      paths: [cwd, ...require2.resolve.paths(name) ?? []]
     });
     return dirname(pkgJson);
   } catch {
@@ -480,11 +481,14 @@ async function defaultQueryPackageManagerRoot(tool) {
     });
   });
 }
-var init_discover_parent_package_paths = () => {};
+var require2;
+var init_discover_parent_package_paths = __esm(() => {
+  require2 = createRequire2(import.meta.url);
+});
 
 // src/process/terminate-process-tree.ts
 import { spawn as spawn2 } from "node:child_process";
-async function terminateProcessTree(pid, platform = process.platform, runCommand = defaultRunProcessCommand, killProcess = (targetPid, signal) => {
+async function terminateProcessTree(pid, options = {}, platform = process.platform, runCommand = defaultRunProcessCommand, killProcess = (targetPid, signal) => {
   process.kill(targetPid, signal);
 }, isProcessRunning = defaultIsProcessRunning) {
   if (pid <= 0) {
@@ -496,7 +500,7 @@ async function terminateProcessTree(pid, platform = process.platform, runCommand
     } catch {}
     return;
   }
-  const targetPid = pid > 0 ? -pid : pid;
+  const targetPid = options.detachedProcessGroup ? -pid : pid;
   try {
     killProcess(targetPid, "SIGTERM");
   } catch {
@@ -692,7 +696,7 @@ async function terminateAcpxQueueOwner(sessionId) {
     return;
   }
   if (typeof owner.pid === "number" && Number.isInteger(owner.pid) && owner.pid > 0) {
-    await terminateProcessTree(owner.pid);
+    await terminateProcessTree(owner.pid, { detachedProcessGroup: true });
   }
   await unlink(lockPath).catch(() => {});
 }