@wu529778790/open-im 0.1.0 → 0.1.2

package/.env.example

@@ -1,16 +1,16 @@
-# Telegram Bot Token (from @BotFather)
-TELEGRAM_BOT_TOKEN=
-
-# Allowed user IDs (comma-separated, empty = allow all in dev)
-ALLOWED_USER_IDS=
-
-# AI tool: claude | codex | cursor
-AI_COMMAND=claude
-
-# Claude CLI (when AI_COMMAND=claude)
-CLAUDE_CLI_PATH=claude
-CLAUDE_WORK_DIR=.
-CLAUDE_SKIP_PERMISSIONS=true
-CLAUDE_TIMEOUT_MS=600000
-CLAUDE_MODEL=
-ALLOWED_BASE_DIRS=
+# Telegram Bot Token (from @BotFather)
+TELEGRAM_BOT_TOKEN=
+
+# Allowed user IDs (comma-separated, empty = allow all in dev)
+ALLOWED_USER_IDS=
+
+# AI tool: claude | codex | cursor
+AI_COMMAND=claude
+
+# Claude CLI (when AI_COMMAND=claude)
+CLAUDE_CLI_PATH=claude
+CLAUDE_WORK_DIR=.
+CLAUDE_SKIP_PERMISSIONS=true
+CLAUDE_TIMEOUT_MS=600000
+CLAUDE_MODEL=
+ALLOWED_BASE_DIRS=

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 wu529778790
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 wu529778790
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,51 +1,76 @@
-# open-im
-
-多平台 IM 桥接，支持多种 AI CLI 工具（Claude Code、Codex、Cursor 等）。
-
-## 功能
-
-- **多 AI 工具**：通过 `AI_COMMAND` 配置切换 Claude / Codex / Cursor
-- **流式输出**：节流更新，Telegram editMessage 实时展示
-- **会话管理**：每用户独立 session，`/new` 重置
-- **命令**：`/help` `/new` `/cd` `/pwd` `/status`
-
-## 快速开始
-
-### 快速开始
-
-```bash
-npm run build
-npm run dev   # 或 npm start
-```
-
-首次运行会进入交互式配置，按提示输入后自动启动服务。配置保存到 `~/.open-im/config.json`。
-
-## 配置
-
-| 变量 | 说明 |
-|------|------|
-| `TELEGRAM_BOT_TOKEN` | Telegram Bot Token |
-| `ALLOWED_USER_IDS` | 白名单用户 ID（逗号分隔，空=所有人） |
-| `AI_COMMAND` | `claude` \| `codex` \| `cursor`，默认 `claude` |
-| `CLAUDE_CLI_PATH` | Claude CLI 路径，默认 `claude` |
-| `CLAUDE_WORK_DIR` | 工作目录 |
-| `CLAUDE_SKIP_PERMISSIONS` | 跳过权限确认，默认 `true` |
-
-## 项目结构
-
-```
-src/
-├── adapters/          # ToolAdapter 抽象与实现
-│   ├── tool-adapter.interface.ts
-│   ├── claude-adapter.ts
-│   └── registry.ts
-├── claude/            # Claude CLI 运行与解析
-├── shared/            # ai-task、utils、types
-├── telegram/          # Telegram 事件与消息
-├── session/           # 会话管理
-└── commands/          # 命令分发
-```
-
-## License
-
-MIT
+# open-im
+
+> 🚀 把你的 AI 助手装进口袋里 - 在 Telegram 随时随地使用 Claude Code
+
+还在受限于终端吗？用手机也能 Coding 了！
+
+open-im 是一个轻量级的 IM 桥接工具，让你通过 Telegram 就能使用 Claude Code、Codex、Cursor 等 AI CLI 工具。无论是在咖啡厅、地铁上，还是躺在床上，你的 AI 助手随时在线。
+
+## ✨ 为什么选择 open-im
+
+- **📱 移动友好** - 告别终端，用手机照样写代码
+- **⚡ 实时流式输出** - AI 思考过程实时可见，像在终端一样流畅
+- **🔒 安全可控** - 支持白名单，只有你能用
+- **🔄 独立会话** - 每个人独立 session，互不干扰
+- **🛠️ 多 AI 支持** - Claude / Codex / Cursor 随意切换
+
+## 🚀 快速开始
+
+### 方式一：npx（无需安装）
+
+```bash
+npx @wu529778790/open-im start
+```
+
+### 方式二：全局安装（推荐常用用户）
+
+```bash
+npm i @wu529778790/open-im -g
+open-im start
+```
+
+首次运行会引导你完成配置，30 秒即可搞定。
+
+## 📖 常用命令
+
+| 命令 | 说明 |
+|------|------|
+| `open-im start` | 启动服务（后台运行） |
+| `open-im stop` | 停止服务 |
+
+### Telegram 机器人命令
+
+| 命令 | 功能 |
+|------|------|
+| `/help` | 查看帮助 |
+| `/new` | 开启新会话 |
+| `/cd <路径>` | 切换工作目录 |
+| `/pwd` | 查看当前目录 |
+| `/status` | 查看运行状态 |
+
+## 💡 使用场景
+
+- 🚇 **通勤路上** - 用手机处理简单的代码问题
+- ☕ **咖啡厅** - 没带电脑也能快速调试
+- 🛋️ **沙发模式** - 躺着看 AI 帮你写代码
+- 🌙 **紧急修复** - 半夜收到报警，手机直接处理
+
+## 📦 安装方式
+
+```bash
+# npx（无需安装）
+npx @wu529778790/open-im start
+
+# npm 全局安装
+npm i @wu529778790/open-im -g
+
+# yarn 全局安装
+yarn global add @wu529778790/open-im
+
+# pnpm 全局安装
+pnpm i @wu529778790/open-im -g
+```
+
+## 📝 License
+
+[MIT](LICENSE)

