@armadra/agent 0.5.1 → 0.6.0

package/dist/checkpoints/backend.js

@@ -14,6 +14,7 @@ import { emptyCodeResult, gitHintFor, restoreCheckpoint } from "./restore.js";
 import { GitMissingError, ShadowRepo, unsafeShadowCwd, } from "./shadow-git.js";
 import { latestShadowCommit, restoreFromShadow } from "./shadow-restore.js";
 import { CheckpointTracker } from "./tracker.js";
+import { msg } from "../i18n/index.js";
 export function createCheckpointBackendFactory(settings) {
     return (ctx) => {
         if (settings.mode === "off")
@@ -33,7 +34,7 @@ export function createCheckpointBackendFactory(settings) {
             });
             if (!registered && settings.sessionsRoot !== undefined) {
                 registered = true;
-                registerSessionRoot(settings.dataDir, settings.sessionsRoot).catch((error) => ctx.log("debug", `检查点：登记会话目录失败（${String(error)}）`));
+                registerSessionRoot(settings.dataDir, settings.sessionsRoot).catch((error) => ctx.log("debug", msg().session.checkpoints.registerFailed(String(error))));
             }
             return tracker;
         };
@@ -41,7 +42,7 @@ export function createCheckpointBackendFactory(settings) {
         let shadow = settings.mode === "shadow-git" ? undefined : null;
         const degrade = (message) => {
             shadow = null;
-            warn(`检查点：影子 git 不可用（${message}），本会话改用 tools 模式`);
+            warn(msg().session.checkpoints.shadowUnavailable(message));
         };
         const getShadow = () => {
             if (shadow !== undefined)
@@ -66,7 +67,7 @@ export function createCheckpointBackendFactory(settings) {
                 return snap.commit;
             }
             catch (error) {
-                degrade(error instanceof GitMissingError ? "PATH 里找不到 git" : describe(error));
+                degrade(error instanceof GitMissingError ? msg().session.checkpoints.gitMissing : describe(error));
                 return undefined;
             }
         };
@@ -82,7 +83,7 @@ export function createCheckpointBackendFactory(settings) {
                     await get().snapshot(userEntryId, shadowCommit !== undefined ? { shadowCommit } : {});
                 }
                 catch (error) {
-                    warn(`检查点：建立失败（${describe(error)}）`);
+                    warn(msg().session.checkpoints.createFailed(describe(error)));
                 }
             },
             hasCheckpoint: (userEntryId) => isRewindable(get().state, userEntryId, settings.keep),
@@ -117,7 +118,7 @@ export function createCheckpointBackendFactory(settings) {
                             });
                         }
                         catch (error) {
-                            warn(`检查点：按影子提交恢复失败（${describe(error)}），改按 tools 记录恢复`);
+                            warn(msg().session.checkpoints.shadowRestoreFailed(describe(error)));
                         }
                     }
                 }

package/dist/checkpoints/restore.js

@@ -24,6 +24,7 @@ import { unifiedDiff } from "../tools/edit.js";
 import { DEFAULT_MAX_FILE_BYTES, hashFile, isNotFound, keyToPath, readBlob, realParentOf, } from "./blobs.js";
 import { readGitHead } from "./git-head.js";
 import { latestCheckpoint } from "./replay.js";
