@wemind/cli 1.1.0 → 1.2.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 (5) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +35 -42
  3. package/dist/cli.js +4918 -1292
  4. package/dist/cli.js.map +1 -1
  5. package/package.json +1 -1
package/LICENSE ADDED
@@ -0,0 +1,22 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Howardzhangdqs (mcp-wechat-server — https://github.com/Howardzhangdqs/mcp-wechat-server)
4
+ Copyright (c) 2026 imwangpan (WeMind — https://github.com/imwangpan/WeMind)
5
+
6
+ Permission is hereby granted, free of charge, to any person obtaining a copy
7
+ of this software and associated documentation files (the "Software"), to deal
8
+ in the Software without restriction, including without limitation the rights
9
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
+ copies of the Software, and to permit persons to whom the Software is
11
+ furnished to do so, subject to the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be included in all
14
+ copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
+ SOFTWARE.
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,7 +10,7 @@
10
10
 
11
11
  ```bash
12
12
  npm i -g @wemind/cli # 安装后得到 wemind 命令
13
- wemind version # → wemind 1.0.0 (@wemind/cli, node 24.x, win32-x64)
13
+ wemind version # → wemind 1.2.0 (@wemind/cli, node …, win32-x64) # 版本以实际安装为准
14
14
 
15
15
  # 不安装、一次性运行（注意是包名 @wemind/cli，不是 wemind）
16
16
  npx -y @wemind/cli list
@@ -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`） |
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,14 @@ 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。
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
+ - ⚠️ **daemon 会让大脑免确认执行工具**（内置的 kiro 带 `--trust-all-tools`；内置的 qoder 带 `--yolo`）：能给这个 bot 发消息的人，即可让大脑在本机执行任意工具（shell / 写文件）。唯一安全闸是**发件人授权（allowFrom）**：扫码登录者自动授权，**勿清空**。
64
66
  - `account.json` 里 bot token 是明文（POSIX 上 chmod 600；Windows 请用目录权限或磁盘加密）。
65
67
  - 同一个 bot token **只能有一个消费者**：`wemind` daemon 与 `@wemind/wechat-mcp` 二选一，否则互相抢消息。
66
68
 
@@ -96,7 +98,7 @@ wemind brain check # ③ 验证大脑能说 ACP（initialize +
96
98
 
97
99
  本包（包名 `@wemind/cli`，命令 `wemind`）通过 GitHub Actions（[`.github/workflows/wemind-publish.yml`](../../.github/workflows/wemind-publish.yml)）发布到 npm。**下面的命令都在 WeMind 仓库根目录运行**，不是在 `packages/wechat-daemon` 子目录。
98
100
 
99
- > ⚠️ **本包比 `@wemind/wechat-mcp` 多一处要改**：版本号除了 `package.json` 和 `package-lock.json`，还有源码常量 `src/version.ts` 的 `CLI_VERSION`（`wemind version` 的输出就来自它）。漏改会让单测与 CI 直接失败——仓库自带 `npm run check:version` 专门挡这个。
101
+ > ℹ️ **版本号只有一处来源**：`packages/wechat-daemon/package.json` 的 `version`。`src/version.ts` 在**运行时**读它（不再手写常量），所以改版本不会漏改源码。仓库提供 `npm run release:*` 一步到位，并自动跑一致性自检。
100
102
 
101
103
  ### 第一步：判断要不要发版
102
104
 
@@ -113,46 +115,37 @@ wemind brain check # ③ 验证大脑能说 ACP（initialize +
113
115
  | 参数 | 示例 | 什么时候用 |
114
116
  | --- | --- | --- |
115
117
  | `patch` | `1.0.0` → `1.0.1` | Bug 修复、兼容性改动（**最常用**） |
116
- | `minor` | `1.0.0` → `1.1.0` | 新增向后兼容的能力（如新增内置大脑预设、新增子命令） |
118
+ | `minor` | `1.0.0` → `1.1.0` | 新增向后兼容的能力（如新增内置的大脑 agent、新增子命令） |
117
119
  | `major` | `1.0.0` → `2.0.0` | 不兼容改动（如删子命令、改数据目录布局、改 CLI 参数） |
118
120
 
119
- ### 第三步：升版本号（三处必须同步）
120
-
121
- **方式 A：用 npm 改 `package.json` + lock，再手改 `version.ts`（推荐）**
121
+ ### 第三步：升版本号（一条命令）
122
122
 
123
123
  ```powershell
124
- # ① 改 package.json 与 package-lock.json
125
- npm version patch --workspace @wemind/cli --no-git-tag-version
126
-
127
- # ② 手工同步源码常量（npm 不会帮你改这个）
128
- # 编辑 packages/wechat-daemon/src/version.ts：
129
- # export const CLI_VERSION = "1.0.1"; ← 与上一步的版本一致
130
-
131
- # ③ 自检三处是否一致（不一致会 exit 1）
132
- npm run check:version
124
+ npm run release:patch # 1.1.0 → 1.1.1（Bug 修复）
125
+ npm run release:minor # 1.1.0 → 1.2.0（向后兼容的新功能）
126
+ npm run release:major # 1.1.0 → 2.0.0（不兼容改动）
133
127
  ```
134
128
 
135
- - `--workspace @wemind/cli`：只动本包，不改根项目、mcp、core 的版本；
136
- - `--no-git-tag-version`：不自动创建 commit 或 tag，改完由你自己检查提交。
137
-
138
- **方式 B：全部手动**
139
-
140
- 1. 编辑 `packages/wechat-daemon/package.json` 的 `"version"`；
141
- 2. 编辑 `packages/wechat-daemon/src/version.ts` 的 `CLI_VERSION`；
142
- 3. 回到仓库根目录刷新锁文件：
129
+ 这三个脚本等价于：
143
130
 
144
131
  ```powershell
145
- npm install --package-lock-only --ignore-scripts
132
+ npm version <type> --workspace @wemind/cli --no-git-tag-version && npm run check:version
146
133
  ```
147
134
 
148
- > 不要手动编辑 `package-lock.json`。上面这条只重算 lockfile 元数据，不重装 `node_modules`、不跑依赖的安装脚本。
135
+ - 前半句改 **`package.json` 与 `package-lock.json` 两处**；`--no-git-tag-version` 让它**不**自动创建 git commit 和 tag（我们的发布流程要求「版本号 + 源码改动」在同一个 commit 里）；
136
+ - 后半句跑 `check-version` 自检：包名、`bin` 是否仍叫 `wemind`、lock 是否同步、**`src/version.ts` 有没有被改回硬编码版本号**。任一项不对就 `exit 1`，`&&` 会中断，不会带着错误版本继续。
137
+
138
+ > **指定具体版本**：`npm version 1.4.2 --workspace @wemind/cli --no-git-tag-version`
139
+ >
140
+ > 想完全手动也可以：改 `packages/wechat-daemon/package.json` 的 `"version"`，再 `npm install --package-lock-only --ignore-scripts` 刷新 lock。
141
+ > **不需要**改 `src/version.ts`——它运行时读 package.json。不要手动编辑 `package-lock.json`。
149
142
 
150
143
  ### 第四步：本地校验
151
144
 
152
145
  ```powershell
153
- npm run check:version # 包名 + 三处版本一致（package.json / version.ts / lock）
146
+ npm run check:version # 包名 / bin / lock / 无硬编码版本号
154
147
  npm run lint && npm run typecheck && npm run build && npm test
155
- npm pack --dry-run --workspace @wemind/cli # 应看到 4 个文件：cli.js / cli.js.map / README.md / package.json
148
+ npm pack --dry-run --workspace @wemind/cli # 应看到 5 个文件：LICENSE / README.md / package.json / dist/cli.js / dist/cli.js.map
156
149
  ```
157
150
 
158
151
  > ⚠️ **`npm publish` 不会自动 build**。CI 会 build，但本地 `npm pack` 前必须先 `npm run build`，否则打出来是旧产物（`dist/` 在 `.gitignore` 里）。
@@ -162,16 +155,16 @@ npm pack --dry-run --workspace @wemind/cli # 应看到 4 个文件：cli.js /
162
155
  ### 第五步：提交并推送
163
156
 
164
157
  ```powershell
165
- git add packages/wechat-daemon/package.json packages/wechat-daemon/src/version.ts package-lock.json
158
+ git add packages/wechat-daemon/package.json package-lock.json
166
159
  git add packages/wechat-daemon/src packages/wechat-ilink-core/src # 有源码改动时
167
- git commit -m "chore: release @wemind/cli 1.0.1"
160
+ git commit -m "chore: release @wemind/cli 1.2.0" # 换成当前要发的版本
168
161
  git push origin main
169
162
  ```
170
163
 
171
164
  推送到 `main` 后，工作流依次执行：
172
165
 
173
166
  ```
174
- check-version（三处一致）→ npm ci → lint → format:check → typecheck → build → test
167
+ check-version（包名 / bin / lock / 无硬编码版本号）→ npm ci → lint → format:check → typecheck → build → test
175
168
  → npm pack --dry-run（prepack 守卫确认包内容）
176
169
  → 把 tarball 真装到临时目录跑 wemind version / help（装包冒烟）
177
170
  → 检查 npm 上是否已存在该版本
@@ -194,9 +187,9 @@ wemind list # 应能正确识别在跑
194
187
 
195
188
  | 现象 | 原因 | 处理 |
196
189
  | --- | --- | --- |
197
- | CI 在 `check-version` 就红了 | 只改了 `package.json`，没同步 `version.ts` | 改 `CLI_VERSION` 后重推 |
198
- | CI 绿了但 npm 上没新版本 | 版本号没升，被跳过 | 升版本号后再推 |
199
- | CI 报 lock 版本不一致 | 没跑 `npm install --package-lock-only` | 补跑第三步 |
190
+ | `check-version` 报「lock 版本不一致」 | 手改了 `package.json` 没刷新 lock | `npm install --package-lock-only --ignore-scripts`（或改用 `npm run release:*`） |
191
+ | `check-version` 报「硬编码 CLI_VERSION 字面量」 | 有人把 `src/version.ts` 改回了常量写法 | 还原为 `readOwnVersion(...)`（版本号必须只来自 package.json） |
192
+ | CI 绿了但 npm 上没新版本 | 版本号没升，被跳过 | `npm run release:patch` 后再推 |
200
193
  | `npm pack` 出来是空壳 | 没先 `npm run build` | 先 build 再 pack |
201
194
  | `prepack` 守卫拒绝发布 | 产物为空 / `bin` 缺失 / 声明了 sourcemap 但 `.map` 不在包里 | 按守卫提示补 build 或检查 `files` |
202
195
  | `npm publish` 报 403 / EOTP | 本地直发需要交互式 2FA | **不要本地发**，走 CI（Trusted Publisher 已配好） |