@keyou007/agent-bot 0.1.9 → 0.1.11

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;