@keyou007/agent-bot 0.1.9 → 0.1.10

package/src/cli.ts

@@ -21,6 +21,7 @@ import {
 } from "./cli/Initializer.js";
 import { parseInitCommandOptions, type InitCommandOptions } from "./cli/initOptions.js";
 import {
+  listenForManualPermissionSkip,
   listenForOptionalAuthorizationSkip,
   type OptionalAuthorizationSkipListener,
 } from "./cli/OptionalAuthorizationSkip.js";
@@ -35,6 +36,7 @@ import {
   type FeishuConfigurationChallenge,
 } from "./cli/FeishuAppConfiguration.js";
 import { renderCliHelp } from "./cli/help.js";
+import { cliLanguage, cliText, localizeCliErrorMessage } from "./cli/i18n.js";
 import { formatServerStatus, withConfiguredFeishuAppId } from "./cli/serverStatus.js";
 import { resolveSystemSkillsRoot, SkillRegistry, type SkillRegistrationStatus } from "./cli/SkillRegistry.js";
 import { readPackageVersion } from "./cli/packageVersion.js";
@@ -58,7 +60,8 @@ import { agentBotHome, defaultSqlitePath } from "./config/paths.js";
 const args = process.argv.slice(2);
 
 void main(args).catch((error: unknown) => {
-  process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`${cliText("Error: ", "错误：")}${localizeCliErrorMessage(message)}\n`);
   process.exitCode = 1;
 });
 
@@ -95,7 +98,10 @@ async function main(input: string[]): Promise<void> {
     skillsCommand(rest);
     return;
   }
-  throw new Error(`Unknown command: ${command}. Run agent-bot --help for usage.`);
+  throw new Error(cliText(
+    `Unknown command: ${command}. Run agent-bot --help for usage.`,
+    `未知命令：${command}。运行 agent-bot --help 查看用法。`,
+  ));
 }
 
 type FeishuInitializationStatus = "created" | "existing" | "skipped";
@@ -136,7 +142,9 @@ async function initCommand(
   }
 
   if (!options.json) printInitializationResult(initialized);
-  if (!options.json && !options.skipFeishu) process.stdout.write("\nStarting Agent Bot server...\n");
+  if (!options.json && !options.skipFeishu) {
+    process.stdout.write(cliText("\nStarting Agent Bot server...\n", "\n正在启动 Agent Bot 服务...\n"));
+  }
   const server = await startInitializedServer({ skipFeishu: options.skipFeishu, configPath });
   const result: InitCommandResult = { ...initialized, server };
   if (options.json) printJson(result);
@@ -156,7 +164,10 @@ async function initializeFeishu(
   }
 
   const controller = new AbortController();
