@wu529778790/open-im 0.3.11 → 0.4.0

package/README.md

@@ -49,11 +49,43 @@ npx @wu529778790/open-im init
   "allowedUserIds": ["你的Telegram用户ID"],
   "claudeWorkDir": "/path/to/your/work/dir",
   "claudeSkipPermissions": true,
-  "aiCommand": "claude"
+  "aiCommand": "claude",
+  "platforms": {
+    "telegram": {
+      "proxy": "http://127.0.0.1:7890"
+    }
+  }
 }
 ```
 
-获取 Telegram Bot Token：
+### 🌐 代理配置
+
+如果你的网络环境无法直接访问 Telegram，需要配置代理。代理配置按平台独立设置，互不影响。
+
+**配置方式：**
+
+在 JSON 配置文件中添加：
+```json
+{
+  "platforms": {
+    "telegram": {
+      "proxy": "http://127.0.0.1:7890"
+    }
+  }
+}
+```
+
+**支持的代理类型：**
+- HTTP 代理：`http://127.0.0.1:7890`
+- HTTPS 代理：`https://127.0.0.1:7890`
+- SOCKS5 代理：`socks5://127.0.0.1:1080`
+
+**注意：**
+- 代理仅用于访问 Telegram API，不会影响 AI 工具（Claude/Codex/Cursor）的网络请求
+- 飞书等其他国内 IM 平台无需配置代理
+- 如果你的网络能直接访问 Telegram，则无需配置代理
+
+### 获取 Telegram Bot Token
 1. 在 Telegram 中搜索 @BotFather
 2. 发送 `/newbot` 创建新机器人
 3. 按提示设置机器人名称
@@ -65,14 +97,6 @@ npx @wu529778790/open-im init
 3. 机器人会返回你的用户 ID
 4. 如不设置，则所有人都可以使用你的机器人
 
-**或者通过环境变量配置：**
-
-```bash
-export TELEGRAM_BOT_TOKEN="你的Bot Token"
-export ALLOWED_USER_IDS="用户ID1,用户ID2"
-open-im run
-```
-
 ## 📖 常用命令
 
 | 命令 | 说明 |
