@armadra/agent 0.5.1 → 0.6.1

package/dist/cli/help-text.js

@@ -1,102 +1,8 @@
 /**
  * `ama --help` 的文本（从 args.ts 搬出，args.ts 再导出）。[W5-C0]
+ * [W6-I1] 文本进消息目录（`msg().cli.help`），按界面语言取；不能是模块级常量（会按 import 时的语言定死）。
  */
-export const HELP_TEXT = `用法：ama [选项] [提示]
-      ama <子命令> …
-
-模式
-  （缺省）                     终端界面；stdin / stdout 非 TTY 或 TERM=dumb 时自动降级为行式
-  --no-tui                     行式界面（readline + 括号粘贴）
-  -p, --print                  非交互：执行提示后退出。提示 = 参数 + stdin 管道内容；有提示参数时
-                               只等管道首字节 2 s（AMA_STDIN_WAIT_MS），没收到就忽略并提示；
-                               末尾加 - 则一直等到 EOF（如 npm test | ama -p 找原因 -）
-  --no-stdin                   -p 不读 stdin（父进程留着管道、又不想等 2 s 时）
-  --output-format <格式>       -p 的输出：text（缺省）| json | stream-json
-  --max-turns <N>              -p 最多跑 N 轮（一次模型请求加其工具执行算一轮）；到达上限仍有
-                               未完成的工具调用时提前结束，退出码 8
-  --image <文件>               -p 随提示发送图片（可重复；png / jpg / gif / webp，单张 ≤ 5 MB）；
-                               交互界面里写 @图片路径 或粘贴图片路径
-  --mode rpc                   stdio JSONL 协议（供嵌入）
-  --mode acp                   ACP 服务端（供 Zed / JetBrains / Armadra 驱动）
-  --max-cost <USD>             一次运行的美元上限（按目录价估算）；到限结束运行，-p 退出码 8
-  --tui-mode <模式>            显示模式，第一期只有 regular（主屏）
-  --quiet-startup <档>         启动画面：normal | header | silent
-
-模型
-  --model <provider/id>        模型（可配合 --provider 只写 id；@渠道 指定渠道，如 packy/kimi-k2.5@messages）
-  --provider <id>              供应商（必须同时给 --model）
-  --api-key <key>              只用于本次启动的 key（需要 --model；优先用 ama auth set）
-  --thinking <级别>            off | minimal | low | medium | high | xhigh
-
-会话
-  -c, --continue               继续本目录最近的会话
-  -r, --resume [id]            恢复会话（交互模式无 id 时弹选择器）
-  --session-id <id>            使用指定 id 的会话（不存在则新建）
-  --fork <id>                  从指定会话分叉出新会话
-  --session-dir <目录>         会话目录（缺省 ~/.local/share/ama/sessions）
-  --no-session                 会话只在内存里，不写会话文件（之后无法 --resume）
-  --from <id>[#编号]           用旧会话的一条用户消息作提示（缺省最后一条；-p 时连图片一起；
-                               编号见 ama sessions show）
-
-权限与信任
-  --permission-mode <模式>     default | auto-edit | plan | auto | full-auto | allowlist
-                               （auto 由 ama 判断每一步；allowlist 只放行 allow 规则命中的，适合 CI）
-  --allow <规则>               追加允许规则，可重复（如 "bash(git status*)"）
-  --deny <规则>                追加拒绝规则，可重复（如 "write(**/.env*)"）
-  --trust / --no-trust         信任 / 不信任当前项目（项目级 Hook、Skill、提示模板）
-
-资源
-  --system-prompt <文本|@文件> 追加系统提示：缺省作为最后一条规则追加（工具表等前缀不变，利于缓存）
-  --system-prompt-mode <方式>  append（缺省）| replace（替换开头的角色说明，工具与项目上下文保留）
-  --profile <文件>             宿主 profile.json（字段等价于对应参数，命令行优先）
-  --host <模块>                宿主适配器模块（CJS / ESM）
-  --instructions <文件>        追加指令文件，可重复
-  --skill-dir <目录>           追加 Skill 目录，可重复
-  --agent-dir <目录>           追加子 Agent 定义目录，可重复
-  --auth-file <文件>           auth.json 位置（缺省 ~/.config/ama/auth.json）
-  --tools <a,b,…>              只启用这些工具
-  --exclude-tools <a,b,…>      禁用这些工具
-  --tools-preset <名>          工具预设：default（缺省）| minimal | codemode-only | coordinator
-                               （codemode 是 codemode-only 的旧名，仍可用）
-  --codemode <模式>            codemode 调用方式：off | on | only（缺省随预设）
-
-子命令
-  ama auth set <provider>      从 stdin 读取 key 写入 auth.json（0600）
-  ama auth list                列出已保存 key 的供应商（不显示 key）
-  ama auth remove <provider>   删除已保存的 key
-  ama sessions list|show|prune 会话管理
-  ama sessions search <关键词|/正则/> [--all] [--role user|assistant|tool] [--since 7d] [--limit N]
-                               跨会话全文检索
-  ama sessions export <id> [--format md|json|jsonl] [--output <文件>] [--branch leaf|all]
-                               导出会话（已脱敏）
-  ama models list [--provider <id>]  列出模型（含来源与 key 状态）
-  ama models check <provider/id>     发一次最小请求检查可用性
-  ama models discover <provider> [--probe] [--write] [--limit N]
-                               从中转 /v1/models 列出模型，探测协议并写入配置
-  ama models refresh [--provider <id>]  联网刷新 models.dev 元数据到数据目录（启动不联网；
-                               旧名 refresh-catalog）
-  ama providers add <id> --base-url <url> [--key-env VAR] [--probe] [--channel n=api@url] [--yes]
-                               一键接入：列模型、补 models.dev 元数据、探测渠道、写入配置
-  ama providers list|channels <id>|remove <id>|refresh <id>
-                               供应商 → 渠道 → 模型；删除；重拉模型列表
-  ama models cache-probe <provider/id> [--tokens N] [--gap-ms MS] [--yes] [--json]
-                               判断端点是否报告缓存命中
-  ama doctor                   配置层级、信任、key 来源、Hook、终端能力
-  ama config show [--json]     生效配置与每项来源、将使用的模型
-  ama config path              配置目录、数据目录与各文件路径
-  ama config edit              用 $VISUAL / $EDITOR 打开 config.json
-  ama init [--force]           建配置目录（0700）与 config.json、config.schema.json；已有的不覆盖
-  ama stats [--since 7d] [--by day|week|month|provider|channel|model|project] [--all] [--json]
-                               跨会话统计：请求、token、缓存命中率、费用、工具调用
-
-其它
-  -h, --help                   输出本帮助
-  -v, --version                输出版本
-
-退出码：0 正常 · 1 运行期错误 · 2 用法错误 · 3 配置错误 · 4 无可用模型或 key ·
-        5 会话错误 · 6 宿主 / Hook 启动失败 · 7 -p 有工具调用被拒（无人审批；用
-        --permission-mode auto-edit|auto 或 --allow 放行）· 8 -p 到达预算上限 ·
-        9 -p 的计划已落盘待审批（plan.unattended: approve 则自动批准执行）·
-        78 宿主 API 版本不匹配 ·
-        130 SIGINT · 143 SIGTERM
-`;
+import { msg } from "../i18n/index.js";
+export function helpText() {
+    return msg().cli.help;
+}

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>;