@wu529778790/open-im 0.2.6 → 0.2.8

package/README.md

@@ -19,23 +19,67 @@ open-im 是一个轻量级的 IM 桥接工具，让你通过 Telegram 就能使
 ### 方式一：npx（无需安装）
 
 ```bash
-npx @wu529778790/open-im start
+npx @wu529778790/open-im run
 ```
 
 ### 方式二：全局安装（推荐常用用户）
 
 ```bash
 npm i @wu529778790/open-im -g
-open-im start
+open-im run
 ```
 
 首次运行会引导你完成配置，30 秒即可搞定。
 
+如果配置引导未出现，可以手动运行：
+
+```bash
+npx @wu529778790/open-im init
+```
+
+## ⚙️ 配置说明
+
+配置文件位置：`~/.open-im/config.json`
+
+配置文件示例：
+
+```json
+{
+  "telegramBotToken": "你的Bot Token（从 @BotFather 获取）",
+  "allowedUserIds": ["你的Telegram用户ID"],
+  "claudeWorkDir": "/path/to/your/work/dir",
+  "claudeSkipPermissions": true,
+  "aiCommand": "claude"
+}
+```
+
+获取 Telegram Bot Token：
+1. 在 Telegram 中搜索 @BotFather
+2. 发送 `/newbot` 创建新机器人
+3. 按提示设置机器人名称
+4. BotFather 会返回 Token，格式如：`123456789:ABCdefGHIjklMNOpqrsTUVwxyz`
+
+获取 Telegram 用户 ID（可选）：
+1. 在 Telegram 中搜索 @userinfobot
+2. 发送任意消息
+3. 机器人会返回你的用户 ID
+4. 如不设置，则所有人都可以使用你的机器人
+
+**或者通过环境变量配置：**
+
+```bash
+export TELEGRAM_BOT_TOKEN="你的Bot Token"
+export ALLOWED_USER_IDS="用户ID1,用户ID2"
+open-im run
+```
+
 ## 📖 常用命令
 
 | 命令 | 说明 |
 |------|------|
-| `open-im start` | 启动服务（后台运行） |
+| `open-im` / `open-im run` | 前台运行（首次使用会引导配置） |
+| `open-im init` | 初始化配置（首次使用或重新配置） |
+| `open-im start` | 后台启动服务 |
 | `open-im stop` | 停止服务 |
 
 ### Telegram 机器人命令
