@wu529778790/open-im 1.10.2 → 1.10.3-beta.0

package/README.md

@@ -6,20 +6,15 @@ Multi-platform IM bridge for AI CLI tools. Connect Telegram, Feishu, WeCom, Ding
 
 ## Features
 
-- **Six IM platforms** — run Telegram, Feishu, WeCom, DingTalk, QQ, and WorkBuddy together
-- **Three AI backends** — Claude (Agent SDK), Codex, CodeBuddy
-- **Per-platform AI routing** — override the default tool per platform
-- **Streaming replies** — live AI output where the platform supports it
-- **Media** — images, files, voice, and video for analysis (platform-dependent)
-- **Session isolation** — per-user state; `/new` resets the AI session
-- **Web configuration** — full dashboard **bundled in the npm package** (`web/dist`), served from **`http://127.0.0.1:39282`** (same origin as the API)
-- **Chat commands** — `/help`, `/new`, `/sessions`, `/resume`, `/cd`, `/pwd`, `/status`, `/allow`, `/deny`
+- **Six IM platforms** — Telegram, Feishu, WeCom, DingTalk, QQ, WorkBuddy
+- **Three AI backends** — Claude (Agent SDK), Codex, CodeBuddy (per-platform override supported)
+- **Streaming, media, sessions** — live output where supported; `/new` for a fresh AI session
+- **Web UI** — dashboard bundled in the package; default **`http://127.0.0.1:39282`**
 
 ## Requirements
 
 - Node.js ≥ 20
-- At least one IM platform configured
-- Credentials for the AI tool you use
+- At least one IM platform configured + credentials for your AI tool
 
 ## Quick start
 
@@ -27,118 +22,62 @@ Multi-platform IM bridge for AI CLI tools. Connect Telegram, Feishu, WeCom, Ding
 npx @wu529778790/open-im start
 ```
 
-Or install globally:
+Or: `npm install -g @wu529778790/open-im` then `open-im start`.
 
-```bash
-npm install -g @wu529778790/open-im
-open-im start
-```
-
-Configuration file: `~/.open-im/config.json`
+Config: **`~/.open-im/config.json`**
 
 ## CLI
 
 | Command | Description |
 | --- | --- |
-| `open-im init` | Interactive setup without starting the bridge |
+| `open-im init` | Interactive setup (does not start the bridge) |
 | `open-im start` | Run the bridge in the background |
 | `open-im stop` | Stop the background bridge |
 | `open-im restart` | Stop then start |
-| `open-im dev` | Foreground mode for debugging |
-| `open-im dashboard` | Keep only the local config HTTP server (no bridge) |
-
-After `start`, the CLI prints the **web dashboard** URL (`http://127.0.0.1:39282` by default, same as the API base).
-
-## Web configuration
-
-### Bundled dashboard (full UI)
-
-The published npm package includes **`web/dist`**. `open-im start` or `open-im dashboard` serves the **full SPA** (overview, platforms, AI, JSON, service controls) from the local HTTP server. Open **`http://127.0.0.1:<port>`** (default **39282**) in your browser; the page is **same-origin** with the API, so you usually do not need to paste a Server URL.
+| `open-im dashboard` | Web config server only (no bridge) |
 
-- Default dashboard URL: **`http://127.0.0.1:39282`** (respects **`OPEN_IM_WEB_PORT`**)
-- Override the URL shown/opened by the CLI with **`OPEN_IM_PUBLIC_WEB_URL`** (e.g. behind a reverse proxy)
+After `start`, the CLI prints the dashboard URL (default **`http://127.0.0.1:39282`**).
 
-If you install from source without running **`npm run build`** (which runs `web:build` + `tsc`), `web/dist` may be missing and **`GET /`** returns **503** until you build. Use **`npm run build:ts`** for TypeScript-only iteration (skips the web bundle).
+## Web dashboard
 
-### Local HTTP service
+`open-im start` and `open-im dashboard` serve the built-in SPA and **`/api/*`** on **`OPEN_IM_WEB_PORT`** (default **39282**). Open **`http://127.0.0.1:39282`** in a browser (same origin as the API). Override the displayed URL with **`OPEN_IM_PUBLIC_WEB_URL`** if behind a proxy.
 
