@wu529778790/open-im 1.10.9-beta.2 → 1.10.9-beta.21

package/README.md

@@ -2,11 +2,15 @@
 
 **English** · [中文](./README.zh-CN.md)
 
-Multi-platform IM bridge for AI CLI tools. Connect Telegram, Feishu, WeCom, DingTalk, QQ, and WeChat (WorkBuddy) to Claude Code, Codex, and CodeBuddy — use your AI coding assistant from any phone or chat window.
+Multi-platform IM bridge for AI CLI tools. Connect Telegram, Feishu, WeCom, DingTalk, QQ, WeChat (WorkBuddy), and WeChat (ClawBot) to Claude Code, Codex, and CodeBuddy — use your AI coding assistant from any phone or chat window.
+
+## Architecture
+
+![Open-IM Architecture](./diagram/architecture/open-im-architecture.svg)
 
 ## Features
 
-- **Six IM platforms** — Telegram, Feishu, WeCom, DingTalk, QQ, WorkBuddy
+- **Seven IM platforms** — Telegram, Feishu, WeCom, DingTalk, QQ, WorkBuddy, ClawBot
 - **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`**
@@ -38,16 +42,6 @@ Config: **`~/.open-im/config.json`**
 
 After `start`, the CLI prints the dashboard URL (default **`http://127.0.0.1:39282`**).
 
-## Git co-authors
-
-`Co-authored-by` is appended by default on AI-driven commits. **Disable:** set **`OPEN_IM_GIT_COAUTHOR=0`** in the environment and restart the bridge.
-
-## Web dashboard
-
-`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.
-
-**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`**.
-
 ## Chat commands
 
 | Command | Description |
