@wu529778790/open-im 1.7.1-beta.0 → 1.7.1-beta.10

package/README.md

@@ -14,19 +14,6 @@ Multi-platform IM bridge for AI CLI tools. Connect Telegram, Feishu, WeCom, Ding
 - Isolated sessions: each user gets an independent local session, and `/new` resets it
 - Built-in commands: `/help`, `/new`, `/cd`, `/pwd`, `/status`
 
-## Coverage Matrix
-
-Capability levels: `Native` = fully supported in-channel, `Fallback` = degraded behavior or text fallback, `None` = not currently supported.
-
-| Platform | Text Inbound | Image Inbound | File Inbound | Voice Inbound | Video Inbound | Streaming Reply | Image Reply | Card Reply |
-| ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- |
-| Telegram | Native | Native | Native | Native | Native | Native | Native | Native |
-| Feishu | Native | Native | Native | Fallback | Fallback | Native | Native | Native |
-| QQ | Native | Fallback | Fallback | Fallback | Fallback | None | Fallback | Fallback |
-| WeCom | Native | Fallback | Fallback | Fallback | Fallback | Native | Native | Native |
-| DingTalk | Native | Fallback | Fallback | Fallback | Fallback | Native | Fallback | Native |
-| WeChat (experimental) | Native | Fallback | Fallback | Fallback | Fallback | Native | Fallback | Native |
-
 ## Requirements
 
 - Node.js >= 20
@@ -50,27 +37,66 @@ The config file is stored at `~/.open-im/config.json` by default.
 
 ## CLI Commands
 
-| Command | Description |
-| ---- | ---- |
-| `open-im init` | Initialize or append configuration without starting the service |
-| `open-im start` | Run the service in the background |
-| `open-im stop` | Stop the background service |
-| `open-im dev` | Run in the foreground for development/debugging |
+| Command           | Description                                                      |
+| ----------------- | ---------------------------------------------------------------- |
+| `open-im init`    | Initialize or append configuration without starting the service |
+| `open-im start`   | Run the service in the background                                |
+| `open-im stop`    | Stop the background service                                      |
+| `open-im dev`     | Run in the foreground for development/debugging                  |
+| `open-im dashboard` | Run only the config web UI (no bridge)                        |
+
+## Server Deployment & Config Page
 
-## Graphical Config Page
+### Local (with browser)
 