-The running process listens on **`OPEN_IM_WEB_PORT`** (default **39282**):
-
-- **`GET /`** — built-in dashboard when `web/dist` is present; otherwise **503** with a short plain-text hint
-- **`/assets/*`** — static assets for the bundled SPA (when present)
-- **`/api/*`** — JSON API used by the dashboard
-
-### Remote access
-
-For access from another host or from an HTTPS-hosted page:
-
-```bash
-export OPEN_IM_WEB_HOST=0.0.0.0
-# Optional: skip cookie login on trusted networks (see security implications in docs)
-# export OPEN_IM_ALLOW_REMOTE_API=true
-# Optional: restrict CORS origins (comma-separated)
-# export OPEN_IM_CORS_ORIGINS=http://127.0.0.1:39282
-```
+**Remote / LAN:** `export OPEN_IM_WEB_HOST=0.0.0.0` — first access from another host may show a one-time login link. Optional: **`OPEN_IM_ALLOW_REMOTE_API`**, **`OPEN_IM_CORS_ORIGINS`**.
 
-If the server is not bound to `127.0.0.1`, it may print a **one-time login URL** (`login_token=…`) for first-time browser access.
-
-### Developing the web UI (from source)
-
-In the repository:
-
-```bash
-npm run web:dev    # Vite dev server; proxies /api to 127.0.0.1:39282
-npm run build      # web:build + tsc (use before running the compiled CLI with dashboard)
-npm run build:ts   # tsc only (no web/dist refresh)
-npm run web:build  # web/dist only
-```
-
-More detail: [CLAUDE.md](./CLAUDE.md), [AGENTS.md](./AGENTS.md).
-
-## IM commands
+## Chat commands
 
 | Command | Description |
 | --- | --- |
 | `/help` | Help |
 | `/new` | New AI session |
-| `/sessions` | List session history |
-| `/resume <N>` | Resume a previous session by number |
-| `/status` | AI tool and session info |
-| `/cd <path>` | Change session working directory |
-| `/pwd` | Print working directory |
-| `/allow` / `/y` | Approve a permission request |
-| `/deny` / `/n` | Reject a permission request |
-
-## Sessions
+| `/sessions` | Session history |
+| `/resume <N>` | Resume by list number |
+| `/status` | AI + session info |
+| `/cd` / `/pwd` | Working directory |
+| `/allow` / `/y`, `/deny` / `/n` | Permission prompts |
 
-Sessions are stored in `~/.open-im/data/sessions.json`, separate from IM chat history. Each user has an isolated session. `/new` starts a fresh session and archives the old one. Use `/sessions` to view history and `/resume <N>` to switch back to a previous session.
+Session state is stored in **`~/.open-im/data/sessions.json`** (per user, not IM chat logs).
 
 ## Configuration
 
-### Per-platform AI tool
+### Per-platform AI
 
-Default: root `aiCommand`. Override per platform with `platforms.<name>.aiCommand`:
+Default: root **`aiCommand`**. Override with **`platforms.<name>.aiCommand`**:
 
 ```json
 {
   "aiCommand": "claude",
   "platforms": {
-    "telegram": { "enabled": true, "aiCommand": "codex" },
-    "feishu": { "enabled": true, "aiCommand": "codex" },
-    "qq": { "enabled": true, "aiCommand": "codebuddy" }
+    "telegram": { "enabled": true, "aiCommand": "codex" }
   }
 }
 ```
 
 ### Claude (Agent SDK)
 
-Uses the Agent SDK by default (no local `claude` binary required). Credentials load order:
-
-1. Environment variables  
-2. `env` in `~/.open-im/config.json`  
-3. `~/.claude/settings.json` or `~/.claude.json`
+No local `claude` binary required. Credentials: env → **`config.json`** `env` → **`~/.claude/settings.json`**.
 
-Third-party compatible endpoints:
+Third-party / compatible API example:
 
 ```json
 {
@@ -150,8 +89,6 @@ Third-party compatible endpoints:
 }
 ```
 
-Claude inherits plugins and settings from `~/.claude/settings.json` when present.
-
 ### CodeBuddy
 
 ```bash
@@ -159,82 +96,53 @@ npm install -g @tencent-ai/codebuddy-code
 codebuddy login
 ```
 
