imtoagent 0.3.4 → 0.3.5

package/modules/im/wecom.ts

@@ -86,7 +86,7 @@ async function fetchQRCode(): Promise<{ scode: string; authUrl: string }> {
   const raw = await httpsGet(url);
   const resp = JSON.parse(raw);
   if (!resp?.data?.scode || !resp?.data?.auth_url) {
-    throw new Error(`获取二维码失败: ${raw.slice(0, 200)}`);
+    throw new Error(`Failed to get QR code: ${raw.slice(0, 200)}`);
   }
   return { scode: resp.data.scode, authUrl: resp.data.auth_url };
 }
@@ -110,7 +110,7 @@ async function pollResult(scode: string): Promise<{ botId: string; secret: strin
     if (status === 'success') {
       const bi = resp.data.bot_info;
       if (!bi?.botid || !bi?.secret) {
-        throw new Error('扫码成功但未获取到 Bot 信息');
+        throw new Error('QR scan successful but Bot info not received');
       }
       return { botId: bi.botid, secret: bi.secret };
     }
@@ -118,7 +118,7 @@ async function pollResult(scode: string): Promise<{ botId: string; secret: strin
     await new Promise(r => setTimeout(r, POLL_INTERVAL_MS));
   }
 
-  console.log('\n⏱ 扫码超时（5 分钟），请重试');
+  console.log('\n⏱ QR scan timed out (5 min), please retry');
   process.exit(1);
 }
 