package/dist/claude/cli-runner.js

@@ -22,7 +22,7 @@ export function runClaude(cliPath, prompt, sessionId, workDir, callbacks, option
         env.CC_IM_CHAT_ID = options.chatId;
     if (options?.hookPort)
         env.CC_IM_HOOK_PORT = String(options.hookPort);
-    const child = spawn(cliPath, args, { cwd: workDir, stdio: ['ignore', 'pipe', 'pipe'], env });
+    const child = spawn(cliPath, args, { cwd: workDir, stdio: ['ignore', 'pipe', 'pipe'], env, windowsHide: true });
     log.debug(`Claude CLI spawned: pid=${child.pid}, cwd=${workDir}, session=${sessionId ?? 'new'}`);
     let accumulated = '';
     let accumulatedThinking = '';

package/dist/cli.js

@@ -1,6 +1,138 @@
 #!/usr/bin/env node
 import { main } from './index.js';
-main().catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
+import { spawn, execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { mkdir, writeFile, rm, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { platform } from 'node:os';
+import { homedir } from 'node:os';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// PID 文件路径
+const PID_DIR = join(homedir(), '.open-im');
+const PID_FILE = join(PID_DIR, 'daemon.pid');
+const STOP_FILE = join(PID_DIR, 'stop.flag');
+// 保存 PID 到文件
+async function savePid(pid) {
+    try {
+        await mkdir(PID_DIR, { recursive: true });
+        await writeFile(PID_FILE, String(pid), 'utf-8');
+    }
+    catch (err) {
+        console.error('无法保存 PID 文件:', err);
+    }
+}
+// 读取 PID 文件
+async function readPid() {
+    try {
+        if (!existsSync(PID_FILE)) {
+            return null;
+        }
+        const content = await readFile(PID_FILE, 'utf-8');
+        return parseInt(content.trim(), 10);
+    }
+    catch {
+        return null;
+    }
+}
+// 删除 PID 文件
+async function removePidFile() {
+    try {
+        if (existsSync(PID_FILE)) {
+            await rm(PID_FILE);
+        }
+    }
+    catch {
+        // 忽略删除错误
+    }
+}
+// 检查进程是否在运行
+async function isProcessRunning(pid) {
+    try {
+        // 尝试发送信号 0（不杀死进程，只检查是否存在）
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// 停止服务 - 创建停止标记文件，让服务优雅关闭
+async function stopService() {
+    const pid = await readPid();
+    if (!pid) {
+        console.log('未找到运行中的服务（PID 文件不存在）');
+        return;
+    }
+    const running = await isProcessRunning(pid);
+    if (!running) {
+        console.log(`服务未运行（进程 ${pid} 不存在）`);
+        await removePidFile();
+        return;
+    }
+    try {
+        // 创建停止标记文件，服务会定期检查并优雅关闭
+        await mkdir(PID_DIR, { recursive: true });
+        await writeFile(STOP_FILE, Date.now().toString(), 'utf-8');
+        console.log('正在停止服务...');
+        // 等待进程退出（最多 10 秒）
+        const maxWait = 10000;
+        const interval = 200;
+        let waited = 0;
+        while (waited < maxWait) {
+            await new Promise(resolve => setTimeout(resolve, interval));
+            if (!(await isProcessRunning(pid))) {
+                await removePidFile();
+                console.log('服务已停止');
+                return;
+            }
+            waited += interval;
+        }
+        // 超时后强制终止
+        console.log('等待超时，强制终止服务...');
+        const isWindows = platform() === 'win32';
+        if (isWindows) {
+            execFileSync('taskkill', ['/F', '/PID', String(pid)], { stdio: 'ignore' });
+        }
+        else {
+            process.kill(pid, 'SIGKILL');
+        }
+        await removePidFile();
+        console.log('服务已强制停止');
+    }
+    catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        console.error(`停止服务失败: ${errorMsg}`);
+        await removePidFile();
+    }
+}
+const args = process.argv.slice(2);
+if (args[0] === 'stop') {
+    stopService().catch((err) => {
+        console.error('停止服务时出错:', err);
+        process.exit(1);
+    });
+}
+else if (args[0] === 'start') {
+    // 后台启动 - 跨平台方案
+    const distPath = join(__dirname, '..', 'dist', 'index.js');
+    // 使用 detached 模式创建独立进程
+    const child = spawn(process.execPath, [distPath], {
+        detached: true,
+        stdio: ['ignore', 'ignore', 'ignore'],
+        windowsHide: true // Windows 上隐藏控制台窗口
+    });
+    // 保存 PID
+    await savePid(child.pid);
+    // 让子进程独立于父进程
+    child.unref();
+    console.log(`服务已在后台启动 (PID: ${child.pid})`);
+}
+else {
+    // 默认启动（兼容直接运行 open-im）
+    main().catch((err) => {
+        console.error(err);
+        process.exit(1);
+    });
+}

package/dist/index.js

@@ -8,9 +8,30 @@ import { SessionManager } from './session/session-manager.js';
 import { loadActiveChats, getActiveChatId, flushActiveChats } from './shared/active-chats.js';
 import { initLogger, createLogger, closeLogger } from './logger.js';
 import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { rm } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
 const require = createRequire(import.meta.url);
 const { version: APP_VERSION } = require('../package.json');
 const log = createLogger('Main');
+// 停止标记文件路径
+const STOP_FILE = join(homedir(), '.open-im', 'stop.flag');
+// 检查是否收到停止信号
+function checkStopSignal() {
+    return existsSync(STOP_FILE);
+}
+// 清理停止标记文件
+async function clearStopSignal() {
+    try {
+        if (existsSync(STOP_FILE)) {
+            await rm(STOP_FILE);
+        }
+    }
+    catch {
+        // 忽略错误
+    }
+}
 async function sendLifecycleNotification(platform, message) {
     const chatId = getActiveChatId('telegram');
     if (!chatId)
@@ -55,7 +76,16 @@ export async function main() {
         log.info('Shutting down...');
         const uptimeSec = Math.floor((Date.now() - startedAt) / 1000);
         const m = Math.floor(uptimeSec / 60);
-        await sendLifecycleNotification('telegram', `🔴 open-im 服务正在关闭...\n运行时长: ${m}分钟`).catch(() => { });
+        try {
+            await sendLifecycleNotification('telegram', `🔴 open-im 服务正在关闭...\n运行时长: ${m}分钟`);
+            // 等待消息发送完成
+            await new Promise(resolve => setTimeout(resolve, 500));
+        }
+        catch (err) {
+            log.debug('Failed to send shutdown notification:', err);
+        }
+        // 清理停止标记文件
+        await clearStopSignal();
         telegramHandle?.stop();
         stopTelegram();
         sessionManager.destroy();
@@ -65,6 +95,13 @@ export async function main() {
     };
     process.on('SIGINT', () => shutdown().catch(() => process.exit(1)));
     process.on('SIGTERM', () => shutdown().catch(() => process.exit(1)));
+    // 定期检查停止标记文件（用于 Windows 等无法发送信号的场景）
+    const stopCheckInterval = setInterval(() => {
+        if (checkStopSignal()) {
+            clearInterval(stopCheckInterval);
+            shutdown().catch(() => process.exit(1));
+        }
+    }, 1000);
 }
 const isEntry = process.argv[1]?.replace(/\\/g, '/').endsWith('/index.js') || process.argv[1]?.replace(/\\/g, '/').endsWith('/index.ts');
 if (isEntry) {

package/dist/setup.js

@@ -14,12 +14,12 @@ function printManualInstructions(configPath) {
     console.log('  2. 创建文件:', configPath);
     console.log('  3. 填入以下内容（替换为你的 Token 和用户 ID）：');
     console.log('');
-    console.log(`{
-  "telegramBotToken": "你的Bot Token",
-  "allowedUserIds": ["你的Telegram用户ID"],
-  "claudeWorkDir": "${process.cwd().replace(/\\/g, '/')}",
-  "claudeSkipPermissions": true,
-  "aiCommand": "claude"
+    console.log(`{
+  "telegramBotToken": "你的Bot Token",
+  "allowedUserIds": ["你的Telegram用户ID"],
+  "claudeWorkDir": "${process.cwd().replace(/\\/g, '/')}",
+  "claudeSkipPermissions": true,
+  "aiCommand": "claude"
 }`);
     console.log('');
     console.log('或设置环境变量: TELEGRAM_BOT_TOKEN=xxx 后再运行');

package/package.json

@@ -1,52 +1,54 @@
-{
-  "name": "@wu529778790/open-im",
-  "version": "0.1.0",
-  "description": "Multi-platform IM bridge for AI CLI tools (Claude, Codex, Cursor)",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "open-im": "dist/cli.js"
-  },
-  "files": [
-    "dist",
-    ".env.example"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "setup": "node dist/index.js --setup-only",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "telegram",
-    "feishu",
-    "claude",
-    "claude-code",
-    "bot",
-    "bridge"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/wu529778790/open-im.git"
-  },
-  "homepage": "https://github.com/wu529778790/open-im#readme",
-  "bugs": {
-    "url": "https://github.com/wu529778790/open-im/issues"
-  },
-  "dependencies": {
-    "prompts": "^2.4.2",
-    "telegraf": "^4.16.3"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/prompts": "^2.4.9",
-    "dotenv": "^16.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.0.0"
-  },
-  "engines": {
-    "node": ">=20"
-  }
-}
+{
+  "name": "@wu529778790/open-im",
+  "version": "0.1.2",
+  "description": "Multi-platform IM bridge for AI CLI tools (Claude, Codex, Cursor)",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "open-im": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    ".env.example"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "run": "node dist/index.js",
+    "start": "node dist/cli.js start",
+    "stop": "node dist/cli.js stop",
+    "setup": "node dist/index.js --setup-only",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "telegram",
+    "feishu",
+    "claude",
+    "claude-code",
+    "bot",
+    "bridge"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wu529778790/open-im.git"
+  },
+  "homepage": "https://github.com/wu529778790/open-im#readme",
+  "bugs": {
+    "url": "https://github.com/wu529778790/open-im/issues"
+  },
+  "dependencies": {
+    "prompts": "^2.4.2",
+    "telegraf": "^4.16.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.9",
+    "dotenv": "^16.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}