+import { msg } from "../i18n/index.js";
 /** 单文件不恢复的原因（安全检查不通过等）；`settleFile` 把它记进 `skipped`。 */
 export class RestoreSkip extends Error {
     reason;
@@ -198,7 +199,7 @@ async function removeRegular(abs, before) {
     if (now.nlink > 1)
         throw new Skip("hardlink");
     if (now.dev !== before.dev || now.ino !== before.ino)
-        throw new Error("文件在恢复期间被替换");
+        throw new Error(msg().session.checkpoints.replacedDuringRestore);
     await unlink(abs);
 }
 async function writeBack(abs, bytes, record, before) {
@@ -239,7 +240,7 @@ async function writeBack(abs, bytes, record, before) {
             opened.ino !== before.ino ||
             now.dev !== opened.dev ||
             now.ino !== opened.ino) {
-            throw new Error("文件在恢复期间被替换");
+            throw new Error(msg().session.checkpoints.replacedDuringRestore);
         }
         if (opened.nlink > 1)
             throw new Skip("hardlink");

package/dist/checkpoints/settings.js

@@ -5,6 +5,7 @@
  * 无效的环境变量值 warn 后忽略。`maxFileBytes` / `keep` 取配置，缺省 5 MiB / 100。
  */
 import { CHECKPOINT_MODES, DEFAULT_CHECKPOINTS_CONFIG } from "../config/types.js";
+import { msg } from "../i18n/index.js";
 export function resolveCheckpointSettings(config, env = process.env, warn = () => { }) {
     const section = config?.checkpoints ?? {};
     let mode = section.mode ?? DEFAULT_CHECKPOINTS_CONFIG.mode;
@@ -13,7 +14,7 @@ export function resolveCheckpointSettings(config, env = process.env, warn = () =
         if (CHECKPOINT_MODES.includes(raw))
             mode = raw;
         else
-            warn(`AMA_CHECKPOINTS=${raw} 无效（${CHECKPOINT_MODES.join(" | ")}），已忽略`);
+            warn(msg().session.checkpoints.invalidEnv(raw, CHECKPOINT_MODES));
     }
     return {
         mode,

package/dist/checkpoints/shadow-git.js

@@ -19,6 +19,7 @@ import { mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises"
 import { homedir } from "node:os";
 import { join, parse, resolve } from "node:path";
 import { fileHistoryDir } from "./blobs.js";
+import { msg } from "../i18n/index.js";
 export const SHADOW_DIR = "shadow";
 /** cwd 下（不含忽略的）文件数上限，超出本会话降级为 tools。 */
 export const SHADOW_MAX_FILES = 20_000;
@@ -42,9 +43,9 @@ export function shadowRepoDir(dataDir, cwd) {
 export function unsafeShadowCwd(cwd, home = homedir()) {
     const abs = resolve(cwd);
     if (parse(abs).root === abs)
-        return "工作目录是文件系统根目录";
+        return msg().session.checkpoints.cwdIsRoot;
     if (home !== "" && sameDir(abs, resolve(home)))
-        return "工作目录是家目录";
+        return msg().session.checkpoints.cwdIsHome;
     return undefined;
 }
 function sameDir(a, b) {
@@ -53,7 +54,7 @@ function sameDir(a, b) {
 /** git 不在 PATH（或指定的可执行文件不存在）。 */
 export class GitMissingError extends Error {
     constructor() {
-        super("找不到 git");
+        super(msg().session.checkpoints.gitNotFound);
     }
 }
 export const MODE_ABSENT = "000000";
@@ -220,7 +221,7 @@ export class ShadowRepo {
                     return {
                         degrade: {
                             reason: "too_many_files",
-                            message: `工作目录有 ${files} 个文件（上限 ${this.maxFiles}）`,
+                            message: msg().session.checkpoints.tooManyFiles(files, this.maxFiles),
                         },
                     };
                 }
@@ -236,7 +237,7 @@ export class ShadowRepo {
                     commit,
                     degrade: {
                         reason: "too_slow",
-                        message: `快照用了 ${(elapsed / 1000).toFixed(1)} 秒（上限 ${this.maxSnapshotMs / 1000} 秒）`,
+                        message: msg().session.checkpoints.tooSlow((elapsed / 1000).toFixed(1), this.maxSnapshotMs / 1000),
                     },
                 };
             }
@@ -412,7 +413,7 @@ function runGit(git, args, options) {
                 return;
             }
             const detail = errText.trim().split("\n").slice(-2).join("; ");
-            reject(new Error(`git ${args.find((a) => !a.startsWith("--")) ?? ""} 失败（${signal ?? code}）${detail === "" ? "" : `：${detail}`}`));
+            reject(new Error(msg().session.checkpoints.gitFailed(args.find((a) => !a.startsWith("--")) ?? "", String(signal ?? code), detail)));
         });
         child.stdin.on("error", () => undefined);
         child.stdin.end(options.input ?? "");

package/dist/checkpoints/shadow-restore.js

@@ -17,6 +17,7 @@ import { DEFAULT_MAX_FILE_BYTES, hashBytes, keyToPath } from "./blobs.js";
 import { latestCheckpoint } from "./replay.js";
 import { emptyCodeResult, restoreCheckpoint, restoreFile, settleFile, } from "./restore.js";
 import { MODE_ABSENT, MODE_EXECUTABLE, MODE_GITLINK, MODE_SYMLINK, } from "./shadow-git.js";
+import { msg } from "../i18n/index.js";
 const IS_WINDOWS = process.platform === "win32";
 /** 文件顺序上最后一个带影子提交的检查点。 */
 export function latestShadowCommit(state) {
@@ -32,9 +33,9 @@ export async function restoreFromShadow(options) {
     const { repo } = options;
     const target = options.target.shadowCommit;
     if (target === undefined)
-        throw new Error("检查点没有影子提交");
+        throw new Error(msg().session.checkpoints.noShadowCommit);
     if (!(await repo.hasCommit(target)))
-        throw new Error(`影子提交 ${target.slice(0, 12)} 不存在`);
+        throw new Error(msg().session.checkpoints.shadowCommitMissing(target.slice(0, 12)));
     const maxBytes = options.maxFileBytes ?? DEFAULT_MAX_FILE_BYTES;
     const current = await repo.currentTree();
     const changes = (await repo.diff(target, current)).filter((c) => c.oldMode !== MODE_GITLINK && c.newMode !== MODE_GITLINK);

package/dist/checkpoints/tracker.js

@@ -14,6 +14,7 @@ import { readGitHead } from "./git-head.js";
 import { DEFAULT_MAX_FILE_BYTES, hashBytes, isNotFound, keyToPath, pathKey, putBlob, realParentOf, recordFile, } from "./blobs.js";
 import { applyCheckpoint, applyTrack, emptyCheckpoints } from "./replay.js";
 import { CHECKPOINT_CUSTOM_TYPE, CHECKPOINT_TRACK_CUSTOM_TYPE, } from "./types.js";
+import { msg } from "../i18n/index.js";
 /** mtime 粒度余量（FAT 2 s；其它文件系统更细）。 */
 export const MTIME_GRANULARITY_MS = 2_000;
 export class CheckpointTracker {
@@ -87,7 +88,7 @@ export class CheckpointTracker {
             this.recordedAt.set(key, at);
         }
         catch (error) {
-            this.warn(`检查点：备份 ${key} 失败（${describe(error)}），本次写入不可回滚`);
+            this.warn(msg().session.checkpoints.backupFailed(key, describe(error)));
         }
     }
     afterWrite(absolutePath, content) {
@@ -95,7 +96,7 @@ export class CheckpointTracker {
             this.lastWritten.set(absolutePath, hashBytes(content));
         }
         catch (error) {
-            this.warn(`检查点：记录 ${absolutePath} 的写入失败（${describe(error)}）`);
+            this.warn(msg().session.checkpoints.recordFailed(absolutePath, describe(error)));
         }
     }
     /** 新回合：重拍全部已跟踪文件，追加 `ama.checkpoint`，返回它。`extra.shadowCommit` 来自影子 git。 */
@@ -114,7 +115,7 @@ export class CheckpointTracker {
                 times.set(key, next.at);
             }
             catch (error) {
-                this.warn(`检查点：快照 ${key} 失败（${describe(error)}），该文件回滚到此处时用更早的记录`);
+                this.warn(msg().session.checkpoints.snapshotFailed(key, describe(error)));
             }
         }
         const data = { v: 1, userEntryId, files };

package/dist/cli/args.d.ts

@@ -10,12 +10,14 @@
  * - `--resume [id]`：下一个参数形如会话 id（无空白、不以 `-` 开头）才被当作 id；
  *   否则仍作为提示文本。显式写法 `--resume=<id>`。
  * - `--provider` 不带 `--model` 不在这里报错，由 bootstrap 第 11 步报（退出码 2）。
+ * - [W6-C0] `--lang zh|en` 也可写在子命令名之前（`ama --lang en doctor`）；`--memory` / `--no-memory`。
  */
 import { AmaError } from "../errors.js";
 import type { ModelThinkingLevel } from "../ai/types.js";
 import { type PermissionMode } from "../permissions/types.js";
 import { type CodemodeMode, type ToolsPreset } from "../config/types.js";
-export declare const SUBCOMMANDS: readonly ["auth", "sessions", "models", "providers", "doctor", "config", "init", "stats"];
+import { type Locale } from "../i18n/index.js";
+export declare const SUBCOMMANDS: readonly ["auth", "sessions", "models", "providers", "doctor", "config", "init", "stats", "memory"];
 export type SubcommandName = (typeof SUBCOMMANDS)[number];
 export type OutputFormat = "text" | "json" | "stream-json";
 export type QuietStartup = "normal" | "header" | "silent";
@@ -80,6 +82,10 @@ export interface ParsedArgs {
     prompt?: string;
     /** 原始位置参数。 */
     positionals: string[];
+    /** [W6-C0] `--lang zh|en`：界面语言（`AMA_LANG` 优先，docs/i18n.md）。 */
+    lang?: Locale;
+    /** [W6-C0] `--memory` → true、`--no-memory` → false：覆盖 `memory.enabled`（W6-M）。 */
+    memory?: boolean;
 }
 export type ParseResult = {
     kind: "run";
@@ -88,11 +94,12 @@ export type ParseResult = {
     kind: "subcommand";
     name: SubcommandName;
     argv: string[];
+    lang?: Locale;
 };
 export declare class UsageError extends AmaError {
     constructor(message: string);
 }
-export { HELP_TEXT } from "./help-text.js";
+export { helpText } from "./help-text.js";
 export declare function emptyArgs(): ParsedArgs;
 /** 解析 argv（不含 node 与脚本路径）；用法错误抛 UsageError（退出码 2）。 */
 export declare function parseArgs(argv: readonly string[]): ParseResult;

package/dist/cli/args.js

@@ -10,11 +10,13 @@
  * - `--resume [id]`：下一个参数形如会话 id（无空白、不以 `-` 开头）才被当作 id；
  *   否则仍作为提示文本。显式写法 `--resume=<id>`。
  * - `--provider` 不带 `--model` 不在这里报错，由 bootstrap 第 11 步报（退出码 2）。
+ * - [W6-C0] `--lang zh|en` 也可写在子命令名之前（`ama --lang en doctor`）；`--memory` / `--no-memory`。
  */
 import { AmaError } from "../errors.js";
 import { PERMISSION_MODES_STRICT_FIRST } from "../permissions/types.js";
 import { canonicalPreset } from "../config/types.js";
 import { CODEMODE_MODES } from "../config/types.js";
+import { LOCALES, msg } from "../i18n/index.js";
 export const SUBCOMMANDS = [
     "auth",
     "sessions",
@@ -24,6 +26,8 @@ export const SUBCOMMANDS = [
     "config",
     "init",
     "stats",
+    // [W6-C0] W6-M 实现（cli/subcommands/memory.ts）；之前 main.ts 报「尚未提供」
+    "memory",
 ];
 export class UsageError extends AmaError {
     constructor(message) {
@@ -45,7 +49,7 @@ const QUIET_LEVELS = ["normal", "header", "silent"];
 /** 帮助与报错按常用顺序列出（校验集合同 TOOLS_PRESET_INPUTS；`codemode` 是 `codemode-only` 的别名）。 */
 const PRESET_CHOICES = ["default", "minimal", "codemode-only", "coordinator", "codemode"];
 const SESSION_ID_LIKE = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;
-export { HELP_TEXT } from "./help-text.js";
+export { helpText } from "./help-text.js";
 const VALUE_OPTIONS = new Set([
     "profile",
     "host",
@@ -77,6 +81,7 @@ const VALUE_OPTIONS = new Set([
     "system-prompt",
     "system-prompt-mode",
     "from",
+    "lang",
 ]);
 const FLAG_ALIASES = {
     "-h": "help",
@@ -88,7 +93,7 @@ const FLAG_ALIASES = {
 function choice(option, value, choices) {
     if (choices.includes(value))
         return value;
-    throw new UsageError(`--${option} 的取值应为 ${choices.join(" | ")}（收到 ${value}）`);
+    throw new UsageError(msg().cli.args.invalidChoice(option, choices, value));
 }
 function list(value) {
     return value
@@ -117,7 +122,7 @@ export function emptyArgs() {
 }
 function applyValue(args, option, value) {
     if (value === "")
-        throw new UsageError(`--${option} 的值不能为空`);
+        throw new UsageError(msg().cli.args.emptyValue(option));
     switch (option) {
         case "profile":
             args.profile = value;
@@ -172,7 +177,7 @@ function applyValue(args, option, value) {
             break;
         case "tui-mode":
             if (value === "fullscreen")
-                throw new UsageError("--tui-mode fullscreen 尚未支持（第一期只有 regular）");
+                throw new UsageError(msg().cli.args.fullscreenUnsupported);
             args.tuiMode = choice(option, value, ["regular"]);
             break;
         case "quiet-startup":
@@ -202,14 +207,14 @@ function applyValue(args, option, value) {
         case "max-turns": {
             const turns = Number(value);
             if (!Number.isInteger(turns) || turns < 1)
-                throw new UsageError(`--max-turns 应为正整数（收到 ${value}）`);
+                throw new UsageError(msg().cli.args.maxTurnsPositive(value));
             args.maxTurns = turns;
             break;
         }
         case "max-cost": {
             const usd = Number(value);
             if (!Number.isFinite(usd) || usd <= 0)
-                throw new UsageError(`--max-cost 应为正数（美元，收到 ${value}）`);
+                throw new UsageError(msg().cli.args.maxCostPositive(value));
             args.maxCostUsd = usd;
             break;
         }
@@ -219,6 +224,9 @@ function applyValue(args, option, value) {
         case "from":
             args.from = value;
             break;
+        case "lang":
+            args.lang = choice(option, value, LOCALES);
+            break;
     }
 }
 function applyFlag(args, name) {
@@ -248,18 +256,27 @@ function applyFlag(args, name) {
         case "no-trust": {
             const value = name === "trust";
             if (args.trust !== undefined && args.trust !== value) {
-                throw new UsageError("--trust 与 --no-trust 不能同时使用");
+                throw new UsageError(msg().cli.args.flagConflict("--trust", "--no-trust"));
             }
             args.trust = value;
             return true;
         }
+        case "memory":
+        case "no-memory": {
+            const value = name === "memory";
+            if (args.memory !== undefined && args.memory !== value)
+                throw new UsageError(msg().cli.args.flagConflict("--memory", "--no-memory"));
+            args.memory = value;
+            return true;
+        }
         default:
             return false;
     }
 }
 function validate(args) {
+    const m = msg().cli.args;
     if (args.print && args.mode !== undefined)
-        throw new UsageError(`-p 与 --mode ${args.mode} 不能同时使用`);
+        throw new UsageError(m.printWithMode(args.mode));
     const sessionFlags = [
         args.continue ? "--continue" : undefined,
         args.resume ? "--resume" : undefined,
@@ -267,38 +284,44 @@ function validate(args) {
         args.fork !== undefined ? "--fork" : undefined,
     ].filter((f) => f !== undefined);
     if (sessionFlags.length > 1)
-        throw new UsageError(`${sessionFlags.join(" 与 ")} 不能同时使用`);
+        throw new UsageError(m.flagsConflict(sessionFlags));
     if (args.noSession && sessionFlags.length > 0) {
-        throw new UsageError(`--no-session 与 ${sessionFlags[0]} 不能同时使用`);
+        throw new UsageError(m.flagConflict("--no-session", sessionFlags[0] ?? ""));
     }
     if (args.apiKey !== undefined && args.model === undefined) {
-        throw new UsageError("--api-key 需要同时给出 --model");
+        throw new UsageError(m.apiKeyNeedsModel);
     }
     if (args.outputFormat !== undefined && !args.print) {
-        throw new UsageError("--output-format 只用于 -p / --print");
+        throw new UsageError(m.printOnly("--output-format"));
     }
     if (args.systemPromptMode !== undefined && args.systemPrompt === undefined) {
-        throw new UsageError("--system-prompt-mode 需要同时给出 --system-prompt");
+        throw new UsageError(m.systemPromptModeNeedsPrompt);
     }
     if (args.maxTurns !== undefined && !args.print) {
-        throw new UsageError("--max-turns 只用于 -p / --print");
+        throw new UsageError(m.printOnly("--max-turns"));
     }
     if (args.noStdin && !args.print)
-        throw new UsageError("--no-stdin 只用于 -p / --print");
+        throw new UsageError(m.printOnly("--no-stdin"));
     if (args.noStdin && args.stdin)
-        throw new UsageError("--no-stdin 与位置参数 - 不能同时使用");
+        throw new UsageError(m.noStdinWithDash);
     if (args.stdin && !args.print) {
-        throw new UsageError("位置参数 - （从 stdin 读提示）只用于 -p / --print");
+        throw new UsageError(m.dashPrintOnly);
     }
     if (args.images.length > 0 && !args.print) {
-        throw new UsageError("--image 只用于 -p / --print（交互界面里写 @图片路径）");
+        throw new UsageError(m.imagePrintOnly);
     }
 }
 /** 解析 argv（不含 node 与脚本路径）；用法错误抛 UsageError（退出码 2）。 */
 export function parseArgs(argv) {
-    const first = argv[0];
+    const lead = leadingLang(argv);
+    const first = argv[lead.next];
     if (first !== undefined && SUBCOMMANDS.includes(first)) {
-        return { kind: "subcommand", name: first, argv: argv.slice(1) };
+        return {
+            kind: "subcommand",
+            name: first,
+            argv: argv.slice(lead.next + 1),
+            ...(lead.lang !== undefined ? { lang: lead.lang } : {}),
+        };
     }
     const args = emptyArgs();
     for (let i = 0; i < argv.length; i++) {
@@ -325,7 +348,7 @@ export function parseArgs(argv) {
         else {
             const alias = FLAG_ALIASES[token];
             if (alias === undefined)
-                throw new UsageError(`未知选项：${token}`);
+                throw new UsageError(msg().cli.args.unknownOption(token));
             name = alias;
         }
         if (name === "resume") {
@@ -333,7 +356,7 @@ export function parseArgs(argv) {
             const next = argv[i + 1];
             if (inline !== undefined) {
                 if (inline === "")
-                    throw new UsageError("--resume= 的 id 不能为空");
+                    throw new UsageError(msg().cli.args.emptyResumeId);
                 args.resumeId = inline;
             }
             else if (next !== undefined && SESSION_ID_LIKE.test(next)) {
@@ -347,16 +370,16 @@ export function parseArgs(argv) {
             if (value === undefined) {
                 value = argv[i + 1];
                 if (value === undefined)
-                    throw new UsageError(`--${name} 需要一个值`);
+                    throw new UsageError(msg().cli.args.needsValue(name));
                 i++;
             }
             applyValue(args, name, value);
             continue;
         }
         if (inline !== undefined)
-            throw new UsageError(`--${name} 不接受值`);
+            throw new UsageError(msg().cli.args.noValue(name));
         if (!applyFlag(args, name))
-            throw new UsageError(`未知选项：${token}`);
+            throw new UsageError(msg().cli.args.unknownOption(token));
     }
     if (args.positionals.length > 0)
         args.prompt = args.positionals.join(" ");
@@ -364,6 +387,30 @@ export function parseArgs(argv) {
         validate(args);
     return { kind: "run", args };
 }
+/** [W6-C0] 子命令名之前的 `--lang X` / `--lang=X`（可重复，后者为准）。 */
+function leadingLang(argv) {
+    let lang;
+    let i = 0;
+    for (;;) {
+        const token = argv[i];
+        if (token === "--lang" && argv[i + 1] !== undefined) {
+            const value = argv[i + 1];
+            lang = choice("lang", value, LOCALES);
+            i += 2;
+        }
+        else if (token?.startsWith("--lang=") === true) {
+            lang = choice("lang", token.slice("--lang=".length), LOCALES);
+            i += 1;
+        }
+        else
+            break;
+    }
+    // 后面不是子命令时整段交回普通解析（--lang 照常进 ParsedArgs）
+    const next = argv[i];
+    if (next === undefined || !SUBCOMMANDS.includes(next))
+        return { next: 0 };
+    return lang === undefined ? { next: i } : { lang, next: i };
+}
 /** 子命令内部的小解析器：`--name value` / `--name=value` / 位置参数。 */
 export function parseSubArgs(argv, valueOptions, flagOptions = []) {
     const positionals = [];
@@ -387,14 +434,14 @@ export function parseSubArgs(argv, valueOptions, flagOptions = []) {
         if (valueOptions.includes(name)) {
             const value = eq === -1 ? argv[++i] : token.slice(eq + 1);
             if (value === undefined || value === "")
-                throw new UsageError(`--${name} 需要一个值`);
+                throw new UsageError(msg().cli.args.needsValue(name));
             values.set(name, value);
         }
         else if (flagOptions.includes(name) && eq === -1) {
             flags.add(name);
         }
         else {
-            throw new UsageError(`未知选项：${token}`);
+            throw new UsageError(msg().cli.args.unknownOption(token));
         }
     }
     return { positionals, values, flags };