@@ -60,33 +54,54 @@ After `start`, the CLI prints the dashboard URL (default **`http://127.0.0.1:392
 | `/cd` / `/pwd` | Working directory |
 | `/allow` / `/y`, `/deny` / `/n` | Permission prompts |
 
-Session state is stored in **`~/.open-im/data/sessions.json`** (per user, not IM chat logs).
+## Session continuity
 
-## Configuration
+open-im and Claude Code CLI share the same session storage. In the same directory, you can seamlessly switch between phone and computer.
 
-### Per-platform AI
+**Phone → Computer:** open-im auto-resumes the latest CLI session — no configuration needed.
+
+**Computer → Phone:** use `claude --continue` (or `claude -c`) to pick up the phone conversation.
 
-Set **`platforms.<name>.aiCommand`** per channel (`claude` / `codex` / `codebuddy`). If unset, the process **`AI_COMMAND`** env var is used when present; otherwise it defaults to **`claude`**.
+```
+# On computer
+cd /my-project && claude        # work as usual, then Ctrl+C
+
+# On phone (via IM)
+"help me fix the login bug"     # open-im auto-resumes the same session
+
+# Back on computer
+claude -c                       # continues the phone conversation
+```
+
+> Only one side can be active at a time. Exit the CLI before sending messages from the phone, and vice versa.
+
+## Git co-authors
+
+`Co-authored-by` is appended by default on AI-driven commits. **Disable:** set **`OPEN_IM_GIT_COAUTHOR=0`** in the environment and restart the bridge.
+
+## Minimal config
 
 ```json
 {
+  "tools": {
+    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
+  },
   "platforms": {
-    "telegram": { "enabled": true, "aiCommand": "codex", "botToken": "..." }
+    "telegram": { "enabled": true, "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
   }
 }
 ```
 
-### Claude (Agent SDK)
+Add other platforms under **`platforms`** as needed. Run **`open-im init`** for a full template.
 
-No local `claude` binary required. Credentials: env → **`config.json`** **`tools.claude.env`** → **`~/.claude/settings.json`** (dashboard saves API fields here).
+### Claude (Agent SDK)
 
-Third-party / compatible API example:
+No local `claude` binary required. Third-party / compatible API:
 
 ```json
 {
   "tools": {
     "claude": {
-      "workDir": "/path/to/project",
       "env": {
         "ANTHROPIC_AUTH_TOKEN": "your-token",
         "ANTHROPIC_BASE_URL": "https://your-api-endpoint",
@@ -97,59 +112,25 @@ Third-party / compatible API example:
 }
 ```
 
-### CodeBuddy
+### Per-platform AI
 
-```bash
-npm install -g @tencent-ai/codebuddy-code
-codebuddy login
-```
+Set **`platforms.<name>.aiCommand`** (`claude` / `codex` / `codebuddy`) per channel. Default: `claude`.
 
-### Minimal `config.json` shape
+### Web dashboard
 
-```json
-{
-  "tools": {
-    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
-  },
-  "platforms": {
-    "telegram": { "enabled": true, "aiCommand": "claude", "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
-  }
-}
-```
-
-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`**.
+`open-im start` serves the built-in SPA and **`/api/*`** on **`OPEN_IM_WEB_PORT`** (default **39282**). For LAN access: `export OPEN_IM_WEB_HOST=0.0.0.0`.
 
 ### Environment variables
 
-Use **`config.json`** (platforms, `tools.*`, etc.) or environment variables; the dashboard exposes common options. Typical keys: **`ANTHROPIC_*`** (shell or **`tools.claude.env`**), **`TELEGRAM_BOT_TOKEN`**, **`OPEN_IM_WEB_PORT`**, **`OPEN_IM_WEB_HOST`**, plus platform-specific `*_APP_ID`, `*_SECRET`, `WORKBUDDY_*`, etc. The root-level **`config.json` `env`** field is no longer read.
+Typical keys: **`ANTHROPIC_*`** (shell or **`tools.claude.env`**), **`TELEGRAM_BOT_TOKEN`**, **`OPEN_IM_WEB_PORT`**, **`OPEN_IM_WEB_HOST`**, plus platform-specific `*_APP_ID`, `*_SECRET`, `WORKBUDDY_*`, etc.
 
 ### Privacy
 
 **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 credentials
-
-| Platform | Notes |
-| --- | --- |
-| Telegram | [@BotFather](https://t.me/BotFather) |
-| Feishu | [Open Platform](https://open.feishu.cn/) |
-| QQ | [QQ Open Platform](https://bot.q.qq.com/) |
-| 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 |
+## Platform setup & troubleshooting
 
-## Troubleshooting
-
-| Issue | What to try |
-| --- | --- |
-| 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) |
+See **[docs/platforms.md](./docs/platforms.md)** for detailed per-platform configuration, credential setup, and troubleshooting.
 
 ## License
 

package/README.zh-CN.md

@@ -2,11 +2,15 @@
 
 [English](./README.md) · **中文**
 
-多平台 IM 桥接：把 Telegram、飞书、企业微信、钉钉、QQ、微信（WorkBuddy）接到 Claude Code、Codex、CodeBuddy，在手机或聊天里使用 AI 编程助手。
+多平台 IM 桥接：把 Telegram、飞书、企业微信、钉钉、QQ、微信（WorkBuddy）、微信（ClawBot）接到 Claude Code、Codex、CodeBuddy，在手机或聊天里使用 AI 编程助手。
+
+## 架构
+
+![Open-IM 架构图](./diagram/architecture/open-im-architecture.svg)
 
 ## 功能特性
 
-- **六个 IM 平台** — Telegram、飞书、企业微信、钉钉、QQ、WorkBuddy
+- **七个 IM 平台** — Telegram、飞书、企业微信、钉钉、QQ、WorkBuddy、ClawBot
 - **三种 AI 后端** — Claude（Agent SDK）、Codex、CodeBuddy（可按平台覆盖）
 - **流式、多媒体、会话** — 视平台能力；`/new` 开启新 AI 会话
 - **Web 控制台** — 随包内置，默认 **`http://127.0.0.1:39282`**
@@ -38,16 +42,6 @@ npx @wu529778790/open-im start
 
 `start` 后会提示控制台地址（默认 **`http://127.0.0.1:39282`**）。
 
-## Git 共同作者
-
-默认在 AI 发起的提交里追加 `Co-authored-by`。**关闭**：设置环境变量 **`OPEN_IM_GIT_COAUTHOR=0`** 并重启桥接。
-
-## Web 控制台
-
-`open-im start` / `open-im dashboard` 在 **`OPEN_IM_WEB_PORT`**（默认 **39282**）提供内置页面与 **`/api/*`**。浏览器打开 **`http://127.0.0.1:39282`** 即可（与 API 同源）。反向代理时可设 **`OPEN_IM_PUBLIC_WEB_URL`**。
-
-**局域网 / 远程：** `export OPEN_IM_WEB_HOST=0.0.0.0` — 首次外网访问可能需一次性登录链接。可选 **`OPEN_IM_ALLOW_REMOTE_API`**、**`OPEN_IM_CORS_ORIGINS`**。
-
 ## IM 内命令
 
 | 命令 | 说明 |
@@ -60,33 +54,54 @@ npx @wu529778790/open-im start
 | `/cd` / `/pwd` | 工作目录 |
 | `/allow` / `/y`、`/deny` / `/n` | 权限确认 |
 
-会话状态保存在 **`~/.open-im/data/sessions.json`**（按用户，与 IM 聊天记录无关）。
+## 会话接力
 
-## 配置说明
+open-im 和 Claude Code CLI 共享同一份 session 存储。在同一个目录下，手机和电脑可以无缝切换。
 
-### 按平台指定 AI
+**手机接电脑：** open-im 自动恢复同目录下最新的 CLI session，无需配置。
+
+**电脑接手机：** 使用 `claude --continue`（或 `claude -c`）接上 open-im 端的对话。
 
-在每个已启用渠道上设置 **`platforms.<name>.aiCommand`**（`claude` / `codex` / `codebuddy`）。若未设置，会尝试进程环境变量 **`AI_COMMAND`**；再否则默认为 **`claude`**。
+```bash
+# 电脑端
+cd /my-project && claude        # 正常工作，退出时 Ctrl+C
+
+# 手机端（IM 消息）
+"帮我修复登录 bug"              # open-im 自动接续同一个 session
+
+# 回到电脑端
+claude -c                       # 接上手机端的对话
+```
+
+> 同一时刻只能有一端活跃。从手机发消息前先退出 CLI，反之亦然。
+
+## Git 共同作者
+
+默认在 AI 发起的提交里追加 `Co-authored-by`。**关闭**：设置环境变量 **`OPEN_IM_GIT_COAUTHOR=0`** 并重启桥接。
+
+## 最小配置
 
 ```json
 {
+  "tools": {
+    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
+  },
   "platforms": {
-    "telegram": { "enabled": true, "aiCommand": "codex", "botToken": "..." }
+    "telegram": { "enabled": true, "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
   }
 }
 ```
 
-### Claude（Agent SDK）
+在 **`platforms`** 下按需补充其他平台。完整模板请用 **`open-im init`**。
 
-无需本地 `claude` 可执行文件。凭证顺序：环境变量 → **`config.json`** 的 **`tools.claude.env`** → **`~/.claude/settings.json`**（控制台保存的 API 配置写入后者）。
+### Claude（Agent SDK）
 
-第三方兼容接口示例：
+无需本地 `claude` 可执行文件。第三方兼容接口示例：
 
 ```json
 {
   "tools": {
     "claude": {
-      "workDir": "/path/to/project",
       "env": {
         "ANTHROPIC_AUTH_TOKEN": "your-token",
         "ANTHROPIC_BASE_URL": "https://your-api-endpoint",
@@ -97,59 +112,25 @@ npx @wu529778790/open-im start
 }
 ```
 
-### CodeBuddy
+### 按平台指定 AI
 
-```bash
-npm install -g @tencent-ai/codebuddy-code
-codebuddy login
-```
+在每个平台上设置 **`platforms.<name>.aiCommand`**（`claude` / `codex` / `codebuddy`）。默认 `claude`。
 
-### 最小配置结构
+### Web 控制台
 
-```json
-{
-  "tools": {
-    "claude": { "workDir": "/path/to/project", "skipPermissions": true, "timeoutMs": 600000 }
-  },
-  "platforms": {
-    "telegram": { "enabled": true, "aiCommand": "claude", "botToken": "YOUR_TELEGRAM_BOT_TOKEN" }
-  }
-}
-```
-
-在 **`platforms`** 下按需补充飞书、QQ、企业微信、钉钉、WorkBuddy。完整模板请用 **`open-im init`**。微信建议 **`open-im init`** 走 WorkBuddy OAuth。
+`open-im start` 在 **`OPEN_IM_WEB_PORT`**（默认 **39282**）提供内置页面与 **`/api/*`**。局域网访问：`export OPEN_IM_WEB_HOST=0.0.0.0`。
 
 ### 环境变量
 
-可在 **`config.json`**（平台与 `tools.*` 等）或环境变量中设置；控制台会展示常用项。常见：**`ANTHROPIC_*`**（shell 或 **`tools.claude.env`**）、**`TELEGRAM_BOT_TOKEN`**、**`OPEN_IM_WEB_PORT`**、**`OPEN_IM_WEB_HOST`**，以及各平台的 `*_APP_ID`、`*_SECRET`、`WORKBUDDY_*` 等。根级 **`config.json` `env`** 已不再使用。
+常见：**`ANTHROPIC_*`**（shell 或 **`tools.claude.env`**）、**`TELEGRAM_BOT_TOKEN`**、**`OPEN_IM_WEB_PORT`**、**`OPEN_IM_WEB_HOST`**，以及各平台的 `*_APP_ID`、`*_SECRET`、`WORKBUDDY_*` 等。
 
 ### 隐私
 
 为改进稳定性，可能记录**匿名**运行信息（不含聊天或 prompt 内容）。若需关闭：环境变量 **`OPEN_IM_TELEMETRY=false`**，或 **`config.json`** 中 **`"telemetry": { "enabled": false }`**。
 
-### 平台凭证
-
-| 平台 | 说明 |
-| --- | --- |
-| Telegram | [@BotFather](https://t.me/BotFather) |
-| 飞书 | [开放平台](https://open.feishu.cn/) |
-| QQ | [QQ 开放平台](https://bot.q.qq.com/) |
-| 钉钉 | 开放平台创建应用，机器人开 **Stream Mode**；可选 **`cardTemplateId`** 走 AI 助理卡片 |
-| 企业微信 | [管理后台](https://work.weixin.qq.com/) |
-| 微信 | **`open-im init`** → WorkBuddy OAuth |
+## 平台配置与故障排除
 
-## 故障排除
-
-| 现象 | 处理 |
-| --- | --- |
-| 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 会过期） |
+详见 **[docs/platforms.zh-CN.md](./docs/platforms.zh-CN.md)**。
 
 ## License
 

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

@@ -9,6 +9,18 @@
  * 认证：ANTHROPIC_API_KEY 或 CLAUDE_CODE_OAUTH_TOKEN
  */
 import type { ToolAdapter, RunCallbacks, RunOptions, RunHandle } from './tool-adapter.interface.js';
+interface ClaudeSessionMeta {
+    sessionId: string;
+    mtime: number;
+    filePath: string;
+    size: number;
+}
+/**
+ * 扫描 ~/.claude/projects/<encoded-path>/ 找到最新的 CLI session。
+ * 只返回 JSONL 文件（排除子目录如 subagents/），按修改时间倒序。
+ * @param homeOverride 测试用：覆盖 homedir() 的返回值
+ */
+export declare function findLatestClaudeSession(workDir: string, homeOverride?: string): ClaudeSessionMeta | undefined;
 /**
  * 由 initAdapters 根据配置调用。ttlMinutes≤0 时关闭空闲回收（仍受 MAX_ACTIVE_SESSIONS 限制）。
  */
@@ -26,3 +38,4 @@ export declare class ClaudeSDKAdapter implements ToolAdapter {
     static removeSession(sessionId: string): void;
     run(prompt: string, sessionId: string | undefined, workDir: string, callbacks: RunCallbacks, options?: RunOptions): RunHandle;
 }
+export {};