-Open the config page at **http://127.0.0.1:39282** (or the URL shown after `open-im start`). The page includes:
+Open the config page at [`http://127.0.0.1:39282`](http://127.0.0.1:39282) (or the URL shown after `open-im start`). The page includes:
 
 - **Dashboard** – Configured / Enabled platform count and service status (Idle or Running)
 - **Platforms** – Enable and configure Telegram, Feishu, QQ, WeCom, and DingTalk (credentials, proxy, per-platform AI tool, allowed user IDs). Each platform has a “Test Configuration” button.
-- **AI Tooling** – **General**: default AI tool (Claude / Codex / CodeBuddy), work directory, hook port, log level. **Per-tool tabs**: Claude (CLI path, timeout, proxy, config path, ANTHROPIC_* fields), Codex (CLI path, timeout, proxy), CodeBuddy (CLI path, timeout).
+- **AI Tooling** – **General**: default AI tool (Claude / Codex / CodeBuddy), work directory, hook port, log level. **Per-tool tabs**: Claude (CLI path, timeout, proxy, config path, ANTHROPIC\_\* fields), Codex (CLI path, timeout, proxy), CodeBuddy (CLI path, timeout).
 - **Service control** – Validate config, Save, Start bridge, Stop bridge.
 
 WeChat is not in the web UI; configure it in `~/.open-im/config.json` or via `open-im init` if needed.
 
-- `open-im start` serves the config page and the bridge.
+- `open-im start` serves both the config page and the bridge on your local machine.
 - `open-im dev` opens the page automatically only when setup is incomplete.
-- To open the page when config already exists, run `open-im start` and visit the URL above.
+- To open the page when config already exists, you can also run `open-im dashboard` to launch the config UI only (without starting the bridge).
+
+### Recommended server workflow
+
+On a remote server, the simplest and safest pattern is:
+
+1. **Use `dashboard` to configure via browser**
+
+   On the server:
+
+   ```bash
+   export OPEN_IM_NO_BROWSER=1
+   # Optional: bind to all interfaces if you want to open from another device
+   # export OPEN_IM_WEB_HOST=0.0.0.0
+   open-im dashboard
+   ```
+
+   - This starts only the config web UI (no bridge yet).
+   - If `OPEN_IM_WEB_HOST` is `0.0.0.0`, the server will print a one-time login URL like:
+
+     ```text
+     http://your-server-ip:39282/?login_token=xxxx
+     ```
+
+   - Open this URL in your browser, complete all platform/AI settings, then click **Start bridge** in the web UI.
+
+2. **Run the bridge as a background service**
+
+   After configuration is saved, you have two options:
+   - Start from the web UI: use the **Start bridge** button on the Service panel.
+   - Or start from the CLI:
+
+     ```bash
+     open-im start
+     ```
+
+   This runs the full bridge in the background using the saved config.
 
 ## Session Behavior
 
@@ -221,46 +247,46 @@ The following is valid JSON and can be saved directly as `~/.open-im/config.json
 
 ### Common Environment Variables
 
-| Variable | Description |
-| ---- | ---- |
-| `AI_COMMAND` | Select `claude`, `codex`, or `codebuddy` |
-| `CLAUDE_WORK_DIR` | Default session working directory |
-| `LOG_DIR` | Log directory |
-| `LOG_LEVEL` | Log level |
-| `HOOK_PORT` | Permission service port |
-| `CODEX_PROXY` | Proxy used by Codex to access `chatgpt.com` |
-| `OPENAI_API_KEY` | Codex API key, can replace `codex login` |
-| `CODEBUDDY_CLI_PATH` | Override CodeBuddy CLI path |
-| `CODEBUDDY_TIMEOUT_MS` | Override CodeBuddy timeout |
-| `CODEBUDDY_SKIP_PERMISSIONS` | Override CodeBuddy skip-permissions behavior |
-| `CODEBUDDY_IDLE_TIMEOUT_MS` | Abort CodeBuddy when it stays silent for too long |
-| `CODEBUDDY_API_KEY` | CodeBuddy API key, can replace `codebuddy login` |
-| `CODEBUDDY_AUTH_TOKEN` | CodeBuddy auth token, can replace `codebuddy login` |
-| `TELEGRAM_BOT_TOKEN` | Telegram bot token |
-| `TELEGRAM_PROXY` | Telegram proxy URL |
-| `TELEGRAM_ALLOWED_USER_IDS` | Telegram allowlist |
-| `FEISHU_APP_ID` | Feishu app ID |
-| `FEISHU_APP_SECRET` | Feishu app secret |
-| `FEISHU_ALLOWED_USER_IDS` | Feishu allowlist |
-| `QQ_BOT_APPID` | QQ bot app ID |
-| `QQ_BOT_SECRET` | QQ bot app secret |
-| `QQ_BOT_SANDBOX` | QQ bot sandbox mode (`1` / `true` to enable, disabled by default) |
-| `QQ_ALLOWED_USER_IDS` | QQ allowlist |
-| `DINGTALK_CLIENT_ID` | DingTalk client ID / AppKey |
-| `DINGTALK_CLIENT_SECRET` | DingTalk client secret / AppSecret |
-| `DINGTALK_CARD_TEMPLATE_ID` | DingTalk AI card template ID; enables single-message streaming replies |
-| `DINGTALK_ALLOWED_USER_IDS` | DingTalk allowlist |
-| `WEWORK_CORP_ID` | WeCom bot ID |
-| `WEWORK_SECRET` | WeCom secret |
-| `WEWORK_WS_URL` | WeCom WebSocket URL |
-| `WEWORK_ALLOWED_USER_IDS` | WeCom allowlist |
-| `WECHAT_APP_ID` | WeChat standard mode app ID |
-| `WECHAT_APP_SECRET` | WeChat standard mode app secret |
-| `WECHAT_TOKEN` | WeChat AGP mode token |
-| `WECHAT_GUID` | WeChat AGP mode GUID |
-| `WECHAT_USER_ID` | WeChat AGP mode user ID |
-| `WECHAT_WS_URL` | WeChat WebSocket URL |
-| `WECHAT_ALLOWED_USER_IDS` | WeChat allowlist |
+| Variable                     | Description                                                            |
+| ---------------------------- | ---------------------------------------------------------------------- |
+| `AI_COMMAND`                 | Select `claude`, `codex`, or `codebuddy`                               |
+| `CLAUDE_WORK_DIR`            | Default session working directory                                      |
+| `LOG_DIR`                    | Log directory                                                          |
+| `LOG_LEVEL`                  | Log level                                                              |
+| `HOOK_PORT`                  | Permission service port                                                |
+| `CODEX_PROXY`                | Proxy used by Codex to access `chatgpt.com`                            |
+| `OPENAI_API_KEY`             | Codex API key, can replace `codex login`                               |
+| `CODEBUDDY_CLI_PATH`         | Override CodeBuddy CLI path                                            |
+| `CODEBUDDY_TIMEOUT_MS`       | Override CodeBuddy timeout                                             |
+| `CODEBUDDY_SKIP_PERMISSIONS` | Override CodeBuddy skip-permissions behavior                           |
+| `CODEBUDDY_IDLE_TIMEOUT_MS`  | Abort CodeBuddy when it stays silent for too long                      |
+| `CODEBUDDY_API_KEY`          | CodeBuddy API key, can replace `codebuddy login`                       |
+| `CODEBUDDY_AUTH_TOKEN`       | CodeBuddy auth token, can replace `codebuddy login`                    |
+| `TELEGRAM_BOT_TOKEN`         | Telegram bot token                                                     |
+| `TELEGRAM_PROXY`             | Telegram proxy URL                                                     |
+| `TELEGRAM_ALLOWED_USER_IDS`  | Telegram allowlist                                                     |
+| `FEISHU_APP_ID`              | Feishu app ID                                                          |
+| `FEISHU_APP_SECRET`          | Feishu app secret                                                      |
+| `FEISHU_ALLOWED_USER_IDS`    | Feishu allowlist                                                       |
+| `QQ_BOT_APPID`               | QQ bot app ID                                                          |
+| `QQ_BOT_SECRET`              | QQ bot app secret                                                      |
+| `QQ_BOT_SANDBOX`             | QQ bot sandbox mode (`1` / `true` to enable, disabled by default)      |
+| `QQ_ALLOWED_USER_IDS`        | QQ allowlist                                                           |
+| `DINGTALK_CLIENT_ID`         | DingTalk client ID / AppKey                                            |
+| `DINGTALK_CLIENT_SECRET`     | DingTalk client secret / AppSecret                                     |
+| `DINGTALK_CARD_TEMPLATE_ID`  | DingTalk AI card template ID; enables single-message streaming replies |
+| `DINGTALK_ALLOWED_USER_IDS`  | DingTalk allowlist                                                     |
+| `WEWORK_CORP_ID`             | WeCom bot ID                                                           |
+| `WEWORK_SECRET`              | WeCom secret                                                           |
+| `WEWORK_WS_URL`              | WeCom WebSocket URL                                                    |
+| `WEWORK_ALLOWED_USER_IDS`    | WeCom allowlist                                                        |
+| `WECHAT_APP_ID`              | WeChat standard mode app ID                                            |
+| `WECHAT_APP_SECRET`          | WeChat standard mode app secret                                        |
+| `WECHAT_TOKEN`               | WeChat AGP mode token                                                  |
+| `WECHAT_GUID`                | WeChat AGP mode GUID                                                   |
+| `WECHAT_USER_ID`             | WeChat AGP mode user ID                                                |
+| `WECHAT_WS_URL`              | WeChat WebSocket URL                                                   |
+| `WECHAT_ALLOWED_USER_IDS`    | WeChat allowlist                                                       |
 
 ### Platform Setup Sources
 
@@ -281,15 +307,15 @@ DingTalk AI card templates are already compatible with the official "Search Resu
 
 ## IM Commands
 
-| Command | Description |
-| ---- | ---- |
-| `/help` | Show help |
-| `/new` | Start a new session |
-| `/status` | Show AI tool, version, session directory, and session ID |
-| `/cd <path>` | Change the session working directory |
-| `/pwd` | Show the current session working directory |
-| `/allow` `/y` | Approve a permission request |
-| `/deny` `/n` | Reject a permission request |
+| Command       | Description                                              |
+| ------------- | -------------------------------------------------------- |
+| `/help`       | Show help                                                |
+| `/new`        | Start a new session                                      |
+| `/status`     | Show AI tool, version, session directory, and session ID |
+| `/cd <path>`  | Change the session working directory                     |
+| `/pwd`        | Show the current session working directory               |
+| `/allow` `/y` | Approve a permission request                             |
+| `/deny` `/n`  | Reject a permission request                              |
 
 ## Troubleshooting
 

package/README.zh-CN.md

@@ -14,19 +14,6 @@
 - 会话隔离：每个用户独立维护本地会话，`/new` 可重置
 - 常用命令：支持 `/help`、`/new`、`/cd`、`/pwd`、`/status`
 
-## 覆盖矩阵
-
-能力等级说明：`Native` 表示平台内原生支持，`Fallback` 表示有降级方案或文本兜底，`None` 表示当前暂不支持。
-
-| 平台 | 文本输入 | 图片输入 | 文件输入 | 语音输入 | 视频输入 | 流式回复 | 图片回复 | 卡片回复 |
-| ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- |
-| Telegram | Native | Native | Native | Native | Native | Native | Native | Native |
-| 飞书 | Native | Native | Native | Fallback | Fallback | Native | Native | Native |
-| QQ | Native | Fallback | Fallback | Fallback | Fallback | None | Fallback | Fallback |
-| 企业微信 | Native | Fallback | Fallback | Fallback | Fallback | Native | Native | Native |
-| 钉钉 | Native | Fallback | Fallback | Fallback | Fallback | Native | Fallback | Native |
-| 微信（测试中） | Native | Fallback | Fallback | Fallback | Fallback | Native | Fallback | Native |
-
 ## 环境要求
 
 - Node.js >= 20
@@ -50,27 +37,72 @@ open-im start
 
 ## CLI 命令
 
-| 命令 | 说明 |
-| ---- | ---- |
-| `open-im init` | 初始化或追加配置，不启动服务 |
-| `open-im start` | 后台运行服务 |
-| `open-im stop` | 停止后台服务 |
-| `open-im dev` | 前台运行（调试模式） |
+| 命令              | 说明                           |
+| ----------------- | ------------------------------ |
+| `open-im init`    | 初始化或追加配置，不启动服务   |
+| `open-im start`   | 后台运行服务                   |
+| `open-im stop`    | 停止后台服务                   |
+| `open-im dev`     | 前台运行（调试模式）           |
+| `open-im dashboard` | 仅启动 Web 配置页（不启动桥接服务） |
 
-## 图形化配置页面
+## 服务器部署与图形化配置
 
-在浏览器中打开 **http://127.0.0.1:39282**（或执行 `open-im start` 后提示的地址），页面结构如下：
+### 本机（带浏览器）使用
+
+在本机直接运行：
+
+```bash
+open-im start
+```
+
+然后在浏览器中打开 [`http://127.0.0.1:39282`](http://127.0.0.1:39282)（或命令行里提示的地址），页面结构如下：
 
 - **概览** – 已配置/已启用平台数量、服务状态（未启动或运行中）
 - **平台配置** – 启用并填写 Telegram、飞书、QQ、企业微信、钉钉的凭证（Bot Token/App ID/Secret、代理、该平台使用的 AI 工具、白名单用户 ID）。每个平台提供「校验配置」按钮
-- **AI 工具配置** – **公共**：默认 AI 工具（Claude / Codex / CodeBuddy）、工作目录、Hook 端口、日志级别。**分工具**：Claude（CLI 路径、超时、代理、配置路径、ANTHROPIC_* 等）、Codex（CLI 路径、超时、代理）、CodeBuddy（CLI 路径、超时）
+- **AI 工具配置** – **公共**：默认 AI 工具（Claude / Codex / CodeBuddy）、工作目录、Hook 端口、日志级别。**分工具**：Claude（CLI 路径、超时、代理、配置路径、ANTHROPIC\_\* 等）、Codex（CLI 路径、超时、代理）、CodeBuddy（CLI 路径、超时）
 - **服务控制** – 校验配置、保存、启动桥接、停止桥接
 
 微信暂不在网页中配置，如需使用请在 `~/.open-im/config.json` 中手动配置或通过 `open-im init` 引导。
 
-- `open-im start` 会同时启动桥接服务并提供该配置页
-- `open-im dev` 仅在未完成配置时自动打开页面
-- 已有配置但想手动打开时，执行 `open-im start` 后访问上述地址即可
+- `open-im start` 会同时启动桥接服务并提供该配置页（本机场景）。
+- `open-im dev` 仅在未完成配置时自动打开页面。
+- 已有配置但想单独打开配置页时，可以使用 `open-im dashboard` 启动仅 Web 配置服务。
+
+### 推荐的服务器端使用方式
+
+在远程服务器上，建议的最简单、安全的方式是：
+
+1. **先通过 `dashboard` 在浏览器里完成配置**
+
+   在服务器上执行：
+
+   ```bash
+   export OPEN_IM_NO_BROWSER=1
+   # 可选：如果希望从其他设备访问配置页，可以绑定到所有网卡
+   # export OPEN_IM_WEB_HOST=0.0.0.0
+   open-im dashboard
+   ```
+
+   - 这只会启动 Web 配置页，不会同时启动桥接服务。
+   - 若设置了 `OPEN_IM_WEB_HOST=0.0.0.0`，服务端会输出一次性登录链接，例如：
+
+     ```text
+     http://your-server-ip:39282/?login_token=xxxx
+     ```
+
+   - 在浏览器中打开该链接，按照页面提示完成各个平台 / AI 工具配置，最后在页面中点击 **「Start bridge」** 按钮启动桥接服务。
+
+2. **后台运行桥接服务**
+
+   配置保存后，有两种启动方式：
+   - 在 Web 页面 Service 面板中直接点击 **「Start bridge」**；
+   - 或者在服务器上运行：
+
+     ```bash
+     open-im start
+     ```
+
+   这会根据已保存的配置，在后台长期运行桥接服务。
 
 ## 会话说明
 
@@ -221,46 +253,46 @@ codebuddy login
 
 ### 常用环境变量
 
-| 变量 | 说明 |
-| ---- | ---- |
-| `AI_COMMAND` | 选择 `claude` / `codex` / `codebuddy` |
-| `CLAUDE_WORK_DIR` | 默认会话目录 |
-| `LOG_DIR` | 日志目录 |
-| `LOG_LEVEL` | 日志级别 |
-| `HOOK_PORT` | 权限服务端口 |
-| `CODEX_PROXY` | Codex 访问 `chatgpt.com` 的代理 |
-| `OPENAI_API_KEY` | Codex API Key，可替代 `codex login` |
-| `CODEBUDDY_CLI_PATH` | 覆盖 CodeBuddy CLI 路径 |
-| `CODEBUDDY_TIMEOUT_MS` | 覆盖 CodeBuddy 超时 |
-| `CODEBUDDY_SKIP_PERMISSIONS` | 覆盖 CodeBuddy 的跳过权限确认行为 |
-| `CODEBUDDY_IDLE_TIMEOUT_MS` | CodeBuddy 长时间无输出时自动终止 |
-| `CODEBUDDY_API_KEY` | CodeBuddy API Key，可替代 `codebuddy login` |
-| `CODEBUDDY_AUTH_TOKEN` | CodeBuddy Auth Token，可替代 `codebuddy login` |
-| `TELEGRAM_BOT_TOKEN` | Telegram Bot Token |
-| `TELEGRAM_PROXY` | Telegram 代理地址 |
-| `TELEGRAM_ALLOWED_USER_IDS` | Telegram 白名单 |
-| `FEISHU_APP_ID` | 飞书 App ID |
-| `FEISHU_APP_SECRET` | 飞书 App Secret |
-| `FEISHU_ALLOWED_USER_IDS` | 飞书白名单 |
-| `QQ_BOT_APPID` | QQ 机器人 App ID |
-| `QQ_BOT_SECRET` | QQ 机器人 App Secret |
-| `QQ_BOT_SANDBOX` | QQ 机器人沙箱模式（`1`/`true` 启用，默认关闭） |
-| `QQ_ALLOWED_USER_IDS` | QQ 白名单 |
-| `DINGTALK_CLIENT_ID` | 钉钉应用 Client ID / AppKey |
-| `DINGTALK_CLIENT_SECRET` | 钉钉应用 Client Secret / AppSecret |
-| `DINGTALK_CARD_TEMPLATE_ID` | 钉钉 AI 卡片模板 ID，配置后启用单条流式回复 |
-| `DINGTALK_ALLOWED_USER_IDS` | 钉钉白名单 |
-| `WEWORK_CORP_ID` | 企业微信 Bot ID |
-| `WEWORK_SECRET` | 企业微信 Secret |
-| `WEWORK_WS_URL` | 企业微信 WebSocket 地址 |
-| `WEWORK_ALLOWED_USER_IDS` | 企业微信白名单 |
-| `WECHAT_APP_ID` | 微信标准模式 App ID |
-| `WECHAT_APP_SECRET` | 微信标准模式 App Secret |
-| `WECHAT_TOKEN` | 微信 AGP 模式 Token |
-| `WECHAT_GUID` | 微信 AGP 模式 GUID |
-| `WECHAT_USER_ID` | 微信 AGP 模式 User ID |
-| `WECHAT_WS_URL` | 微信 WebSocket 地址 |
-| `WECHAT_ALLOWED_USER_IDS` | 微信白名单 |
+| 变量                         | 说明                                           |
+| ---------------------------- | ---------------------------------------------- |
+| `AI_COMMAND`                 | 选择 `claude` / `codex` / `codebuddy`          |
+| `CLAUDE_WORK_DIR`            | 默认会话目录                                   |
+| `LOG_DIR`                    | 日志目录                                       |
+| `LOG_LEVEL`                  | 日志级别                                       |
+| `HOOK_PORT`                  | 权限服务端口                                   |
+| `CODEX_PROXY`                | Codex 访问 `chatgpt.com` 的代理                |
+| `OPENAI_API_KEY`             | Codex API Key，可替代 `codex login`            |
+| `CODEBUDDY_CLI_PATH`         | 覆盖 CodeBuddy CLI 路径                        |
+| `CODEBUDDY_TIMEOUT_MS`       | 覆盖 CodeBuddy 超时                            |
+| `CODEBUDDY_SKIP_PERMISSIONS` | 覆盖 CodeBuddy 的跳过权限确认行为              |
+| `CODEBUDDY_IDLE_TIMEOUT_MS`  | CodeBuddy 长时间无输出时自动终止               |
+| `CODEBUDDY_API_KEY`          | CodeBuddy API Key，可替代 `codebuddy login`    |
+| `CODEBUDDY_AUTH_TOKEN`       | CodeBuddy Auth Token，可替代 `codebuddy login` |
+| `TELEGRAM_BOT_TOKEN`         | Telegram Bot Token                             |
+| `TELEGRAM_PROXY`             | Telegram 代理地址                              |
+| `TELEGRAM_ALLOWED_USER_IDS`  | Telegram 白名单                                |
+| `FEISHU_APP_ID`              | 飞书 App ID                                    |
+| `FEISHU_APP_SECRET`          | 飞书 App Secret                                |
+| `FEISHU_ALLOWED_USER_IDS`    | 飞书白名单                                     |
+| `QQ_BOT_APPID`               | QQ 机器人 App ID                               |
+| `QQ_BOT_SECRET`              | QQ 机器人 App Secret                           |
+| `QQ_BOT_SANDBOX`             | QQ 机器人沙箱模式（`1`/`true` 启用，默认关闭） |
+| `QQ_ALLOWED_USER_IDS`        | QQ 白名单                                      |
+| `DINGTALK_CLIENT_ID`         | 钉钉应用 Client ID / AppKey                    |
+| `DINGTALK_CLIENT_SECRET`     | 钉钉应用 Client Secret / AppSecret             |
+| `DINGTALK_CARD_TEMPLATE_ID`  | 钉钉 AI 卡片模板 ID，配置后启用单条流式回复    |
+| `DINGTALK_ALLOWED_USER_IDS`  | 钉钉白名单                                     |
+| `WEWORK_CORP_ID`             | 企业微信 Bot ID                                |
+| `WEWORK_SECRET`              | 企业微信 Secret                                |
+| `WEWORK_WS_URL`              | 企业微信 WebSocket 地址                        |
+| `WEWORK_ALLOWED_USER_IDS`    | 企业微信白名单                                 |
+| `WECHAT_APP_ID`              | 微信标准模式 App ID                            |
+| `WECHAT_APP_SECRET`          | 微信标准模式 App Secret                        |
+| `WECHAT_TOKEN`               | 微信 AGP 模式 Token                            |
+| `WECHAT_GUID`                | 微信 AGP 模式 GUID                             |
+| `WECHAT_USER_ID`             | 微信 AGP 模式 User ID                          |
+| `WECHAT_WS_URL`              | 微信 WebSocket 地址                            |
+| `WECHAT_ALLOWED_USER_IDS`    | 微信白名单                                     |
 
 ### 平台配置来源
 
@@ -281,15 +313,15 @@ codebuddy login
 
 ## IM 内命令
 
-| 命令 | 说明 |
-| ---- | ---- |
-| `/help` | 显示帮助 |
-| `/new` | 开始新会话 |
-| `/status` | 显示 AI 工具、版本、会话目录、会话 ID |
-| `/cd <路径>` | 切换会话目录 |
-| `/pwd` | 显示当前会话目录 |
-| `/allow` `/y` | 允许权限请求 |
-| `/deny` `/n` | 拒绝权限请求 |
+| 命令          | 说明                                  |
+| ------------- | ------------------------------------- |
+| `/help`       | 显示帮助                              |
+| `/new`        | 开始新会话                            |
+| `/status`     | 显示 AI 工具、版本、会话目录、会话 ID |
+| `/cd <路径>`  | 切换会话目录                          |
+| `/pwd`        | 显示当前会话目录                      |
+| `/allow` `/y` | 允许权限请求                          |
+| `/deny` `/n`  | 拒绝权限请求                          |
 
 ## 故障排除
 

package/dist/adapters/claude-sdk-adapter.d.ts

@@ -1,18 +1,18 @@
 /**
- * Claude SDK Adapter - 使用 Agent SDK 实现持久会话，无需每次 spawn 进程
+ * Claude SDK Adapter - 使用 Agent SDK V2 Session API 实现真正的多轮对话
  *
- * 优势：
- * 1. 进程内执行 - 无 fork/exec 开销，响应更快
- * 2. 会话复用 - resume 保留上下文，无需重新加载历史
- * 3. 流式输出 - includePartialMessages 支持 text_delta、thinking_delta
+ * V2 API 优势：
+ * 1. 进程内执行 - 无 fork/exec 开销
+ * 2. 持久会话 - SDKSession 对象保持会话状态，支持真正的多轮对话
+ * 3. 流式输出 - 支持实时增量更新
  *
- * 认证：ANTHROPIC_API_KEY 或 CLAUDE_CODE_OAUTH_TOKEN（claude setup-token）
+ * 认证：ANTHROPIC_API_KEY 或 CLAUDE_CODE_OAUTH_TOKEN
  */
 import type { ToolAdapter, RunCallbacks, RunOptions, RunHandle } from './tool-adapter.interface.js';
 export declare class ClaudeSDKAdapter implements ToolAdapter {
     readonly toolId = "claude-sdk";
     /**
-     * 清理所有活跃的 SDK 查询
+     * 清理所有活跃的 SDK 会话和流
      */
     static destroy(): void;
     run(prompt: string, sessionId: string | undefined, workDir: string, callbacks: RunCallbacks, options?: RunOptions): RunHandle;