-Useful keys: `tools.codebuddy.cliPath`, `tools.codebuddy.skipPermissions`, `tools.codebuddy.timeoutMs`. On Windows, `codebuddy` may resolve to `%AppData%\Roaming\npm\codebuddy.cmd`.
-
-### Example `config.json`
+### Minimal `config.json` shape
 
 ```json
 {
   "aiCommand": "claude",
   "tools": {
-    "claude": {
-      "workDir": "/path/to/project",
-      "skipPermissions": true,
-      "timeoutMs": 600000
-    },
-    "codex": {
-      "workDir": "/path/to/project",
-      "skipPermissions": true,
-      "proxy": "http://127.0.0.1:7890"
-    },
-    "codebuddy": {
-      "skipPermissions": true,
-      "timeoutMs": 600000
-    }
+    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
   },
   "platforms": {
-    "telegram": { "enabled": true, "botToken": "YOUR_TELEGRAM_BOT_TOKEN" },
-    "feishu": { "enabled": false, "appId": "YOUR_FEISHU_APP_ID", "appSecret": "YOUR_FEISHU_APP_SECRET" },
-    "qq": { "enabled": false, "appId": "YOUR_QQ_APP_ID", "secret": "YOUR_QQ_APP_SECRET" },
-    "wework": { "enabled": false, "corpId": "YOUR_WEWORK_CORP_ID", "secret": "YOUR_WEWORK_SECRET" },
-    "dingtalk": {
-      "enabled": false,
-      "clientId": "YOUR_DINGTALK_CLIENT_ID",
-      "clientSecret": "YOUR_DINGTALK_CLIENT_SECRET",
-      "cardTemplateId": "YOUR_DINGTALK_AI_CARD_TEMPLATE_ID"
-    },
-    "workbuddy": { "enabled": false, "accessToken": "", "refreshToken": "", "userId": "" }
+    "telegram": { "enabled": true, "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
   }
 }
 ```
 
-WorkBuddy (WeChat) is easiest via `open-im init` or by editing `~/.open-im/config.json`.
+Add Feishu, QQ, WeCom, DingTalk, WorkBuddy under **`platforms`** as needed. Run **`open-im init`** for a full template. WeChat (WorkBuddy) is easiest via **`open-im init`**.
 
 ### Environment variables
 
-**General:** `AI_COMMAND`, `CLAUDE_WORK_DIR`, `LOG_DIR`, `LOG_LEVEL`, `HOOK_PORT`, `OPEN_IM_WEB_PORT`, `OPEN_IM_WEB_HOST`, `OPEN_IM_PUBLIC_WEB_URL`, `OPEN_IM_NO_BROWSER`, `OPEN_IM_ALLOW_REMOTE_API`, `OPEN_IM_CORS_ORIGINS`
+Use **`config.json`** or environment variables; the dashboard exposes common options. Typical keys: **`ANTHROPIC_*`**, **`TELEGRAM_BOT_TOKEN`**, **`OPEN_IM_WEB_PORT`**, **`OPEN_IM_WEB_HOST`**, plus platform-specific `*_APP_ID`, `*_SECRET`, `WORKBUDDY_*`, etc.
 
-**AI:** `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL`, `ANTHROPIC_MODEL`, `OPENAI_API_KEY`, `CODEX_PROXY`, `CODEBUDDY_CLI_PATH`, `CODEBUDDY_TIMEOUT_MS`, `CODEBUDDY_API_KEY`, `CODEBUDDY_AUTH_TOKEN`
+### Privacy
 
-**Platforms:** `TELEGRAM_BOT_TOKEN`, `TELEGRAM_PROXY`, `TELEGRAM_ALLOWED_USER_IDS`, `FEISHU_APP_ID`, `FEISHU_APP_SECRET`, `FEISHU_ALLOWED_USER_IDS`, `QQ_BOT_APPID`, `QQ_BOT_SECRET`, `QQ_BOT_SANDBOX`, `QQ_ALLOWED_USER_IDS`, `DINGTALK_CLIENT_ID`, `DINGTALK_CLIENT_SECRET`, `DINGTALK_CARD_TEMPLATE_ID`, `DINGTALK_ALLOWED_USER_IDS`, `WEWORK_CORP_ID`, `WEWORK_SECRET`, `WEWORK_WS_URL`, `WEWORK_ALLOWED_USER_IDS`, `WORKBUDDY_ACCESS_TOKEN`, `WORKBUDDY_REFRESH_TOKEN`, `WORKBUDDY_USER_ID`, `WORKBUDDY_BASE_URL`, `WORKBUDDY_ALLOWED_USER_IDS`
+**Anonymous** usage information may be collected to improve reliability (no chat or prompt content). To disable: **`OPEN_IM_TELEMETRY=false`** or **`"telemetry": { "enabled": false }`** in **`config.json`**.
 
