@keyou007/agent-bot 0.1.9 → 0.1.10

package/src/cli/LocalControlClient.ts

@@ -1,5 +1,6 @@
 import net from "node:net";
 import type { ControlRequest, ControlResponse } from "./controlProtocol.js";
+import { cliText } from "./i18n.js";
 
 export async function sendControlRequest(
   endpoint: string,
@@ -17,7 +18,10 @@ export async function sendControlRequest(
       socket.destroy();
       operation();
     };
-    const timer = setTimeout(() => finish(() => reject(new Error("Timed out connecting to the Agent Bot control endpoint."))), timeoutMs);
+    const timer = setTimeout(() => finish(() => reject(new Error(cliText(
+      "Timed out connecting to the Agent Bot control endpoint.",
+      "连接 Agent Bot 控制端点超时。",
+    )))), timeoutMs);
     socket.setEncoding("utf8");
     socket.once("connect", () => socket.write(`${JSON.stringify(request)}\n`));
     socket.on("data", (chunk: string) => {
@@ -33,7 +37,10 @@ export async function sendControlRequest(
     });
     socket.once("error", (error) => finish(() => reject(error)));
     socket.once("end", () => {
-      if (!settled) finish(() => reject(new Error("The Agent Bot control endpoint returned no response.")));
+      if (!settled) finish(() => reject(new Error(cliText(
+        "The Agent Bot control endpoint returned no response.",
+        "Agent Bot 控制端点未返回响应。",
+      ))));
     });
   });
 }

package/src/cli/LocalControlServer.ts

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import net from "node:net";
 import type { ControlRequest, ControlResponse } from "./controlProtocol.js";
+import { cliText } from "./i18n.js";
 
 export type ControlRequestHandler = (request: ControlRequest) => Promise<ControlResponse>;
 
