@armadra/agent 0.5.1 → 0.6.0

package/dist/cli/main.d.ts

@@ -14,8 +14,11 @@
  *   `createRuntimeDeps()`（cli/compose.ts，动态 import）。
  * - 签名 `main(argv): Promise<number>` 与「直接执行才自动运行」判定保持不变：
  *   src/bundle.ts 显式调用 `main()`。
+ * - [W6-C0] 界面语言在解析参数后、任何输出前定一次：`AMA_LANG` > `--lang` > 用户级 `ui.language` >
+ *   `LC_ALL` / `LC_MESSAGES` / `LANG`（docs/i18n.md）；profile / 项目级的 `ui.language` 由 bootstrap 合并后补定。
  */
 import type { CliIo, RuntimeDeps, StdinKind } from "./deps.js";
+import { type LanguageSetting } from "../i18n/index.js";
 /** 集成批次注入运行时实现（B1 / B2 / B3 / B6 / B7）。 */
 export declare function registerRuntimeDeps(deps: RuntimeDeps | undefined): void;
 export interface MainOptions {
@@ -31,4 +34,6 @@ export declare function stdinKindDefault(): StdinKind;
 /** 等 stdin 首字节至多 `timeoutMs`；超时则停止读取并返回 undefined，否则读到 EOF。 */
 export declare function readStdinFirstByteDefault(timeoutMs: number): Promise<string | undefined>;
 export declare function defaultIo(): CliIo;
+/** 用户级 config.json 的 `ui.language`（只读、不校验、读不到当未设；完整校验在 bootstrap）。 */
+export declare function peekUserLanguage(env: NodeJS.ProcessEnv): LanguageSetting | undefined;
 export declare function main(argv: readonly string[], options?: MainOptions): Promise<number>;

package/dist/cli/main.js

@@ -14,8 +14,11 @@
  *   `createRuntimeDeps()`（cli/compose.ts，动态 import）。
  * - 签名 `main(argv): Promise<number>` 与「直接执行才自动运行」判定保持不变：
  *   src/bundle.ts 显式调用 `main()`。
+ * - [W6-C0] 界面语言在解析参数后、任何输出前定一次：`AMA_LANG` > `--lang` > 用户级 `ui.language` >
+ *   `LC_ALL` / `LC_MESSAGES` / `LANG`（docs/i18n.md）；profile / 项目级的 `ui.language` 由 bootstrap 合并后补定。
  */
-import { fstatSync, realpathSync } from "node:fs";
+import { fstatSync, readFileSync, realpathSync } from "node:fs";
+import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { AMA_VERSION } from "../version.js";
 import { parseArgs } from "./args.js";
@@ -32,6 +35,7 @@ import { resolveConfigDir } from "../config/paths.js";
 import { runSessions } from "./subcommands/sessions.js";
 import { runStats } from "./subcommands/stats.js";
 import { enableEnvProxy, proxyHint } from "./proxy.js";
+import { msg, resolveLocale, setLocale } from "../i18n/index.js";
 let registeredDeps;
 /** 集成批次注入运行时实现（B1 / B2 / B3 / B6 / B7）。 */
 export function registerRuntimeDeps(deps) {
@@ -145,6 +149,17 @@ export function defaultIo() {
         stdinKind: stdinKindDefault,
     };
 }
+/** 用户级 config.json 的 `ui.language`（只读、不校验、读不到当未设；完整校验在 bootstrap）。 */
+export function peekUserLanguage(env) {
+    try {
+        const raw = readFileSync(join(resolveConfigDir({ env }), "config.json"), "utf8");
+        const value = JSON.parse(raw).ui?.language;
+        return value === "auto" || value === "zh" || value === "en" ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 let hooksInstalled = false;
 function installProcessHooks(io) {
     if (hooksInstalled)
@@ -152,7 +167,7 @@ function installProcessHooks(io) {
     hooksInstalled = true;
     const fatal = (error) => {
         const message = error instanceof Error ? (error.stack ?? error.message) : String(error);
-        io.stderr(`ama: 未捕获的异常：${message.split("\n")[0] ?? ""}\n`);
+        io.stderr(msg().cli.main.uncaught(message.split("\n")[0] ?? ""));
         process.exit(ExitCode.RuntimeError);
     };
     process.on("uncaughtException", fatal);
@@ -181,6 +196,8 @@ export async function main(argv, options = {}) {
         });
     try {
         const parsed = parseArgs(argv);
+        const cliLang = parsed.kind === "run" ? parsed.args.lang : parsed.lang;
+        setLocale(resolveLocale(io.env, { language: peekUserLanguage(io.env) }, cliLang));
         if (parsed.kind !== "subcommand")
             noTui = parsed.args.noTui;
         const informational = parsed.kind === "run" ? parsed.args.help || parsed.args.version : parsed.name === "init";
@@ -214,6 +231,8 @@ export async function main(argv, options = {}) {
                     return runInit(parsed.argv, io);
                 case "stats":
                     return await runStats(parsed.argv, io);
+                case "memory":
+                    return await (await import("./subcommands/memory.js")).runMemory(parsed.argv, io);
             }
         }
         if (parsed.args.version) {

package/dist/cli/proxy.js

@@ -10,6 +10,7 @@
  * `ama doctor` 用 `describeProxy()` 显示同一份状态；代理 URL 里的账号密码打码。
  */
 import * as http from "node:http";
+import { msg } from "../i18n/index.js";
 function pick(env, name) {
     const value = env[name.toLowerCase()] ?? env[name.toUpperCase()];
     return value !== undefined && value.trim() !== "" ? value.trim() : undefined;
@@ -58,7 +59,11 @@ export function inspectProxy(env, runtime = defaultProxyRuntime()) {
         return { env: proxy, state: "unsupported" };
     for (const value of [proxy.httpsProxy, proxy.httpProxy]) {
         if (value !== undefined && !URL.canParse(value))
-            return { env: proxy, state: "invalid", error: `无法解析 ${redactProxyUrl(value)}` };
+            return {
+                env: proxy,
+                state: "invalid",
+                error: msg().cli.proxy.unparsable(redactProxyUrl(value)),
+            };
     }
     return { env: proxy, state: "enabled" };
 }
@@ -104,12 +109,11 @@ export function proxyHint(status, nodeVersion = process.versions.node) {
         return undefined;
     if (status.state === "unsupported") {
         hinted = true;
-        return (`ama: 检测到 HTTPS_PROXY / HTTP_PROXY，但 Node ${nodeVersion} 的 fetch 不读代理变量，请求将直连；` +
-            "升级到 Node 24+，或在 Node 22.21+ 上设 NODE_USE_ENV_PROXY=1\n");
+        return msg().cli.proxy.unsupportedHint(nodeVersion);
     }
     if (status.state === "invalid") {
         hinted = true;
-        return `ama: 代理变量无法解析，请求将直连：${status.error ?? ""}\n`;
+        return msg().cli.proxy.invalidHint(status.error ?? "");
     }
     return undefined;
 }
@@ -123,12 +127,13 @@ export function describeProxy(status) {
         lines.push(`HTTP_PROXY=${redactProxyUrl(env.httpProxy)}`);
     if (env.noProxy !== undefined)
         lines.push(`NO_PROXY=${env.noProxy}`);
+    const m = msg().cli.proxy.state;
     const state = {
-        none: "未设置代理变量：直连",
-        runtime: "已启用（Node 按 NODE_USE_ENV_PROXY / --use-env-proxy 接管）",
-        enabled: "已启用（ama 启动时调用 Node 内置的 setGlobalProxyFromEnv）",
-        unsupported: `✗ 当前 Node ${process.versions.node} 不支持内置代理，请求直连；升级到 Node 24+`,
-        invalid: `✗ 代理变量无法解析：${status.error ?? ""}`,
+        none: m.none,
+        runtime: m.runtime,
+        enabled: m.enabled,
+        unsupported: m.unsupported(process.versions.node),
+        invalid: m.invalid(status.error ?? ""),
     };
     lines.push(state[status.state]);
     return lines;

package/dist/cli/runtime.d.ts

@@ -83,6 +83,11 @@ export interface Runtime {
     readonly tools: ToolRegistryApi;
     readonly approvals: RuntimeApprovals;
     readonly notifier: RuntimeNotifier;
+    /**
+     * [W6-S] 换上重新合并的配置（`/config` 改完立即写盘后调用）：`config` 与之后 `/new` / `/resume` 组装的
+     * 会话读新值；已在运行的会话不受影响（「即时」档由界面另行热应用）。SDK 组装的运行时可以没有。
+     */
+    replaceConfig?(config: AmaConfig): void;
     /** 启动期收集的 warning（被忽略的放宽项、文件读错等）。 */
     readonly warnings: readonly string[];
     /** 发 session_shutdown、SessionEnd Hook、适配器 dispose；幂等。 */

package/dist/cli/startup-screen.js

@@ -14,25 +14,19 @@ import { isBuiltinSkill } from "../skills/builtin.js";
 import { basename } from "node:path";
 import { formatModelRef } from "../ai/providers/channels.js";
 import { effectiveCodemodeMode } from "../tools/presets.js";
+import { msg } from "../i18n/index.js";
 import { AMA_VERSION } from "../version.js";
 export function startupScreenLevel(runtime) {
     return runtime.config.ui?.quietStartup ?? "normal";
 }
 export function headerLine() {
-    return `ama ${AMA_VERSION} · Enter 发送 · Esc 中断 · Ctrl+C 两次退出 · /help 命令`;
+    return msg().cli.startupScreen.header(AMA_VERSION);
 }
 function trustText(runtime) {
     const { trusted, source, matchedPath } = runtime.trust;
-    const from = source === "flag"
-        ? "命令行"
-        : source === "trust-file"
-            ? `trust.json${matchedPath === undefined ? "" : ` ${matchedPath}`}`
-            : source === "prompt"
-                ? "本次确认"
-                : source === "profile"
-                    ? "profile"
-                    : "缺省";
-    return `${trusted ? "已信任" : "未信任"}（${from}）`;
+    const label = trustSourceLabel(source);
+    const from = source === "trust-file" && matchedPath !== undefined ? `${label} ${matchedPath}` : label;
+    return msg().cli.startupScreen.trust(trusted, from);
 }
 export function buildStartupScreen(runtime, level = startupScreenLevel(runtime)) {
     if (level === "silent")
@@ -41,34 +35,33 @@ export function buildStartupScreen(runtime, level = startupScreenLevel(runtime))
     if (level === "header")
         return lines;
     const { resources } = runtime;
-    lines.push(`模型：${runtime.model.provider}/${runtime.model.id} · 思考 ${runtime.thinkingLevel}`);
-    lines.push(`目录：${runtime.paths.cwd} · ${trustText(runtime)}`);
+    const m = msg().cli.startupScreen;
+    lines.push(m.model(`${runtime.model.provider}/${runtime.model.id}`, runtime.thinkingLevel));
+    lines.push(m.cwd(runtime.paths.cwd, trustText(runtime)));
     if (resources.contextFiles.length > 0) {
-        lines.push(`上下文：${resources.contextFiles.map((f) => f.path).join(", ")}`);
+        lines.push(m.context(resources.contextFiles.map((f) => f.path)));
     }
     const skills = resources.skills.filter((s) => !isBuiltinSkill(s));
     if (skills.length > 0) {
-        lines.push(`Skill：${skills.map((s) => s.name).join(", ")}`);
+        lines.push(m.skills(skills.map((s) => s.name)));
     }
     if (resources.prompts.length > 0) {
-        lines.push(`提示模板：${resources.prompts.map((p) => `/${p.name}`).join(" ")}`);
+        lines.push(m.prompts(resources.prompts.map((p) => `/${p.name}`)));
     }
     const hooks = runtime.hooks.list();
     if (hooks.length > 0)
-        lines.push(`Hook：${hooks.length} 条`);
+        lines.push(m.hooks(hooks.length));
     if (runtime.host !== undefined)
-        lines.push(`宿主：${runtime.host.adapter.id}`);
+        lines.push(m.host(runtime.host.adapter.id));
     if (runtime.warnings.length > 0)
-        lines.push(`警告：${runtime.warnings.length} 条（ama doctor 查看）`);
+        lines.push(m.warnings(runtime.warnings.length));
     return lines;
 }
-const TRUST_SOURCE = {
-    flag: "命令行",
-    "trust-file": "trust.json",
-    prompt: "本次确认",
-    profile: "profile",
-    default: "缺省",
-};
+/** 信任来源的短名（按界面语言）。 */
+function trustSourceLabel(source) {
+    const labels = msg().cli.startupScreen.trustSource;
+    return source === "trust-file" ? labels.trustFile : labels[source];
+}
 /** 家目录前缀缩写为 `~`（`/` 与 `\` 两种分隔都认，余下部分原样保留）。 */
 export function tildePath(path, home) {
     if (home === undefined || home === "")
@@ -89,7 +82,7 @@ export function startupInfo(runtime, home) {
         thinking: runtime.thinkingLevel,
         cwd: tildePath(runtime.paths.cwd, home),
         trusted: runtime.trust.trusted,
-        trustSource: TRUST_SOURCE[runtime.trust.source],
+        trustSource: trustSourceLabel(runtime.trust.source),
         permissionMode: runtime.session.state.permissionMode,
         preset: runtime.config.tools?.preset ?? "default",
         codemode: effectiveCodemodeMode(runtime.config),

package/dist/cli/startup-steps.js

@@ -11,6 +11,7 @@ import { UsageError } from "./args.js";
 import { noModelGuidance, pickDefaultModel } from "./default-model.js";
 import { hideFakeProvider } from "./fake-visibility.js";
 import { ExitCode } from "./exit-codes.js";
+import { msg } from "../i18n/index.js";
 /** 把非 StartupError 包成指定退出码；StartupError / UsageError 原样透传。 */
 export async function step(exitCode, label, fn) {
     try {
@@ -41,7 +42,7 @@ export function toStartupError(error, exitCode, label) {
         return new StartupError(error.code, error.message, mapped, { cause: error });
     }
     const message = error instanceof Error ? error.message : String(error);
-    return new StartupError("startup_failed", `${label}：${message}`, exitCode, { cause: error });
+    return new StartupError("startup_failed", msg().cli.startupSteps.stepFailed(label, message), exitCode, { cause: error });
 }
 /** 第 4 步。 */
 export function decideMode(args, io) {
@@ -106,7 +107,7 @@ export function lastEntry(manager, predicate) {
 /** 第 11 步：解析模型与 key。 */
 export async function resolveModel(args, registry, manager, defaultModel, deps, interactive, env = {}) {
     if (args.provider !== undefined && args.model === undefined) {
-        throw new UsageError(`--provider ${args.provider} 需要同时给出 --model（不回退到该供应商的缺省模型）`);
+        throw new UsageError(msg().cli.startupSteps.providerNeedsModel(args.provider));
     }
     const lookup = (ref, label) => {
         const found = registry.findModel(ref);
@@ -156,10 +157,7 @@ export async function resolveModel(args, registry, manager, defaultModel, deps,
     if (choice.provider.requiresApiKey) {
         const key = await registry.resolveApiKey(choice.provider.id);
         if (key.apiKey === undefined) {
-            const envs = choice.provider.envKeys.length > 0
-                ? `，或设置环境变量 ${choice.provider.envKeys.join(" / ")}`
-                : "";
-            return pick(`供应商 ${choice.provider.id} 没有 API key：运行 \`ama auth set ${choice.provider.id}\`${envs}`);
+            return pick(msg().cli.startupSteps.noApiKey(choice.provider.id, choice.provider.envKeys));
         }
     }
     return choice;
@@ -176,7 +174,7 @@ export function thinkingOf(args, manager, fallback) {
 export function applyToolFilters(args, runtimeTools) {
     const unknown = [...(args.tools ?? []), ...(args.excludeTools ?? [])].filter((n) => runtimeTools.get(n) === undefined);
     if (unknown.length > 0) {
-        throw new UsageError(`未知工具：${unknown.join(", ")}（可用：${runtimeTools.list().join(", ")}）`);
+        throw new UsageError(msg().cli.startupSteps.unknownTools(unknown, runtimeTools.list()));
     }
     if (args.tools !== undefined)
         runtimeTools.setActive(args.tools);
@@ -194,7 +192,7 @@ export function instructionSources(paths, cwd) {
             ok = false;
         }
         if (!ok)
-            throw new StartupError("config_invalid", `--instructions 文件不存在：${abs}`, ExitCode.Config);
+            throw new StartupError("config_invalid", msg().cli.startupSteps.instructionsMissing(abs), ExitCode.Config);
         return { kind: "file", path: abs };
     });
 }

package/dist/cli/subcommands/auth.d.ts

@@ -1,12 +1,15 @@
 /**
  * `ama auth set|list|remove <provider>`（设计 §3.5、§16.2 B5 验收）。[B5]
+ * `ama auth login|logout|status chatgpt`（docs/wave6-plan.md §4.2）。[W6-O] 实现在 auth/chatgpt/cli.ts。
  *
  * - set：key 从 stdin 读取（TTY 下不回显），不经命令行参数，避免进 shell 历史；写 auth.json 0600。
- * - list：只列供应商与 key 形态（字面量 / `!command` / `$ENV` 引用），从不输出 key。
+ * - list：只列供应商与 key 形态（字面量 / `!command` / `$ENV` 引用 / oauth 的 flavor 与计划），从不输出 key 或 token。
  * - `--auth-file <path>` 改变目标文件（缺省 `<configDir>/auth.json`）。
  */
+import { type AuthCliDeps } from "../../auth/chatgpt/cli.js";
 import type { CliIo } from "../deps.js";
-export declare const AUTH_USAGE = "\u7528\u6CD5\uFF1Aama auth set <provider> [--auth-file <\u6587\u4EF6>]   \u4ECE stdin \u8BFB\u53D6 key\n      ama auth list [--auth-file <\u6587\u4EF6>]\n      ama auth remove <provider> [--auth-file <\u6587\u4EF6>]\n";
+/** 用法文本（按当前语言）。 */
+export declare function authUsage(): string;
 /** 取第一行并去掉首尾空白；stdin 为空返回 ""。 */
 export declare function extractKey(raw: string): string;
-export declare function runAuth(argv: readonly string[], io: CliIo): Promise<number>;
+export declare function runAuth(argv: readonly string[], io: CliIo, deps?: AuthCliDeps): Promise<number>;

package/dist/cli/subcommands/auth.js

@@ -1,28 +1,46 @@
 /**
  * `ama auth set|list|remove <provider>`（设计 §3.5、§16.2 B5 验收）。[B5]
+ * `ama auth login|logout|status chatgpt`（docs/wave6-plan.md §4.2）。[W6-O] 实现在 auth/chatgpt/cli.ts。
  *
  * - set：key 从 stdin 读取（TTY 下不回显），不经命令行参数，避免进 shell 历史；写 auth.json 0600。
- * - list：只列供应商与 key 形态（字面量 / `!command` / `$ENV` 引用），从不输出 key。
+ * - list：只列供应商与 key 形态（字面量 / `!command` / `$ENV` 引用 / oauth 的 flavor 与计划），从不输出 key 或 token。
  * - `--auth-file <path>` 改变目标文件（缺省 `<configDir>/auth.json`）。
  */
 import { resolve } from "node:path";
+import { runLogin, runLogout, runStatus } from "../../auth/chatgpt/cli.js";
 import { PROVIDER_ID_PATTERN, defaultAuthFilePath, describeAuthFile, readAuthFile, removeAuthKey, setAuthKey, } from "../../config/auth-file.js";
 import { resolveConfigDir } from "../../config/paths.js";
+import { msg } from "../../i18n/index.js";
 import { parseSubArgs, UsageError } from "../args.js";
 import { ExitCode } from "../exit-codes.js";
-export const AUTH_USAGE = `用法：ama auth set <provider> [--auth-file <文件>]   从 stdin 读取 key
-      ama auth list [--auth-file <文件>]
-      ama auth remove <provider> [--auth-file <文件>]
-`;
-const KIND_TEXT = { literal: "key", command: "!命令", "env-ref": "环境变量引用" };
+/** 用法文本（按当前语言）。 */
+export function authUsage() {
+    return msg().auth.usage;
+}
+function kindText(entry) {
+    const kind = msg().auth.kind;
+    switch (entry.kind) {
+        case "literal":
+            return kind.literal;
+        case "command":
+            return kind.command;
+        case "env-ref":
+            return kind.envRef;
+        case "oauth":
+            return entry.flavor === undefined
+                ? kind.oauth
+                : `${kind.oauth} · ${msg().auth.oauthSummary(entry.flavor, entry.plan, entry.needsLogin === true)}`;
+    }
+}
 function providerArg(positionals, action) {
+    const m = msg().auth;
     const provider = positionals[1];
     if (provider === undefined)
-        throw new UsageError(`ama auth ${action} 需要 <provider>`);
+        throw new UsageError(m.needProvider(action));
     if (positionals.length > 2)
-        throw new UsageError(`多余的参数：${positionals.slice(2).join(" ")}`);
+        throw new UsageError(m.extraArgs(positionals.slice(2).join(" ")));
     if (!PROVIDER_ID_PATTERN.test(provider))
-        throw new UsageError(`供应商 id 不合法：${provider}`);
+        throw new UsageError(m.badProvider(provider));
     return provider;
 }
 /** 取第一行并去掉首尾空白；stdin 为空返回 ""。 */
@@ -30,40 +48,52 @@ export function extractKey(raw) {
     const line = raw.split(/\r?\n/).find((l) => l.trim() !== "") ?? "";
     return line.trim();
 }
-export async function runAuth(argv, io) {
-    const { positionals, values, flags } = parseSubArgs(argv, ["auth-file"]);
+export async function runAuth(argv, io, deps = {}) {
+    const m = msg().auth;
+    const { positionals, values, flags } = parseSubArgs(argv, ["auth-file", "flavor", "port"], ["paste", "device", "no-browser", "yes"]);
     const action = positionals[0];
     if (flags.has("help") || action === undefined) {
-        io.stdout(AUTH_USAGE);
+        io.stdout(authUsage());
         return flags.has("help") ? ExitCode.Ok : ExitCode.Usage;
     }
     const explicit = values.get("auth-file");
     const path = explicit !== undefined
         ? resolve(io.cwd, explicit)
         : defaultAuthFilePath(resolveConfigDir({ env: io.env }));
+    const loginOnly = ["flavor", "port"].filter((name) => values.has(name));
+    const loginFlags = ["paste", "device", "no-browser", "yes"].filter((name) => flags.has(name));
+    if (action !== "login" && [...loginOnly, ...loginFlags].length > 0)
+        throw new UsageError(m.extraArgs([...loginOnly, ...loginFlags].map((n) => `--${n}`).join(" ")));
+    const cli = { positionals, values, flags, path };
     switch (action) {
+        case "login":
+            return runLogin(cli, io, deps);
+        case "logout":
+            return runLogout(cli, io, deps);
+        case "status":
+            return runStatus(cli, io, deps);
         case "set": {
             const provider = providerArg(positionals, "set");
             if (io.stdinIsTTY)
-                io.stderr(`输入 ${provider} 的 API key（不回显），回车结束：`);
+                io.stderr(m.setPrompt(provider));
             const key = extractKey(await io.readStdin());
             if (io.stdinIsTTY)
                 io.stderr("\n");
             if (key === "")
-                throw new UsageError("没有从 stdin 读到 key");
+                throw new UsageError(m.noKeyFromStdin);
             setAuthKey(path, provider, key);
-            io.stdout(`已保存 ${provider} 的 key → ${path}（0600）\n`);
+            io.stdout(`${m.saved(provider, path)}\n`);
             return ExitCode.Ok;
         }
         case "list": {
             if (positionals.length > 1)
-                throw new UsageError(`多余的参数：${positionals.slice(1).join(" ")}`);
+                throw new UsageError(m.extraArgs(positionals.slice(1).join(" ")));
             const result = readAuthFile(path);
             for (const warning of result.warnings)
-                io.stderr(`ama: 警告：${warning}\n`);
+                io.stderr(`${m.warning(warning)}\n`);
             const entries = describeAuthFile(result.file);
             if (entries.length === 0) {
-                io.stdout(`${path}：没有保存的 key\n`);
+                io.stdout(`${m.listEmpty(path)}\n`);
                 return ExitCode.Ok;
             }
             io.stdout(`${path}\n`);
@@ -72,20 +102,20 @@ export async function runAuth(argv, io) {
                     entry.hasBaseUrl ? "baseUrl" : undefined,
                     entry.envNames.length > 0 ? `env ${entry.envNames.join(",")}` : undefined,
                 ].filter((x) => x !== undefined);
-                io.stdout(`  ${entry.provider.padEnd(20)} ${KIND_TEXT[entry.kind]}${extra.length > 0 ? ` · ${extra.join(" · ")}` : ""}\n`);
+                io.stdout(`  ${entry.provider.padEnd(20)} ${kindText(entry)}${extra.length > 0 ? ` · ${extra.join(" · ")}` : ""}\n`);
             }
             return ExitCode.Ok;
         }
         case "remove": {
             const provider = providerArg(positionals, "remove");
             if (removeAuthKey(path, provider)) {
-                io.stdout(`已删除 ${provider} 的 key（${path}）\n`);
+                io.stdout(`${m.removed(provider, path)}\n`);
                 return ExitCode.Ok;
             }
-            io.stderr(`ama: ${path} 中没有 ${provider}\n`);
+            io.stderr(`${m.notFound(path, provider)}\n`);
             return ExitCode.RuntimeError;
         }
         default:
-            throw new UsageError(`未知的 auth 子命令：${action}`);
+            throw new UsageError(m.unknownAction(action));
     }
 }

package/dist/cli/subcommands/config-set.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `ama config get | set | unset | list` (docs/wave6-plan.md §6.4, D24-D26). [W6-S]
+ *
+ * Thin layer over config/edit.ts (the `/config` panel uses the same core):
+ * - `get <key> [--json]`: effective value, source layer and apply tier;
+ * - `set <key> <value> [--project] [--json-value] [--yes]`: write one key to the user file (or the
+ *   project file, tighten only); lists and objects need `--json-value`; `permission.mode full-auto`
+ *   asks once on a TTY and needs `--yes` otherwise;
+ * - `unset <key> [--project]`;
+ * - `list [prefix] [--json] [--all]`: panel settings (or every settable key with `--all`).
+ * Unknown keys, invalid values and refused project writes exit 3 (`ExitCode.Config`). `get` / `list`
+ * never create the config directory. `--profile <file>` adds the host profile layer to the view.
+ */
+import type { CliIo } from "../deps.js";
+export declare const CONFIG_EDIT_ACTIONS: readonly ["get", "set", "unset", "list"];
+export type ConfigEditAction = (typeof CONFIG_EDIT_ACTIONS)[number];
+export interface ConfigSetDeps {
+    /** Ask before persisting Bypass (TTY only); default: the CLI y/N prompt. */
+    confirm?(question: string): Promise<boolean>;
+}
+export declare function runConfigEdit(action: ConfigEditAction, argv: readonly string[], io: CliIo, deps?: ConfigSetDeps): Promise<number>;

package/dist/cli/subcommands/config-set.js

@@ -0,0 +1,137 @@
+/**
+ * `ama config get | set | unset | list` (docs/wave6-plan.md §6.4, D24-D26). [W6-S]
+ *
+ * Thin layer over config/edit.ts (the `/config` panel uses the same core):
+ * - `get <key> [--json]`: effective value, source layer and apply tier;
+ * - `set <key> <value> [--project] [--json-value] [--yes]`: write one key to the user file (or the
+ *   project file, tighten only); lists and objects need `--json-value`; `permission.mode full-auto`
+ *   asks once on a TTY and needs `--yes` otherwise;
+ * - `unset <key> [--project]`;
+ * - `list [prefix] [--json] [--all]`: panel settings (or every settable key with `--all`).
+ * Unknown keys, invalid values and refused project writes exit 3 (`ExitCode.Config`). `get` / `list`
+ * never create the config directory. `--profile <file>` adds the host profile layer to the view.
+ */
+import { msg } from "../../i18n/index.js";
+import { assertSettable, formatSettingValue, getConfigValue, parseValue, readSnapshot, setConfigValue, } from "../../config/edit.js";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { initConfigDir } from "../../config/init.js";
+import { CONFIG_FILE, resolveConfigDir } from "../../config/paths.js";
+import { loadProfile } from "../../config/profile.js";
+import { settableKeys, settingSpec, settingsRegistry } from "../../config/settings-registry.js";
+import { confirmContinue } from "../choice-prompt.js";
+import { parseSubArgs, UsageError } from "../args.js";
+import { ExitCode } from "../exit-codes.js";
+export const CONFIG_EDIT_ACTIONS = ["get", "set", "unset", "list"];
+function layerInput(io, profilePath) {
+    const input = {
+        configDir: resolveConfigDir({ env: io.env }),
+        cwd: io.cwd,
+        env: io.env,
+    };
+    if (profilePath !== undefined) {
+        const profile = loadProfile(profilePath, io.cwd);
+        input.profile = { config: profile.config };
+        input.hasProfile = true;
+    }
+    return input;
+}
+function applyText(key) {
+    const spec = settingSpec(key);
+    const s = msg().settings;
+    if (spec === undefined)
+        return s.cli.applyNone;
+    return spec.prefix === true ? `${s.apply[spec.apply]} · ${s.prefixTag}` : s.apply[spec.apply];
+}
+function jsonRow(value) {
+    const spec = settingSpec(value.key);
+    return {
+        key: value.key,
+        value: value.value ?? null,
+        source: value.source,
+        ...(value.envName !== undefined ? { env: value.envName } : {}),
+        apply: spec?.apply ?? null,
+        prefix: spec?.prefix === true,
+        project: spec?.project ?? null,
+    };
+}
+function textRow(value) {
+    const source = value.envName !== undefined ? `env ${value.envName}` : value.source;
+    return msg().settings.cli.getLine(value.key, formatSettingValue(value.value), source, applyText(value.key));
+}
+function scopeLabel(scope) {
+    return msg().settings.scope[scope];
+}
+function report(io, result, unset) {
+    const s = msg().settings;
+    const value = formatSettingValue(result.after.value);
+    io.stdout(`${unset
+        ? s.unsetDone(result.key, value, scopeLabel(result.scope))
+        : s.setDone(result.key, value, scopeLabel(result.scope))}\n`);
+    if (result.overriddenBy !== undefined) {
+        const by = result.after.envName ?? result.overriddenBy;
+        io.stdout(`${s.stillOverridden(result.key, by)}\n`);
+    }
+}
+/** Confirm persisting `permission.mode full-auto`: TTY asks, otherwise `--yes` is required. */
+async function confirmBypass(io, yes, deps) {
+    const s = msg().settings.cli;
+    if (yes)
+        return true;
+    if (!io.stdinIsTTY) {
+        io.stderr(`ama: ${s.needYes}\n`);
+        return false;
+    }
+    const ask = deps.confirm ?? ((question) => confirmContinue({ question, env: io.env }));
+    if (await ask(s.confirmBypass))
+        return true;
+    io.stderr(`${s.cancelled}\n`);
+    return false;
+}
+export async function runConfigEdit(action, argv, io, deps = {}) {
+    const { positionals, values, flags } = parseSubArgs(argv, ["profile"], ["json", "project", "json-value", "yes", "all"]);
+    const s = msg().settings;
+    if (flags.has("help")) {
+        io.stdout(s.cli.usage);
+        return ExitCode.Ok;
+    }
+    const input = layerInput(io, values.get("profile"));
+    const scope = flags.has("project") ? "project" : "user";
+    if (action === "list") {
+        const snapshot = readSnapshot(input);
+        const prefix = positionals[0] ?? "";
+        const keys = (flags.has("all") ? settableKeys() : settingsRegistry().map((spec) => spec.key)).filter((key) => key.startsWith(prefix));
+        const rows = keys.map((key) => getConfigValue(snapshot, key));
+        if (flags.has("json"))
+            io.stdout(`${JSON.stringify(rows.map(jsonRow), null, 2)}\n`);
+        else
+            io.stdout(`${[s.cli.listHeader, ...rows.map((r) => `  ${textRow(r)}`)].join("\n")}\n`);
+        return ExitCode.Ok;
+    }
+    const key = positionals[0];
+    if (key === undefined)
+        throw new UsageError(s.cli.missingKey);
+    if (action === "get") {
+        assertSettable(key);
+        const value = getConfigValue(readSnapshot(input), key);
+        io.stdout(flags.has("json") ? `${JSON.stringify(jsonRow(value), null, 2)}\n` : `${textRow(value)}\n`);
+        return ExitCode.Ok;
+    }
+    if (action === "unset") {
+        report(io, setConfigValue({ ...input, scope, key, value: undefined }), true);
+        return ExitCode.Ok;
+    }
+    const raw = positionals.slice(1).join(" ");
+    if (positionals.length < 2)
+        throw new UsageError(s.cli.missingValue);
+    const value = parseValue(key, raw, flags.has("json-value"));
+    if (key === "permission.mode" && value === "full-auto" && scope === "user") {
+        if (!(await confirmBypass(io, flags.has("yes"), deps)))
+            return ExitCode.Config;
+    }
+    // first write to a fresh config dir: lay out config.json + config.schema.json like `ama init`
+    if (scope === "user" && !existsSync(join(input.configDir, CONFIG_FILE)))
+        initConfigDir(input.configDir);
+    report(io, setConfigValue({ ...input, scope, key, value }), value === undefined);
+    return ExitCode.Ok;
+}

package/dist/cli/subcommands/config.d.ts

@@ -14,7 +14,8 @@
 import { type AmaConfig, type CodemodeMode } from "../../config/types.js";
 import type { Api, ProviderRegistryApi } from "../../ai/types.js";
 import type { CliIo, RuntimeDeps } from "../deps.js";
-export declare const CONFIG_USAGE = "\u7528\u6CD5\uFF1Aama config show [--json] [--profile <\u6587\u4EF6>] [--auth-file <\u6587\u4EF6>]\n                        [--tools-preset <\u540D>] [--codemode off|on|only]\n      ama config path    \u914D\u7F6E\u76EE\u5F55\u3001\u6570\u636E\u76EE\u5F55\u4E0E\u5404\u6587\u4EF6\u8DEF\u5F84\n      ama config edit    \u7528 $VISUAL / $EDITOR \u6253\u5F00 config.json\uFF08\u6CA1\u6709\u7F16\u8F91\u5668\u65F6\u6253\u5370\u8DEF\u5F84\uFF09\n";
+/** `ama config --help` 的前半（get / set 等编辑子命令的用法接在后面）。 */
+export declare const configUsage: () => string;
 type Layer = {
     name: "default" | "user" | "profile" | "project" | "cli";
     label: string;