@wemind/cli 1.1.1 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +20 -16
  2. package/dist/cli.js +4974 -1263
  3. package/dist/cli.js.map +1 -1
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @wemind/cli — 命令 `wemind`
2
2
 
3
- > **你的 AI 大脑，挂在微信上。** 常驻微信 Bot 守护进程：自己长轮询 iLink 收消息 → 调常驻 **ACP 大脑**生成回复 → 自动回发。支持**远程任务（worker）**、**多账号**、收发图/文件。
3
+ > **你的 AI 大脑，挂在微信上。** 常驻微信 Bot daemon：自己长轮询 iLink 收消息 → 调常驻 **ACP 大脑**生成回复 → 自动回发。支持**运行时切换大脑**（免重启）、**多任务并行（worker 进程池）**、**完整会话管理**（列表/恢复/改名/删除）、**会话交接**、**多账号**、收发图/文件。
4
4
 
5
5
  [WeMind](https://github.com/imwangpan/WeMind) monorepo 的完整应用包；只依赖内核 `@wemind/wechat-ilink-core`（构建时已内联进单文件产物），不碰 MCP 层，可独立运行。
6
6
 
@@ -10,13 +10,13 @@
10
10
 
11
11
  ```bash
12
12
  npm i -g @wemind/cli # 安装后得到 wemind 命令
13
- wemind version # → wemind 1.1.0 (@wemind/cli, node …, win32-x64) # 版本以实际安装为准
13
+ wemind version # → wemind 1.3.0 (@wemind/cli, node …, win32-x64) # 版本以实际安装为准
14
14
 
15
15
  # 不安装、一次性运行（注意是包名 @wemind/cli，不是 wemind）
16
16
  npx -y @wemind/cli list
17
17
  ```
18
18
 
19
- 要求：**Node.js >= 20**；想让它真的会「思考」，需要 PATH 上有一个支持 **ACP** 的 agent CLI（`kiro-cli` / `opencode` / 桌面端 `dsh` / `qodercli` 等；未配置时自动探测 `kiro → opencode → gemini → deepseek → qoder`）。
19
+ 要求：**Node.js >= 20**；想让它真的会「思考」，需要 PATH 上有一个支持 **ACP** 的 agent CLI（`kiro-cli` / `opencode` / 桌面端 `dsh` / `qodercli` / `cline` 等；未配置时自动探测 `kiro → opencode → gemini → deepseek → qoder → cline`）。
20
20
 
21
21
  ## 升级
22
22
 
@@ -28,7 +28,7 @@ wemind stop <账号> && wemind start <账号> # 已在运行的 daemon 不会
28
28
  ## 三步上手
29
29
 
30
30
  ```bash
31
- wemind login --label 主号 --start # ① 终端里出二维码，微信扫码 → 自动归档 + 启动常驻
31
+ wemind login --label 工作号 --start # ① 终端里出二维码，微信扫码 → 自动归档 + 启动常驻
32
32
  wemind list # ② 看账号与运行状态
33
33
  wemind brain check # ③ 验证大脑能说 ACP（initialize + session/new 握手）
34
34
  ```
@@ -40,11 +40,13 @@ wemind brain check # ③ 验证大脑能说 ACP（initialize +
40
40
  | 命令 | 作用 |
41
41
  | --- | --- |
42
42
  | `wemind login [--label 名] [--start] [--runner builtin\|pm2]` | 扫码登录；`--start` 顺带拉起常驻 |
43
- | `wemind list` | 账号、别名、运行状态、当前大脑 |
43
+ | `wemind list` | 账号、别名、运行状态、当前大脑、worker 池 |
44
44
  | `wemind start / stop <key\|label>` | 启停某账号的常驻 |
45
- | `wemind brain [show\|set\|unset\|check]` | 查看/切换/清除/自检大脑（`brain set deepseek --bin "<绝对路径>" --restart`） |
46
- | `wemind task "<描述>" [--cwd 目录]` | 本地派发远程任务给 worker |
47
- | `wemind task-status / task-reply / task-stop` | 任务状态、注入续跑（`task-reply 继续`）、结束 |
45
+ | `wemind brain [show\|set\|unset\|check]` | 查看 / 设置（写入磁盘）/ 清除 / 自检大脑（`brain set deepseek --bin "<绝对路径>" --restart`）；只加启动开关用 `--extra-args "…"`（追加，保留预设的 ACP 模式参数），`--args "…"` 是整段替换（漏掉 `acp` 会握手超时，`wemind brain` 会警告） |
46
+ | `wemind brain switch <agent 名\|auto>` | **热切换对话大脑**：daemon 在跑也不重启、不打断在途回合；失败自动回滚。`--worker` 设默认任务大脑；`wemind brain handoff` 生成交接摘要 |
47
+ | `wemind session new [名字] / list / resume <ref> / rename <ref> <名> / delete <ref>` | 会话管理：新建 / 列表 / 严格恢复 / 改名 / 删除（`ref` = 序号、名字或 id 前缀） |
48
+ | `wemind task "<描述>" [--agent 名] [--cwd 目录]` | 派发任务给 worker（多任务并行、按编号回话） |
49
+ | `wemind task-list / task-reply <编号> "…" / task-stop [编号\|全部]` | 任务列表、回话续跑（`task-reply 继续`）、结束（在等回复的进程回池复用） |
48
50
  | `wemind allow / revoke / allowlist` | 授权管理（谁能驱动这个 bot） |
49
51
  | `wemind logout / delete / label / set-default` | 账号运维 |
50
52
  | `wemind version` / `wemind help` | 版本、完整帮助 |
@@ -53,14 +55,15 @@ wemind brain check # ③ 验证大脑能说 ACP（initialize +
53
55
 
54
56
  ## 常驻怎么跑
55
57
 
56
- `wemind start` 默认用**自带的跨平台看门狗**（builtin）：detached 拉起 `wemind _watchdog`，它循环执行 `wemind daemon`，进程退出 5 秒后自动重拉；单实例靠 `wrapper.pid` + 进程身份校验。也可以用 `--runner pm2`（或 `WEMIND_RUNNER=pm2`）交给 pm2——`wemind` 会在账号目录生成 `pm2.app.json`（5s 重拉、最多 50 次、退出码 78 停手、日志合并到 `daemon.log`，与 builtin 语义一致），再 `pm2 start` 它。
58
+ `wemind start` 默认用**自带的跨平台后台守护进程**（builtin）：detached 拉起 `wemind _watchdog`，它循环执行 `wemind daemon`，进程退出 5 秒后自动重拉；单实例靠 `wrapper.pid` + 进程身份校验。也可以用 `--runner pm2`（或 `WEMIND_RUNNER=pm2`）交给 pm2——`wemind` 会在账号目录生成 `pm2.app.json`（5s 重拉、最多 50 次、退出码 78 停手、日志合并到 `daemon.log`，与 builtin 语义一致），再 `pm2 start` 它。
57
59
 
58
60
  开机自启：让系统在登录时执行一次 `wemind start <账号>` 即可（Windows 计划任务/启动文件夹、Linux systemd user service、macOS launchd）。**同一账号只用一套常驻方案**——两种 runner 同时跑会抢同一个 bot token。
59
61
 
60
62
  ## 数据与安全
61
63
 
62
- - 所有状态在 `~/.wemind/<账号>/`（可用 `WEMIND_HOME` 改根目录）：`account.json` 登录凭证、`state.json` 游标、`allowFrom.json` 授权清单、`brain-home/` 大脑沙箱、`daemon.log` 日志。
63
- - ⚠️ **daemon 会让大脑免确认执行工具**（kiro 预设 `--trust-all-tools`；qoder 预设 `--yolo`）：能给这个 bot 发消息的人，即可让大脑在本机执行任意工具（shell / 写文件）。唯一安全闸是**发件人授权（allowFrom）**：扫码登录者自动授权，**勿清空**。
64
+ - 所有状态在 `~/.wemind/<账号>/`（可用 `WEMIND_HOME` 改根目录）：`account.json` 登录凭证、`state.json` 游标（读到哪条消息了）、`allowFrom.json` 授权清单、`brain-home/` 大脑沙箱、`daemon.log` 日志。
65
+ - **适配器类大脑要单独装**（`claude-code` / `codex`）：先 `npm i -g <适配器包>`（npx 只作兜底，常驻 daemon / 每条 worker 任务起进程时它要每次联网且版本会漂）。Claude Code：`npm i -g @agentclientprotocol/claude-agent-acp`（**Node ≥22**；Windows 产出 `claude-agent-acp.cmd`）→ `wemind brain set claude-code`；沙箱用 `CLAUDE_CONFIG_DIR=<brain-home>/claude`（实测连 `~/.claude.json` 一起隔离），MCP 走 ACP `mcpServers`（目录取真实 `~/.claude.json`，`wechat` 永远排除），免审批走 `session/set_mode bypassPermissions`。
66
+ - ⚠️ **daemon 会让大脑免确认执行工具**（**8 个内置预设默认都免审批**：kiro `--trust-all-tools`、gemini `--approval-mode yolo`、qoder `--yolo`、cline `--auto-approve true`、opencode 沙箱 `permission: allow`、DSH `danger-full-access`、claude-code `bypassPermissions`、codex `agent-full-access`）：能给这个 bot 发消息的人，即可让大脑在本机执行任意工具（shell / 写文件）。唯一安全闸是**发件人授权（allowFrom）**：扫码登录者自动授权，**勿清空**。边缘权限请求默认拒绝，`WEMIND_ACP_AUTO_ALLOW=1` 才逐次放行。
64
67
  - `account.json` 里 bot token 是明文（POSIX 上 chmod 600；Windows 请用目录权限或磁盘加密）。
65
68
  - 同一个 bot token **只能有一个消费者**：`wemind` daemon 与 `@wemind/wechat-mcp` 二选一，否则互相抢消息。
66
69
 
@@ -71,8 +74,9 @@ wemind brain check # ③ 验证大脑能说 ACP（initialize +
71
74
  | `WEMIND_HOME` | 数据根目录，默认 `~/.wemind` |
72
75
  | `WECHAT_ACCOUNT` / `WECHAT_DATA_DIR` | 指定账号 / 指定完整数据目录（多账号隔离） |
73
76
  | `WEMIND_RUNNER` | `builtin`（默认）或 `pm2` |
74
- | `WEMIND_BRAIN` / `WEMIND_BRAIN_BIN` / `WEMIND_BRAIN_ARGS` | 一次性覆盖大脑选择（持久化请用 `wemind brain set`） |
77
+ | `WEMIND_BRAIN` / `WEMIND_BRAIN_BIN` / `WEMIND_BRAIN_ARGS` / `WEMIND_BRAIN_EXTRA_ARGS` | 一次性覆盖大脑选择与启动参数（`ARGS` 整段替换、`EXTRA_ARGS` 追加；持久化请用 `wemind brain set`） |
75
78
  | `WEMIND_ACP_AUTO_ALLOW=1` | 放行 ACP agent 的一次性权限请求（默认为拒绝） |
79
+ | `WEMIND_ACP_SESSION_MODE` | 覆盖/关闭预设的会话模式（`session/set_mode`）：`0`/`false`/`off` 关闭，其它值 = 该 modeId |
76
80
 
77
81
  ## 与 MCP 形态的区别
78
82
 
@@ -113,14 +117,14 @@ wemind brain check # ③ 验证大脑能说 ACP（initialize +
113
117
  | 参数 | 示例 | 什么时候用 |
114
118
  | --- | --- | --- |
115
119
  | `patch` | `1.0.0` → `1.0.1` | Bug 修复、兼容性改动（**最常用**） |
116
- | `minor` | `1.0.0` → `1.1.0` | 新增向后兼容的能力（如新增内置大脑预设、新增子命令） |
120
+ | `minor` | `1.0.0` → `1.1.0` | 新增向后兼容的能力（如新增内置的大脑 agent、新增子命令） |
117
121
  | `major` | `1.0.0` → `2.0.0` | 不兼容改动（如删子命令、改数据目录布局、改 CLI 参数） |
118
122
 
119
123
  ### 第三步：升版本号（一条命令）
120
124
 
121
125
  ```powershell
122
126
  npm run release:patch # 1.1.0 → 1.1.1（Bug 修复）
123
- npm run release:minor # 1.1.0 → 1.2.0（向后兼容的新功能）
127
+ npm run release:minor # 1.2.0 → 1.3.0（向后兼容的新功能）
124
128
  npm run release:major # 1.1.0 → 2.0.0（不兼容改动）
125
129
  ```
126
130
 
@@ -143,7 +147,7 @@ npm version <type> --workspace @wemind/cli --no-git-tag-version && npm run check
143
147
  ```powershell
144
148
  npm run check:version # 包名 / bin / lock / 无硬编码版本号
145
149
  npm run lint && npm run typecheck && npm run build && npm test
146
- npm pack --dry-run --workspace @wemind/cli # 应看到 4 个文件：cli.js / cli.js.map / README.md / package.json
150
+ npm pack --dry-run --workspace @wemind/cli # 应看到 5 个文件：LICENSE / README.md / package.json / dist/cli.js / dist/cli.js.map
147
151
  ```
148
152
 
149
153
  > ⚠️ **`npm publish` 不会自动 build**。CI 会 build，但本地 `npm pack` 前必须先 `npm run build`，否则打出来是旧产物（`dist/` 在 `.gitignore` 里）。
@@ -155,7 +159,7 @@ npm pack --dry-run --workspace @wemind/cli # 应看到 4 个文件：cli.js /
155
159
  ```powershell
156
160
  git add packages/wechat-daemon/package.json package-lock.json
157
161
  git add packages/wechat-daemon/src packages/wechat-ilink-core/src # 有源码改动时
158
- git commit -m "chore: release @wemind/cli 1.1.1"
162
+ git commit -m "chore: release @wemind/cli 1.3.0" # 换成当前要发的版本
159
163
  git push origin main
160
164
  ```
161
165