@wu529778790/open-im 0.2.7 → 0.2.9

package/README.md

@@ -19,24 +19,69 @@ 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` | 停止服务 |
+| `open-im restart` | 重启服务 |
 
 ### Telegram 机器人命令
 
@@ -59,7 +104,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 +119,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';
@@ -128,14 +129,28 @@ async function stopService() {
         await removePidFile();
     }
 }
-const args = process.argv.slice(2);
-if (args[0] === 'stop') {
-    stopService().catch((err) => {
-        console.error('停止服务时出错:', err);
+// 启动服务（后台）
+async function startService() {
+    // 首先检查是否需要配置
+    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);
-    });
-}
-else if (args[0] === 'start') {
+    }
     // 获取当前工作目录
     const currentDir = process.cwd();
     // 更新配置中的工作目录
@@ -155,8 +170,49 @@ else if (args[0] === 'start') {
     child.unref();
     console.log(`服务已在后台启动 (PID: ${child.pid})`);
 }
+const args = process.argv.slice(2);
+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] === 'restart') {
+    console.log('正在重启服务...\n');
+    await stopService().catch((err) => {
+        console.error('停止服务时出错:', err);
+    });
+    // 等待进程完全退出
+    await new Promise(resolve => setTimeout(resolve, 1000));
+    console.log('\n正在重新启动服务...\n');
+    await startService();
+}
+else if (args[0] === 'start') {
+    await startService();
+}
+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.d.ts

@@ -1,8 +1,8 @@
 import type { Config } from '../config.js';
 import type { SessionManager } from '../session/session-manager.js';
 import type { RequestQueue } from '../queue/request-queue.js';
-import type { ThreadContext, CostRecord } from '../shared/types.js';
-export type { ThreadContext, CostRecord };
+import type { ThreadContext } from '../shared/types.js';
+export type { ThreadContext };
 export interface MessageSender {
     sendTextReply(chatId: string, text: string, threadCtx?: ThreadContext): Promise<void>;
 }
@@ -11,7 +11,6 @@ export interface CommandHandlerDeps {
     sessionManager: SessionManager;
     requestQueue: RequestQueue;
     sender: MessageSender;
-    userCosts: Map<string, CostRecord>;
     getRunningTasksSize: () => number;
 }
 export type ClaudeRequestHandler = (userId: string, chatId: string, prompt: string, workDir: string, convId?: string, threadCtx?: ThreadContext, replyToMessageId?: string) => Promise<void>;

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) {
@@ -64,7 +69,6 @@ export class CommandHandler {
         const workDir = this.deps.sessionManager.getWorkDir(userId);
         const convId = this.deps.sessionManager.getConvId(userId);
         const sessionId = this.deps.sessionManager.getSessionIdForConv(userId, convId);
-        const record = this.deps.userCosts.get(userId);
         const lines = [
             '📊 状态:',
             '',
@@ -72,7 +76,6 @@ export class CommandHandler {
             `版本: ${version}`,
             `工作目录: ${workDir}`,
             `会话: ${sessionId ?? '无'}`,
-            `费用: $${record?.totalCost.toFixed(4) ?? '0.0000'}`,
         ];
         await this.deps.sender.sendTextReply(chatId, lines.join('\n'));
         return true;
@@ -84,7 +87,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/dist/shared/ai-task.d.ts

@@ -4,11 +4,9 @@
 import type { Config } from '../config.js';
 import type { SessionManager } from '../session/session-manager.js';
 import type { ToolAdapter } from '../adapters/tool-adapter.interface.js';
-import type { CostRecord } from './types.js';
 export interface TaskDeps {
     config: Config;
     sessionManager: SessionManager;
-    userCosts: Map<string, CostRecord>;
 }
 export interface TaskContext {
     userId: string;

package/dist/shared/ai-task.js

@@ -1,19 +1,13 @@
 /**
  * 共享 AI 任务执行层 - 支持多 ToolAdapter
  */
-import { formatToolStats, formatToolCallNotification, trackCost, getContextWarning, } from './utils.js';
+import { formatToolStats, formatToolCallNotification, getContextWarning, } from './utils.js';
 import { createLogger } from '../logger.js';
 const log = createLogger('AITask');
 function buildCompletionNote(result, sessionManager, ctx) {
     const toolInfo = formatToolStats(result.toolStats, result.numTurns);
     const parts = [];
-    if (result.cost > 0) {
-        parts.push(`耗时 ${(result.durationMs / 1000).toFixed(1)}s`);
-        parts.push(`费用 $${result.cost.toFixed(4)}`);
-    }
-    else {
-        parts.push('完成');
-    }
+    parts.push(`耗时 ${(result.durationMs / 1000).toFixed(1)}s`);
     if (toolInfo)
         parts.push(toolInfo);
     if (result.model)
@@ -27,7 +21,7 @@ function buildCompletionNote(result, sessionManager, ctx) {
     return parts.join(' | ');
 }
 export function runAITask(deps, ctx, prompt, toolAdapter, platformAdapter) {
-    const { config, sessionManager, userCosts } = deps;
+    const { config, sessionManager } = deps;
     return new Promise((resolve) => {
         let lastUpdateTime = 0;
         let pendingUpdate = null;
@@ -125,8 +119,6 @@ export function runAITask(deps, ctx, prompt, toolAdapter, platformAdapter) {
                     pendingUpdate = null;
                 }
                 const note = buildCompletionNote(result, sessionManager, ctx);
-                log.info(`Task completed for user ${ctx.userId}: cost=$${result.cost.toFixed(4)}`);
-                trackCost(userCosts, ctx.userId, result.cost, result.durationMs);
                 const finalContent = result.accumulated || result.result || '(无输出)';
                 try {
                     await platformAdapter.sendComplete(finalContent, note, thinkingText || undefined);

package/dist/shared/types.d.ts

@@ -2,8 +2,3 @@ export interface ThreadContext {
     rootMessageId: string;
     threadId: string;
 }
-export interface CostRecord {
-    totalCost: number;
-    totalDurationMs: number;
-    requestCount: number;
-}

package/dist/shared/utils.d.ts

@@ -1,7 +1,5 @@
-import type { CostRecord } from './types.js';
 export declare function truncateText(text: string, maxLen: number): string;
 export declare function splitLongContent(text: string, maxLen: number): string[];
 export declare function formatToolStats(toolStats: Record<string, number>, numTurns: number): string;
 export declare function formatToolCallNotification(toolName: string, toolInput?: Record<string, unknown>): string;
-export declare function trackCost(userCosts: Map<string, CostRecord>, userId: string, cost: number, durationMs: number): void;
 export declare function getContextWarning(totalTurns: number): string | null;

package/dist/shared/utils.js

@@ -56,13 +56,6 @@ export function formatToolCallNotification(toolName, toolInput) {
         detail = ` → ${toolInput.file_path}`;
     return `${emoji} ${toolName}${detail}`;
 }
-export function trackCost(userCosts, userId, cost, durationMs) {
-    const r = userCosts.get(userId) ?? { totalCost: 0, totalDurationMs: 0, requestCount: 0 };
-    r.totalCost += cost;
-    r.totalDurationMs += durationMs;
-    r.requestCount += 1;
-    userCosts.set(userId, r);
-}
 export function getContextWarning(totalTurns) {
     if (totalTurns >= 12)
         return '⚠️ 上下文较长，建议 /new 开始新会话';

package/dist/telegram/event-handler.js

@@ -27,7 +27,6 @@ async function downloadTelegramPhoto(bot, fileId) {
 export function setupTelegramHandlers(bot, config, sessionManager) {
     const accessControl = new AccessControl(config.allowedUserIds);
     const requestQueue = new RequestQueue();
-    const userCosts = new Map();
     const runningTasks = new Map();
     const stopTaskCleanup = startTaskCleanup(runningTasks);
     const dedup = new MessageDedup();
@@ -36,7 +35,6 @@ export function setupTelegramHandlers(bot, config, sessionManager) {
         sessionManager,
         requestQueue,
         sender: { sendTextReply },
-        userCosts,
         getRunningTasksSize: () => runningTasks.size,
     });
     registerPermissionSender('telegram', {});
@@ -59,7 +57,7 @@ export function setupTelegramHandlers(bot, config, sessionManager) {
         }
         const stopTyping = startTypingLoop(chatId);
         const taskKey = `${userId}:${msgId}`;
-        await runAITask({ config, sessionManager, userCosts }, { userId, chatId, workDir, sessionId, convId, platform: 'telegram', taskKey }, prompt, toolAdapter, {
+        await runAITask({ config, sessionManager }, { userId, chatId, workDir, sessionId, convId, platform: 'telegram', taskKey }, prompt, toolAdapter, {
             throttleMs: THROTTLE_MS,
             streamUpdate: (content, toolNote) => {
                 const note = toolNote ? '输出中...\n' + toolNote : '输出中...';

package/dist/telegram/message-sender.js

@@ -45,8 +45,9 @@ export async function sendThinkingMessage(chatId, replyToMessageId, toolId = 'cl
             message_id: Number(replyToMessageId),
         };
     }
-    const msg = await bot.telegram.sendMessage(Number(chatId), formatMessage('正在思考...', 'thinking', '请稍候', toolId), { ...extra, parse_mode: 'Markdown' });
-    await bot.telegram.editMessageText(Number(chatId), msg.message_id, undefined, formatMessage('正在思考...', 'thinking', '请稍候', toolId), { reply_markup: buildStopKeyboard(msg.message_id), parse_mode: 'Markdown' });
+    // 初始消息使用纯文本，避免 Markdown 解析问题
+    const msg = await bot.telegram.sendMessage(Number(chatId), formatMessage('正在思考...', 'thinking', '请稍候', toolId), extra);
+    await bot.telegram.editMessageText(Number(chatId), msg.message_id, undefined, formatMessage('正在思考...', 'thinking', '请稍候', toolId), { reply_markup: buildStopKeyboard(msg.message_id) });
     return String(msg.message_id);
 }
 export async function updateMessage(chatId, messageId, content, status, note, toolId = 'claude') {
@@ -55,8 +56,11 @@ export async function updateMessage(chatId, messageId, content, status, note, to
     if (status === 'thinking' || status === 'streaming') {
         opts.reply_markup = buildStopKeyboard(Number(messageId));
     }
+    // 流式输出时使用纯文本，避免 Markdown 解析导致内容减少
+    // 只在完成时应用 Markdown 格式
+    const shouldParseMarkdown = status === 'done' || status === 'error';
     try {
-        await bot.telegram.editMessageText(Number(chatId), Number(messageId), undefined, formatMessage(content, status, note, toolId), { ...opts, parse_mode: 'Markdown' });
+        await bot.telegram.editMessageText(Number(chatId), Number(messageId), undefined, formatMessage(content, status, note, toolId), { ...opts, parse_mode: shouldParseMarkdown ? 'Markdown' : undefined });
     }
     catch (err) {
         if (err && typeof err === 'object' && 'message' in err && String(err.message).includes('not modified')) {

package/package.json

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