botmux 1.13.0 → 1.13.1

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/README.en.md +249 -142
  2. package/README.md +251 -133
  3. package/dist/im/lark/message-parser.js +13 -8
  4. package/dist/im/lark/message-parser.js.map +1 -1
  5. package/package.json +1 -1
package/README.en.md CHANGED
@@ -4,84 +4,276 @@
4
4
  <img src="cover.svg" alt="botmux cover" width="800">
5
5
  </p>
6
6
 
7
- [中文](README.md) | English
8
-
9
- Bridge between Lark (Feishu) topic groups and AI coding CLIs. The daemon listens for Lark messages and automatically spawns an independent CLI process (supporting Claude Code, Aiden, CoCo, Codex, Gemini) for each new topic thread, with live streaming cards and a web-based terminal.
10
-
11
- ## Demo
7
+ <p align="center">
8
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License MIT"></a>
9
+ <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg" alt="Node.js >= 20">
10
+ <a href="https://www.npmjs.com/package/botmux"><img src="https://img.shields.io/npm/v/botmux.svg" alt="npm version"></a>
11
+ <a href="https://github.com/deepcoldy/botmux"><img src="https://img.shields.io/github/stars/deepcoldy/botmux?style=social" alt="GitHub Stars"></a>
12
+ </p>
12
13
 
13
14
  <p align="center">
14
- <img src="gif/fold&unfold.gif" alt="Lark card interaction — streaming output fold/unfold" width="600">
15
+ <a href="#design-philosophy">Design</a> &middot;
16
+ <a href="#key-advantages">Advantages</a> &middot;
17
+ <a href="#5-minute-setup">Quick Start</a> &middot;
18
+ <a href="#usage">Usage</a> &middot;
19
+ <a href="#configuration">Config</a>
15
20
  </p>
16
21
 
22
+ [中文](README.md) | English
23
+
24
+ **Plug any AI coding CLI into Lark (Feishu) topic groups — one thread per session, streaming cards, web terminal, zero glue code.**
25
+
26
+ | Lark Streaming Cards | Web Terminal | tmux Session Management | Multi-Bot Collaboration |
27
+ |:-:|:-:|:-:|:-:|
28
+ | <img src="gif/fold&unfold.gif" width="220" /> | <img src="gif/web_terminal.gif" width="220" /> | <img src="gif/tmux.gif" width="220" /> | <img src="docs/setup/multi-bot-collab.png" width="220" /> |
29
+
17
30
  <details>
18
- <summary>📺 Full demo video</summary>
31
+ <summary>Full demo video</summary>
19
32
 