-### Platform setup
+### Platform credentials
 
-| Platform | Where to get credentials |
+| Platform | Notes |
 | --- | --- |
 | Telegram | [@BotFather](https://t.me/BotFather) |
-| Feishu | [Feishu Open Platform](https://open.feishu.cn/) |
+| Feishu | [Open Platform](https://open.feishu.cn/) |
 | QQ | [QQ Open Platform](https://bot.q.qq.com/) |
-| DingTalk | DingTalk Open Platform — enable bot **Stream Mode** |
-| WeCom | [WeCom admin](https://work.weixin.qq.com/) |
-| WeChat | `open-im init` → WorkBuddy OAuth |
-
-**DingTalk:** Stream Mode (receive) + OpenAPI (send). With `cardTemplateId`, AI assistant streaming cards are used when possible; otherwise plain text. Custom bots and normal groups may only get single text replies. Startup/shutdown notices are not sent to DingTalk.
+| DingTalk | Open Platform — bot **Stream Mode**; optional **`cardTemplateId`** for AI assistant cards |
+| WeCom | [Admin](https://work.weixin.qq.com/) |
+| WeChat | **`open-im init`** → WorkBuddy OAuth |
 
 ## Troubleshooting
 
 | Issue | What to try |
 | --- | --- |
-| Telegram not responding | Check network; set `proxy` / `TELEGRAM_PROXY` |
-| QQ cannot connect | Verify bot and `QQ_BOT_APPID` / `QQ_BOT_SECRET` |
-| QQ duplicate replies | Upgrade to the latest version |
-| Feishu card errors | Use `/mode ask` or `/mode yolo` without card callbacks |
-| WeCom no notifications | Send at least one message to the bot first |
-| DingTalk cannot reply | Enable Stream Mode; verify credentials |
-| DingTalk no streaming | Custom bots: plain text only; set `cardTemplateId` for AI assistant cards |
-| Codex `stream disconnected` | Set `tools.codex.proxy` or `CODEX_PROXY` |
-| CodeBuddy asks for login | Run `codebuddy login` |
-| WorkBuddy / WeChat | Re-run `open-im init`; tokens and binding links expire |
+| Telegram / network | `proxy` or **`TELEGRAM_PROXY`** |
+| QQ | Check **`QQ_BOT_APPID`** / **`QQ_BOT_SECRET`**; update if duplicate replies |
+| Feishu cards | **`/mode ask`** or **`/mode yolo`** without card callbacks |
+| WeCom | Send the bot a message first |
+| DingTalk | Stream Mode + credentials; custom bots may be text-only |
+| Codex disconnect | **`CODEX_PROXY`** or **`tools.codex.proxy`** |
+| CodeBuddy login | **`codebuddy login`** |
+| WorkBuddy | Re-run **`open-im init`** (tokens expire) |
 
 ## License
 

package/README.zh-CN.md

@@ -6,20 +6,15 @@
 
 ## 功能特性
 
-- **六个 IM 平台** — 可同时启用多平台
-- **三种 AI 后端** — Claude（Agent SDK）、Codex、CodeBuddy
-- **按平台指定 AI** — 覆盖默认 `aiCommand`
-- **流式输出** — 视平台能力实时回传
-- **多媒体** — 图片、文件、语音、视频（因平台而异）
-- **会话隔离** — 每用户独立；`/new` 重置会话
-- **Web 配置** — 完整仪表盘 **随 npm 包内置**（`web/dist`），由本机 `http://127.0.0.1:39282` **同源**提供
-- **聊天命令** — `/help`、`/new`、`/sessions`、`/resume`、`/cd`、`/pwd`、`/status`、`/allow`、`/deny`
+- **六个 IM 平台** — Telegram、飞书、企业微信、钉钉、QQ、WorkBuddy
+- **三种 AI 后端** — Claude（Agent SDK）、Codex、CodeBuddy（可按平台覆盖）
+- **流式、多媒体、会话** — 视平台能力；`/new` 开启新 AI 会话
+- **Web 控制台** — 随包内置，默认 **`http://127.0.0.1:39282`**
 
 ## 环境要求
 
 - Node.js ≥ 20
-- 至少配置一个 IM 平台
-- 所选 AI 工具所需的凭证
+- 至少配置一个 IM 平台 + 所选 AI 的凭证
 
 ## 快速开始
 
@@ -27,71 +22,27 @@
 npx @wu529778790/open-im start
 ```
 
-或全局安装：
+或：`npm install -g @wu529778790/open-im` 后执行 `open-im start`。
 
-```bash
-npm install -g @wu529778790/open-im
-open-im start
-```
-
-配置文件：`~/.open-im/config.json`
+配置：**`~/.open-im/config.json`**
 
 ## CLI 命令
 
 | 命令 | 说明 |
 | --- | --- |
-| `open-im init` | 交互配置，不启动桥接 |
+| `open-im init` | 交互配置（不启动桥接） |
 | `open-im start` | 后台运行桥接 |
 | `open-im stop` | 停止后台服务 |
 | `open-im restart` | 重启 |
-| `open-im dev` | 前台调试 |
-| `open-im dashboard` | 仅保留本地配置 HTTP 服务（不启动桥接） |
-
-执行 `start` 后，终端会提示 **Web 控制台** 地址（默认 **`http://127.0.0.1:39282`**，与 API 同源）。
-
-## Web 配置
-
-### 内置仪表盘（完整 UI）
+| `open-im dashboard` | 仅 Web 配置服务（不启动桥接） |
 
-发布到 npm 的包内含 **`web/dist`** 构建产物；`open-im start` 或 `open-im dashboard` 在本机 HTTP 服务上提供 **完整 SPA**（概览、平台、AI、JSON、服务启停等）。浏览器打开 **`http://127.0.0.1:<端口>`**（默认端口 **39282**）即可，**Server URL** 与页面同源，一般无需再填。
+`start` 后会提示控制台地址（默认 **`http://127.0.0.1:39282`**）。
 
-- 默认控制台地址：本机 **`http://127.0.0.1:39282`**（随 **`OPEN_IM_WEB_PORT`** 变化）
-- 若需自定义打开的链接（例如反向代理后的地址），可设置 **`OPEN_IM_PUBLIC_WEB_URL`**
+## Web 控制台
 
-若从源码安装且未执行 **`npm run build`**（内含 `web:build`），可能没有 `web/dist`，此时 **`GET /`** 会返回 **503** 直至构建完成。仅改 TypeScript 时可使用 **`npm run build:ts`** 跳过前端构建。
+`open-im start` / `open-im dashboard` 在 **`OPEN_IM_WEB_PORT`**（默认 **39282**）提供内置页面与 **`/api/*`**。浏览器打开 **`http://127.0.0.1:39282`** 即可（与 API 同源）。反向代理时可设 **`OPEN_IM_PUBLIC_WEB_URL`**。
 
-### 本机 HTTP 服务
-
-进程监听 **`OPEN_IM_WEB_PORT`**（默认 **39282**）：
-
-- **`GET /`** — 有 `web/dist` 时返回内置仪表盘；否则 **503** 纯文本提示
-- **`/assets/*`** — 内置前端静态资源（有构建产物时）
-- **`/api/*`** — JSON API
-
-### 远程访问
-
-从其他机器或 HTTPS 页面访问时：
-
-```bash
-export OPEN_IM_WEB_HOST=0.0.0.0
-# 可选：受信网络跳过 Cookie 登录（请自行评估风险）
-# export OPEN_IM_ALLOW_REMOTE_API=true
-# 可选：限制 CORS 来源（逗号分隔）
-# export OPEN_IM_CORS_ORIGINS=http://127.0.0.1:39282
-```
-
-未绑定 `127.0.0.1` 时，服务端可能打印 **一次性登录链接**（`login_token=…`）。
-
-### 开发 Web 前端（源码仓库）
-
-```bash
-npm run web:dev    # Vite；将 /api 代理到 127.0.0.1:39282
-npm run build      # web:build + tsc；发布前与日常请用此命令
-npm run build:ts   # 仅 tsc（不更新 web/dist）
-npm run web:build  # 仅构建 web/dist
-```
-
-更多开发说明见 [CLAUDE.md](./CLAUDE.md)、[AGENTS.md](./AGENTS.md)。
+**局域网 / 远程：** `export OPEN_IM_WEB_HOST=0.0.0.0` — 首次外网访问可能需一次性登录链接。可选 **`OPEN_IM_ALLOW_REMOTE_API`**、**`OPEN_IM_CORS_ORIGINS`**。
 
 ## IM 内命令
 
@@ -99,38 +50,32 @@ npm run web:build  # 仅构建 web/dist
 | --- | --- |
 | `/help` | 帮助 |
 | `/new` | 新 AI 会话 |
-| `/sessions` | 查看历史会话 |
-| `/resume <序号>` | 恢复历史会话 |
+| `/sessions` | 历史会话 |
+| `/resume <序号>` | 按列表序号恢复 |
 | `/status` | AI 与会话信息 |
-| `/cd <路径>` | 切换工作目录 |
-| `/pwd` | 当前目录 |
-| `/allow` / `/y` | 同意权限请求 |
-| `/deny` / `/n` | 拒绝权限请求 |
-
-## 会话说明
+| `/cd` / `/pwd` | 工作目录 |
+| `/allow` / `/y`、`/deny` / `/n` | 权限确认 |
 
-会话保存在 `~/.open-im/data/sessions.json`，与 IM 聊天记录无关。`/new` 创建新会话并归档旧会话。使用 `/sessions` 查看历史，`/resume <序号>` 恢复之前的会话。
+会话状态保存在 **`~/.open-im/data/sessions.json`**（按用户，与 IM 聊天记录无关）。
 
 ## 配置说明
 
-### 按平台分配 AI
+### 按平台指定 AI
 
-根级 `aiCommand` 为默认；用 `platforms.<name>.aiCommand` 覆盖：
+根级 **`aiCommand`** 为默认；用 **`platforms.<name>.aiCommand`** 覆盖：
 
 ```json
 {
   "aiCommand": "claude",
   "platforms": {
-    "telegram": { "enabled": true, "aiCommand": "codex" },
-    "feishu": { "enabled": true, "aiCommand": "codex" },
-    "qq": { "enabled": true, "aiCommand": "codebuddy" }
+    "telegram": { "enabled": true, "aiCommand": "codex" }
   }
 }
 ```
 
 ### Claude（Agent SDK）
 
-默认使用 Agent SDK，无需本地 `claude` 可执行文件。凭证顺序：环境变量 → `config.json` 的 `env` → `~/.claude/settings.json` / `~/.claude.json`。
+无需本地 `claude` 可执行文件。凭证顺序：环境变量 → **`config.json`** 的 **`env`** → **`~/.claude/settings.json`**。
 
 第三方兼容接口示例：
 
@@ -144,8 +89,6 @@ npm run web:build  # 仅构建 web/dist
 }
 ```
 
-会继承 `~/.claude/settings.json` 中的插件等配置。
-
 ### CodeBuddy
 
 ```bash
@@ -153,82 +96,53 @@ npm install -g @tencent-ai/codebuddy-code
 codebuddy login
 ```
 
-常用项：`tools.codebuddy.cliPath`、`skipPermissions`、`timeoutMs`。Windows 下可能解析到 `%AppData%\Roaming\npm\codebuddy.cmd`。
-
-### 配置示例
+### 最小配置结构
 
 ```json
 {
   "aiCommand": "claude",
   "tools": {
-    "claude": {
-      "workDir": "/path/to/project",
-      "skipPermissions": true,
-      "timeoutMs": 600000
-    },
-    "codex": {
-      "workDir": "/path/to/project",
-      "skipPermissions": true,
-      "proxy": "http://127.0.0.1:7890"
-    },
-    "codebuddy": {
-      "skipPermissions": true,
-      "timeoutMs": 600000
-    }
+    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
   },
   "platforms": {
-    "telegram": { "enabled": true, "botToken": "YOUR_TELEGRAM_BOT_TOKEN" },
-    "feishu": { "enabled": false, "appId": "YOUR_FEISHU_APP_ID", "appSecret": "YOUR_FEISHU_APP_SECRET" },
-    "qq": { "enabled": false, "appId": "YOUR_QQ_APP_ID", "secret": "YOUR_QQ_APP_SECRET" },
-    "wework": { "enabled": false, "corpId": "YOUR_WEWORK_CORP_ID", "secret": "YOUR_WEWORK_SECRET" },
-    "dingtalk": {
-      "enabled": false,
-      "clientId": "YOUR_DINGTALK_CLIENT_ID",
-      "clientSecret": "YOUR_DINGTALK_CLIENT_SECRET",
-      "cardTemplateId": "YOUR_DINGTALK_AI_CARD_TEMPLATE_ID"
-    },
-    "workbuddy": { "enabled": false, "accessToken": "", "refreshToken": "", "userId": "" }
+    "telegram": { "enabled": true, "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
   }
 }
 ```
 
-微信（WorkBuddy）建议用 `open-im init` 或直接编辑 `~/.open-im/config.json`。
+在 **`platforms`** 下按需补充飞书、QQ、企业微信、钉钉、WorkBuddy。完整模板请用 **`open-im init`**。微信建议 **`open-im init`** 走 WorkBuddy OAuth。
 
 ### 环境变量
 
-**通用：** `AI_COMMAND`、`CLAUDE_WORK_DIR`、`LOG_DIR`、`LOG_LEVEL`、`HOOK_PORT`、`OPEN_IM_WEB_PORT`、`OPEN_IM_WEB_HOST`、`OPEN_IM_PUBLIC_WEB_URL`、`OPEN_IM_NO_BROWSER`、`OPEN_IM_ALLOW_REMOTE_API`、`OPEN_IM_CORS_ORIGINS`
+可在 **`config.json`** 或环境变量中设置；控制台会展示常用项。常见：**`ANTHROPIC_*`**、**`TELEGRAM_BOT_TOKEN`**、**`OPEN_IM_WEB_PORT`**、**`OPEN_IM_WEB_HOST`**，以及各平台的 `*_APP_ID`、`*_SECRET`、`WORKBUDDY_*` 等。
 
-**AI：** `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_MODEL`、`OPENAI_API_KEY`、`CODEX_PROXY`、`CODEBUDDY_CLI_PATH`、`CODEBUDDY_TIMEOUT_MS`、`CODEBUDDY_API_KEY`、`CODEBUDDY_AUTH_TOKEN`
+### 隐私
 
-**平台：** `TELEGRAM_BOT_TOKEN`、`TELEGRAM_PROXY`、`TELEGRAM_ALLOWED_USER_IDS`、`FEISHU_APP_ID`、`FEISHU_APP_SECRET`、`FEISHU_ALLOWED_USER_IDS`、`QQ_BOT_APPID`、`QQ_BOT_SECRET`、`QQ_BOT_SANDBOX`、`QQ_ALLOWED_USER_IDS`、`DINGTALK_CLIENT_ID`、`DINGTALK_CLIENT_SECRET`、`DINGTALK_CARD_TEMPLATE_ID`、`DINGTALK_ALLOWED_USER_IDS`、`WEWORK_CORP_ID`、`WEWORK_SECRET`、`WEWORK_WS_URL`、`WEWORK_ALLOWED_USER_IDS`、`WORKBUDDY_ACCESS_TOKEN`、`WORKBUDDY_REFRESH_TOKEN`、`WORKBUDDY_USER_ID`、`WORKBUDDY_BASE_URL`、`WORKBUDDY_ALLOWED_USER_IDS`
+为改进稳定性，可能记录**匿名**运行信息（不含聊天或 prompt 内容）。若需关闭：环境变量 **`OPEN_IM_TELEMETRY=false`**，或 **`config.json`** 中 **`"telemetry": { "enabled": false }`**。
 
-### 平台凭证来源
+### 平台凭证
 
 | 平台 | 说明 |
 | --- | --- |
 | Telegram | [@BotFather](https://t.me/BotFather) |
-| 飞书 | [飞书开放平台](https://open.feishu.cn/) |
+| 飞书 | [开放平台](https://open.feishu.cn/) |
 | QQ | [QQ 开放平台](https://bot.q.qq.com/) |
-| 钉钉 | 开放平台创建应用，启用机器人 **Stream Mode** |
+| 钉钉 | 开放平台创建应用，机器人开 **Stream Mode**；可选 **`cardTemplateId`** 走 AI 助理卡片 |
 | 企业微信 | [管理后台](https://work.weixin.qq.com/) |
-| 微信 | `open-im init` 选择 WorkBuddy 完成 OAuth |
-
-**钉钉：** Stream 收消息 + OpenAPI 发消息；配置 `cardTemplateId` 可用 AI 助理流式卡片，失败则回退纯文本；自定义机器人与普通群可能仅支持单条文本；启停通知不会发到钉钉。
+| 微信 | **`open-im init`** → WorkBuddy OAuth |
 
 ## 故障排除
 
 | 现象 | 处理 |
 | --- | --- |
-| Telegram 无响应 | 检查网络；配置 `proxy` / `TELEGRAM_PROXY` |
-| QQ 连不上 | 核对机器人与 `QQ_BOT_APPID`、`QQ_BOT_SECRET` |
-| QQ 重复回复 | 升级到最新版 |
-| 飞书卡片报错 | 未配回调时用 `/mode ask` 或 `/mode yolo` |
-| 企业微信无通知 | 先给机器人发一条消息 |
-| 钉钉无法回复 | 开启 Stream Mode；核对凭证 |
-| 钉钉无流式 | 自定义机器人多为纯文本；配 `cardTemplateId` 走 AI 助理卡片 |
-| Codex `stream disconnected` | 配置 `tools.codex.proxy` 或 `CODEX_PROXY` |
-| CodeBuddy 要登录 | 先 `codebuddy login` |
-| WorkBuddy / 微信 | 重跑 `open-im init`；Token 与绑定链接会过期 |
+| Telegram / 网络 | 配置 `proxy` 或 **`TELEGRAM_PROXY`** |
+| QQ | 核对 **`QQ_BOT_APPID`**、**`QQ_BOT_SECRET`**；重复回复请升级版本 |
+| 飞书卡片 | 未配回调时用 **`/mode ask`** 或 **`/mode yolo`** |
+| 企业微信 | 先给机器人发一条消息 |
+| 钉钉 | 开启 Stream Mode；自定义机器人可能仅纯文本 |
+| Codex 断流 | **`CODEX_PROXY`** 或 **`tools.codex.proxy`** |
+| CodeBuddy 登录 | **`codebuddy login`** |
+| WorkBuddy / 微信 | 重跑 **`open-im init`**（Token 会过期） |
 
 ## License
 

package/dist/config/types.d.ts

@@ -38,6 +38,17 @@ export interface Config {
     skipPermissions?: boolean;
     logDir: string;
     logLevel: LogLevel;
+    /**
+     * 遥测：默认开启；关闭后不写入结构化事件、不上传。
+     * 环境变量：OPEN_IM_TELEMETRY、OPEN_IM_TELEMETRY_URL、OPEN_IM_TELEMETRY_TOKEN。
+     */
+    telemetry: {
+        enabled: boolean;
+        /** HTTPS 采集端完整 URL（如 https://example.com/v1/ingest） */
+        url?: string;
+        /** 可选 Bearer，与采集端一致 */
+        token?: string;
+    };
     platforms: {
         telegram?: {
             enabled: boolean;
@@ -180,4 +191,9 @@ export interface FileConfig {
     };
     logDir?: string;
     logLevel?: LogLevel;
+    telemetry?: {
+        enabled?: boolean;
+        url?: string;
+        token?: string;
+    };
 }

package/dist/config-web.js

@@ -461,6 +461,7 @@ function createProbeConfig(values) {
         claudeSessionIdleTtlMinutes: 30,
         logDir: "",
         logLevel: "INFO",
+        telemetry: { enabled: true },
         codebuddyCliPath: "codebuddy",
         platforms: {},
         ...values,