@@ -143,6 +167,11 @@ pnpm i @wu529778790/open-im -g
    {
      "telegramBotToken": "你的Bot Token",
      "allowedUserIds": ["你的Telegram用户ID"],
+     "platforms": {
+       "telegram": {
+         "proxy": "http://127.0.0.1:7890"
+       }
+     },
      "claudeWorkDir": "$(pwd)",
      "claudeSkipPermissions": true,
      "aiCommand": "claude"
@@ -175,3 +204,39 @@ npx @wu529778790/open-im run
 1. 在 Telegram 中搜索 @userinfobot
 2. 点击"START"或发送任意消息
 3. 机器人会返回你的用户 ID（数字）
+
+### Q: 如何配置代理？
+
+如果你的网络环境无法直接访问 Telegram，需要在配置文件中添加代理设置：
+
+```json
+{
+  "platforms": {
+    "telegram": {
+      "proxy": "http://127.0.0.1:7890"
+    }
+  }
+}
+```
+
+支持的代理格式：
+- HTTP：`http://127.0.0.1:7890`
+- HTTPS：`https://127.0.0.1:7890`
+- SOCKS5：`socks5://127.0.0.1:1080`
+
+注意：代理仅用于访问 Telegram API，不影响 AI 工具的网络请求。
+
+### Q: Telegram 机器人无响应？
+
+可能原因及解决方法：
+
+1. **网络问题 - Telegram 被阻断**
+   - 配置代理（见上方"如何配置代理"）
+   - 测试代理是否可用：`curl -x http://127.0.0.1:7890 https://api.telegram.org`
+
+2. **Token 错误**
+   - 重新获取 Token：在 @BotFather 中使用 `/revoke` 命令
+
+3. **用户 ID 白名单问题**
+   - 检查配置文件中的 `allowedUserIds` 是否包含你的用户 ID
+   - 或留空允许所有人访问（仅开发环境建议）

package/dist/config.d.ts

@@ -14,6 +14,11 @@ export interface Config {
     claudeModel?: string;
     logDir: string;
     logLevel: LogLevel;
+    platforms: {
+        telegram?: {
+            proxy?: string;
+        };
+    };
 }
 /** 检测是否需要交互式配置（无 token 且无环境变量） */
 export declare function needsSetup(): boolean;

package/dist/config.js

@@ -91,6 +91,12 @@ export function loadConfig() {
     }
     const logDir = process.env.LOG_DIR ?? file.logDir ?? join(APP_HOME, 'logs');
     const logLevel = (process.env.LOG_LEVEL?.toUpperCase() ?? file.logLevel ?? 'INFO');
+    // Platform-specific proxy configuration
+    const platforms = {
+        telegram: {
+            proxy: process.env.TELEGRAM_PROXY ?? file?.platforms?.telegram?.proxy,
+        },
+    };
     return {
         enabledPlatforms,
         telegramBotToken,
@@ -104,5 +110,6 @@ export function loadConfig() {
         claudeModel: process.env.CLAUDE_MODEL ?? file.claudeModel,
         logDir,
         logLevel,
+        platforms,
     };
 }

package/dist/setup.js

@@ -17,6 +17,11 @@ function printManualInstructions(configPath) {
     console.log(`{
   "telegramBotToken": "你的Bot Token",
   "allowedUserIds": ["你的Telegram用户ID"],
+  "platforms": {
+    "telegram": {
+      "proxy": "http://127.0.0.1:7890"
+    }
+  },
   "claudeWorkDir": "${process.cwd().replace(/\\/g, '/')}",
   "claudeSkipPermissions": true,
   "aiCommand": "claude"
@@ -52,6 +57,12 @@ export async function runInteractiveSetup() {
             message: '白名单用户 ID（可选，逗号分隔，留空=所有人可访问）',
             initial: '',
         },
+        {
+            type: 'text',
+            name: 'telegramProxy',
+            message: 'Telegram 代理地址（可选，如: http://127.0.0.1:7890 或 socks5://127.0.0.1:1080）',
+            initial: '',
+        },
         {
             type: 'select',
             name: 'aiCommand',
@@ -82,6 +93,11 @@ export async function runInteractiveSetup() {
                 .map((s) => s.trim())
                 .filter(Boolean)
             : [],
+        platforms: {
+            telegram: response.telegramProxy
+                ? { proxy: response.telegramProxy.trim() }
+                : undefined,
+        },
         claudeWorkDir: (response.workDir || process.cwd()).trim(),
         claudeSkipPermissions: true,
         aiCommand: response.aiCommand ?? 'claude',

package/dist/telegram/client.js

@@ -1,5 +1,6 @@
 import { Telegraf } from 'telegraf';
 import { createLogger } from '../logger.js';
+import { HttpsProxyAgent } from 'https-proxy-agent';
 const log = createLogger('Telegram');
 let bot;
 let botUsername;
@@ -12,7 +13,22 @@ export function getBotUsername() {
     return botUsername;
 }
 export async function initTelegram(config, setupHandlers) {
-    bot = new Telegraf(config.telegramBotToken);
+    const telegrafOptions = {};
+    // 配置平台特定代理
+    const proxy = config.platforms?.telegram?.proxy;
+    if (proxy) {
+        try {
+            const agent = new HttpsProxyAgent(proxy);
+            telegrafOptions.telegram = {
+                agent,
+            };
+            log.info(`Using proxy: ${proxy}`);
+        }
+        catch (err) {
+            log.warn(`Failed to create proxy agent: ${err}. Continuing without proxy.`);
+        }
+    }
+    bot = new Telegraf(config.telegramBotToken, telegrafOptions);
     setupHandlers(bot);
     const me = (await bot.telegram.getMe());
     botUsername = me.username;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wu529778790/open-im",
-  "version": "0.3.11",
+  "version": "0.4.0",
   "description": "Multi-platform IM bridge for AI CLI tools (Claude, Codex, Cursor)",
   "type": "module",
   "main": "dist/index.js",
@@ -41,6 +41,7 @@
     "url": "https://github.com/wu529778790/open-im/issues"
   },
   "dependencies": {
+    "https-proxy-agent": "^7.0.6",
     "prompts": "^2.4.2",
     "telegraf": "^4.16.3"
   },

package/.env.example

@@ -1,16 +0,0 @@
-# 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=