@@ -59,7 +103,7 @@ open-im start
 
 ```bash
 # npx（无需安装）
-npx @wu529778790/open-im start
+npx @wu529778790/open-im run
 
 # npm 全局安装
 npm i @wu529778790/open-im -g
@@ -74,3 +118,59 @@ pnpm i @wu529778790/open-im -g
 ## 📝 License
 
 [MIT](LICENSE)
+
+## 🔧 故障排除
+
+### Q: 首次运行没有配置引导？
+
+如果配置引导没有出现，尝试以下方法：
+
+1. **手动运行配置命令：**
+   ```bash
+   npx @wu529778790/open-im init
+   ```
+
+2. **检查是否已有配置文件：**
+   ```bash
+   cat ~/.open-im/config.json
+   ```
+
+3. **手动创建配置文件：**
+   ```bash
+   mkdir -p ~/.open-im
+   cat > ~/.open-im/config.json << 'EOF'
+   {
+     "telegramBotToken": "你的Bot Token",
+     "allowedUserIds": ["你的Telegram用户ID"],
+     "claudeWorkDir": "$(pwd)",
+     "claudeSkipPermissions": true,
+     "aiCommand": "claude"
+   }
+   EOF
+   ```
+
+### Q: 启动后服务立即退出？
+
+可能是配置文件无效，检查配置：
+
+```bash
+# 查看日志
+tail -f ~/.open-im/logs/*.log
+
+# 重新配置
+rm ~/.open-im/config.json
+npx @wu529778790/open-im run
+```
+
+### Q: 如何获取 Telegram Bot Token？
+
+1. 在 Telegram 中搜索 @BotFather
+2. 发送 `/newbot` 创建新机器人
+3. 按提示设置机器人名称
+4. BotFather 会返回 Token，格式如：`123456789:ABCdefGHIjklMNOpqrsTUVwxyz`
+
+### Q: 如何获取 Telegram 用户 ID？
+
+1. 在 Telegram 中搜索 @userinfobot
+2. 点击"START"或发送任意消息
+3. 机器人会返回你的用户 ID（数字）

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-import { main } from './index.js';
+import { main, needsSetup, runInteractiveSetup } from './index.js';
+import { loadConfig } from './config.js';
 import { spawn, execFileSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
@@ -129,13 +130,43 @@ async function stopService() {
     }
 }
 const args = process.argv.slice(2);
-if (args[0] === 'stop') {
+if (args[0] === 'init') {
+    // 手动触发配置
+    console.log('\n━━━ open-im 配置向导 ━━━\n');
+    const saved = await runInteractiveSetup();
+    if (!saved) {
+        console.log('配置未完成。');
+        process.exit(1);
+    }
+    console.log('\n✅ 配置完成！现在可以运行以下命令启动服务:\n  open-im start\n');
+}
+else if (args[0] === 'stop') {
     stopService().catch((err) => {
         console.error('停止服务时出错:', err);
         process.exit(1);
     });
 }
 else if (args[0] === 'start') {
+    // 首先检查是否需要配置
+    if (needsSetup()) {
+        console.log('\n━━━ open-im 首次配置 ━━━\n');
+        console.log('检测到未配置，需要先完成配置才能启动服务\n');
+        const saved = await runInteractiveSetup();
+        if (!saved) {
+            console.log('配置未完成，取消启动。');
+            process.exit(1);
+        }
+        console.log('');
+    }
+    // 验证配置是否有效（避免有配置文件但缺少必要字段的情况）
+    try {
+        loadConfig();
+    }
+    catch (err) {
+        console.error('配置无效或缺少必要字段:', err instanceof Error ? err.message : err);
+        console.log('\n请运行以下命令重新配置:\n  npx @wu529778790/open-im\n');
+        process.exit(1);
+    }
     // 获取当前工作目录
     const currentDir = process.cwd();
     // 更新配置中的工作目录
@@ -155,8 +186,19 @@ else if (args[0] === 'start') {
     child.unref();
     console.log(`服务已在后台启动 (PID: ${child.pid})`);
 }
+else if (args[0] === 'run' || args.length === 0) {
+    // 前台运行（默认命令）
+    console.log('\n🚀 正在前台启动 open-im 服务...\n');
+    console.log('💡 提示：按 Ctrl+C 可随时停止服务\n');
+    main().catch((err) => {
+        console.error(err);
+        process.exit(1);
+    });
+}
 else {
-    // 默认启动（兼容直接运行 open-im）
+    // 兼容旧版本，无参数时也运行
+    console.log('\n🚀 正在前台启动 open-im 服务...\n');
+    console.log('💡 提示：按 Ctrl+C 可随时停止服务\n');
     main().catch((err) => {
         console.error(err);
         process.exit(1);

package/dist/commands/handler.js

@@ -39,19 +39,24 @@ export class CommandHandler {
             '📋 可用命令:',
             '',
             '/help - 显示帮助',
-            '/new - 开始新会话',
+            '/new - 开始新会话（AI 上下文重置）',
             '/status - 显示状态',
             '/cd <路径> - 切换工作目录',
             '/pwd - 当前工作目录',
             '/allow (/y) - 允许权限请求',
             '/deny (/n) - 拒绝权限请求',
+            '',
+            '💡 提示：清除聊天历史请点击 Telegram 右上角 ⋮ → 清除历史',
         ].join('\n');
         await this.deps.sender.sendTextReply(chatId, help);
         return true;
     }
     async handleNew(chatId, userId) {
         const ok = this.deps.sessionManager.newSession(userId);
-        await this.deps.sender.sendTextReply(chatId, ok ? '✅ 已开始新会话。' : '当前没有活动会话。');
+        await this.deps.sender.sendTextReply(chatId, ok
+            ? '✅ AI 会话已重置，下一条消息将使用全新上下文。\n\n' +
+                '💡 提示：如需清除本对话的历史消息，请点击 Telegram 聊天右上角 ⋮ → 清除历史'
+            : '当前没有活动会话。');
         return true;
     }
     async handlePwd(chatId, userId) {
@@ -84,7 +89,9 @@ export class CommandHandler {
         }
         try {
             const resolved = await this.deps.sessionManager.setWorkDir(userId, dir);
-            await this.deps.sender.sendTextReply(chatId, `工作目录已切换到: ${resolved}\n会话已重置。`);
+            await this.deps.sender.sendTextReply(chatId, `📁 工作目录已切换到: ${resolved}\n\n` +
+                `🔄 AI 会话已重置，下一条消息将使用全新上下文。\n` +
+                `💡 提示：如需清除本对话的历史消息，请点击 Telegram 聊天右上角 ⋮ → 清除历史`);
         }
         catch (err) {
             await this.deps.sender.sendTextReply(chatId, err instanceof Error ? err.message : String(err));

package/dist/index.d.ts

@@ -1 +1,4 @@
+import { needsSetup } from './config.js';
+import { runInteractiveSetup } from './setup.js';
+export { needsSetup, runInteractiveSetup };
 export declare function main(): Promise<void>;

package/dist/index.js

@@ -1,5 +1,7 @@
 import { loadConfig, needsSetup } from './config.js';
 import { runInteractiveSetup } from './setup.js';
+// 导出供 cli.ts 使用
+export { needsSetup, runInteractiveSetup };
 import { initTelegram, stopTelegram } from './telegram/client.js';
 import { setupTelegramHandlers } from './telegram/event-handler.js';
 import { sendTextReply } from './telegram/message-sender.js';
@@ -72,17 +74,23 @@ export async function main() {
     ].join('\n');
     await sendLifecycleNotification('telegram', startupMsg).catch(() => { });
     const startedAt = Date.now();
+    // 防止重复发送关闭通知
+    let shutdownNotificationSent = false;
     const shutdown = async () => {
         log.info('Shutting down...');
         const uptimeSec = Math.floor((Date.now() - startedAt) / 1000);
         const m = Math.floor(uptimeSec / 60);
-        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);
+        // 只发送一次通知
+        if (!shutdownNotificationSent) {
+            shutdownNotificationSent = true;
+            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();

package/dist/session/session-manager.js

@@ -68,12 +68,17 @@ export class SessionManager {
         const realPath = await this.resolveAndValidate(currentDir, workDir);
         const s = this.sessions.get(userId);
         if (s) {
+            const oldConvId = s.activeConvId;
             if (s.activeConvId && s.sessionId) {
                 this.convSessionMap.set(`${userId}:${s.activeConvId}`, s.sessionId);
             }
             s.workDir = realPath;
             s.sessionId = undefined;
             s.activeConvId = randomBytes(4).toString('hex');
+            // 清除旧的 convSessionMap 中的映射
+            if (oldConvId) {
+                this.convSessionMap.delete(`${userId}:${oldConvId}`);
+            }
         }
         else {
             this.sessions.set(userId, {
@@ -82,19 +87,26 @@ export class SessionManager {
             });
         }
         this.flushSync();
-        log.info(`WorkDir changed for user ${userId}: ${realPath}`);
+        log.info(`WorkDir changed for user ${userId}: ${realPath}, oldConvId=${s?.activeConvId}`);
         return realPath;
     }
     newSession(userId) {
         const s = this.sessions.get(userId);
         if (s) {
+            const oldSessionId = s.sessionId;
+            const oldConvId = s.activeConvId;
             if (s.activeConvId && s.sessionId) {
                 this.convSessionMap.set(`${userId}:${s.activeConvId}`, s.sessionId);
             }
             s.sessionId = undefined;
             s.activeConvId = randomBytes(4).toString('hex');
             s.totalTurns = 0;
+            // 清除旧的 convSessionMap 中的映射，防止恢复旧的 sessionId
+            if (oldConvId) {
+                this.convSessionMap.delete(`${userId}:${oldConvId}`);
+            }
             this.flushSync();
+            log.info(`New session for user ${userId}: oldConvId=${oldConvId}, oldSessionId=${oldSessionId}, newConvId=${s.activeConvId}, sessionId=undefined`);
             return true;
         }
         return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wu529778790/open-im",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Multi-platform IM bridge for AI CLI tools (Claude, Codex, Cursor)",
   "type": "module",
   "main": "dist/index.js",