@keyou007/agent-bot 0.1.3 → 0.1.5

package/src/cli.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import fs from "node:fs";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import qrcode from "qrcode-terminal";
@@ -19,6 +20,7 @@ import {
   type InitializationResult,
   type InitializationStatus,
 } from "./cli/Initializer.js";
+import { parseInitCommandOptions, type InitCommandOptions } from "./cli/initOptions.js";
 import {
   registerFeishuApp,
   type FeishuAppCredentials,
@@ -30,6 +32,7 @@ import {
   type FeishuConfigurationChallenge,
 } from "./cli/FeishuAppConfiguration.js";
 import { renderCliHelp } from "./cli/help.js";
+import { formatServerStatus, withConfiguredFeishuAppId } from "./cli/serverStatus.js";
 import { resolveSystemSkillsRoot, SkillRegistry, type SkillRegistrationStatus } from "./cli/SkillRegistry.js";
 import { readPackageVersion } from "./cli/packageVersion.js";
 import { applyExplicitProfile, parseGlobalOptions } from "./cli/profile.js";
@@ -46,11 +49,12 @@ import {
   prepareCrashReportDirectory,
   resolveSupervisorDiagnosticsPaths,
 } from "./supervision/SupervisorDiagnostics.js";
+import { agentBotHome, defaultSqlitePath } from "./config/paths.js";
 
 const args = process.argv.slice(2);
 
 void main(args).catch((error: unknown) => {
-  process.stderr.write(`错误：${error instanceof Error ? error.message : String(error)}\n`);
+  process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
   process.exitCode = 1;
 });
 
@@ -68,7 +72,7 @@ async function main(input: string[]): Promise<void> {
     return;
   }
   if (command === "init") {
-    await initCommand(rest, parsed.configPath);
+    await initCommand(rest, parsed.configPath, Boolean(parsed.profilePath));
     return;
   }
   if (command === "console") {
@@ -87,7 +91,7 @@ async function main(input: string[]): Promise<void> {
     skillsCommand(rest);
     return;
   }
-  throw new Error(`未知命令：${command}。使用 agent-bot --help 查看帮助。`);
+  throw new Error(`Unknown command: ${command}. Run agent-bot --help for usage.`);
 }
 
 type FeishuInitializationStatus = "created" | "existing" | "skipped";
@@ -101,44 +105,43 @@ interface InitCommandResult extends InitializationResult {
   server: InitializationServerResult;
 }
 
-async function initCommand(input: string[], configPath?: string): Promise<void> {
-  const supported = new Set(["--json", "--skip-feishu", "--reconfigure-feishu"]);
-  const unsupported = input.filter((value) => !supported.has(value));
-  if (unsupported.length > 0) throw new Error(`init 不支持参数：${unsupported.join(" ")}`);
-  const json = input.includes("--json");
-  const skipFeishu = input.includes("--skip-feishu");
-  const reconfigureFeishu = input.includes("--reconfigure-feishu");
-  if (skipFeishu && reconfigureFeishu) {
-    throw new Error("--skip-feishu 和 --reconfigure-feishu 不能同时使用。");
-  }
-
-  const paths = initializeAgentBot({ configPath });
-  if (!json) printInitializationPaths(paths);
-  const initializationLock = acquireInitializationLock(paths.home.path);
-
+async function initCommand(
+  input: string[],
+  configPath: string | undefined,
+  explicitProfile: boolean,
+): Promise<void> {
+  const options = parseInitCommandOptions(input, explicitProfile);
+  let initializationLock = options.reset
+    ? acquireInitializationLock(agentBotHome())
+    : undefined;
+  let paths: InitializationResult;
   let initialized: Omit<InitCommandResult, "server">;
   try {
+    if (options.reset) await assertResetProfileServerStopped(configPath);
+    paths = initializeAgentBot({ configPath, reset: options.reset });
+    if (!options.json) printInitializationPaths(paths);
+    initializationLock ??= acquireInitializationLock(paths.home.path);
     cleanupFeishuCredentialTemporaryFiles(paths.env.path);
     const feishu = await initializeFeishu(
       paths,
-      { json, skipFeishu, reconfigureFeishu },
+      options,
     );
     initialized = { ...paths, feishu };
   } finally {
-    initializationLock.release();
+    initializationLock?.release();
   }
 
-  if (!json) printInitializationResult(initialized);
-  if (!json && !skipFeishu) process.stdout.write("\n正在启动 Agent Bot server...\n");
-  const server = await startInitializedServer({ skipFeishu, configPath });
+  if (!options.json) printInitializationResult(initialized);
+  if (!options.json && !options.skipFeishu) process.stdout.write("\nStarting Agent Bot server...\n");
+  const server = await startInitializedServer({ skipFeishu: options.skipFeishu, configPath });
   const result: InitCommandResult = { ...initialized, server };
-  if (json) printJson(result);
+  if (options.json) printJson(result);
   else printInitializationServerResult(server);
 }
 
 async function initializeFeishu(
   paths: InitializationResult,
-  options: { json: boolean; skipFeishu: boolean; reconfigureFeishu: boolean },
+  options: InitCommandOptions,
 ): Promise<InitCommandResult["feishu"]> {
   const existing = readFeishuCredentials(paths.env.path);
   if (options.skipFeishu) {
@@ -149,7 +152,7 @@ async function initializeFeishu(
   }
 
   const controller = new AbortController();
-  const onInterrupt = (): void => controller.abort(new Error("已取消初始化。"));
+  const onInterrupt = (): void => controller.abort(new Error("Initialization was cancelled."));
   process.once("SIGINT", onInterrupt);
   process.once("SIGTERM", onInterrupt);
   try {
@@ -164,7 +167,7 @@ async function initializeFeishu(
       status = "existing";
     } else {
       if (existing.status === "incomplete" && !options.json) {
-        process.stdout.write("\n检测到未完整保存的飞书凭据，将重新创建机器人。\n");
+        process.stdout.write("\nIncomplete Lark credentials were found. A new bot will be created.\n");
       }
       credentials = await registerFeishuApp({
         signal: controller.signal,
@@ -174,7 +177,7 @@ async function initializeFeishu(
       status = "created";
     }
 
-    if (!options.json) process.stdout.write("\n正在检查飞书应用权限、事件和回调配置...\n");
+    if (!options.json) process.stdout.write("\nChecking Lark app permissions, events, and callbacks...\n");
     const configuration = await ensureFeishuAppConfiguration(credentials, {
       signal: controller.signal,
       onVerification: (challenge) => printFeishuConfigurationVerification(challenge, options.json),
@@ -190,6 +193,25 @@ async function initializeFeishu(
   }
 }
 
+async function assertResetProfileServerStopped(configPath?: string): Promise<void> {
+  const endpoints = new Set<string>([controlEndpoint(defaultSqlitePath())]);
+  const selectedConfigPath = configPath ?? process.env.AGENT_BOT_CONFIG;
+  if (selectedConfigPath && fs.existsSync(selectedConfigPath)) {
+    try {
+      endpoints.add(controlEndpoint(loadConfig(selectedConfigPath).storage.sqlitePath));
+    } catch {
+      // Reset must remain available when the existing configuration is invalid.
+    }
+  }
+  for (const endpoint of endpoints) {
+    if (await isServerReachable(endpoint)) {
+      throw new Error(
+        "Cannot reset a running profile. Stop it with agent-bot --profile <directory> server stop, then try again.",
+      );
+    }
+  }
+}
+
 function skillsCommand(input: string[]): void {
   const [action = "status", ...rest] = input;
   const sourcePath = fileURLToPath(new URL("../skills/agent-bot/", import.meta.url));
@@ -201,16 +223,16 @@ function skillsCommand(input: string[]): void {
     const result = registry.install();
     if (json) printJson(result);
     else process.stdout.write(result.updated
-      ? `已注册 Agent Bot Skill：${result.status.targetPath}\n`
-      : `Agent Bot Skill 已是最新版本：${result.status.targetPath}\n`);
+      ? `Installed the Agent Bot Skill: ${result.status.targetPath}\n`
+      : `The Agent Bot Skill is already up to date: ${result.status.targetPath}\n`);
     return;
   }
   if (action === "uninstall" || action === "unregister") {
     const removed = registry.uninstall();
     if (json) printJson({ removed, targetPath: registry.targetPath });
     else process.stdout.write(removed
-      ? `已反注册 Agent Bot Skill：${registry.targetPath}\n`
-      : `Agent Bot Skill 尚未注册：${registry.targetPath}\n`);
+      ? `Uninstalled the Agent Bot Skill: ${registry.targetPath}\n`
+      : `The Agent Bot Skill is not installed: ${registry.targetPath}\n`);
     return;
   }
   if (action === "status") {
@@ -223,13 +245,13 @@ function skillsCommand(input: string[]): void {
     const paths = { sourcePath: registry.sourcePath, skillsRoot: registry.skillsRoot, targetPath: registry.targetPath };
     if (json) printJson(paths);
     else {
-      process.stdout.write(`内置 Skill：${paths.sourcePath}\n`);
-      process.stdout.write(`系统 Skills：${paths.skillsRoot}\n`);
-      process.stdout.write(`注册位置：${paths.targetPath}\n`);
+      process.stdout.write(`Built-in Skill: ${paths.sourcePath}\n`);
+      process.stdout.write(`System Skills directory: ${paths.skillsRoot}\n`);
+      process.stdout.write(`Installation path: ${paths.targetPath}\n`);
     }
     return;
   }
-  throw new Error(`未知 skills 命令：${action}`);
+  throw new Error(`Unknown skills command: ${action}`);
 }
 
 async function consoleCommand(input: string[]): Promise<void> {
@@ -237,7 +259,9 @@ async function consoleCommand(input: string[]): Promise<void> {
   const endpoint = controlEndpoint(config.storage.sqlitePath);
   const force = input.includes("--force");
   if (!force && await isServerReachable(endpoint)) {
-    throw new Error("agent-bot server 正在运行。为避免争用同一任务状态，请先停止 server，或明确使用 --force。");
+    throw new Error(
+      "The Agent Bot server is running. Stop it first to avoid concurrent task-state access, or explicitly use --force.",
+    );
   }
   const entry = fileURLToPath(new URL("./index.js", import.meta.url));
   const reportDirectory = resolveSupervisorDiagnosticsPaths(config).crashReportDirectory;
@@ -262,11 +286,16 @@ async function serverCommand(input: string[]): Promise<void> {
     try {
       const response = await sendControlRequest(endpoint, { action: "health" }, 1_500);
       ensureOk(response);
-      if (rest.includes("--json")) printJson(response.data);
-      else printServerStatus(response.data);
+      const status = withConfiguredFeishuAppId(response.data, config.feishu.appId);
+      if (rest.includes("--json")) printJson(status);
+      else process.stdout.write(formatServerStatus(status));
     } catch {
-      if (rest.includes("--json")) printJson({ running: false });
-      else process.stdout.write("agent-bot server：未运行\n");
+      const status = {
+        running: false,
+        feishuAppId: config.feishu.appId ?? null,
+      };
+      if (rest.includes("--json")) printJson(status);
+      else process.stdout.write(formatServerStatus(status));
       process.exitCode = 3;
     }
     return;
@@ -276,21 +305,23 @@ async function serverCommand(input: string[]): Promise<void> {
     return;
   }
   if (action === "stop") {
-    printResponse(await sendControlRequest(endpoint, { action: "server_stop" }));
+    ensureOk(await sendControlRequest(endpoint, { action: "server_stop" }));
+    process.stdout.write("Agent Bot server stop requested.\n");
     return;
   }
   if (action === "restart") {
     const immediate = rest.includes("--immediate") || rest.includes("--force");
     const reason = optionValue(rest, "--reason")
-      ?? (immediate ? "通过 agent-bot CLI 立即重启" : "通过 agent-bot CLI 安全重启");
-    printResponse(await sendControlRequest(endpoint, {
+      ?? (immediate ? "通过 Agent Bot CLI 立即重启" : "通过 Agent Bot CLI 安全重启");
+    ensureOk(await sendControlRequest(endpoint, {
       action: "server_restart",
       mode: immediate ? "immediate" : "safe",
       reason,
     }));
+    process.stdout.write(immediate ? "Immediate restart requested.\n" : "Safe restart requested.\n");
     return;
   }
-  throw new Error(`未知 server 命令：${action}`);
+  throw new Error(`Unknown server command: ${action}`);
 }
 
 async function taskCommand(input: string[]): Promise<void> {
@@ -301,16 +332,17 @@ async function taskCommand(input: string[]): Promise<void> {
     const allSessions = store.listAllSessions();
     if (action === "prompt" || action === "send") {
       const [reference, ...promptParts] = rest;
-      if (!reference) throw new Error(`task ${action} 需要任务序号或任务 ID。`);
+      if (!reference) throw new Error(`task ${action} requires a task number or task ID.`);
       const text = promptParts.join(" ").trim();
-      if (!text) throw new Error(`task ${action} 需要要发送的 Prompt。`);
+      if (!text) throw new Error(`task ${action} requires a Prompt.`);
       const session = resolveTask(allSessions, reference);
       const endpoint = controlEndpoint(config.storage.sqlitePath);
-      printResponse(await sendControlRequest(endpoint, {
+      ensureOk(await sendControlRequest(endpoint, {
         action: "task_prompt",
         localSessionId: session.localSessionId,
         text,
       }, 60_000));
+      process.stdout.write("Prompt submitted.\n");
       return;
     }
     const sessions = filterSessions(allSessions, rest);
@@ -320,7 +352,7 @@ async function taskCommand(input: string[]): Promise<void> {
       return;
     }
     const reference = rest.find((value) => !value.startsWith("--"));
-    if (!reference) throw new Error(`task ${action} 需要任务序号或任务 ID。`);
+    if (!reference) throw new Error(`task ${action} requires a task number or task ID.`);
     const session = resolveTask(sessions, reference);
     if (action === "chat") {
       const route = taskChatRoute(session);
@@ -355,7 +387,8 @@ async function taskCommand(input: string[]): Promise<void> {
     }
     const endpoint = controlEndpoint(config.storage.sqlitePath);
     if (action === "stop") {
-      printResponse(await sendControlRequest(endpoint, { action: "task_stop", localSessionId: session.localSessionId }));
+      ensureOk(await sendControlRequest(endpoint, { action: "task_stop", localSessionId: session.localSessionId }));
+      process.stdout.write("Task stop requested.\n");
       return;
     }
     if (action === "title") {
@@ -363,15 +396,16 @@ async function taskCommand(input: string[]): Promise<void> {
       const titleArgs = rest.slice(referenceIndex + 1);
       const optionIndex = titleArgs.findIndex((value) => value.startsWith("--"));
       const title = titleArgs.slice(0, optionIndex < 0 ? undefined : optionIndex).join(" ").trim();
-      if (!title) throw new Error("task title 需要新标题。");
-      printResponse(await sendControlRequest(endpoint, {
+      if (!title) throw new Error("task title requires a new title.");
+      ensureOk(await sendControlRequest(endpoint, {
         action: "task_title",
         localSessionId: session.localSessionId,
         title,
       }));
+      process.stdout.write("Task title updated.\n");
       return;
     }
-    throw new Error(`未知 task 命令：${action}`);
+    throw new Error(`Unknown task command: ${action}`);
   } finally {
     store.close();
   }
@@ -389,7 +423,7 @@ function resolveTask(sessions: SessionRecord[], reference: string): SessionRecor
   if (/^\d+$/.test(reference)) {
     const index = Number(reference) - 1;
     const session = sessions[index];
-    if (!session) throw new Error(`任务序号超出范围：${reference}`);
+    if (!session) throw new Error(`Task number is out of range: ${reference}`);
     return session;
   }
   const exact = sessions.find((session) =>
@@ -400,93 +434,78 @@ function resolveTask(sessions: SessionRecord[], reference: string): SessionRecor
     || session.remoteSessionId?.startsWith(reference)
     || session.acpSessionId?.startsWith(reference));
   if (matches.length === 1) return matches[0]!;
-  if (matches.length > 1) throw new Error(`任务 ID 前缀不唯一：${reference}`);
-  throw new Error(`找不到任务：${reference}`);
+  if (matches.length > 1) throw new Error(`Task ID prefix is ambiguous: ${reference}`);
+  throw new Error(`Task not found: ${reference}`);
 }
 
 function printTaskList(sessions: SessionRecord[]): void {
   if (sessions.length === 0) {
-    process.stdout.write("没有任务。\n");
+    process.stdout.write("No tasks.\n");
     return;
   }
   for (const [index, session] of sessions.entries()) {
     const id = session.remoteSessionId ?? session.acpSessionId ?? session.localSessionId;
-    process.stdout.write(`${index + 1}. [${session.status}/${session.lastTurnStatus ?? "-"}] ${session.title ?? "未命名任务"}\n`);
+    process.stdout.write(`${index + 1}. [${session.status}/${session.lastTurnStatus ?? "-"}] ${session.title ?? "Untitled task"}\n`);
     process.stdout.write(`   ${id} · ${session.contextKey} · ${session.updatedAt}\n`);
   }
 }
 
 function printTaskStatus(session: SessionRecord, snapshot: unknown, remote?: TaskStatusControlData["remote"]): void {
-  process.stdout.write(`标题：${session.title ?? "未命名任务"}\n`);
-  process.stdout.write(`任务 ID：${session.remoteSessionId ?? session.acpSessionId ?? session.localSessionId}\n`);
-  process.stdout.write(`本地 ID：${session.localSessionId}\n`);
-  process.stdout.write(`上下文：${session.contextKey}\n`);
-  process.stdout.write(`状态：${session.status} / ${session.lastTurnStatus ?? "-"}\n`);
-  process.stdout.write(`目录：${session.cwd}\n`);
-  process.stdout.write(`最后轮次：${session.lastTurnId ?? "-"}\n`);
+  process.stdout.write(`Title: ${session.title ?? "Untitled task"}\n`);
+  process.stdout.write(`Task ID: ${session.remoteSessionId ?? session.acpSessionId ?? session.localSessionId}\n`);
+  process.stdout.write(`Local ID: ${session.localSessionId}\n`);
+  process.stdout.write(`Context: ${session.contextKey}\n`);
+  process.stdout.write(`Status: ${session.status} / ${session.lastTurnStatus ?? "-"}\n`);
+  process.stdout.write(`Directory: ${session.cwd}\n`);
+  process.stdout.write(`Last turn: ${session.lastTurnId ?? "-"}\n`);
   let displayedFinalResponse: string | undefined;
   if (snapshot && typeof snapshot === "object") {
     const state = snapshot as Record<string, unknown>;
-    if (typeof state.durationMs === "number") process.stdout.write(`耗时：${Math.round(state.durationMs / 1_000)}s\n`);
+    if (typeof state.durationMs === "number") process.stdout.write(`Duration: ${Math.round(state.durationMs / 1_000)}s\n`);
     if (typeof state.totalTokens === "number") process.stdout.write(`Tokens：${state.totalTokens}\n`);
-    if (typeof state.totalToolCount === "number") process.stdout.write(`工具调用：${state.totalToolCount}\n`);
+    if (typeof state.totalToolCount === "number") process.stdout.write(`Tool calls: ${state.totalToolCount}\n`);
     if (typeof state.finalResponse === "string" && state.finalResponse.trim()) displayedFinalResponse = state.finalResponse.trim();
   }
-  if (!snapshot && remote?.lastTurnToolCount !== undefined) process.stdout.write(`工具调用：${remote.lastTurnToolCount}\n`);
+  if (!snapshot && remote?.lastTurnToolCount !== undefined) process.stdout.write(`Tool calls: ${remote.lastTurnToolCount}\n`);
   displayedFinalResponse = remote?.finalResponse?.trim() || displayedFinalResponse;
-  if (displayedFinalResponse) process.stdout.write(`最终结果：\n${displayedFinalResponse}\n`);
-}
-
-function printServerStatus(data: unknown): void {
-  const value = data && typeof data === "object" ? data as Record<string, unknown> : {};
-  const activity = value.activity && typeof value.activity === "object"
-    ? value.activity as Record<string, unknown>
-    : {};
-  process.stdout.write(
-    value.ready === false
-      ? "agent-bot server：启动中（正在连接飞书机器人）\n"
-      : "agent-bot server：运行中\n",
-  );
-  process.stdout.write(`PID：${value.pid ?? "-"}\n`);
-  process.stdout.write(`启动时间：${value.startedAt ?? "-"}\n`);
-  process.stdout.write(`Supervisor：${value.supervised ? "已启用" : "未启用"}\n`);
-  process.stdout.write(`运行任务：${activity.runningSessions ?? 0}\n`);
-  process.stdout.write(`待投递结果：${activity.pendingFinalDeliveries ?? 0}\n`);
-  process.stdout.write(`安全重启：${value.safeRestartScheduled ? `等待中（${value.safeRestartReason ?? "未注明原因"}）` : "未安排"}\n`);
+  if (displayedFinalResponse) process.stdout.write(`Final response:\n${displayedFinalResponse}\n`);
 }
 
 function printSkillStatus(status: SkillRegistrationStatus): void {
-  process.stdout.write(`Agent Bot Skill：${status.registered ? "已注册" : "未注册"}\n`);
-  process.stdout.write(`系统目录：${status.skillsRoot}\n`);
-  process.stdout.write(`注册位置：${status.targetPath}\n`);
+  process.stdout.write(`Agent Bot Skill: ${status.registered ? "installed" : "not installed"}\n`);
+  process.stdout.write(`System directory: ${status.skillsRoot}\n`);
+  process.stdout.write(`Installation path: ${status.targetPath}\n`);
   if (status.registered) {
-    process.stdout.write(`归属：${status.managed ? "由 Agent Bot 管理" : "外部目录（不会覆盖或删除）"}\n`);
-    process.stdout.write(`版本：${status.upToDate ? "最新" : "需要更新"}\n`);
+    process.stdout.write(`Ownership: ${status.managed ? "managed by Agent Bot" : "external directory (will not be modified or removed)"}\n`);
+    process.stdout.write(`Version: ${status.upToDate ? "up to date" : "update required"}\n`);
   }
 }
 
 function printInitializationPaths(result: InitializationResult): void {
-  process.stdout.write("正在准备 Agent Bot 用户环境...\n");
-  process.stdout.write(`用户目录：${result.home.path}（${initializationStatusLabel(result.home.status)}）\n`);
-  process.stdout.write(`配置文件：${result.config.path}（${initializationStatusLabel(result.config.status)}）\n`);
-  process.stdout.write(`环境文件：${result.env.path}（${initializationStatusLabel(result.env.status)}）\n`);
-  process.stdout.write(`数据目录：${result.data.path}（${initializationStatusLabel(result.data.status)}）\n`);
-  process.stdout.write(`日志目录：${result.logs.path}（${initializationStatusLabel(result.logs.status)}）\n`);
+  process.stdout.write("Preparing the Agent Bot user environment...\n");
+  if (result.reset) {
+    process.stdout.write(`Reset backup: ${result.reset.backupPath}\n`);
+  }
+  process.stdout.write(`Home directory: ${result.home.path} (${initializationStatusLabel(result.home.status)})\n`);
+  process.stdout.write(`Config file: ${result.config.path} (${initializationStatusLabel(result.config.status)})\n`);
+  process.stdout.write(`Environment file: ${result.env.path} (${initializationStatusLabel(result.env.status)})\n`);
+  process.stdout.write(`Data directory: ${result.data.path} (${initializationStatusLabel(result.data.status)})\n`);
+  process.stdout.write(`Log directory: ${result.logs.path} (${initializationStatusLabel(result.logs.status)})\n`);
 }
 
 function printInitializationResult(result: Omit<InitCommandResult, "server">): void {
-  process.stdout.write("\nAgent Bot 初始化完成。\n");
+  process.stdout.write("\nAgent Bot initialization completed.\n");
   if (result.feishu.status === "created") {
-    process.stdout.write(`飞书应用：已创建并保存凭证（${result.feishu.appId}）\n`);
+    process.stdout.write(`Lark app: created and credentials saved (${result.feishu.appId})\n`);
   } else if (result.feishu.status === "existing") {
-    process.stdout.write(`飞书应用：已配置，未修改（${result.feishu.appId}）\n`);
+    process.stdout.write(`Lark app: already configured and unchanged (${result.feishu.appId})\n`);
   } else {
-    process.stdout.write("飞书应用：已跳过，可使用 Console 模式或稍后重新运行 init。\n");
+    process.stdout.write("Lark app: skipped; use Console mode or run init again later.\n");
   }
   if (result.feishu.configuration?.status === "updated") {
     const added = result.feishu.configuration.added;
     process.stdout.write(
-      `飞书配置：已补齐 ${added.scopes.length} 项权限、${added.events.length} 项事件、${added.callbacks.length} 项回调\n`,
+      `Lark configuration: added ${added.scopes.length} scopes, ${added.events.length} events, and ${added.callbacks.length} callbacks\n`,
     );
   } else if (result.feishu.configuration?.status === "partial") {
     const configuration = result.feishu.configuration;
@@ -494,21 +513,21 @@ function printInitializationResult(result: Omit<InitCommandResult, "server">): v
       configuration.added.scopes.length + configuration.added.events.length + configuration.added.callbacks.length;
     if (addedCount > 0) {
       process.stdout.write(
-        `飞书配置：核心能力已就绪，已补齐 ${configuration.added.scopes.length} 项权限、${configuration.added.events.length} 项事件、${configuration.added.callbacks.length} 项回调\n`,
+        `Lark configuration: core capabilities are ready; added ${configuration.added.scopes.length} scopes, ${configuration.added.events.length} events, and ${configuration.added.callbacks.length} callbacks\n`,
       );
     } else {
-      process.stdout.write("飞书配置：核心能力已就绪\n");
+      process.stdout.write("Lark configuration: core capabilities are ready\n");
     }
     printOptionalFeishuConfigurationWarnings(configuration.remaining);
   } else if (result.feishu.configuration?.status === "ready") {
-    process.stdout.write("飞书配置：权限、事件和回调均已就绪\n");
+    process.stdout.write("Lark configuration: scopes, events, and callbacks are ready\n");
   }
-  process.stdout.write(`配置文件：${result.config.path}\n`);
+  process.stdout.write(`Config file: ${result.config.path}\n`);
 }
 
 function printInitializationServerResult(result: InitCommandResult["server"]): void {
   if (result.status === "skipped") {
-    process.stdout.write("Agent Bot server：已跳过（未配置飞书，可使用 Console 模式）\n");
+    process.stdout.write("Agent Bot server: skipped (Lark is not configured; Console mode is available)\n");
     return;
   }
   printServerStartResult(result);
@@ -517,37 +536,37 @@ function printInitializationServerResult(result: InitCommandResult["server"]): v
 function printServerStartResult(result: ServerStartResult): void {
   process.stdout.write(
     result.status === "already-running"
-      ? "agent-bot server 已在运行。\n"
-      : "agent-bot server 已启动。\n",
+      ? "Agent Bot server is already running.\n"
+      : "Agent Bot server started.\n",
   );
 }
 
 function printFeishuVerification(challenge: FeishuAppRegistrationChallenge, json: boolean): void {
-  process.stderr.write("\n请使用飞书扫码，或在浏览器中打开下面的链接创建机器人应用：\n\n");
+  process.stderr.write("\nScan with Lark or open the link below in a browser to create the bot app:\n\n");
   process.stderr.write(`${challenge.verificationUrl}\n\n`);
   if (!json) {
     qrcode.generate(challenge.verificationUrl, { small: true }, (output) => {
       process.stderr.write(`${output}\n`);
     });
   }
-  process.stderr.write(`链接约在 ${Math.ceil(challenge.expiresIn / 60)} 分钟后过期，正在等待确认...\n`);
+  process.stderr.write(`The link expires in about ${Math.ceil(challenge.expiresIn / 60)} minutes. Waiting for confirmation...\n`);
 }
 
 function printFeishuConfigurationVerification(
   challenge: FeishuConfigurationChallenge,
   json: boolean,
 ): void {
-  process.stderr.write("\n飞书应用还缺少以下配置：\n");
+  process.stderr.write("\nThe Lark app is missing the following configuration:\n");
   if (challenge.missing.scopes.length > 0) {
-    process.stderr.write(`权限：${challenge.missing.scopes.join(", ")}\n`);
+    process.stderr.write(`Scopes: ${challenge.missing.scopes.join(", ")}\n`);
   }
   if (challenge.missing.events.length > 0) {
-    process.stderr.write(`事件：${challenge.missing.events.join(", ")}\n`);
+    process.stderr.write(`Events: ${challenge.missing.events.join(", ")}\n`);
   }
   if (challenge.missing.callbacks.length > 0) {
-    process.stderr.write(`回调：${challenge.missing.callbacks.join(", ")}\n`);
+    process.stderr.write(`Callbacks: ${challenge.missing.callbacks.join(", ")}\n`);
   }
-  process.stderr.write("\n请使用飞书扫码，或在浏览器中打开下面的链接补齐配置：\n\n");
+  process.stderr.write("\nScan with Lark or open the link below in a browser to complete the configuration:\n\n");
   process.stderr.write(`${challenge.verificationUrl}\n\n`);
   if (!json) {
     qrcode.generate(challenge.verificationUrl, { small: true }, (output) => {
@@ -555,25 +574,25 @@ function printFeishuConfigurationVerification(
     });
   }
   if (challenge.blocking) {
-    process.stderr.write("正在等待核心权限和消息事件发布生效...\n");
+    process.stderr.write("Waiting for the core scopes and message event to become active...\n");
   } else {
-    process.stderr.write("以上配置不影响基础消息收发；初始化将继续，可稍后打开链接授权。\n");
+    process.stderr.write("These optional items do not block basic messaging. Initialization will continue; grant them later using the link.\n");
   }
 }
 
 function printOptionalFeishuConfigurationWarnings(missing: FeishuConfigurationChallenge["missing"]): void {
-  process.stdout.write("提醒：以下非核心配置尚未生效，部分功能可能不可用。\n");
+  process.stdout.write("Warning: some optional configuration is not active, so some features may be unavailable.\n");
   if (missing.scopes.length > 0) {
-    process.stdout.write(`未生效权限：${missing.scopes.join(", ")}\n`);
+    process.stdout.write(`Inactive scopes: ${missing.scopes.join(", ")}\n`);
   }
   if (missing.events.length > 0) {
-    process.stdout.write(`未生效事件：${missing.events.join(", ")}\n`);
+    process.stdout.write(`Inactive events: ${missing.events.join(", ")}\n`);
   }
   if (missing.callbacks.length > 0) {
-    process.stdout.write(`未生效回调：${missing.callbacks.join(", ")}\n`);
+    process.stdout.write(`Inactive callbacks: ${missing.callbacks.join(", ")}\n`);
   }
   for (const feature of optionalFeishuFeatureWarnings(missing)) {
-    process.stdout.write(`可能缺失功能：${feature}\n`);
+    process.stdout.write(`Affected feature: ${feature}\n`);
   }
 }
 
@@ -583,41 +602,41 @@ function optionalFeishuFeatureWarnings(missing: FeishuConfigurationChallenge["mi
   const callbacks = new Set(missing.callbacks);
   const warnings: string[] = [];
   if (scopes.has("im:chat:create")) {
-    warnings.push("无法使用 /newgroup 和 /forkgroup 创建飞书群");
+    warnings.push("creating Lark groups with /newgroup and /forkgroup");
   }
   if (scopes.has("im:chat:read") || events.has("im.chat.updated_v1")) {
-    warnings.push("修改飞书群名称时无法同步 Agent Bot 任务标题");
+    warnings.push("synchronizing Agent Bot task titles after Lark group renames");
   }
   if (scopes.has("im:message.reactions:write_only")) {
-    warnings.push("无法用表情显示消息处理状态");
+    warnings.push("showing message-processing status with reactions");
   }
   if (scopes.has("im:message:readonly")) {
-    warnings.push("可能无法读取用户消息中的图片");
+    warnings.push("reading images from user messages");
   }
   if (scopes.has("im:resource")) {
-    warnings.push("可能无法上传图片、发送本地图片或设置群头像");
+    warnings.push("uploading images, sending local images, or setting group avatars");
   }
   if (scopes.has("im:message:update")) {
-    warnings.push("可能无法更新已发送的进度卡片");
+    warnings.push("updating sent progress cards");
   }
   if (callbacks.has("card.action.trigger")) {
-    warnings.push("卡片按钮和交互操作不可用");
+    warnings.push("card buttons and interactive actions");
   }
   return warnings;
 }
 
 function initializationStatusLabel(status: InitializationStatus): string {
-  if (status === "created") return "已创建";
-  return "已存在，未修改";
-}
-
-function printResponse(response: ControlResponse): void {
-  ensureOk(response);
-  process.stdout.write(`${response.message ?? "操作成功。"}\n`);
+  if (status === "created") return "created";
+  if (status === "reset") return "reset from template";
+  return "already exists; unchanged";
 }
 
 function ensureOk(response: ControlResponse): void {
-  if (!response.ok) throw new Error(response.message ?? "Agent Bot 控制操作失败。");
+  if (response.ok) return;
+  const message = response.message?.trim();
+  throw new Error(message && !/[一-龥]/u.test(message)
+    ? message
+    : "Agent Bot control operation failed. Check the server logs for details.");
 }
 
 function optionValue(args: string[], name: string): string | undefined {

package/src/feishu/CardRenderer.ts

@@ -16,6 +16,7 @@ import { localCardImage } from "./LocalCardImage.js";
 export interface StartupStatusView {
   startedAt: Date;
   restartReason: string;
+  agentBotVersion: string;
   defaultAgentName: string;
   defaultAgentTitle: string;
   cwd: string;
@@ -340,6 +341,7 @@ export class CardRenderer {
         `**默认 Agent**：${view.defaultAgentTitle} (${inlineCode(view.defaultAgentName)})`,
       ];
     lines.push(
+      `**Agent Bot 版本**：${inlineCode(view.agentBotVersion)}`,
       `**服务状态 / 启动时间**：🟢 在线 / ${formatStartupTime(view.startedAt)}`,
       `**重启原因**：${inlineCode(view.restartReason)}`,
       "> 发送消息即可开始对话；发送 `/new` 创建新任务；发送 `/help` 查看帮助。",