@@ -61,7 +62,7 @@ export class LocalControlServer {
 function parseRequest(line: string): ControlRequest {
   const value = JSON.parse(line) as unknown;
   if (!value || typeof value !== "object" || !("action" in value) || typeof value.action !== "string") {
-    throw new Error("Invalid local control request.");
+    throw new Error(cliText("Invalid local control request.", "无效的本地控制请求。"));
   }
   return value as ControlRequest;
 }

package/src/cli/OptionalAuthorizationSkip.ts

@@ -1,4 +1,5 @@
 import { createInterface, type Interface } from "node:readline";
+import { cliText } from "./i18n.js";
 
 export interface OptionalAuthorizationSkipListener {
   close(): void;
@@ -6,6 +7,45 @@ export interface OptionalAuthorizationSkipListener {
 
 export function listenForOptionalAuthorizationSkip(
   onSkip: () => void,
+): OptionalAuthorizationSkipListener {
+  return listenForAuthorizationSkip(onSkip, {
+    prompt: cliText(
+      "Skip optional authorization? Enter Y and press Enter to skip.\n",
+      "是否跳过可选授权？输入 Y 并按回车键跳过。\n",
+    ),
+    retry: cliText(
+      "Enter Y to skip optional authorization, or keep waiting.\n",
+      "输入 Y 跳过可选授权，或继续等待。\n",
+    ),
+    skipped: cliText(
+      "Optional authorization skipped. Initialization will continue.\n",
+      "已跳过可选授权，初始化将继续。\n",
+    ),
+  });
+}
+
+export function listenForManualPermissionSkip(
+  onSkip: () => void,
+): OptionalAuthorizationSkipListener {
+  return listenForAuthorizationSkip(onSkip, {
+    prompt: cliText(
+      "Skip waiting for this permission? Enter Y and press Enter to skip.\n",
+      "是否跳过等待此权限？输入 Y 并按回车键跳过。\n",
+    ),
+    retry: cliText(
+      "Enter Y to skip this permission, or keep waiting.\n",
+      "输入 Y 跳过此权限，或继续等待。\n",
+    ),
+    skipped: cliText(
+      "Permission wait skipped. Initialization will continue with limited group-message functionality.\n",
+      "已跳过权限等待，初始化将继续，但群消息功能受限。\n",
+    ),
+  });
+}
+
+function listenForAuthorizationSkip(
+  onSkip: () => void,
+  messages: { prompt: string; retry: string; skipped: string },
 ): OptionalAuthorizationSkipListener {
   if (!process.stdin.isTTY) return { close: () => undefined };
 
@@ -13,19 +53,24 @@ export function listenForOptionalAuthorizationSkip(
     input: process.stdin,
     output: process.stderr,
   });
+  let closed = false;
+  const close = (): void => {
+    if (closed) return;
+    closed = true;
+    closeReadline(readline, onLine);
+  };
   const onLine = (value: string): void => {
     if (!isOptionalAuthorizationSkip(value)) {
-      process.stderr.write("Enter Y to skip optional authorization, or keep waiting.\n");
+      process.stderr.write(messages.retry);
       return;
     }
-    process.stderr.write("Optional authorization skipped. Initialization will continue.\n");
+    process.stderr.write(messages.skipped);
+    close();
     onSkip();
   };
   readline.on("line", onLine);
-  process.stderr.write("Skip optional authorization? Enter Y and press Enter to skip.\n");
-  return {
-    close: () => closeReadline(readline, onLine),
-  };
+  process.stderr.write(messages.prompt);
+  return { close };
 }
 
 export function isOptionalAuthorizationSkip(value: string): boolean {

package/src/cli/ServerStarter.ts

@@ -9,6 +9,7 @@ import {
   resolveSupervisorDiagnosticsPaths,
 } from "../supervision/SupervisorDiagnostics.js";
 import { controlEndpoint } from "./controlProtocol.js";
+import { cliText } from "./i18n.js";
 import { isServerReachable, isServerRunning } from "./LocalControlClient.js";
 
 export interface ServerStartResult {
@@ -47,7 +48,17 @@ export async function startServer(
   config: AppConfig,
   dependencies: ServerStarterDependencies = defaultDependencies,
 ): Promise<ServerStartResult> {
-  requireServerFeishuTransport(config.feishu);
+  try {
+    requireServerFeishuTransport(config.feishu);
+  } catch (error) {
+    if (error instanceof Error && /Lark bot is not configured/.test(error.message)) {
+      throw new Error(cliText(
+        "The Lark bot is not configured. Run agent-bot init first, or use agent-bot console for local-only testing.",
+        "尚未配置飞书机器人。请先运行 agent-bot init，或使用 agent-bot console 进行纯本地测试。",
+      ));
+    }
+    throw error;
+  }
   const endpoint = controlEndpoint(config.storage.sqlitePath);
 
   if (await dependencies.isRunning(endpoint)) {
@@ -56,7 +67,10 @@ export async function startServer(
   if (await dependencies.isReachable(endpoint)) {
     const running = await dependencies.waitUntilRunning(endpoint, SERVER_START_TIMEOUT_MS);
     if (!running) {
-      throw new Error("The Agent Bot server started but could not connect to Lark. Check the logs.");
+      throw new Error(cliText(
+        "The Agent Bot server started but could not connect to Lark. Check the logs.",
+        "Agent Bot 服务已启动，但无法连接飞书。请检查日志。",
+      ));
     }
     return { status: "started" };
   }
@@ -64,7 +78,10 @@ export async function startServer(
   dependencies.spawnSupervisor(config);
   const running = await dependencies.waitUntilRunning(endpoint, SERVER_START_TIMEOUT_MS);
   if (!running) {
-    throw new Error("The Supervisor started, but the server did not connect to Lark within 45 seconds. Check the logs.");
+    throw new Error(cliText(
+      "The Supervisor started, but the server did not connect to Lark within 45 seconds. Check the logs.",
+      "Supervisor 已启动，但服务未能在 45 秒内连接飞书。请检查日志。",
+    ));
   }
   return { status: "started" };
 }

package/src/cli/SkillRegistry.ts

@@ -2,6 +2,7 @@ import { createHash, randomUUID } from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { cliText } from "./i18n.js";
 
 const SKILL_NAME = "agent-bot";
 const MARKER_FILE = ".agent-bot-managed.json";
@@ -65,7 +66,10 @@ export class SkillRegistry {
     this.assertValidSource();
     const existing = fs.existsSync(this.targetPath);
     if (existing && this.readMarker()?.managedBy !== "agent-bot") {
-      throw new Error(`The target directory exists and is not managed by Agent Bot: ${this.targetPath}`);
+      throw new Error(cliText(
+        `The target directory exists and is not managed by Agent Bot: ${this.targetPath}`,
+        `目标目录已存在且不由 Agent Bot 管理：${this.targetPath}`,
+      ));
     }
 
     const before = existing ? this.status() : undefined;
@@ -93,7 +97,10 @@ export class SkillRegistry {
   uninstall(): boolean {
     if (!fs.existsSync(this.targetPath)) return false;
     if (this.readMarker()?.managedBy !== "agent-bot") {
-      throw new Error(`Refusing to remove a directory that is not managed by Agent Bot: ${this.targetPath}`);
+      throw new Error(cliText(
+        `Refusing to remove a directory that is not managed by Agent Bot: ${this.targetPath}`,
+        `拒绝删除不由 Agent Bot 管理的目录：${this.targetPath}`,
+      ));
     }
     this.removeManagedTarget();
     return true;
@@ -101,13 +108,19 @@ export class SkillRegistry {
 
   private assertValidSource(): void {
     if (!fs.existsSync(path.join(this.sourcePath, "SKILL.md"))) {
-      throw new Error(`The built-in Agent Bot Skill was not found: ${this.sourcePath}`);
+      throw new Error(cliText(
+        `The built-in Agent Bot Skill was not found: ${this.sourcePath}`,
+        `未找到内置 Agent Bot Skill：${this.sourcePath}`,
+      ));
     }
   }
 
   private assertSafeTarget(): void {
     if (path.dirname(this.targetPath) !== this.skillsRoot || path.basename(this.targetPath) !== SKILL_NAME) {
-      throw new Error(`Unsafe Skill target path: ${this.targetPath}`);
+      throw new Error(cliText(
+        `Unsafe Skill target path: ${this.targetPath}`,
+        `不安全的 Skill 目标路径：${this.targetPath}`,
+      ));
     }
   }
 

package/src/cli/VerificationOutput.ts

@@ -1,9 +1,12 @@
 import qrcode from "qrcode-terminal";
+import { cliText, type CliLanguage } from "./i18n.js";
 
 export interface VerificationOutputOptions {
   verificationUrl: string;
   json: boolean;
   qrInstruction: string;
+  linkLabel?: string;
+  language?: CliLanguage;
 }
 
 export function printVerificationQrAndLink(
@@ -18,5 +21,5 @@ export function printVerificationQrAndLink(
     write(`\n${options.qrInstruction}\n\n`);
     renderQr(options.verificationUrl, (output) => write(`${output}\n`));
   }
-  write(`Authorization link:\n${options.verificationUrl}\n\n`);
+  write(`${options.linkLabel ?? cliText("Authorization link", "授权链接", options.language)}${cliText(":", "：", options.language)}\n${options.verificationUrl}\n\n`);
 }

package/src/cli/help.ts

@@ -1,4 +1,53 @@
-export function renderCliHelp(version: string): string {
+import { cliLanguage, type CliLanguage } from "./i18n.js";
+
+export function renderCliHelp(version: string, language: CliLanguage = cliLanguage): string {
+  if (language === "zh") {
+    return `Agent Bot ${version}
+通过飞书使用本地 Codex 和 ACP Agent。
+
+用法：
+  agent-bot [选项] <命令>
+
+常用命令：
+  init                              初始化飞书应用并启动服务
+  init --reset                      重置并重新配置显式指定的 Profile
+  console                           打开本地控制台
+  server start                      在后台启动 Agent Bot
+  server status                     显示服务、飞书 App ID 和安全重启状态
+  server restart                    安排安全重启
+  server stop                       停止 Agent Bot
+  task list                         列出任务
+  task status <任务>                显示任务状态
+  task chat <任务>                  显示任务绑定的飞书会话
+  task prompt <任务> <提示词>       向任务发送提示词
+  task stop <任务>                  停止任务
+  task title <任务> <标题>          重命名任务
+  skills status                     显示内置 Skill 状态
+  skills install                    安装内置 Skill
+
+选项：
+  --profile <目录>                  使用独立的 Profile 目录
+  --config <路径>                   使用指定的配置文件
+  --json                            在支持时输出 JSON
+  -h, --help                        显示帮助
+  -v, --version                     显示版本
+
+初始化选项：
+  --reset                           备份并重置显式指定的 Profile
+  --skip-feishu                     仅初始化 Console 环境
+  --reconfigure-feishu              仅替换现有飞书凭据
+
+示例：
+  agent-bot init
+  agent-bot --profile ~/.agent-bot init --reset
+  agent-bot --profile ~/.agent-bot-rescue init
+  agent-bot server start
+  agent-bot server status
+  agent-bot task list
+  agent-bot server restart --reason "更新 Agent Bot"
+`;
+  }
+
   return `Agent Bot ${version}
 Use local Codex and ACP agents from Lark/Feishu.
 

package/src/cli/i18n.ts

@@ -0,0 +1,38 @@
+export type CliLanguage = "en" | "zh";
+
+export function detectCliLanguage(locale = systemLocale()): CliLanguage {
+  return /^zh(?:[-_]|$)/i.test(locale.trim()) ? "zh" : "en";
+}
+
+export const cliLanguage = detectCliLanguage();
+
+export function cliText(
+  english: string,
+  chinese: string,
+  language: CliLanguage = cliLanguage,
+): string {
+  return language === "zh" ? chinese : english;
+}
+
+export function localizeCliErrorMessage(
+  message: string,
+  language: CliLanguage = cliLanguage,
+): string {
+  if (language !== "zh") return message;
+
+  const missingConfig = /^Config file does not exist: (.+)$/u.exec(message);
+  if (missingConfig) return `配置文件不存在：${missingConfig[1]}`;
+
+  const missingAgent = /^Default agent "(.+)" is not configured\.$/u.exec(message);
+  if (missingAgent) return `默认 Agent“${missingAgent[1]}”尚未配置。`;
+
+  return message;
+}
+
+function systemLocale(): string {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().locale || "en";
+  } catch {
+    return "en";
+  }
+}

package/src/cli/initOptions.ts

@@ -12,7 +12,10 @@ export function parseInitCommandOptions(
   const supported = new Set(["--json", "--skip-feishu", "--reconfigure-feishu", "--reset"]);
   const unsupported = input.filter((value) => !supported.has(value));
   if (unsupported.length > 0) {
-    throw new Error(`Unsupported init options: ${unsupported.join(" ")}`);
+    throw new Error(cliText(
+      `Unsupported init options: ${unsupported.join(" ")}`,
+      `不支持的 init 选项：${unsupported.join(" ")}`,
+    ));
   }
   const options = {
     json: input.includes("--json"),
@@ -21,13 +24,23 @@ export function parseInitCommandOptions(
     reset: input.includes("--reset"),
   };
   if (options.skipFeishu && options.reconfigureFeishu) {
-    throw new Error("--skip-feishu and --reconfigure-feishu cannot be used together.");
+    throw new Error(cliText(
+      "--skip-feishu and --reconfigure-feishu cannot be used together.",
+      "--skip-feishu 和 --reconfigure-feishu 不能同时使用。",
+    ));
   }
   if (options.reset && !explicitProfile) {
-    throw new Error("--reset requires an explicit --profile <directory>.");
+    throw new Error(cliText(
+      "--reset requires an explicit --profile <directory>.",
+      "--reset 需要显式指定 --profile <目录>。",
+    ));
   }
   if (options.reset && options.reconfigureFeishu) {
-    throw new Error("--reset cannot be combined with --reconfigure-feishu because reset already replaces Lark credentials.");
+    throw new Error(cliText(
+      "--reset cannot be combined with --reconfigure-feishu because reset already replaces Lark credentials.",
+      "--reset 不能与 --reconfigure-feishu 同时使用，因为重置已经会替换飞书凭据。",
+    ));
   }
   return options;
 }
+import { cliText } from "./i18n.js";

package/src/cli/packageVersion.ts

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import { cliText } from "./i18n.js";
 import { fileURLToPath } from "node:url";
 
 export function readPackageVersion(
@@ -8,7 +9,10 @@ export function readPackageVersion(
     fs.readFileSync(fileURLToPath(packageJsonUrl), "utf8"),
   ) as { version?: unknown };
   if (typeof metadata.version !== "string" || !metadata.version.trim()) {
-    throw new Error("package.json does not contain a valid version.");
+    throw new Error(cliText(
+      "package.json does not contain a valid version.",
+      "package.json 中不包含有效版本号。",
+    ));
   }
   return metadata.version;
 }

package/src/cli/profile.ts

@@ -1,4 +1,5 @@
 import path from "node:path";
+import { cliText } from "./i18n.js";
 import {
   AGENT_BOT_EXPLICIT_PROFILE_ENV,
   AGENT_BOT_HOME_ENV,
@@ -22,7 +23,10 @@ export function parseGlobalOptions(input: string[]): ParsedGlobalOptions {
   const configPath = removeOption(args, "--config");
   const profilePath = removeOption(args, "--profile");
   if (configPath && profilePath) {
-    throw new Error("--profile and --config cannot be used together. A profile always uses config.yaml in its directory.");
+    throw new Error(cliText(
+      "--profile and --config cannot be used together. A profile always uses config.yaml in its directory.",
+      "--profile 和 --config 不能同时使用。Profile 始终使用其目录中的 config.yaml。",
+    ));
   }
   return {
     args,
@@ -49,11 +53,17 @@ export function applyExplicitProfile(
 
 function removeOption(args: string[], option: string): string | undefined {
   const indexes = args.flatMap((value, index) => value === option ? [index] : []);
-  if (indexes.length > 1) throw new Error(`${option} can only be specified once.`);
+  if (indexes.length > 1) throw new Error(cliText(
+    `${option} can only be specified once.`,
+    `${option} 只能指定一次。`,
+  ));
   const index = indexes[0];
   if (index === undefined) return undefined;
   const value = args[index + 1];
-  if (!value || value.startsWith("--")) throw new Error(`${option} requires a directory or file path.`);
+  if (!value || value.startsWith("--")) throw new Error(cliText(
+    `${option} requires a directory or file path.`,
+    `${option} 需要目录或文件路径。`,
+  ));
   args.splice(index, 2);
   return value;
 }

package/src/cli/serverStatus.ts

@@ -12,28 +12,33 @@ export function withConfiguredFeishuAppId(
   };
 }
 
-export function formatServerStatus(data: unknown): string {
+export function formatServerStatus(data: unknown, language: CliLanguage = cliLanguage): string {
   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>
     : {};
   const state = value.running === false
-    ? "not running"
+    ? cliText("not running", "未运行", language)
     : value.ready === false
-      ? "starting (connecting to Lark)"
-      : "running";
+      ? cliText("starting (connecting to Lark)", "正在启动（连接飞书中）", language)
+      : cliText("running", "运行中", language);
   const safeRestart = value.safeRestartScheduled
-    ? `pending (${String(value.safeRestartReason ?? "no reason provided")})`
-    : "not scheduled";
+    ? cliText(
+        `pending (${String(value.safeRestartReason ?? "no reason provided")})`,
+        `等待中（${String(value.safeRestartReason ?? "未提供原因")}）`,
+        language,
+      )
+    : cliText("not scheduled", "未计划", language);
   return [
-    `Agent Bot server: ${state}`,
-    `Lark App ID: ${value.feishuAppId ?? "not configured"}`,
-    `PID: ${value.pid ?? "-"}`,
-    `Started at: ${value.startedAt ?? "-"}`,
-    `Supervisor: ${value.supervised ? "enabled" : "disabled"}`,
-    `Running tasks: ${activity.runningSessions ?? 0}`,
-    `Pending final deliveries: ${activity.pendingFinalDeliveries ?? 0}`,
-    `Safe restart: ${safeRestart}`,
+    `${cliText("Agent Bot server: ", "Agent Bot 服务：", language)}${state}`,
+    `${cliText("Lark App ID: ", "飞书 App ID：", language)}${value.feishuAppId ?? cliText("not configured", "未配置", language)}`,
+    `${cliText("PID: ", "PID：", language)}${value.pid ?? "-"}`,
+    `${cliText("Started at: ", "启动时间：", language)}${value.startedAt ?? "-"}`,
+    `${cliText("Supervisor: ", "Supervisor：", language)}${value.supervised ? cliText("enabled", "已启用", language) : cliText("disabled", "未启用", language)}`,
+    `${cliText("Running tasks: ", "运行中任务：", language)}${activity.runningSessions ?? 0}`,
+    `${cliText("Pending final deliveries: ", "待发送最终结果：", language)}${activity.pendingFinalDeliveries ?? 0}`,
+    `${cliText("Safe restart: ", "安全重启：", language)}${safeRestart}`,
     "",
   ].join("\n");
 }
+import { cliLanguage, cliText, type CliLanguage } from "./i18n.js";

package/src/cli/taskChatRoute.ts

@@ -1,5 +1,6 @@
 import { baseChatContextKey, isThreadContextKey } from "../feishu/contextKey.js";
 import type { SessionRecord } from "../state/StateStore.js";
+import { cliText } from "./i18n.js";
 
 const CHAT_CONTEXT_PREFIX = "chat_id:";
 const THREAD_CONTEXT_MARKER = ":thread_id:";
@@ -15,10 +16,16 @@ export function taskChatRoute(session: SessionRecord): TaskChatRoute {
   const contextKey = session.contextKey;
   const baseContextKey = baseChatContextKey(contextKey);
   if (!baseContextKey.startsWith(CHAT_CONTEXT_PREFIX)) {
-    throw new Error(`The task is not bound to a Lark chat: ${session.remoteSessionId ?? session.acpSessionId ?? session.localSessionId}`);
+    throw new Error(cliText(
+      `The task is not bound to a Lark chat: ${session.remoteSessionId ?? session.acpSessionId ?? session.localSessionId}`,
+      `任务未绑定飞书会话：${session.remoteSessionId ?? session.acpSessionId ?? session.localSessionId}`,
+    ));
   }
   const chatId = baseContextKey.slice(CHAT_CONTEXT_PREFIX.length);
-  if (!chatId) throw new Error(`The task has an invalid Lark chat ID: ${contextKey}`);
+  if (!chatId) throw new Error(cliText(
+    `The task has an invalid Lark chat ID: ${contextKey}`,
+    `任务的飞书会话 ID 无效：${contextKey}`,
+  ));
   const threadId = isThreadContextKey(contextKey)
     ? contextKey.slice(contextKey.indexOf(THREAD_CONTEXT_MARKER) + THREAD_CONTEXT_MARKER.length)
     : undefined;