@@ -127,17 +127,17 @@ async function pollResult(scode: string): Promise<{ botId: string; secret: strin
  * 调用后会在终端显示二维码，用户扫码后自动获取 botId 和 secret 并保存到本地
  */
 export async function bindWeComQR(): Promise<{ botId: string; secret: string }> {
-  console.log('\n📱 企业微信扫码绑定');
-  console.log('正在获取二维码...');
+  console.log('\n📱 WeCom QR Code Binding');
+  console.log('Fetching QR code...');
 
   const { scode, authUrl } = await fetchQRCode();
 
-  console.log('请使用企业微信扫描以下二维码：');
+  console.log('Please scan the following QR code with WeCom:');
   await renderQR(authUrl);
-  console.log('等待扫码中...');
+  console.log('Waiting for scan...');
 
   const result = await pollResult(scode);
-  console.log('\n✅ 扫码成功！Bot ID 和 Secret 已保存');
+  console.log('\n✅ QR scan successful! Bot ID and Secret saved');
 
   const creds: StoredCreds = {
     botId: result.botId,
@@ -192,12 +192,12 @@ export class WeComIMModule implements IMModule {
   getCapabilities(): IMCapabilities {
     return {
       text: true,
-      codeBlock: false,        // 企微不支持代码块
-      cardMessage: true,       // 模板卡片消息
+      codeBlock: false,        // WeCom doesn't support code blocks
+      cardMessage: true,       // Template card messages
       fileSend: true,
       imageSend: true,
       audioSend: false,
-      buttonAction: true,      // 模板卡片按钮回调
+      buttonAction: true,      // Template card button callbacks
       maxTextLength: TEXT_MAX,
     };
   }
@@ -206,7 +206,7 @@ export class WeComIMModule implements IMModule {
 
   start(handler: MessageHandler): void {
     if (this.running) {
-      console.warn('[WeCom] 已在运行中');
+      console.warn('[WeCom] Already running');
       return;
     }
     this.handler = handler;
@@ -221,7 +221,7 @@ export class WeComIMModule implements IMModule {
       this.ws = null;
     }
     this.handler = null;
-    console.log('[WeCom] 已断开');
+    console.log('[WeCom] Disconnected');
   }
 
   // ── WebSocket 连接 ──
@@ -236,18 +236,18 @@ export class WeComIMModule implements IMModule {
       if (stored) {
         botId = stored.botId;
         secret = stored.secret;
-        console.log('[WeCom] 已加载本地凭证');
+        console.log('[WeCom] Loaded local credentials');
       }
     }
 
     if (!botId || !secret) {
-      console.log('[WeCom] 未找到凭证，启动扫码绑定...');
+      console.log('[WeCom] No credentials found, starting QR binding...');
       const bound = await bindWeComQR();
       botId = bound.botId;
       secret = bound.secret;
     }
 
-    console.log(`[WeCom] 正在连接 WebSocket (bot: ${botId.slice(0, 6)}...)`);
+    console.log(`[WeCom] Connecting WebSocket (bot: ${botId.slice(0, 6)}...)`);
 
     // 2. 创建 WSClient
     this.ws = new WSClient({
@@ -266,23 +266,23 @@ export class WeComIMModule implements IMModule {
 
     // 3. 事件监听
     this.ws.on('connected', () => {
-      console.log('[WeCom] WebSocket 已连接');
+      console.log('[WeCom] WebSocket connected');
     });
 
     this.ws.on('authenticated', () => {
-      console.log('[WeCom] 认证成功');
+      console.log('[WeCom] Authenticated');
     });
 
     this.ws.on('disconnected', (reason: string) => {
-      console.log(`[WeCom] 断开连接: ${reason}`);
+      console.log(`[WeCom] Disconnected: ${reason}`);
       if (this.running) {
-        console.log('[WeCom] 5 秒后重连...');
+        console.log('[WeCom] Reconnecting in 5s...');
         setTimeout(() => { if (this.running) this._connect(); }, 5000);
       }
     });
 
     this.ws.on('error', (err: any) => {
-      console.error(`[WeCom] 错误: ${err?.message || err}`);
+      console.error(`[WeCom] Error: ${err?.message || err}`);
     });
 
     // 4. 接收消息
@@ -290,12 +290,12 @@ export class WeComIMModule implements IMModule {
       try {
         await this._handleMessage(frame);
       } catch (e: any) {
-        console.error(`[WeCom] 消息处理异常: ${e.message}`);
+        console.error(`[WeCom] Message processing error: ${e.message}`);
       }
     });
   }
 
-  // ── 消息解析 ──
+  // ── Message Parsing ──
 
   private async _handleMessage(frame: any): Promise<void> {
     const body = frame.body || {};
@@ -309,10 +309,10 @@ export class WeComIMModule implements IMModule {
         const items = evt.selected_items?.selected_item ?? [];
         const lines = items.map((it: any) => {
           const ids = it.option_ids?.option_id?.filter(Boolean) ?? [];
-          return `- ${it.question_key || '?'}: ${ids.join(', ') || '(未选择)'}`;
+          return `- ${it.question_key || '?'}: ${ids.join(', ') || '(not selected)'}`;
         });
         const text = [
-          '[模板卡片回调]',
+          '[Template card callback]',
           `card_type: ${evt.card_type || '?'}`,
           `event_key: ${evt.event_key || '?'}`,
           ...lines,
@@ -339,28 +339,28 @@ export class WeComIMModule implements IMModule {
         text = body.content?.text || body.text?.content || body.content || '';
         break;
       case 'image':
-        text = '[图片]';
+        text = '[Image]';
         if (body.image?.mediaid) {
           const localPath = await this._downloadMedia(body.image.mediaid, body.image.aeskey, 'image.png');
           attachments.push({ type: 'image', localPath: localPath || '', sourceKey: body.image.mediaid, mimeType: 'image/png' });
         }
         break;
       case 'voice':
-        text = body.voice?.recognition || body.recognition || '[语音]';
+        text = body.voice?.recognition || body.recognition || '[Voice]';
         if (body.voice?.mediaid) {
           const localPath = await this._downloadMedia(body.voice.mediaid, body.voice.aeskey, 'voice.amr');
           attachments.push({ type: 'file', localPath: localPath || '', filename: 'voice.amr', sourceKey: body.voice.mediaid });
         }
         break;
       case 'video':
-        text = '[视频]';
+        text = '[Video]';
         if (body.video?.mediaid) {
           const localPath = await this._downloadMedia(body.video.mediaid, body.video.aeskey, 'video.mp4');
           attachments.push({ type: 'file', localPath: localPath || '', filename: 'video.mp4', sourceKey: body.video.mediaid });
         }
         break;
       case 'file':
-        text = `[文件: ${body.file?.title || body.title || '未知'}]`;
+        text = `[File: ${body.file?.title || body.title || 'unknown'}]`;
         if (body.file?.mediaid) {
           const localPath = await this._downloadMedia(body.file.mediaid, body.file.aeskey, body.file.title || 'file');
           attachments.push({ type: 'file', localPath: localPath || '', filename: body.file.title || 'file', sourceKey: body.file.mediaid });
@@ -370,11 +370,11 @@ export class WeComIMModule implements IMModule {
         text = body.markdown?.content || '';
         break;
       default:
-        text = `[${msgType}消息]`;
+        text = `[${msgType} message]`;
     }
 
     const preview = text.length > 80 ? text.slice(0, 80) + '...' : text;
-    console.log(`[WeCom] ${chatType === 'group' ? '群' : '私聊'} ${fromUser}@${chatId}: ${preview}`);
+    console.log(`[WeCom] ${chatType === 'group' ? 'Group' : 'DM'} ${fromUser}@${chatId}: ${preview}`);
 
     // 保存 frame 用于被动回复
     this.pendingFrames.set(chatId, frame);
@@ -388,10 +388,10 @@ export class WeComIMModule implements IMModule {
 
   async reply(chatId: string, text: string): Promise<void> {
     if (!this.ws?.isConnected) {
-      console.error('[WeCom] WS 未连接');
+      console.error('[WeCom] WS not connected');
       return;
     }
-    const safe = text.length > TEXT_MAX ? text.slice(0, TEXT_MAX) + '\n…截断' : text;
+    const safe = text.length > TEXT_MAX ? text.slice(0, TEXT_MAX) + '\n…truncated' : text;
     const body = {
       msgtype: 'markdown',
       markdown: { content: safe },
@@ -404,7 +404,7 @@ export class WeComIMModule implements IMModule {
         await this.ws.reply(frame, body);
         return;
       } catch (e: any) {
-        console.warn(`[WeCom] 被动回复失败，fallback 到主动推送: ${e.message}`);
+        console.warn(`[WeCom] Passive reply failed, falling back to push: ${e.message}`);
       }
     }
 
@@ -412,7 +412,7 @@ export class WeComIMModule implements IMModule {
     try {
       await this.ws.sendMessage(chatId, body);
     } catch (e: any) {
-      console.error(`[WeCom] 发送失败: ${e.message}`);
+      console.error(`[WeCom] Send failed: ${e.message}`);
     }
   }
 
@@ -436,12 +436,12 @@ export class WeComIMModule implements IMModule {
     try {
       await this.ws.replyStream(frame, streamId, content, finish);
     } catch (e: any) {
-      console.error(`[WeCom] 流式发送失败: ${e.message}`);
+      console.error(`[WeCom] Stream send failed: ${e.message}`);
     }
   }
 
   /**
-   * 非阻塞流式回复
+   * Non-blocking streaming reply
    * 当上一条消息还未收到 ACK 时跳过中间帧，避免慢连接下排队积压
    * finish=true 的最终帧不受限制，始终发送
    */
@@ -458,7 +458,7 @@ export class WeComIMModule implements IMModule {
         // 静默跳过中间帧（非阻塞保护生效）
       }
     } catch (e: any) {
-      console.error(`[WeCom] 非阻塞流式发送失败: ${e.message}`);
+      console.error(`[WeCom] Non-blocking stream send failed: ${e.message}`);
     }
   }
 
@@ -482,7 +482,7 @@ export class WeComIMModule implements IMModule {
             try {
               const mediaId = await this._uploadMediaFromSource(b.url, 'image', b.title || 'image.png');
               if (mediaId) await this.ws!.sendMediaMessage(chatId, 'image', mediaId);
-            } catch (e: any) { console.error(`[WeCom] 图片上传失败: ${e.message}`); }
+            } catch (e: any) { console.error(`[WeCom] Image upload failed: ${e.message}`); }
           }
           break;
         case 'file':
@@ -490,7 +490,7 @@ export class WeComIMModule implements IMModule {
             try {
               const mediaId = await this._uploadMediaFromSource(b.url, 'file', b.title || 'file');
               if (mediaId) await this.ws!.sendMediaMessage(chatId, 'file', mediaId);
-            } catch (e: any) { console.error(`[WeCom] 文件上传失败: ${e.message}`); }
+            } catch (e: any) { console.error(`[WeCom] File upload failed: ${e.message}`); }
           }
           break;
       }
@@ -499,19 +499,19 @@ export class WeComIMModule implements IMModule {
   }
 
   async sendImage(chatId: string, imageKey: string, _alt?: string): Promise<void> {
-    if (!this.ws?.isConnected) { console.error('[WeCom] WS 未连接'); return; }
+    if (!this.ws?.isConnected) { console.error('[WeCom] WS not connected'); return; }
     try {
       const mediaId = await this._uploadMediaFromSource(imageKey, 'image', this._basename(imageKey));
       if (mediaId) await this.ws.sendMediaMessage(chatId, 'image', mediaId);
-    } catch (e: any) { console.error(`[WeCom] 图片发送失败: ${e.message}`); }
+    } catch (e: any) { console.error(`[WeCom] Image send failed: ${e.message}`); }
   }
 
   async sendFile(chatId: string, fileKey: string, fileName: string): Promise<void> {
-    if (!this.ws?.isConnected) { console.error('[WeCom] WS 未连接'); return; }
+    if (!this.ws?.isConnected) { console.error('[WeCom] WS not connected'); return; }
     try {
       const mediaId = await this._uploadMediaFromSource(fileKey, 'file', fileName);
       if (mediaId) await this.ws.sendMediaMessage(chatId, 'file', mediaId);
-    } catch (e: any) { console.error(`[WeCom] 文件发送失败: ${e.message}`); }
+    } catch (e: any) { console.error(`[WeCom] File send failed: ${e.message}`); }
   }
 
   // ── 媒体上传 ──
@@ -529,17 +529,17 @@ export class WeComIMModule implements IMModule {
       const b64 = source.substring(commaIdx + 1);
       buffer = Buffer.from(b64, 'base64');
     } else {
-      // 本地文件路径
+      // local file path
       if (!fs.existsSync(source)) {
-        throw new Error(`文件不存在: ${source}`);
+        throw new Error(`File not found: ${source}`);
       }
       buffer = fs.readFileSync(source);
     }
 
-    if (buffer.length === 0) throw new Error('文件为空');
+    if (buffer.length === 0) throw new Error('File is empty');
 
     const result = await this.ws!.uploadMedia(buffer, { type: mediaType, filename: fileName });
-    console.log(`[WeCom] 媒体上传成功: ${fileName} → ${result.media_id}`);
+    console.log(`[WeCom] Media uploaded: ${fileName} → ${result.media_id}`);
     return result.media_id;
   }
 
@@ -593,10 +593,10 @@ export class WeComIMModule implements IMModule {
       fs.mkdirSync(tempDir, { recursive: true });
       const filePath = path.join(tempDir, `${Date.now()}_${finalName}`);
       fs.writeFileSync(filePath, buffer);
-      console.log(`[WeCom] 媒体下载成功: ${mediaId} → ${filePath}`);
+      console.log(`[WeCom] Media downloaded: ${mediaId} → ${filePath}`);
       return filePath;
     } catch (e: any) {
-      console.error(`[WeCom] 媒体下载失败 (${mediaId}): ${e.message}`);
+      console.error(`[WeCom] Media download failed (${mediaId}): ${e.message}`);
       return null;
     }
   }

package/modules/media/feishu-inbound-adapter.ts

@@ -44,7 +44,7 @@ export class FeishuInboundAdapter implements InboundMediaAdapter {
       if (!resp.ok) {
         // 容错：文件类型 502 时尝试用 media 类型重试
         if (resp.status === 502 && type === 'file') {
-          console.log(`[FeishuInbound] file 类型返回 502，尝试 media 类型重试`);
+          console.log(`[FeishuInbound] file type returned 502, retrying with media type`);
           const retryUrl = `https://open.feishu.cn/open-apis/im/v1/messages/${messageId}/resources/${resourceKey}?type=media`;
           const retryResp = await fetch(retryUrl, {
             headers: { Authorization: `Bearer ${token}` },
@@ -60,7 +60,7 @@ export class FeishuInboundAdapter implements InboundMediaAdapter {
             };
           }
         }
-        console.error(`[FeishuInbound] 下载消息资源失败: HTTP ${resp.status} (key=${resourceKey})`);
+        console.error(`[FeishuInbound] download message resource failed: HTTP ${resp.status} (key=${resourceKey})`);
         return null;
       }
 
@@ -74,7 +74,7 @@ export class FeishuInboundAdapter implements InboundMediaAdapter {
         sourceKey: resourceKey,
       };
     } catch (e: any) {
-      console.error(`[FeishuInbound] 下载消息资源异常: ${e.message}`);
+      console.error(`[FeishuInbound] download message resource exception: ${e.message}`);
       return null;
     }
   }
@@ -97,7 +97,7 @@ export class FeishuInboundAdapter implements InboundMediaAdapter {
 
     const data = await resp.json();
     if (data.code !== 0 || !data.tenant_access_token) {
-      throw new Error(`获取飞书 tenant_access_token 失败: ${JSON.stringify(data)}`);
+      throw new Error(`Failed to get Feishu tenant_access_token: ${JSON.stringify(data)}`);
     }
 
     this._appToken = data.tenant_access_token;

package/modules/media/resolver.ts

@@ -50,31 +50,31 @@ function buildHintForCategory(entry: MediaEntry): string {
 
   switch (category) {
     case 'image':
-      return `图片已保存到本地，路径: \`${localPath}\`，格式: ${mimeType}，可使用图片查看工具打开`;
+      return `Image saved locally, path: \`${localPath}\`, format: ${mimeType}, can be opened with an image viewer`;
 
     case 'audio':
-      return `音频文件路径: \`${localPath}\`，格式: ${mimeType}，可用语音识别工具处理`;
+      return `Audio file path: \`${localPath}\`, format: ${mimeType}, can be processed with speech recognition tools`;
 
     case 'video':
-      return `视频文件路径: \`${localPath}\`，格式: ${mimeType}`;
+      return `Video file path: \`${localPath}\`, format: ${mimeType}`;
 
     case 'document':
-      return `文档文件路径: \`${localPath}\`，类型: ${mimeType}，可直接读取（如果是文本/PDF）或用相应工具处理`;
+      return `Document file path: \`${localPath}\`, type: ${mimeType}, can be read directly (if text/PDF) or processed with appropriate tools`;
 
     case 'text':
-      return `文本文件路径: \`${localPath}\`，可直接用文件读取工具读取内容`;
+      return `Text file path: \`${localPath}\`, can be read directly with a file reading tool`;
 
     case 'spreadsheet':
-      return `表格文件路径: \`${localPath}\`，类型: ${mimeType}，可用表格解析工具（如 Python pandas/openpyxl）处理`;
+      return `Spreadsheet file path: \`${localPath}\`, type: ${mimeType}, can be processed with spreadsheet tools (e.g. Python pandas/openpyxl)`;
 
     case 'presentation':
-      return `演示文稿路径: \`${localPath}\`，类型: ${mimeType}`;
+      return `Presentation file path: \`${localPath}\`, type: ${mimeType}`;
 
     case 'archive':
-      return `压缩文件路径: \`${localPath}\`，类型: ${mimeType}，需要先解压再处理`;
+      return `Archive file path: \`${localPath}\`, type: ${mimeType}, needs to be extracted before processing`;
 
     default:
-      return `文件路径: \`${localPath}\`，格式: ${mimeType}，可用文件工具分析或直接读取`;
+      return `File path: \`${localPath}\`, format: ${mimeType}, can be analyzed with file tools or read directly`;
   }
 }
 
@@ -109,7 +109,7 @@ export class InboundMediaResolver {
       );
 
       if (!downloaded) {
-        console.log(`[${this.adapter.platform}] 下载资源失败: ${request.resourceKey}`);
+        console.log(`[${this.adapter.platform}] Failed to download resource: ${request.resourceKey}`);
         return null;
       }
 
@@ -126,7 +126,7 @@ export class InboundMediaResolver {
 
       return { attachment, entry };
     } catch (e: any) {
-      console.error(`[${this.adapter.platform}] 解析媒体异常: ${e.message}`);
+      console.error(`[${this.adapter.platform}] Media resolution error: ${e.message}`);
       return null;
     }
   }

package/modules/media/telegram-inbound-adapter.ts

@@ -40,12 +40,12 @@ export class TelegramInboundAdapter implements InboundMediaAdapter {
         const ProxyAgent = (globalThis as any).ProxyAgent;
         if (ProxyAgent) {
           this.dispatcher = new ProxyAgent(this.proxy);
-          console.log(`[TelegramInbound] 已配置代理 dispatcher: ${this.proxy}`);
+          console.log(`[TelegramInbound] Proxy dispatcher configured: ${this.proxy}`);
         } else {
-          console.log(`[TelegramInbound] ⚠️ 代理已配置但 ProxyAgent 不可用，将尝试直接连接`);
+          console.log(`[TelegramInbound] ⚠️ Proxy configured but ProxyAgent unavailable, will try direct connection`);
         }
       } catch (e: any) {
-        console.log(`[TelegramInbound] ⚠️ 代理 dispatcher 初始化失败: ${e.message}`);
+        console.log(`[TelegramInbound] ⚠️ Proxy dispatcher init failed: ${e.message}`);
       }
     }
   }
@@ -65,13 +65,13 @@ export class TelegramInboundAdapter implements InboundMediaAdapter {
       });
 
       if (!fileResp.ok) {
-        console.error(`[TelegramInbound] getFile 失败: HTTP ${fileResp.status} (file_id=${resourceKey.slice(-10)})`);
+        console.error(`[TelegramInbound] getFile failed: HTTP ${fileResp.status} (file_id=${resourceKey.slice(-10)})`);
         return null;
       }
 
       const fileData = await fileResp.json();
       if (!fileData.ok || !fileData.result?.file_path) {
-        console.error(`[TelegramInbound] getFile 返回无效: ${JSON.stringify(fileData).slice(0, 200)}`);
+        console.error(`[TelegramInbound] getFile returned invalid: ${JSON.stringify(fileData).slice(0, 200)}`);
         return null;
       }
 
@@ -79,7 +79,7 @@ export class TelegramInboundAdapter implements InboundMediaAdapter {
       const fileSize = fileData.result.file_size;
 
       if (fileSize && fileSize > 20 * 1024 * 1024) {
-        console.log(`[TelegramInbound] 文件过大 (${fileSize} bytes)，跳过下载`);
+        console.log(`[TelegramInbound] File too large (${fileSize} bytes), skipping download`);
         return null;
       }
 
@@ -88,7 +88,7 @@ export class TelegramInboundAdapter implements InboundMediaAdapter {
       const contentResp = await this._fetch(downloadUrl);
 
       if (!contentResp.ok) {
-        console.error(`[TelegramInbound] 下载文件失败: HTTP ${contentResp.status} (path=${filePath})`);
+        console.error(`[TelegramInbound] Download failed: HTTP ${contentResp.status} (path=${filePath})`);
         return null;
       }
 
@@ -105,7 +105,7 @@ export class TelegramInboundAdapter implements InboundMediaAdapter {
         sourceKey: resourceKey,
       };
     } catch (e: any) {
-      console.error(`[TelegramInbound] 下载资源异常: ${e.message}`);
+      console.error(`[TelegramInbound] download resource exception: ${e.message}`);
       return null;
     }
   }

package/modules/prompt-builder.ts

@@ -88,32 +88,32 @@ export function buildSystemPrompt(ctx: PromptBuilderContext): string {
   // 2. IM 能力
   const caps = ctx.imModule?.getCapabilities() ?? ctx.caps ?? DEFAULT_TERMINAL_CAPS;
   const capSection = buildCapabilityPrompt(caps);
-  sections.push('# 当前对接 IM 能力\n\n' + capSection);
+  sections.push('# Current IM Capabilities\n\n' + capSection);
 
-  // 3. 网关运行日志（Agent 可主动查询）
-  sections.push(`# 网关运行日志
+  // 3. Gateway logs (Agent can proactively query)
+  sections.push(`# Gateway Runtime Logs
 
-网关运行日志: ~/.imtoagent/logs/imtoagent.log
+Gateway runtime logs: ~/.imtoagent/logs/imtoagent.log
 
-你可以通过查看日志来了解网关状态、排查问题、感知重启事件：
-- \`tail -n 30 ~/.imtoagent/logs/imtoagent.log\` — 最近 30 行
-- \`grep -i "restart\|reload\|shutdown\|SIGTERM" ~/.imtoagent/logs/imtoagent.log | tail -n 10\` — 重启/关闭记录
-- \`grep -i "error\|fail\|crash" ~/.imtoagent/logs/imtoagent.log | tail -n 10\` — 错误记录
-- \`grep -i "online\|connected\|disconnected" ~/.imtoagent/logs/imtoagent.log | tail -n 10\` — Bot 连接状态
+You can check logs to understand gateway status, troubleshoot issues, and detect restart events:
+- \`tail -n 30 ~/.imtoagent/logs/imtoagent.log\` — Last 30 lines
+- \`grep -i "restart\|reload\|shutdown\|SIGTERM" ~/.imtoagent/logs/imtoagent.log | tail -n 10\` — Restart/shutdown records
+- \`grep -i "error\|fail\|crash" ~/.imtoagent/logs/imtoagent.log | tail -n 10\` — Error records
+- \`grep -i "online\|connected\|disconnected" ~/.imtoagent/logs/imtoagent.log | tail -n 10\` — Bot connection status
 
-注意：你启动后第一条消息的对话记忆可能已丢失（如果网关重启过），请先检查日志了解上下文。`);
+Note: Your first message after startup may have lost conversation memory (if the gateway restarted). Check logs first to understand the context.`);
 
   // 4. Soul
   const soul = loadSoul(ctx.botName);
   if (soul) {
-    sections.push('# 用户自定义指令 (IMtoAgent Soul)\n\n' + soul);
+    sections.push('# User-Defined Instructions (IMtoAgent Soul)\n\n' + soul);
   }
 
   return sections.join('\n\n---\n\n');
 }
 
 // ================================================================
-// 便捷函数：直接获取能力（消除各处 inline fallback）
+// Convenience: resolve capabilities directly (eliminate inline fallbacks)
 // ================================================================
 export function resolveCapabilities(
   imModule?: { getCapabilities(): IMCapabilities } | null,