-  const onInterrupt = (): void => controller.abort(new Error("Initialization was cancelled."));
+  const onInterrupt = (): void => controller.abort(new Error(cliText(
+    "Initialization was cancelled.",
+    "初始化已取消。",
+  )));
   process.once("SIGINT", onInterrupt);
   process.once("SIGTERM", onInterrupt);
   try {
@@ -171,7 +182,10 @@ async function initializeFeishu(
       status = "existing";
     } else {
       if (existing.status === "incomplete" && !options.json) {
-        process.stdout.write("\nIncomplete Lark credentials were found. A new bot will be created.\n");
+        process.stdout.write(cliText(
+          "\nIncomplete Lark credentials were found. A new bot will be created.\n",
+          "\n发现不完整的飞书凭据，将创建一个新机器人。\n",
+        ));
       }
       credentials = await registerFeishuApp({
         signal: controller.signal,
@@ -181,15 +195,26 @@ async function initializeFeishu(
       status = "created";
     }
 
-    if (!options.json) process.stdout.write("\nChecking Lark app permissions, events, and callbacks...\n");
+    if (!options.json) {
+      process.stdout.write(cliText(
+        "\nChecking Lark app permissions, events, and callbacks...\n",
+        "\n正在检查飞书应用权限、事件和回调...\n",
+      ));
+    }
+    const manualPermissionSkip = new AbortController();
     const optionalSkip = new AbortController();
     let skipListener: OptionalAuthorizationSkipListener | undefined;
     const configuration = await ensureFeishuAppConfiguration(credentials, {
       signal: controller.signal,
+      manualPermissionSkipSignal: manualPermissionSkip.signal,
       optionalSkipSignal: optionalSkip.signal,
       onVerification: (challenge) => {
         printFeishuConfigurationVerification(challenge, options.json);
-        if (!challenge.blocking) {
+        if (challenge.kind === "manual_scope" && challenge.blocking) {
+          skipListener?.close();
+          skipListener = listenForManualPermissionSkip(() => manualPermissionSkip.abort());
+        } else if (!challenge.blocking) {
+          skipListener?.close();
           skipListener = listenForOptionalAuthorizationSkip(() => optionalSkip.abort());
         }
       },
@@ -220,7 +245,10 @@ async function assertResetProfileServerStopped(configPath?: string): Promise<voi
   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.",
+        cliText(
+          "Cannot reset a running profile. Stop it with agent-bot --profile <directory> server stop, then try again.",
+          "无法重置正在运行的 Profile。请先执行 agent-bot --profile <目录> server stop，然后重试。",
+        ),
       );
     }
   }
@@ -237,16 +265,28 @@ function skillsCommand(input: string[]): void {
     const result = registry.install();
     if (json) printJson(result);
     else process.stdout.write(result.updated
-      ? `Installed the Agent Bot Skill: ${result.status.targetPath}\n`
-      : `The Agent Bot Skill is already up to date: ${result.status.targetPath}\n`);
+      ? cliText(
+          `Installed the Agent Bot Skill: ${result.status.targetPath}\n`,
+          `已安装 Agent Bot Skill：${result.status.targetPath}\n`,
+        )
+      : cliText(
+          `The Agent Bot Skill is already up to date: ${result.status.targetPath}\n`,
+          `Agent Bot Skill 已是最新版本：${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
-      ? `Uninstalled the Agent Bot Skill: ${registry.targetPath}\n`
-      : `The Agent Bot Skill is not installed: ${registry.targetPath}\n`);
+      ? cliText(
+          `Uninstalled the Agent Bot Skill: ${registry.targetPath}\n`,
+          `已卸载 Agent Bot Skill：${registry.targetPath}\n`,
+        )
+      : cliText(
+          `The Agent Bot Skill is not installed: ${registry.targetPath}\n`,
+          `Agent Bot Skill 尚未安装：${registry.targetPath}\n`,
+        ));
     return;
   }
   if (action === "status") {
@@ -259,13 +299,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(`Built-in Skill: ${paths.sourcePath}\n`);
-      process.stdout.write(`System Skills directory: ${paths.skillsRoot}\n`);
-      process.stdout.write(`Installation path: ${paths.targetPath}\n`);
+      process.stdout.write(`${cliText("Built-in Skill: ", "内置 Skill：")}${paths.sourcePath}\n`);
+      process.stdout.write(`${cliText("System Skills directory: ", "系统 Skills 目录：")}${paths.skillsRoot}\n`);
+      process.stdout.write(`${cliText("Installation path: ", "安装路径：")}${paths.targetPath}\n`);
     }
     return;
   }
-  throw new Error(`Unknown skills command: ${action}`);
+  throw new Error(cliText(`Unknown skills command: ${action}`, `未知的 skills 命令：${action}`));
 }
 
 async function consoleCommand(input: string[]): Promise<void> {
@@ -274,7 +314,10 @@ async function consoleCommand(input: string[]): Promise<void> {
   const force = input.includes("--force");
   if (!force && await isServerReachable(endpoint)) {
     throw new Error(
-      "The Agent Bot server is running. Stop it first to avoid concurrent task-state access, or explicitly use --force.",
+      cliText(
+        "The Agent Bot server is running. Stop it first to avoid concurrent task-state access, or explicitly use --force.",
+        "Agent Bot 服务正在运行。请先停止服务以避免并发访问任务状态，或显式使用 --force。",
+      ),
     );
   }
   const entry = fileURLToPath(new URL("./index.js", import.meta.url));
@@ -320,7 +363,7 @@ async function serverCommand(input: string[]): Promise<void> {
   }
   if (action === "stop") {
     ensureOk(await sendControlRequest(endpoint, { action: "server_stop" }));
-    process.stdout.write("Agent Bot server stop requested.\n");
+    process.stdout.write(cliText("Agent Bot server stop requested.\n", "已请求停止 Agent Bot 服务。\n"));
     return;
   }
   if (action === "restart") {
@@ -332,10 +375,12 @@ async function serverCommand(input: string[]): Promise<void> {
       mode: immediate ? "immediate" : "safe",
       reason,
     }));
-    process.stdout.write(immediate ? "Immediate restart requested.\n" : "Safe restart requested.\n");
+    process.stdout.write(immediate
+      ? cliText("Immediate restart requested.\n", "已请求立即重启。\n")
+      : cliText("Safe restart requested.\n", "已请求安全重启。\n"));
     return;
   }
-  throw new Error(`Unknown server command: ${action}`);
+  throw new Error(cliText(`Unknown server command: ${action}`, `未知的 server 命令：${action}`));
 }
 
 async function taskCommand(input: string[]): Promise<void> {
@@ -346,9 +391,15 @@ 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} requires a task number or task ID.`);
+      if (!reference) throw new Error(cliText(
+        `task ${action} requires a task number or task ID.`,
+        `task ${action} 需要任务序号或任务 ID。`,
+      ));
       const text = promptParts.join(" ").trim();
-      if (!text) throw new Error(`task ${action} requires a Prompt.`);
+      if (!text) throw new Error(cliText(
+        `task ${action} requires a Prompt.`,
+        `task ${action} 需要提示词。`,
+      ));
       const session = resolveTask(allSessions, reference);
       const endpoint = controlEndpoint(config.storage.sqlitePath);
       ensureOk(await sendControlRequest(endpoint, {
@@ -356,7 +407,7 @@ async function taskCommand(input: string[]): Promise<void> {
         localSessionId: session.localSessionId,
         text,
       }, 60_000));
-      process.stdout.write("Prompt submitted.\n");
+      process.stdout.write(cliText("Prompt submitted.\n", "提示词已提交。\n"));
       return;
     }
     const sessions = filterSessions(allSessions, rest);
@@ -366,7 +417,10 @@ async function taskCommand(input: string[]): Promise<void> {
       return;
     }
     const reference = rest.find((value) => !value.startsWith("--"));
-    if (!reference) throw new Error(`task ${action} requires a task number or task ID.`);
+    if (!reference) throw new Error(cliText(
+      `task ${action} requires a task number or task ID.`,
+      `task ${action} 需要任务序号或任务 ID。`,
+    ));
     const session = resolveTask(sessions, reference);
     if (action === "chat") {
       const route = taskChatRoute(session);
@@ -402,7 +456,7 @@ async function taskCommand(input: string[]): Promise<void> {
     const endpoint = controlEndpoint(config.storage.sqlitePath);
     if (action === "stop") {
       ensureOk(await sendControlRequest(endpoint, { action: "task_stop", localSessionId: session.localSessionId }));
-      process.stdout.write("Task stop requested.\n");
+      process.stdout.write(cliText("Task stop requested.\n", "已请求停止任务。\n"));
       return;
     }
     if (action === "title") {
@@ -410,16 +464,19 @@ 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 requires a new title.");
+      if (!title) throw new Error(cliText(
+        "task title requires a new title.",
+        "task title 需要新标题。",
+      ));
       ensureOk(await sendControlRequest(endpoint, {
         action: "task_title",
         localSessionId: session.localSessionId,
         title,
       }));
-      process.stdout.write("Task title updated.\n");
+      process.stdout.write(cliText("Task title updated.\n", "任务标题已更新。\n"));
       return;
     }
-    throw new Error(`Unknown task command: ${action}`);
+    throw new Error(cliText(`Unknown task command: ${action}`, `未知的 task 命令：${action}`));
   } finally {
     store.close();
   }
@@ -437,7 +494,10 @@ 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(`Task number is out of range: ${reference}`);
+    if (!session) throw new Error(cliText(
+      `Task number is out of range: ${reference}`,
+      `任务序号超出范围：${reference}`,
+    ));
     return session;
   }
   const exact = sessions.find((session) =>
@@ -448,100 +508,143 @@ 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(`Task ID prefix is ambiguous: ${reference}`);
-  throw new Error(`Task not found: ${reference}`);
+  if (matches.length > 1) throw new Error(cliText(
+    `Task ID prefix is ambiguous: ${reference}`,
+    `任务 ID 前缀不唯一：${reference}`,
+  ));
+  throw new Error(cliText(`Task not found: ${reference}`, `未找到任务：${reference}`));
 }
 
 function printTaskList(sessions: SessionRecord[]): void {
   if (sessions.length === 0) {
-    process.stdout.write("No tasks.\n");
+    process.stdout.write(cliText("No tasks.\n", "没有任务。\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 ?? "Untitled task"}\n`);
+    process.stdout.write(`${index + 1}. [${taskStateLabel(session.status)}/${taskStateLabel(session.lastTurnStatus)}] ${session.title ?? cliText("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(`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`);
+  process.stdout.write(`${cliText("Title: ", "标题：")}${session.title ?? cliText("Untitled task", "未命名任务")}\n`);
+  process.stdout.write(`${cliText("Task ID: ", "任务 ID：")}${session.remoteSessionId ?? session.acpSessionId ?? session.localSessionId}\n`);
+  process.stdout.write(`${cliText("Local ID: ", "本地 ID：")}${session.localSessionId}\n`);
+  process.stdout.write(`${cliText("Context: ", "上下文：")}${session.contextKey}\n`);
+  process.stdout.write(`${cliText("Status: ", "状态：")}${taskStateLabel(session.status)} / ${taskStateLabel(session.lastTurnStatus)}\n`);
+  process.stdout.write(`${cliText("Directory: ", "目录：")}${session.cwd}\n`);
+  process.stdout.write(`${cliText("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(`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(`Tool calls: ${state.totalToolCount}\n`);
+    if (typeof state.durationMs === "number") {
+      process.stdout.write(`${cliText("Duration: ", "耗时：")}${Math.round(state.durationMs / 1_000)}s\n`);
+    }
+    if (typeof state.totalTokens === "number") {
+      process.stdout.write(`${cliText("Tokens: ", "Tokens：")}${state.totalTokens}\n`);
+    }
+    if (typeof state.totalToolCount === "number") {
+      process.stdout.write(`${cliText("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(`Tool calls: ${remote.lastTurnToolCount}\n`);
+  if (!snapshot && remote?.lastTurnToolCount !== undefined) {
+    process.stdout.write(`${cliText("Tool calls: ", "工具调用：")}${remote.lastTurnToolCount}\n`);
+  }
   displayedFinalResponse = remote?.finalResponse?.trim() || displayedFinalResponse;
-  if (displayedFinalResponse) process.stdout.write(`Final response:\n${displayedFinalResponse}\n`);
+  if (displayedFinalResponse) {
+    process.stdout.write(`${cliText("Final response:\n", "最终回答：\n")}${displayedFinalResponse}\n`);
+  }
 }
 
 function printSkillStatus(status: SkillRegistrationStatus): void {
-  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`);
+  process.stdout.write(`${cliText("Agent Bot Skill: ", "Agent Bot Skill：")}${status.registered ? cliText("installed", "已安装") : cliText("not installed", "未安装")}\n`);
+  process.stdout.write(`${cliText("System directory: ", "系统目录：")}${status.skillsRoot}\n`);
+  process.stdout.write(`${cliText("Installation path: ", "安装路径：")}${status.targetPath}\n`);
   if (status.registered) {
-    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`);
+    process.stdout.write(`${cliText("Ownership: ", "所有权：")}${status.managed
+      ? cliText("managed by Agent Bot", "由 Agent Bot 管理")
+      : cliText("external directory (will not be modified or removed)", "外部目录（不会修改或删除）")}\n`);
+    process.stdout.write(`${cliText("Version: ", "版本：")}${status.upToDate
+      ? cliText("up to date", "已是最新")
+      : cliText("update required", "需要更新")}\n`);
   }
 }
 
 function printInitializationPaths(result: InitializationResult): void {
-  process.stdout.write("Preparing the Agent Bot user environment...\n");
+  process.stdout.write(cliText(
+    "Preparing the Agent Bot user environment...\n",
+    "正在准备 Agent Bot 用户环境...\n",
+  ));
   if (result.reset) {
-    process.stdout.write(`Reset backup: ${result.reset.backupPath}\n`);
+    process.stdout.write(`${cliText("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`);
+  process.stdout.write(`${cliText("Home directory: ", "主目录：")}${result.home.path} (${initializationStatusLabel(result.home.status)})\n`);
+  process.stdout.write(`${cliText("Config file: ", "配置文件：")}${result.config.path} (${initializationStatusLabel(result.config.status)})\n`);
+  process.stdout.write(`${cliText("Environment file: ", "环境文件：")}${result.env.path} (${initializationStatusLabel(result.env.status)})\n`);
+  process.stdout.write(`${cliText("Data directory: ", "数据目录：")}${result.data.path} (${initializationStatusLabel(result.data.status)})\n`);
+  process.stdout.write(`${cliText("Log directory: ", "日志目录：")}${result.logs.path} (${initializationStatusLabel(result.logs.status)})\n`);
 }
 
 function printInitializationResult(result: Omit<InitCommandResult, "server">): void {
-  process.stdout.write("\nAgent Bot initialization completed.\n");
+  process.stdout.write(cliText(
+    "\nAgent Bot initialization completed.\n",
+    "\nAgent Bot 初始化完成。\n",
+  ));
   if (result.feishu.status === "created") {
-    process.stdout.write(`Lark app: created and credentials saved (${result.feishu.appId})\n`);
+    process.stdout.write(cliText(
+      `Lark app: created and credentials saved (${result.feishu.appId})\n`,
+      `飞书应用：已创建并保存凭据 (${result.feishu.appId})\n`,
+    ));
   } else if (result.feishu.status === "existing") {
-    process.stdout.write(`Lark app: already configured and unchanged (${result.feishu.appId})\n`);
+    process.stdout.write(cliText(
+      `Lark app: already configured and unchanged (${result.feishu.appId})\n`,
+      `飞书应用：已配置，未做修改 (${result.feishu.appId})\n`,
+    ));
   } else {
-    process.stdout.write("Lark app: skipped; use Console mode or run init again later.\n");
+    process.stdout.write(cliText(
+      "Lark app: skipped; use Console mode or run init again later.\n",
+      "飞书应用：已跳过；请使用 Console 模式或稍后重新运行 init。\n",
+    ));
   }
   if (result.feishu.configuration?.status === "updated") {
     const added = result.feishu.configuration.added;
-    process.stdout.write(
+    process.stdout.write(cliText(
       `Lark configuration: added ${added.scopes.length} scopes, ${added.events.length} events, and ${added.callbacks.length} callbacks\n`,
-    );
+      `飞书配置：已新增 ${added.scopes.length} 项权限、${added.events.length} 个事件和 ${added.callbacks.length} 个回调\n`,
+    ));
   } else if (result.feishu.configuration?.status === "partial") {
     const configuration = result.feishu.configuration;
     const addedCount =
       configuration.added.scopes.length + configuration.added.events.length + configuration.added.callbacks.length;
     if (addedCount > 0) {
-      process.stdout.write(
-        `Lark configuration: core capabilities are ready; added ${configuration.added.scopes.length} scopes, ${configuration.added.events.length} events, and ${configuration.added.callbacks.length} callbacks\n`,
-      );
+      process.stdout.write(cliText(
+        `Lark configuration: initialization continued with missing configuration; added ${configuration.added.scopes.length} scopes, ${configuration.added.events.length} events, and ${configuration.added.callbacks.length} callbacks\n`,
+        `飞书配置：仍有配置缺失，初始化已继续；新增 ${configuration.added.scopes.length} 项权限、${configuration.added.events.length} 个事件和 ${configuration.added.callbacks.length} 个回调\n`,
+      ));
     } else {
-      process.stdout.write("Lark configuration: core capabilities are ready\n");
+      process.stdout.write(cliText(
+        "Lark configuration: initialization continued with missing configuration\n",
+        "飞书配置：仍有配置缺失，初始化已继续\n",
+      ));
     }
-    printOptionalFeishuConfigurationWarnings(configuration.remaining);
+    printFeishuConfigurationWarnings(configuration.remaining);
   } else if (result.feishu.configuration?.status === "ready") {
-    process.stdout.write("Lark configuration: scopes, events, and callbacks are ready\n");
+    process.stdout.write(cliText(
+      "Lark configuration: scopes, events, and callbacks are ready\n",
+      "飞书配置：权限、事件和回调均已就绪\n",
+    ));
   }
-  process.stdout.write(`Config file: ${result.config.path}\n`);
+  process.stdout.write(`${cliText("Config file: ", "配置文件：")}${result.config.path}\n`);
 }
 
 function printInitializationServerResult(result: InitCommandResult["server"]): void {
   if (result.status === "skipped") {
-    process.stdout.write("Agent Bot server: skipped (Lark is not configured; Console mode is available)\n");
+    process.stdout.write(cliText(
+      "Agent Bot server: skipped (Lark is not configured; Console mode is available)\n",
+      "Agent Bot 服务：已跳过（未配置飞书；可使用 Console 模式）\n",
+    ));
     return;
   }
   printServerStartResult(result);
@@ -550,8 +653,8 @@ function printInitializationServerResult(result: InitCommandResult["server"]): v
 function printServerStartResult(result: ServerStartResult): void {
   process.stdout.write(
     result.status === "already-running"
-      ? "Agent Bot server is already running.\n"
-      : "Agent Bot server started.\n",
+      ? cliText("Agent Bot server is already running.\n", "Agent Bot 服务已在运行。\n")
+      : cliText("Agent Bot server started.\n", "Agent Bot 服务已启动。\n"),
   );
 }
 
@@ -560,97 +663,181 @@ function printFeishuVerification(challenge: FeishuAppRegistrationChallenge, json
     {
       verificationUrl: challenge.verificationUrl,
       json,
-      qrInstruction: "Scan this QR code with Lark to create the bot app:",
+      qrInstruction: cliText(
+        "Scan this QR code with Lark to create the bot app:",
+        "使用飞书扫描此二维码以创建机器人应用：",
+      ),
     },
   );
-  process.stderr.write(`The link expires in about ${Math.ceil(challenge.expiresIn / 60)} minutes. Waiting for confirmation...\n`);
+  process.stderr.write(cliText(
+    `The link expires in about ${Math.ceil(challenge.expiresIn / 60)} minutes. Waiting for confirmation...\n`,
+    `链接将在约 ${Math.ceil(challenge.expiresIn / 60)} 分钟后过期，正在等待确认...\n`,
+  ));
 }
 
 function printFeishuConfigurationVerification(
   challenge: FeishuConfigurationChallenge,
   json: boolean,
 ): void {
-  process.stderr.write("\nThe Lark app is missing the following configuration:\n");
+  process.stderr.write(challenge.kind === "manual_scope"
+    ? cliText(
+        "\nThe following Lark permission must be added manually in Developer Console:\n",
+        "\n必须在飞书开发者后台手动添加以下权限：\n",
+      )
+    : cliText(
+        "\nThe Lark app is missing the following configuration:\n",
+        "\n飞书应用缺少以下配置：\n",
+      ));
   if (challenge.missing.scopes.length > 0) {
-    process.stderr.write(`Scopes: ${challenge.missing.scopes.join(", ")}\n`);
+    process.stderr.write(`${cliText("Scopes: ", "权限：")}${challenge.missing.scopes.join(", ")}\n`);
   }
   if (challenge.missing.events.length > 0) {
-    process.stderr.write(`Events: ${challenge.missing.events.join(", ")}\n`);
+    process.stderr.write(`${cliText("Events: ", "事件：")}${challenge.missing.events.join(", ")}\n`);
   }
   if (challenge.missing.callbacks.length > 0) {
-    process.stderr.write(`Callbacks: ${challenge.missing.callbacks.join(", ")}\n`);
+    process.stderr.write(`${cliText("Callbacks: ", "回调：")}${challenge.missing.callbacks.join(", ")}\n`);
   }
   printVerificationQrAndLink(
     {
       verificationUrl: challenge.verificationUrl,
       json,
-      qrInstruction: "Scan this QR code with Lark to complete the configuration:",
+      qrInstruction: challenge.kind === "manual_scope"
+        ? cliText(
+            "Scan this QR code with Lark to open the filtered permission page:",
+            "使用飞书扫描此二维码以打开已筛选的权限页面：",
+          )
+        : cliText(
+            "Scan this QR code with Lark to complete the configuration:",
+            "使用飞书扫描此二维码以完成配置：",
+          ),
+      linkLabel: challenge.kind === "manual_scope"
+        ? cliText("Permission page", "权限页面")
+        : undefined,
     },
   );
+  if (challenge.kind === "manual_scope") {
+    process.stderr.write(cliText(
+      "Add the filtered permission, publish the app version, and complete tenant approval if required.\n",
+      "请添加已筛选的权限、发布应用版本，并在需要时完成租户管理员审批。\n",
+    ));
+  }
   if (challenge.blocking) {
-    process.stderr.write("Waiting for the core scopes and message event to become active...\n");
+    process.stderr.write(cliText(
+      "Waiting for the core scopes and message event to become active...\n",
+      "正在等待核心权限和消息事件生效...\n",
+    ));
   } else {
-    process.stderr.write("Waiting up to 5 minutes for these optional items to become active...\n");
+    process.stderr.write(cliText(
+      "Waiting up to 5 minutes for these optional items to become active...\n",
+      "将等待最多 5 分钟，直到这些可选配置生效...\n",
+    ));
   }
 }
 
-function printOptionalFeishuConfigurationWarnings(missing: FeishuConfigurationChallenge["missing"]): void {
-  process.stdout.write("Warning: some optional configuration is not active, so some features may be unavailable.\n");
+function printFeishuConfigurationWarnings(missing: FeishuConfigurationChallenge["missing"]): void {
+  process.stdout.write(cliText(
+    "Warning: some Lark configuration is not active, so some features may be unavailable.\n",
+    "警告：部分飞书配置尚未生效，某些功能可能不可用。\n",
+  ));
   if (missing.scopes.length > 0) {
-    process.stdout.write(`Inactive scopes: ${missing.scopes.join(", ")}\n`);
+    process.stdout.write(`${cliText("Inactive scopes: ", "未生效权限：")}${missing.scopes.join(", ")}\n`);
   }
   if (missing.events.length > 0) {
-    process.stdout.write(`Inactive events: ${missing.events.join(", ")}\n`);
+    process.stdout.write(`${cliText("Inactive events: ", "未生效事件：")}${missing.events.join(", ")}\n`);
   }
   if (missing.callbacks.length > 0) {
-    process.stdout.write(`Inactive callbacks: ${missing.callbacks.join(", ")}\n`);
+    process.stdout.write(`${cliText("Inactive callbacks: ", "未生效回调：")}${missing.callbacks.join(", ")}\n`);
   }
-  for (const feature of optionalFeishuFeatureWarnings(missing)) {
-    process.stdout.write(`Affected feature: ${feature}\n`);
+  for (const feature of feishuFeatureWarnings(missing)) {
+    process.stdout.write(`${cliText("Affected feature: ", "受影响功能：")}${feature}\n`);
   }
 }
 
-function optionalFeishuFeatureWarnings(missing: FeishuConfigurationChallenge["missing"]): string[] {
+function feishuFeatureWarnings(missing: FeishuConfigurationChallenge["missing"]): string[] {
   const scopes = new Set(missing.scopes);
   const events = new Set(missing.events);
   const callbacks = new Set(missing.callbacks);
   const warnings: string[] = [];
+  if (scopes.has("im:message.group_msg")) {
+    warnings.push(cliText(
+      "responding to ordinary group messages that do not mention the bot",
+      "响应未 @ 机器人的普通群消息",
+    ));
+  }
   if (scopes.has("im:chat:create")) {
-    warnings.push("creating Lark groups with /newgroup and /forkgroup");
+    warnings.push(cliText(
+      "creating Lark groups with /newgroup and /forkgroup",
+      "使用 /newgroup 和 /forkgroup 创建飞书群",
+    ));
   }
   if (scopes.has("im:chat:read") || events.has("im.chat.updated_v1")) {
-    warnings.push("synchronizing Agent Bot task titles after Lark group renames");
+    warnings.push(cliText(
+      "synchronizing Agent Bot task titles after Lark group renames",
+      "飞书群重命名后同步 Agent Bot 任务标题",
+    ));
   }
   if (scopes.has("im:message.reactions:write_only")) {
-    warnings.push("showing message-processing status with reactions");
+    warnings.push(cliText(
+      "showing message-processing status with reactions",
+      "使用 Reaction 显示消息处理状态",
+    ));
   }
   if (scopes.has("im:message:readonly")) {
-    warnings.push("reading images from user messages");
+    warnings.push(cliText("reading images from user messages", "读取用户消息中的图片"));
   }
   if (scopes.has("im:resource")) {
-    warnings.push("uploading images, sending local images, or setting group avatars");
+    warnings.push(cliText(
+      "uploading images, sending local images, or setting group avatars",
+      "上传图片、发送本地图片或设置群头像",
+    ));
   }
   if (scopes.has("im:message:update")) {
-    warnings.push("updating sent progress cards");
+    warnings.push(cliText("updating sent progress cards", "更新已发送的进度卡片"));
   }
   if (callbacks.has("card.action.trigger")) {
-    warnings.push("card buttons and interactive actions");
+    warnings.push(cliText("card buttons and interactive actions", "卡片按钮和交互操作"));
   }
   return warnings;
 }
 
 function initializationStatusLabel(status: InitializationStatus): string {
-  if (status === "created") return "created";
-  if (status === "reset") return "reset from template";
-  return "already exists; unchanged";
+  if (status === "created") return cliText("created", "已创建");
+  if (status === "reset") return cliText("reset from template", "已从模板重置");
+  return cliText("already exists; unchanged", "已存在，未修改");
+}
+
+function taskStateLabel(status: string | undefined): string {
+  if (!status) return "-";
+  const chinese: Record<string, string> = {
+    starting: "启动中",
+    ready: "就绪",
+    running: "运行中",
+    closed: "已关闭",
+    failed: "失败",
+    completed: "已完成",
+    cancelled: "已取消",
+    interrupted: "已中断",
+    inProgress: "进行中",
+    active: "活动中",
+    idle: "空闲",
+    not_loaded: "未加载",
+    error: "错误",
+  };
+  return cliLanguage === "zh" ? chinese[status] ?? status : status;
 }
 
 function ensureOk(response: ControlResponse): void {
   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.");
+  const matchesLanguage = cliLanguage === "zh"
+    ? Boolean(message && /[一-龥]/u.test(message))
+    : Boolean(message && !/[一-龥]/u.test(message));
+  throw new Error(matchesLanguage
+    ? message!
+    : cliText(
+        "Agent Bot control operation failed. Check the server logs for details.",
+        "Agent Bot 控制操作失败，请查看服务日志了解详情。",
+      ));
 }
 
 function optionValue(args: string[], name: string): string | undefined {