20
33
  [Demo Video](https://github.com/user-attachments/assets/3ba4c681-0a7e-4a03-89c8-b8d26b544a65)
21
34
  </details>
22
35
 
23
- ## Features
36
+ ---
37
+
38
+ ## Why botmux?
39
+
40
+ ### Design Philosophy
41
+
42
+ Core philosophy: **Bridge CLIs, don't rebuild them**. botmux doesn't reimplement Agent capabilities — it bridges existing AI coding CLIs (Claude Code, Codex, Aiden, CoCo, Gemini, OpenCode) directly. Memory, context management, tool use, permission systems — these capabilities are evolving rapidly within the CLIs themselves. botmux rides on top of that evolution rather than rebuilding in parallel. Every CLI upgrade benefits botmux automatically with zero adaptation.
43
+
44
+ ### Key Advantages
45
+
46
+ Compared to OpenClaw-style approaches built on Agent SDKs:
47
+
48
+ | Feature | botmux | OpenClaw-style |
49
+ |---------|--------|---------------|
50
+ | Architecture | Bridges full CLI processes directly | Rebuilds on Agent SDK |
51
+ | CLI Capabilities | Full runtime (hooks, memory, plan mode, MCP ecosystem, `/` commands) | SDK API subset, missing features must be reimplemented |
52
+ | CLI Upgrades | Zero-adaptation automatic benefit | Must track SDK version changes |
53
+ | Memory / Context | Reuses CLI's built-in memory system, improves as the CLI evolves | Must build custom memory system, duplicating CLI-native capabilities |
54
+ | Multi-CLI Support | 6 CLIs, switch with one config (Claude Code / Codex / Aiden / CoCo / Gemini / OpenCode) | Tied to a single SDK, cannot switch CLIs |
55
+ | Web Terminal | Interactive full terminal, mobile shortcut toolbar, phone/desktop/Lark tri-screen sync | Usually web chat UI or read-only output |
56
+ | Multi-Bot Collaboration | Multiple bots in same group via @mention routing, isolated processes, different CLIs sparring | Usually single bot |
57
+ | Terminal Access | tmux attach directly into the CLI process, same as local dev experience | No direct terminal access |
58
+ | Installation | `npm install -g botmux`, 5-min Lark setup | Easy to install, but more configuration needed |
24
59
 
25
- - **One topic = one AI coding session** — each Lark thread gets its own isolated CLI process
26
- - **Multi-CLI support** — adapter architecture supports Claude Code, Aiden, CoCo, Codex, Gemini, and is extensible
27
- - **Live streaming cards** — real-time terminal output rendered in Feishu cards with markdown support, per-turn card lifecycle
28
- - **Web terminal (xterm.js)** — full PTY output in the browser with a mobile shortcut toolbar and on-demand write access via DM link
29
- - **Session persistence** — sessions survive daemon restarts; with tmux backend, CLI processes persist across restarts with zero interruption
30
- - **Scheduled tasks** — cron-based recurring prompts with natural language scheduling (Chinese supported)
31
- - **Project management** — interactive repo selector, per-session working directory
32
- - **MCP integration** — CLI can reply to Lark threads, read message history, and add reactions via MCP tools
33
- - **Access control** — allowlist for users, token-based write access for terminals, button restrictions on cards
60
+ ---
34
61
 
35
62
  ## Prerequisites
36
63
 
37
64
  - **Node.js** >= 20
38
65
  - **AI coding CLI** installed and authenticated (`claude`, `aiden`, `coco`, `codex`, `gemini`, or `opencode` in PATH)
39
- - **Lark app** with Bot and Message permissions (WebSocket event subscription)
40
66
  - **tmux** >= 3.x (optional — auto-enabled when installed for persistent CLI sessions)
41
67
 
42
- ## Installation
68
+ ## 5-Minute Setup
43
69
 
44
- ```bash
45
- npm install -g botmux
70
+ ### Step 1: Create a Lark App
71
+
72
+ Go to the [Lark Open Platform](https://open.larkoffice.com/app) and click "Create Custom App".
73
+
74
+ ![Create App](docs/setup/create-app.png)
75
+
76
+ ### Step 2: Get Credentials
77
+
78
+ Open the app details page → "Credentials & Basic Info", and copy the **App ID** and **App Secret**.
79
+
80
+ ![Get Credentials](docs/setup/credentials.png)
81
+
82
+ ### Step 3: Add Permissions
83
+
84
+ Go to "Permissions & Scopes" → "Batch Import/Export", and paste the following JSON to import all permissions at once:
85
+
86
+ ![Permissions](docs/setup/permissions.png)
87
+
88
+ <details>
89
+ <summary>Click to expand batch import JSON</summary>
90
+
91
+ ```json
92
+ {
93
+ "scopes": {
94
+ "tenant": [
95
+ "contact:user.base:readonly",
96
+ "contact:user.id:readonly",
97
+ "im:chat:read",
98
+ "im:chat.members:bot_access",
99
+ "im:chat.members:read",
100
+ "im:message",
101
+ "im:message:readonly",
102
+ "im:message:send_as_bot",
103
+ "im:message:update",
104
+ "im:message.group_at_msg",
105
+ "im:message.group_at_msg:readonly",
106
+ "im:message.group_msg",
107
+ "im:message.p2p_msg:readonly",
108
+ "im:message.reactions:write_only",
109
+ "im:resource"
110
+ ]
111
+ }
112
+ }
46
113
  ```
114
+ </details>
47
115
 
48
- ## Quick Start
116
+ ### Step 4: Install & Start botmux
49
117
 
50
118
  ```bash
51
- # 1. Interactive setup — creates ~/.botmux/bots.json
119
+ # Install
120
+ npm install -g botmux
121
+
122
+ # Interactive setup — enter the App ID and App Secret from Step 2
52
123
  botmux setup
53
124
 
54
- # 2. Start the daemon
125
+ # Start (must be running before configuring WebSocket subscription — Lark checks for an active connection)
55
126
  botmux start
56
127
  ```
57
128
 
58
- The `setup` command will guide you through:
59
- - Creating a Lark app (with required permissions listed)
60
- - Entering App ID, App Secret, Chat ID
61
- - Optional: Claude model, working directory, access control
129
+ ### Step 5: Configure Event Subscription
62
130
 
63
- ## CLI Commands
131
+ Back in the Lark Open Platform, go to "Events & Callbacks":
132
+
133
+ 1. **Subscription mode**: Click the edit icon, select "Receive events via persistent connection" (WebSocket) — requires botmux to be running so Lark can detect the connection
134
+
135
+ ![WebSocket subscription](docs/setup/event-websocket.png)
136
+
137
+ 2. **Add event**: Click "Add Event", search and add `im.message.receive_v1` (Receive messages v2.0)
138
+
139
+ ![Add event](docs/setup/event-receive-msg.png)
140
+
141
+ 3. **Enable callback**: Switch to the "Callback Configuration" tab, turn on "Card action callback" (`card.action.trigger`)
142
+
143
+ ### Step 6: Publish the App
144
+
145
+ Go to "Version Management & Release", click "Create Version" and publish. Set availability to "Visible to me only" for automatic approval.
146
+
147
+ ![Publish](docs/setup/publish.png)
148
+
149
+ ### Step 7: Create a Group and Start Chatting
150
+
151
+ 1. Create a **topic-enabled group** in Lark
152
+ 2. Go to Group Settings → Bots → Add the bot you just created
153
+ 3. Send a message in the group — the bot responds automatically
154
+
155
+ ![Add bot to group](docs/setup/add-bot-to-group.png)
156
+
157
+ ---
158
+
159
+ ## Features
160
+
161
+ ### Streaming Cards
162
+
163
+ Each conversation turn gets a live-updating Feishu card that shows:
164
+
165
+ - Real-time terminal output rendered as Markdown, TUI chrome auto-filtered to show only actual work output
166
+ - Status indicator: Starting > Working > Idle
167
+ - Action buttons: Open Terminal, Get Write Link, Restart CLI, Close Session
168
+
169
+
170
+ ### Web Terminal (Interactive)
171
+
172
+ Each session exposes a web terminal at `http://<WEB_EXTERNAL_HOST>:<port>`.
173
+
174
+ - **Read-only link** — shown on the streaming card in the group thread
175
+ - **Write-enabled link** — sent via DM on demand (click "Get Write Link" on the card)
176
+
177
+ On mobile/tablet, a floating shortcut toolbar provides Esc, Ctrl+C, Tab, arrow keys and other control keys missing from virtual keyboards — full CLI control from your phone.
178
+
179
+ ### Multi-Bot Collaboration
180
+
181
+ Run multiple Lark bots on a single machine, each mapped to a different CLI. In the same group chat, messages are routed via @mention — each bot gets its own isolated CLI process. With a single bot in the group, it responds automatically without @.
182
+
183
+ ### Tmux Persistence
184
+
185
+ When tmux is installed, botmux automatically uses it. CLI processes persist inside tmux sessions — all features work unchanged.
186
+
187
+ **Key benefit: daemon restarts don't interrupt the CLI.** During `botmux restart`, the worker process exits but the tmux session (and the CLI inside it) keeps running. The next incoming message triggers a re-attach — no `--resume` context reload needed.
188
+
189
+ ```bash
190
+ # Recommended: interactive session picker — select and attach to tmux
191
+ npx botmux list
192
+
193
+ # Or manually attach (session name = bmx-<first 8 chars of session ID>)
194
+ tmux attach -t bmx-<first-8-chars-of-session-id>
195
+ # Ctrl+B, D to detach — CLI keeps running
196
+
197
+ # Force pure pty mode (disable tmux)
198
+ BACKEND_TYPE=pty botmux start
199
+ ```
200
+
201
+ `botmux list` provides an interactive TUI showing all active sessions with ID, title, working directory, PID, uptime, and status. Use arrow keys to select and Enter to attach. Use `botmux list --plain` for plain-text table output suitable for scripting.
202
+
203
+ **Session naming:** `bmx-<first 8 chars of session UUID>`
204
+
205
+ **Lifecycle:**
206
+
207
+ | Event | tmux session | CLI process |
208
+ |-------|-------------|-------------|
209
+ | `botmux restart` | Survives | Survives (re-attaches on next message) |
210
+ | `/close` or close button | Destroyed | Terminated (SIGHUP) |
211
+ | CLI exits / crashes | Closes with it | Already exited (auto-restart creates new session) |
212
+
213
+ ### Scheduled Tasks
214
+
215
+ Create recurring tasks with natural language:
216
+
217
+ ```
218
+ /schedule every day at 17:50 check AI news
219
+ /schedule weekdays at 9:00 run health check
220
+ /schedule every Monday at 10:00 generate weekly report
221
+ ```
222
+
223
+ ### MCP Integration
224
+
225
+ botmux exposes MCP tools so the CLI can interact with Lark directly:
226
+
227
+ - Reply to the current Lark thread
228
+ - Read message history from the thread
229
+ - Add emoji reactions to messages
230
+
231
+ ---
232
+
233
+ ## Usage
234
+
235
+ ### Workflow
236
+
237
+ 1. Send a message in your Lark topic group to create a new thread
238
+ 2. The bot shows a repo selection card — pick a project or click "Start directly"
239
+ 3. The CLI spawns in the selected directory
240
+ 4. A live streaming card appears in the thread, showing real-time terminal output with markdown rendering
241
+ 5. Each reply creates a new streaming card for that turn; previous cards freeze at their last state
242
+ 6. Click "Get Write Link" on the card to receive a write-enabled terminal URL via DM
243
+ 7. The CLI replies in the thread via MCP tools
244
+
245
+ ### Slash Commands
64
246
 
65
247
  | Command | Description |
66
248
  |---------|-------------|
67
- | `botmux setup` | Interactive setup (first-time or add bots) |
68
- | `botmux start` | Start daemon (PM2 managed) |
69
- | `botmux stop` | Stop daemon |
70
- | `botmux restart` | Restart daemon (auto-restores active sessions) |
71
- | `botmux logs` | View daemon logs (`--lines N` for more) |
72
- | `botmux status` | Show daemon status |
73
- | `botmux upgrade` | Upgrade to latest version |
74
- | `botmux list` | List all active sessions (alias: `ls`) |
75
- | `botmux delete <id>` | Close a session by ID prefix (alias: `del`/`rm`) |
76
- | `botmux delete all` | Close all active sessions |
77
- | `botmux delete stopped` | Clean up zombie sessions with dead processes |
249
+ | `/repo` | Show project selector card |
250
+ | `/repo <N>` | Switch to Nth project from last scan |
251
+ | `/skip` | Skip repo selection, start session directly |
252
+ | `/cd <path>` | Change working directory |
253
+ | `/status` | Show session info (uptime, terminal URL, etc.) |
254
+ | `/cost` | Show token usage and estimated cost |
255
+ | `/restart` | Restart CLI process |
256
+ | `/close` | Close session and terminate CLI |
257
+ | `/clear` | Clear context (new session, same thread) |
258
+ | `/schedule` | Manage scheduled tasks |
259
+ | `/help` | Show available commands |
260
+
261
+ ### Scheduled Task Management
262
+
263
+ ```
264
+ /schedule list
265
+ /schedule remove <id>
266
+ /schedule enable <id>
267
+ /schedule disable <id>
268
+ /schedule run <id>
269
+ ```
270
+
271
+ ---
78
272
 
79
273
  ## Configuration
80
274
 
81
275
  Configure bots via `~/.botmux/bots.json`. Run `botmux setup` to create it interactively, or edit manually.
82
276
 
83
- Supports running multiple Lark bots on a single machine, each mapped to a different CLI. Multiple bots in the same group chat route messages via @mention; a single bot responds automatically without @.
84
-
85
277
  ```bash
86
278
  # Interactive setup
87
279
  botmux setup
@@ -130,7 +322,7 @@ botmux setup
130
322
  | `SESSION_DATA_DIR` | `~/.botmux/data` | Where sessions and queues are stored |
131
323
  | `DEBUG` | _(unset)_ | Set to `1` for debug logging |
132
324
 
133
- ## File Locations
325
+ ### File Locations
134
326
 
135
327
  | Path | Description |
136
328
  |------|-------------|
@@ -138,110 +330,25 @@ botmux setup
138
330
  | `~/.botmux/data/` | Session data, message queues |
139
331
  | `~/.botmux/logs/` | Daemon logs |
140
332
 
141
- ## Usage
142
-
143
- ### Workflow
144
-
145
- 1. Send a message in your Lark topic group to create a new thread
146
- 2. The bot shows a repo selection card — pick a project or click "Start directly"
147
- 3. Claude Code spawns in the selected directory
148
- 4. A live streaming card appears in the thread, showing real-time terminal output with markdown rendering
149
- 5. Each reply creates a new streaming card for that turn; previous cards freeze at their last state
150
- 6. Click "🔑 Get Write Link" on the card to receive a write-enabled terminal URL via DM
151
- 7. Claude replies in the thread via MCP tools
333
+ ---
152
334
 
153
- ### Slash Commands
335
+ ## CLI Commands
154
336
 
155
337
  | Command | Description |
156
338
  |---------|-------------|
157
- | `/repo` | Show project selector card |
158
- | `/repo <N>` | Switch to Nth project from last scan |
159
- | `/skip` | Skip repo selection, start session directly |
160
- | `/cd <path>` | Change working directory |
161
- | `/status` | Show session info (uptime, terminal URL, etc.) |
162
- | `/cost` | Show token usage and estimated cost |
163
- | `/restart` | Restart Claude process |
164
- | `/close` | Close session and terminate Claude |
165
- | `/clear` | Clear context (new session, same thread) |
166
- | `/schedule` | Manage scheduled tasks |
167
- | `/help` | Show available commands |
168
-
169
- ### Scheduled Tasks
170
-
171
- Create recurring tasks with natural language:
172
-
173
- ```
174
- /schedule every day at 17:50 check AI news
175
- /schedule weekdays at 9:00 run health check
176
- /schedule every Monday at 10:00 generate weekly report
177
- ```
178
-
179
- Manage tasks:
180
-
181
- ```
182
- /schedule list
183
- /schedule remove <id>
184
- /schedule enable <id>
185
- /schedule disable <id>
186
- /schedule run <id>
187
- ```
188
-
189
- ### Streaming Cards
190
-
191
- Each conversation turn gets a live-updating Feishu card that shows:
192
-
193
- - Real-time terminal output (rendered via headless xterm + Feishu Card v2 markdown)
194
- - Status indicator: 🟡 Starting > 🔵 Working > 🟢 Idle
195
- - Action buttons: Open Terminal, Get Write Link, Restart Claude, Close Session
196
-
197
- The card content is captured from a headless xterm terminal that filters out TUI chrome (logo, status bar, prompts, box-drawing characters) and shows only Claude's actual work output.
198
-
199
- ### Web Terminal
200
-
201
- <p align="center">
202
- <img src="gif/web_terminal.gif" alt="Web terminal live output" width="600">
203
- </p>
204
-
205
- Each session exposes a web terminal at `http://<WEB_EXTERNAL_HOST>:<port>`.
206
-
207
- - **Read-only link** — shown on the streaming card in the group thread
208
- - **Write-enabled link** — sent via DM on demand (click "🔑 Get Write Link" on the card)
209
-
210
- Features: xterm.js with fit/unicode11/web-links addons, TokyoNight theme, scrollback buffer. On mobile/tablet, a floating shortcut toolbar provides Esc, Ctrl+C, Tab, arrow keys and other control keys missing from virtual keyboards, with automatic keyboard avoidance.
211
-
212
- ### Tmux Persistent Sessions
213
-
214
- <p align="center">
215
- <img src="gif/tmux.gif" alt="botmux list — interactive tmux session management" width="600">
216
- </p>
217
-
218
- When tmux is installed, botmux automatically uses the tmux backend. CLI processes run inside tmux sessions while the daemon attaches via node-pty to capture output — streaming cards, idle detection, and web terminal all work unchanged.
219
-
220
- **Key benefit: daemon restarts don't interrupt the CLI.** During `botmux restart`, the worker process exits but the tmux session (and the CLI inside it) keeps running. The next incoming message triggers a re-attach — no `--resume` context reload needed.
221
-
222
- ```bash
223
- # Recommended: interactive session picker — select and attach to tmux
224
- npx botmux list
225
-
226
- # Or manually attach (session name = bmx-<first 8 chars of session ID>)
227
- tmux attach -t bmx-<first-8-chars-of-session-id>
228
- # Ctrl+B, D to detach — CLI keeps running
229
-
230
- # Force pure pty mode (disable tmux)
231
- BACKEND_TYPE=pty botmux start
232
- ```
233
-
234
- `botmux list` provides an interactive TUI showing all active sessions with ID, title, working directory, PID, uptime, and status. Use arrow keys to select and Enter to attach. Use `botmux list --plain` for plain-text table output suitable for scripting.
235
-
236
- **Session naming:** `bmx-<first 8 chars of session UUID>`
237
-
238
- **Lifecycle:**
339
+ | `botmux setup` | Interactive setup (first-time or add bots) |
340
+ | `botmux start` | Start daemon (PM2 managed) |
341
+ | `botmux stop` | Stop daemon |
342
+ | `botmux restart` | Restart daemon (auto-restores active sessions) |
343
+ | `botmux logs` | View daemon logs (`--lines N` for more) |
344
+ | `botmux status` | Show daemon status |
345
+ | `botmux upgrade` | Upgrade to latest version |
346
+ | `botmux list` | List all active sessions (alias: `ls`) |
347
+ | `botmux delete <id>` | Close a session by ID prefix (alias: `del`/`rm`) |
348
+ | `botmux delete all` | Close all active sessions |
349
+ | `botmux delete stopped` | Clean up zombie sessions with dead processes |
239
350
 
240
- | Event | tmux session | CLI process |
241
- |-------|-------------|-------------|
242
- | `botmux restart` | Survives | Survives (re-attaches on next message) |
243
- | `/close` or close button | Destroyed | Terminated (SIGHUP) |
244
- | CLI exits / crashes | Closes with it | Already exited (auto-restart creates new session) |
351
+ ---
245
352
 
246
353
  ## Contributing
247
354
 
package/README.md CHANGED
@@ -4,61 +4,282 @@
4
4
  <img src="cover.svg" alt="botmux cover" width="800">
5
5
  </p>
6
6
 
7
- 中文 | [English](README.en.md)
8
-
9
- 飞书话题群与 AI 编程 CLI 的桥接工具。Daemon 监听飞书消息，为每个新话题自动启动一个独立的 CLI 进程（支持 Claude Code、Aiden、CoCo、Codex、Gemini），提供实时流式卡片和 Web 终端。
7
+ <p align="center">
8
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License MIT"></a>
9
+ <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg" alt="Node.js >= 20">
10
+ <a href="https://www.npmjs.com/package/botmux"><img src="https://img.shields.io/npm/v/botmux.svg" alt="npm version"></a>
11
+ <a href="https://github.com/deepcoldy/botmux"><img src="https://img.shields.io/github/stars/deepcoldy/botmux.svg?style=social" alt="GitHub Stars"></a>
12
+ </p>
10
13
 
11
- ## 演示
14
+ <p align="center">
15
+ <a href="#设计理念">设计理念</a> · <a href="#核心优势">核心优势</a> · <a href="#5-分钟快速接入">快速接入</a> · <a href="#使用指南">使用指南</a> · <a href="#配置">配置</a>
16
+ </p>
12
17
 
13
18
  <p align="center">
14
- <img src="gif/fold&unfold.gif" alt="飞书卡片交互 — 流式输出展开/折叠" width="600">
19
+ 中文 | <a href="README.en.md">English</a>
15
20
  </p>
16
21
 
22
+ ---
23
+
24
+ **飞书话题群 + AI 编程 CLI，一条消息启动编程会话。** Daemon 监听飞书消息，为每个新话题自动启动独立 CLI 进程（Claude Code / Aiden / CoCo / Codex / Gemini / OpenCode），提供实时流式卡片和可交互 Web 终端。
25
+
26
+ ## 演示
27
+
28
+ | 飞书流式卡片 | Web 终端 | tmux 会话管理 | 多机器人协作 |
29
+ |:-:|:-:|:-:|:-:|
30
+ | <img src="gif/fold&unfold.gif" width="220" /> | <img src="gif/web_terminal.gif" width="220" /> | <img src="gif/tmux.gif" width="220" /> | <img src="docs/setup/multi-bot-collab.png" width="220" /> |
31
+
17
32
  <details>
18
- <summary>📺 完整演示视频</summary>
33
+ <summary>完整演示视频</summary>
19
34
 
20
35
  [演示视频](https://github.com/user-attachments/assets/3ba4c681-0a7e-4a03-89c8-b8d26b544a65)
21
36
  </details>
22
37
 
38
+ ---
39
+
40
+ ## 为什么选择 botmux
41
+
42
+ ### 设计理念
43
+
44
+ **不做 SDK wrapper，直接桥接 CLI。**
45
+
46
+ botmux 不重新实现 Agent 能力，而是直接桥接已有的 AI 编程 CLI（Claude Code、Codex、Aiden、CoCo、Gemini、OpenCode）。记忆、上下文管理、工具调用、权限体系——这些能力 CLI 本身都在快速迭代，botmux 选择站在这个进化之上，而不是平行重造一套。CLI 的每次升级，botmux 零适配自动受益。
47
+
48
+ ### 核心优势
49
+
50
+ 与 OpenClaw 等基于 Agent SDK 构建的方案相比：
51
+
52
+ | 特性 | botmux | OpenClaw 类方案 |
53
+ |------|--------|----------------|
54
+ | 底层架构 | 直接桥接完整 CLI 进程 | 基于 Agent SDK 重新构建 |
55
+ | CLI 能力 | 完整运行时（hooks、memory、plan mode、MCP 生态、`/` 命令） | SDK API 子集，需手动实现缺失功能 |
56
+ | CLI 升级 | 零适配自动受益 | 需要跟进 SDK 版本变更 |
57
+ | 记忆 / 上下文 | 直接复用 CLI 内建的记忆系统，随 CLI 迭代自动增强 | 需自建记忆系统，与 CLI 原生能力重复 |
58
+ | 多 CLI 支持 | 6 种 CLI 一键切换（Claude Code / Codex / Aiden / CoCo / Gemini / OpenCode） | 绑定单一 SDK，无法切换 CLI |
59
+ | Web 终端 | 可交互的完整终端，移动端快捷键工具栏，手机/电脑/飞书三端同步 | 通常仅 Web 聊天界面或只读输出 |
60
+ | 多机器人协作 | 多 bot 同群 @mention 路由，独立进程隔离，不同 CLI 赛博斗蛐蛐 | 通常单机器人 |
61
+ | 终端直连 | tmux attach 直接进入 CLI 进程，和本地开发体验一致 | 无法直接操作底层终端 |
62
+ | 安装部署 | `npm install -g botmux`，5 分钟飞书配置即可使用 | 安装简单，但配置项较多 |
63
+
64
+ ---
65
+
23
66
  ## 功能特性
24
67
 
25
- - **一个话题 = 一个 AI 编程会话** — 每个飞书话题线程对应一个独立的 CLI 进程
26
- - **多 CLI 支持** — 通过适配器架构支持 Claude Code、Aiden、CoCo、Codex、Gemini，可扩展
27
- - **实时流式卡片** — 终端输出实时渲染到飞书卡片中，支持 Markdown 格式，每轮对话独立卡片
28
- - **Web 终端 (xterm.js)** — 浏览器查看完整 PTY 输出，移动端快捷键工具栏，按需获取可操作链接
29
- - **会话持久化** — 会话在 Daemon 重启后自动恢复；tmux 后端下 CLI 进程常驻，重启零中断
30
- - **定时任务** — 基于 Cron 的周期性任务，支持中文自然语言配置
31
- - **项目管理** — 交互式仓库选择器，每个会话独立工作目录
32
- - **MCP 集成** — CLI 可通过 MCP 工具回复飞书话题、读取消息历史、添加表情回应
33
- - **权限控制** — 用户白名单、终端 Token 写入权限、卡片按钮操作限制
68
+ ### 实时流式卡片
69
+
70
+ 每轮对话生成一个实时更新的飞书卡片：
71
+
72
+ - 终端输出实时渲染为 Markdown，自动过滤 TUI 装饰，仅展示实际工作输出
73
+ - 状态指示：🟡 启动中 → 🔵 工作中 → 🟢 就绪
74
+ - 操作按钮：打开终端、获取操作链接、重启 CLI、关闭会话
75
+ - 每次回复创建新的流式卡片，上一轮卡片冻结在最后状态
76
+
77
+ ### Web 终端（可交互）
78
+
79
+ 每个会话提供一个 Web 终端，地址为 `http://<WEB_EXTERNAL_HOST>:<端口>`。
80
+
81
+ - **只读链接** — 展示在群话题的流式卡片上，随时查看进度
82
+ - **可操作链接** — 按需获取（点击卡片上的「🔑 获取操作链接」通过私聊发送），可直接在浏览器中操作 CLI
83
+ - 移动端/平板提供悬浮快捷键工具栏（Esc、Ctrl+C、Tab、方向键等），手机上也能流畅操作
84
+
85
+ ### 多机器人协作
86
+
87
+ 支持在同一台机器上运行多个飞书机器人，每个机器人可对应不同的 CLI。同一群聊中的多个机器人通过 @mention 路由消息，仅有一个机器人时自动响应无需 @。
88
+
89
+ ### Tmux 会话常驻
90
+
91
+ 安装 tmux 后自动启用。CLI 进程常驻在 tmux session 内，所有功能不受影响。
92
+
93
+ **核心收益：Daemon 重启不中断 CLI。** `botmux restart` 时 worker 进程退出，但 tmux session（及其中的 CLI 进程）保持运行。下次收到消息时 worker 自动 re-attach，无需 `--resume` 重载上下文。
94
+
95
+ | 事件 | tmux session | CLI 进程 |
96
+ |------|-------------|---------|
97
+ | `botmux restart` | 存活 | 存活（下次消息 re-attach） |
98
+ | `/close` 或关闭按钮 | 销毁 | 终止（SIGHUP） |
99
+ | CLI 自行退出 / 崩溃 | 随之关闭 | 已退出（自动重启用新 session） |
100
+
101
+ ```bash
102
+ # 推荐：交互式会话列表 — 选择后直接 attach 到 tmux
103
+ npx botmux list
104
+
105
+ # 也可以手动 attach（会话名 = bmx-<sessionId 前 8 位>）
106
+ tmux attach -t bmx-<session-id-前8位>
107
+ # Ctrl+B, D 退出 attach，不影响 CLI 继续运行
108
+
109
+ # 强制降级到纯 pty 模式（不使用 tmux）
110
+ BACKEND_TYPE=pty botmux start
111
+ ```
112
+
113
+ `botmux list` 提供交互式 TUI，显示所有活跃会话的 ID、标题、工作目录、PID、运行时长和状态，方向键选择后回车即可 attach。也支持 `botmux list --plain` 输出纯文本表格供脚本使用。
114
+
115
+ **tmux 会话命名规则：** `bmx-<sessionId 前 8 位>`
116
+
117
+ ### 定时任务
118
+
119
+ 基于 Cron 的周期性任务，支持中文自然语言配置。
120
+
121
+ ```
122
+ /schedule 每日17:50 帮我看看AI圈有什么新闻
123
+ /schedule 工作日每天9:00 检查服务状态
124
+ /schedule 每周一10:00 生成周报
125
+ ```
126
+
127
+ ### MCP 集成
128
+
129
+ CLI 可通过 MCP 工具与飞书话题交互：
130
+
131
+ - 回复飞书话题
132
+ - 读取消息历史
133
+ - 添加表情回应
134
+
135
+ ---
34
136
 
35
137
  ## 前置要求
36
138
 
37
139
  - **Node.js** >= 20
38
140
  - **AI 编程 CLI** 已安装并完成认证（`claude`、`aiden`、`coco`、`codex`、`gemini` 或 `opencode` 在 PATH 中）
39
- - **飞书应用** 具备机器人和消息权限（WebSocket 事件订阅）
40
141
  - **tmux** >= 3.x（可选，安装后自动启用会话常驻）
41
142
 
42
- ## 安装
143
+ ## 5 分钟快速接入
43
144
 
44
- ```bash
45
- npm install -g botmux
145
+ ### Step 1: 创建飞书应用
146
+
147
+ 打开 [飞书开放平台](https://open.larkoffice.com/app)，点击「创建企业自建应用」。
148
+
149
+ ![创建应用](docs/setup/create-app.png)
150
+
151
+ ### Step 2: 获取凭证
152
+
153
+ 进入应用详情 →「凭证与基础信息」，复制 **App ID** 和 **App Secret**。
154
+
155
+ ![获取凭证](docs/setup/credentials.png)
156
+
157
+ ### Step 3: 添加权限
158
+
159
+ 进入「权限管理」→「批量导入/导出权限」，粘贴以下 JSON 一次性导入所有权限：
160
+
161
+ ![权限管理](docs/setup/permissions.png)
162
+
163
+ <details>
164
+ <summary>点击展开批量导入 JSON</summary>
165
+
166
+ ```json
167
+ {
168
+ "scopes": {
169
+ "tenant": [
170
+ "contact:user.base:readonly",
171
+ "contact:user.id:readonly",
172
+ "im:chat:read",
173
+ "im:chat.members:bot_access",
174
+ "im:chat.members:read",
175
+ "im:message",
176
+ "im:message:readonly",
177
+ "im:message:send_as_bot",
178
+ "im:message:update",
179
+ "im:message.group_at_msg",
180
+ "im:message.group_at_msg:readonly",
181
+ "im:message.group_msg",
182
+ "im:message.p2p_msg:readonly",
183
+ "im:message.reactions:write_only",
184
+ "im:resource"
185
+ ]
186
+ }
187
+ }
46
188
  ```
189
+ </details>
47
190
 
48
- ## 快速开始
191
+ ### Step 4: 安装 & 启动 botmux
49
192
 
50
193
  ```bash
51
- # 1. 交互式配置 — 创建 ~/.botmux/bots.json
194
+ # 安装
195
+ npm install -g botmux
196
+
197
+ # 交互式配置 — 输入 Step 2 的 App ID 和 App Secret
52
198
  botmux setup
53
199
 
54
- # 2. 启动 daemon
200
+ # 启动（飞书后台配置长连接订阅前需要先启动，否则无法检测到连接）
55
201
  botmux start
56
202
  ```
57
203
 
58
- `setup` 命令会引导你完成：
59
- - 创建飞书应用（列出所需权限）
60
- - 输入 App ID、App Secret、Chat ID
61
- - 可选：Claude 模型、工作目录、权限控制
204
+ ### Step 5: 配置事件订阅
205
+
206
+ 回到飞书开放平台，进入「事件与回调」：
207
+
208
+ 1. **订阅方式**：点击编辑图标，选择「使用长连接接收事件」（需要 botmux 已启动，飞书会检测长连接是否建立）
209
+
210
+ ![配置长连接](docs/setup/event-websocket.png)
211
+
212
+ 2. **添加事件**：点击「添加事件」，搜索添加 `im.message.receive_v1`（接收消息 v2.0）
213
+
214
+ ![添加事件](docs/setup/event-receive-msg.png)
215
+
216
+ 3. **启用回调**：切换到「回调配置」tab，开启「卡片回传交互」（`card.action.trigger`）
217
+
218
+ ### Step 6: 发版
219
+
220
+ 进入「版本管理与发布」，点击「创建版本」并发布。可用性范围选择「仅自己可见」即可自动通过审核。
221
+
222
+ ![发版](docs/setup/publish.png)
223
+
224
+ ### Step 7: 建群开聊
225
+
226
+ 1. 飞书中创建一个**话题群**
227
+ 2. 进入群设置 → 群机器人 → 添加刚创建的机器人
228
+ 3. 在群里发消息，机器人自动响应
229
+
230
+ ![添加机器人到群](docs/setup/add-bot-to-group.png)
231
+
232
+ ---
233
+
234
+ ## 使用指南
235
+
236
+ ### 使用流程
237
+
238
+ 1. 在飞书话题群中发送消息创建新话题
239
+ 2. 机器人弹出仓库选择卡片 — 选择项目或点击「直接开启会话」
240
+ 3. CLI 在所选目录下启动
241
+ 4. 话题中出现实时流式卡片，展示终端输出并支持 Markdown 渲染
242
+ 5. 每次回复创建新的流式卡片，上一轮卡片冻结在最后状态
243
+ 6. 点击卡片上的「🔑 获取操作链接」通过私聊获取可写终端链接
244
+ 7. CLI 通过 MCP 工具在话题中回复
245
+
246
+ ### 斜杠命令
247
+
248
+ | 命令 | 说明 |
249
+ |------|------|
250
+ | `/repo` | 显示项目选择卡片 |
251
+ | `/repo <N>` | 切换到上次扫描的第 N 个项目 |
252
+ | `/skip` | 跳过仓库选择，直接开启会话 |
253
+ | `/cd <路径>` | 切换工作目录 |
254
+ | `/status` | 查看会话信息（运行时间、终端地址等） |
255
+ | `/cost` | 查看 Token 用量和费用估算 |
256
+ | `/restart` | 重启 CLI 进程 |
257
+ | `/close` | 关闭会话并终止 CLI |
258
+ | `/clear` | 清除上下文（新会话，同一话题） |
259
+ | `/schedule` | 管理定时任务 |
260
+ | `/help` | 显示可用命令 |
261
+
262
+ ### 定时任务管理
263
+
264
+ 用自然语言创建周期性任务：
265
+
266
+ ```
267
+ /schedule 每日17:50 帮我看看AI圈有什么新闻
268
+ /schedule 工作日每天9:00 检查服务状态
269
+ /schedule 每周一10:00 生成周报
270
+ ```
271
+
272
+ 管理任务：
273
+
274
+ ```
275
+ /schedule list
276
+ /schedule remove <id>
277
+ /schedule enable <id>
278
+ /schedule disable <id>
279
+ /schedule run <id>
280
+ ```
281
+
282
+ ---
62
283
 
63
284
  ## CLI 命令
64
285
 
@@ -76,12 +297,12 @@ botmux start
76
297
  | `botmux delete all` | 关闭所有活跃会话 |
77
298
  | `botmux delete stopped` | 清理所有进程已退出的僵尸会话 |
78
299
 
300
+ ---
301
+
79
302
  ## 配置
80
303
 
81
304
  通过 `~/.botmux/bots.json` 配置机器人。运行 `botmux setup` 交互式创建，或手动编辑。
82
305
 
83
- 支持在同一台机器上运行多个飞书机器人，每个机器人可对应不同的 CLI。同一群聊中的多个机器人通过 @mention 路由消息，仅有一个机器人时自动响应无需 @。
84
-
85
306
  ```bash
86
307
  # 交互式配置
87
308
  botmux setup
@@ -130,7 +351,7 @@ botmux setup
130
351
  | `SESSION_DATA_DIR` | `~/.botmux/data` | 会话和队列的存储目录 |
131
352
  | `DEBUG` | _(未设置)_ | 设为 `1` 启用调试日志 |
132
353
 
133
- ## 文件位置
354
+ ### 文件位置
134
355
 
135
356
  | 路径 | 说明 |
136
357
  |------|------|
@@ -138,110 +359,7 @@ botmux setup
138
359
  | `~/.botmux/data/` | 会话数据、消息队列 |
139
360
  | `~/.botmux/logs/` | Daemon 日志 |
140
361
 
141
- ## 使用
142
-
143
- ### 使用流程
144
-
145
- 1. 在飞书话题群中发送消息创建新话题
146
- 2. 机器人弹出仓库选择卡片 — 选择项目或点击「直接开启会话」
147
- 3. Claude Code 在所选目录下启动
148
- 4. 话题中出现实时流式卡片，展示终端输出并支持 Markdown 渲染
149
- 5. 每次回复创建新的流式卡片，上一轮卡片冻结在最后状态
150
- 6. 点击卡片上的「🔑 获取操作链接」通过私聊获取可写终端链接
151
- 7. Claude 通过 MCP 工具在话题中回复
152
-
153
- ### 斜杠命令
154
-
155
- | 命令 | 说明 |
156
- |------|------|
157
- | `/repo` | 显示项目选择卡片 |
158
- | `/repo <N>` | 切换到上次扫描的第 N 个项目 |
159
- | `/skip` | 跳过仓库选择，直接开启会话 |
160
- | `/cd <路径>` | 切换工作目录 |
161
- | `/status` | 查看会话信息（运行时间、终端地址等） |
162
- | `/cost` | 查看 Token 用量和费用估算 |
163
- | `/restart` | 重启 Claude 进程 |
164
- | `/close` | 关闭会话并终止 Claude |
165
- | `/clear` | 清除上下文（新会话，同一话题） |
166
- | `/schedule` | 管理定时任务 |
167
- | `/help` | 显示可用命令 |
168
-
169
- ### 定时任务
170
-
171
- 用自然语言创建周期性任务：
172
-
173
- ```
174
- /schedule 每日17:50 帮我看看AI圈有什么新闻
175
- /schedule 工作日每天9:00 检查服务状态
176
- /schedule 每周一10:00 生成周报
177
- ```
178
-
179
- 管理任务：
180
-
181
- ```
182
- /schedule list
183
- /schedule remove <id>
184
- /schedule enable <id>
185
- /schedule disable <id>
186
- /schedule run <id>
187
- ```
188
-
189
- ### 流式卡片
190
-
191
- 每轮对话会生成一个实时更新的飞书卡片，展示：
192
-
193
- - 实时终端输出（通过 headless xterm 捕获 + 飞书卡片 v2 Markdown 渲染）
194
- - 状态指示：🟡 启动中 → 🔵 工作中 → 🟢 就绪
195
- - 操作按钮：打开终端、获取操作链接、重启 Claude、关闭会话
196
-
197
- 卡片内容由 headless xterm 终端捕获，自动过滤 TUI 装饰（Logo、状态栏、提示符、框线字符），仅展示 Claude 的实际工作输出。
198
-
199
- ### Web 终端
200
-
201
- <p align="center">
202
- <img src="gif/web_terminal.gif" alt="Web 终端实时输出" width="600">
203
- </p>
204
-
205
- 每个会话提供一个 Web 终端，地址为 `http://<WEB_EXTERNAL_HOST>:<端口>`。
206
-
207
- - **只读链接** — 展示在群话题的流式卡片上
208
- - **可操作链接** — 按需获取（点击卡片上的「🔑 获取操作链接」通过私聊发送）
209
-
210
- 特性：xterm.js + fit/unicode11/web-links 插件、TokyoNight 主题、滚动缓冲区。移动端/平板通过悬浮快捷键工具栏提供 Esc、Ctrl+C、Tab、方向键等虚拟键盘缺失的控制键，工具栏自动避让虚拟键盘。
211
-
212
- ### Tmux 会话常驻
213
-
214
- <p align="center">
215
- <img src="gif/tmux.gif" alt="botmux list — 交互式 tmux 会话管理" width="600">
216
- </p>
217
-
218
- 安装 tmux 后，botmux 自动使用 tmux 后端。CLI 进程运行在 tmux session 内，daemon 通过 node-pty attach 到 tmux 来捕获输出，流式卡片、空闲检测、Web 终端等功能全部不受影响。
219
-
220
- **核心收益：Daemon 重启不中断 CLI。** `botmux restart` 时 worker 进程退出，但 tmux session（及其中的 CLI 进程）保持运行。下次收到消息时 worker 自动 re-attach，无需 `--resume` 重载上下文。
221
-
222
- ```bash
223
- # 推荐：交互式会话列表 — 选择后直接 attach 到 tmux
224
- npx botmux list
225
-
226
- # 也可以手动 attach（会话名 = bmx-<sessionId 前 8 位>）
227
- tmux attach -t bmx-<session-id-前8位>
228
- # Ctrl+B, D 退出 attach，不影响 CLI 继续运行
229
-
230
- # 强制降级到纯 pty 模式（不使用 tmux）
231
- BACKEND_TYPE=pty botmux start
232
- ```
233
-
234
- `botmux list` 提供交互式 TUI，显示所有活跃会话的 ID、标题、工作目录、PID、运行时长和状态，方向键选择后回车即可 attach。也支持 `botmux list --plain` 输出纯文本表格供脚本使用。
235
-
236
- **tmux 会话命名规则：** `bmx-<sessionId 前 8 位>`
237
-
238
- **生命周期：**
239
-
240
- | 事件 | tmux session | CLI 进程 |
241
- |------|-------------|---------|
242
- | `botmux restart` | 存活 | 存活（下次消息 re-attach） |
243
- | `/close` 或关闭按钮 | 销毁 | 终止（SIGHUP） |
244
- | CLI 自行退出 / 崩溃 | 随之关闭 | 已退出（自动重启用新 session） |
362
+ ---
245
363
 
246
364
  ## 贡献
247
365
 
package/dist/im/lark/message-parser.js CHANGED
@@ -89,7 +89,7 @@ function resolvePostBody(parsed) {
89
89
  function resolveMentions(text, mentions) {
90
90
  if (!mentions || mentions.length === 0) {
91
91
  // No mention info available — strip placeholders
92
- return text.replace(/@_user_\d+/g, '').replace(/\s{2,}/g, ' ').trim();
92
+ return text.replace(/@_user_\d+/g, '').replace(/[^\S\r\n]{2,}/g, ' ').trim();
93
93
  }
94
94
  let result = text;
95
95
  for (const m of mentions) {
@@ -107,14 +107,19 @@ function extractTextContent(msgType, rawContent, mentions) {
107
107
  const parsed = JSON.parse(rawContent);
108
108
  const { title, content } = resolvePostBody(parsed);
109
109
  const body = content
110
- .flat()
111
- .filter((node) => node.tag === 'text' || node.tag === 'a' || node.tag === 'at')
112
- .map((node) => {
113
- if (node.tag === 'at')
114
- return `@${node.user_name ?? 'unknown'}`;
115
- return node.text ?? node.href ?? '';
110
+ .map((paragraph) => {
111
+ const nodes = Array.isArray(paragraph) ? paragraph : [paragraph];
112
+ return nodes
113
+ .filter((node) => node.tag === 'text' || node.tag === 'a' || node.tag === 'at')
114
+ .map((node) => {
115
+ if (node.tag === 'at')
116
+ return `@${node.user_name ?? 'unknown'}`;
117
+ return node.text ?? node.href ?? '';
118
+ })
119
+ .join('');
116
120
  })
117
- .join('');
121
+ .filter(Boolean)
122
+ .join('\n');
118
123
  return title ? `${title}\n${body}` : body;
119
124
  }
120
125
  if (msgType === 'image') {
package/dist/im/lark/message-parser.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"message-parser.js","sourceRoot":"","sources":["../../../src/im/lark/message-parser.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"message-parser.js","sourceRoot":"","sources":["../../../src/im/lark/message-parser.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "botmux",
3
- "version": "1.13.0",
3
+ "version": "1.13.1",
4
4
  "description": "Bridge between IM platforms and AI coding CLIs — one topic, one CLI session with live streaming",
5
5
  "type": "module",
6
6
  "main": "dist/index-daemon.js",