@armadra/agent 0.5.1 → 0.6.0

package/dist/config/checker.js

@@ -1,6 +1,7 @@
 /**
  * 配置校验的诊断收集器（从 schema.ts 抽出，schema-w5.ts 共用）。[W5-C0]
  */
+import { msg } from "../i18n/index.js";
 export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
 export class Checker {
     diagnostics = [];
@@ -13,44 +14,44 @@ export class Checker {
     object(value, path) {
         if (typeof value === "object" && value !== null && !Array.isArray(value))
             return true;
-        this.error(path, "应为对象");
+        this.error(path, msg().config.schema.object);
         return false;
     }
     /** 未知字段只警告（前向兼容）。 */
     keys(value, path, allowed) {
         for (const key of Object.keys(value)) {
             if (!allowed.includes(key))
-                this.warn(join(path, key), "未知字段，已忽略");
+                this.warn(join(path, key), msg().config.schema.unknownKey);
         }
     }
     version(value, path) {
         if (value["version"] !== 1)
-            this.error(join(path, "version"), "version 必须为 1");
+            this.error(join(path, "version"), msg().config.schema.version);
     }
     string(value, key, path, required = false) {
         const v = value[key];
         if (v === undefined) {
             if (required)
-                this.error(join(path, key), "缺少必填字符串");
+                this.error(join(path, key), msg().config.schema.requiredString);
             return;
         }
         if (typeof v !== "string")
-            this.error(join(path, key), "应为字符串");
+            this.error(join(path, key), msg().config.schema.string);
     }
     boolean(value, key, path) {
         const v = value[key];
         if (v !== undefined && typeof v !== "boolean")
-            this.error(join(path, key), "应为布尔值");
+            this.error(join(path, key), msg().config.schema.boolean);
     }
     number(value, key, path, min = 0, max = Number.MAX_SAFE_INTEGER) {
         const v = value[key];
         if (v === undefined)
             return;
         if (typeof v !== "number" || !Number.isFinite(v)) {
-            this.error(join(path, key), "应为数字");
+            this.error(join(path, key), msg().config.schema.number);
         }
         else if (v < min || v > max) {
-            this.error(join(path, key), `应在 ${min}–${max} 之间`);
+            this.error(join(path, key), msg().config.schema.range(min, max));
         }
     }
     oneOf(value, key, path, choices) {
@@ -58,7 +59,7 @@ export class Checker {
         if (v === undefined)
             return;
         if (typeof v !== "string" || !choices.includes(v)) {
-            this.error(join(path, key), `取值应为 ${choices.join(" | ")}`);
+            this.error(join(path, key), msg().config.schema.oneOf(choices));
         }
     }
     stringArray(value, key, path) {
@@ -66,7 +67,7 @@ export class Checker {
         if (v === undefined)
             return;
         if (!Array.isArray(v) || v.some((item) => typeof item !== "string")) {
-            this.error(join(path, key), "应为字符串数组");
+            this.error(join(path, key), msg().config.schema.stringArray);
         }
     }
     stringRecord(value, key, path) {
@@ -77,7 +78,7 @@ export class Checker {
             return;
         for (const [k, item] of Object.entries(v)) {
             if (typeof item !== "string")
-                this.error(join(join(path, key), k), "应为字符串");
+                this.error(join(join(path, key), k), msg().config.schema.string);
         }
     }
 }

package/dist/config/context-files.js

@@ -10,6 +10,7 @@
  */
 import { readFileSync, realpathSync, statSync } from "node:fs";
 import { join } from "node:path";
+import { msg } from "../i18n/index.js";
 import { ancestorsOf } from "./trust.js";
 export const CONTEXT_FILE_NAMES = ["AGENTS.override.md", "AGENTS.md", "AGENTS.MD"];
 function isFile(path) {
@@ -51,12 +52,12 @@ export function findContextFiles(input) {
             content = readFileSync(path, "utf8");
         }
         catch (error) {
-            warnings.push(`${path}: 读取失败（${error.message}）`);
+            warnings.push(msg().config.context.readFailed(path, error.message));
             return;
         }
         if (Buffer.byteLength(content) > maxBytes) {
             content = Buffer.from(content).subarray(0, maxBytes).toString("utf8");
-            warnings.push(`${path}: 超过 ${maxBytes} 字节，已截断`);
+            warnings.push(msg().config.context.truncated(path, maxBytes));
         }
         if (seenContent.has(content))
             return;

package/dist/config/edit.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Settings edit core (docs/wave6-plan.md §6.2, D24-D26). [W6-S]
+ *
+ * Shared by the `/config` panel, `/config key=value` and `ama config get | set | unset | list`:
+ * - `readSnapshot()` reads the user and project files fresh and merges them with the profile / command
+ *   line layers the same way bootstrap does (default <- user <- profile <- project, tighten only <- cli);
+ * - `getConfigValue()` gives the effective value of a key and which layer it came from (env vars that
+ *   override a key count as a layer `env`);
+ * - `setConfigValue()` / `unsetConfigValue()` re-read the target file right before writing, change one
+ *   path, run `validateConfig`, check project writes with `restrictProjectConfig` (anything that would be
+ *   ignored there -- a loosening or a user-only key -- is refused), then write atomically with `.bak`
+ *   (`writeConfigFile`). Refusals leave the file byte-for-byte untouched.
+ * There is no file lock: a concurrent `ama config edit` between our read and write is lost (R12).
+ */
+import { AmaError } from "../errors.js";
+import { type CliConfigOverrides, type ConfigLayerName } from "./merge.js";
+import { type SettingApply } from "./settings-registry.js";
+import { type AmaConfig } from "./types.js";
+export type SettingSource = ConfigLayerName | "env";
+export type EditScope = "user" | "project";
+export type ConfigEditCode = "config_unknown_key" | "config_invalid_value" | "config_project_denied" | "config_locked" | "config_read_failed" | "config_write_failed";
+/** Refused edit; `exitCode` 3 (`ExitCode.Config`) except write failures (1). */
+export declare class ConfigEditError extends AmaError {
+    readonly code: ConfigEditCode;
+    constructor(code: ConfigEditCode, message: string);
+}
+type Env = Readonly<Record<string, string | undefined>>;
+type Obj = Record<string, unknown>;
+export interface ConfigLayerInput {
+    /** User config directory (`AMA_CONFIG_DIR` / XDG). */
+    configDir: string;
+    /** Project root (`.ama/config.json` lives here). */
+    cwd: string;
+    env: Env;
+    /** Embedded host profile: its `config` layer (PROFILE_DEFAULTS are added when `hasProfile`). */
+    profile?: {
+        config?: AmaConfig | undefined;
+    } | undefined;
+    hasProfile?: boolean;
+    /** Command line overrides of this process. */
+    cli?: CliConfigOverrides | undefined;
+}
+export interface ConfigSnapshot {
+    input: ConfigLayerInput;
+    userPath: string;
+    projectPath: string;
+    user: AmaConfig | undefined;
+    project: AmaConfig | undefined;
+    /** default <- user <- profile (the baseline project-level tightening is measured against). */
+    base: AmaConfig;
+    /** Effective config (what bootstrap would build now). */
+    config: AmaConfig;
+    /** Each layer as it contributes (project = accepted part only), lowest first. */
+    layers: readonly {
+        name: ConfigLayerName;
+        value: unknown;
+    }[];
+}
+export interface SettingValue {
+    key: string;
+    /** Effective value (built-in default when no layer sets it; undefined = unset / decided at run time). */
+    value: unknown;
+    source: SettingSource;
+    /** Env var that overrides it (when source is `env`). */
+    envName?: string;
+}
+export interface EditResult {
+    key: string;
+    scope: EditScope;
+    path: string;
+    before: SettingValue;
+    after: SettingValue;
+    apply: SettingApply | undefined;
+    /** The key changes the cache prefix and its effective value changed. */
+    prefixChanged: boolean;
+    /** The written value is still hidden by a higher layer. */
+    overriddenBy: SettingSource | undefined;
+    snapshot: ConfigSnapshot;
+}
+export declare function getPath(value: unknown, key: string): unknown;
+/** Set (or with `undefined` delete) one dotted path; empty parent objects are removed. */
+export declare function setPath(target: Obj, key: string, value: unknown): void;
+/** Read both files and merge all layers. */
+export declare function readSnapshot(input: ConfigLayerInput): ConfigSnapshot;
+/** Effective value and source of one key. */
+export declare function getConfigValue(snapshot: ConfigSnapshot, key: string): SettingValue;
+export declare function overriddenFor(value: SettingValue, scope: EditScope): SettingSource | undefined;
+/** Throws `config_unknown_key` unless `ama config set` accepts the key. */
+export declare function assertSettable(key: string): void;
+/**
+ * Parse a command line / panel value. `undefined` means unset (`none`, `unset`; `default` too unless it
+ * is a valid enum value). `jsonValue` takes JSON (lists and objects need it).
+ */
+export declare function parseValue(key: string, raw: string, jsonValue?: boolean): unknown;
+export interface SetOptions extends ConfigLayerInput {
+    scope: EditScope;
+    key: string;
+    /** Parsed value; `undefined` unsets. */
+    value: unknown;
+}
+/** Write one key into the user or project file (or unset it with `value: undefined`). */
+export declare function setConfigValue(options: SetOptions): EditResult;
+export declare function unsetConfigValue(options: Omit<SetOptions, "value">): EditResult;
+/** Display text of a value (JSON for lists / objects, plain otherwise). */
+export declare function formatSettingValue(value: unknown): string;
+export {};

package/dist/config/edit.js

@@ -0,0 +1,350 @@
+/**
+ * Settings edit core (docs/wave6-plan.md §6.2, D24-D26). [W6-S]
+ *
+ * Shared by the `/config` panel, `/config key=value` and `ama config get | set | unset | list`:
+ * - `readSnapshot()` reads the user and project files fresh and merges them with the profile / command
+ *   line layers the same way bootstrap does (default <- user <- profile <- project, tighten only <- cli);
+ * - `getConfigValue()` gives the effective value of a key and which layer it came from (env vars that
+ *   override a key count as a layer `env`);
+ * - `setConfigValue()` / `unsetConfigValue()` re-read the target file right before writing, change one
+ *   path, run `validateConfig`, check project writes with `restrictProjectConfig` (anything that would be
+ *   ignored there -- a loosening or a user-only key -- is refused), then write atomically with `.bak`
+ *   (`writeConfigFile`). Refusals leave the file byte-for-byte untouched.
+ * There is no file lock: a concurrent `ama config edit` between our read and write is lost (R12).
+ */
+import { readFileSync } from "node:fs";
+import { AmaError } from "../errors.js";
+import { msg } from "../i18n/index.js";
+import { minimalConfig } from "./init.js";
+import { DISPLAY_DEFAULTS } from "./key-docs.js";
+import { loadConfigFile, parseJsonText } from "./load.js";
+import { PROFILE_DEFAULTS, cliOverridesToConfig, mergeBaseLayers, mergeProjectAndCli, restrictProjectConfig, } from "./merge.js";
+import { CONFIG_FILE, projectFile, userFile } from "./paths.js";
+import { hasErrors, validateConfig } from "./schema.js";
+import { schemaAt, settableKeys, settingDefault, settingSpec, } from "./settings-registry.js";
+import { CONFIG_FILE_VERSION, DEFAULT_CHECKPOINTS_CONFIG } from "./types.js";
+import { writeConfigFile } from "./write.js";
+/** Refused edit; `exitCode` 3 (`ExitCode.Config`) except write failures (1). */
+export class ConfigEditError extends AmaError {
+    constructor(code, message) {
+        super(code, message, { exitCode: code === "config_write_failed" ? 1 : 3 });
+        this.name = "ConfigEditError";
+    }
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function getPath(value, key) {
+    let node = value;
+    for (const part of key.split(".")) {
+        if (!isObject(node))
+            return undefined;
+        node = node[part];
+    }
+    return node;
+}
+/** Set (or with `undefined` delete) one dotted path; empty parent objects are removed. */
+export function setPath(target, key, value) {
+    const parts = key.split(".");
+    const chain = [target];
+    let node = target;
+    for (const part of parts.slice(0, -1)) {
+        const next = node[part];
+        if (!isObject(next)) {
+            if (value === undefined)
+                return;
+            node[part] = {};
+        }
+        node = node[part];
+        chain.push(node);
+    }
+    const leaf = parts.at(-1);
+    if (value !== undefined) {
+        node[leaf] = value;
+        return;
+    }
+    delete node[leaf];
+    for (let i = chain.length - 1; i > 0; i--) {
+        if (Object.keys(chain[i]).length > 0)
+            break;
+        delete chain[i - 1][parts[i - 1]];
+    }
+}
+const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+function loadLayerFile(path) {
+    try {
+        return loadConfigFile("config", path)?.value;
+    }
+    catch (error) {
+        throw new ConfigEditError("config_read_failed", msg().settings.errors.readFailed(errorText(error)));
+    }
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Read both files and merge all layers. */
+export function readSnapshot(input) {
+    const userPath = userFile({ configDir: input.configDir }, CONFIG_FILE);
+    const projectPath = projectFile(input.cwd, CONFIG_FILE);
+    const user = loadLayerFile(userPath);
+    const project = loadLayerFile(projectPath);
+    const hasProfile = input.hasProfile ?? input.profile !== undefined;
+    const base = mergeBaseLayers({ user, profile: input.profile?.config, hasProfile });
+    const merged = mergeProjectAndCli(base, project, input.cli);
+    const layers = [
+        { name: "default", value: DISPLAY_DEFAULTS },
+    ];
+    if (user !== undefined)
+        layers.push({ name: "user", value: user });
+    if (hasProfile)
+        layers.push({ name: "profile", value: PROFILE_DEFAULTS });
+    if (input.profile?.config !== undefined)
+        layers.push({ name: "profile", value: input.profile.config });
+    if (project !== undefined)
+        layers.push({ name: "project", value: restrictAgainst(project, base.config) });
+    if (input.cli !== undefined)
+        layers.push({ name: "cli", value: cliOverridesToConfig(input.cli) });
+    return {
+        input,
+        userPath,
+        projectPath,
+        user,
+        project,
+        base: base.config,
+        config: merged.config,
+        layers,
+    };
+}
+function restrictAgainst(project, base) {
+    return restrictProjectConfig(project, base.permission?.mode ?? "default", ".ama/config.json", base.tools?.preset ?? "default", base.checkpoints?.maxFileBytes ?? DEFAULT_CHECKPOINTS_CONFIG.maxFileBytes, base.plan?.bash ?? "readonly").accepted;
+}
+/** Effective value and source of one key. */
+export function getConfigValue(snapshot, key) {
+    const envName = settingSpec(key)?.envOverride;
+    const envValue = envName === undefined ? undefined : snapshot.input.env[envName]?.trim();
+    if (envName !== undefined && envValue !== undefined && envValue !== "")
+        return { key, value: envValue, source: "env", envName };
+    let source = "default";
+    for (const layer of snapshot.layers) {
+        if (getPath(layer.value, key) !== undefined)
+            source = layer.name;
+    }
+    const value = getPath(snapshot.config, key) ?? settingDefault(key);
+    return { key, value, source };
+}
+/** Layers above the write scope: a value from one of them hides what the scope writes. */
+const ABOVE = {
+    user: ["profile", "project", "cli", "env"],
+    project: ["cli", "env"],
+};
+export function overriddenFor(value, scope) {
+    return ABOVE[scope].includes(value.source) ? value.source : undefined;
+}
+// ---- parsing ---------------------------------------------------------------
+const TRUE = new Set(["true", "on", "1", "yes"]);
+const FALSE = new Set(["false", "off", "0", "no"]);
+const UNSET = new Set(["none", "unset"]);
+function invalid(message) {
+    return new ConfigEditError("config_invalid_value", message);
+}
+function rangeText(spec) {
+    if (spec.minimum !== undefined && spec.maximum !== undefined)
+        return `${spec.minimum}–${spec.maximum}`;
+    if (spec.minimum !== undefined)
+        return `≥ ${spec.minimum}`;
+    return `≤ ${spec.maximum}`;
+}
+function parseNumber(key, raw, spec) {
+    const text = raw.trim().replace(/_/g, "");
+    const value = text === "" ? Number.NaN : Number(text);
+    if (!Number.isFinite(value))
+        throw invalid(msg().settings.errors.invalidNumber(key, raw));
+    if ((spec.minimum !== undefined && value < spec.minimum) ||
+        (spec.maximum !== undefined && value > spec.maximum))
+        throw invalid(msg().settings.errors.outOfRange(key, rangeText(spec)));
+    return value;
+}
+/** Registry spec, or one derived from the schema for documented keys outside the panel. */
+function specFor(key) {
+    const spec = settingSpec(key);
+    if (spec !== undefined)
+        return spec;
+    if (!settableKeys().includes(key))
+        throw new ConfigEditError("config_unknown_key", msg().settings.errors.unknownKey(key));
+    return { key, schema: schemaAt(key) ?? {} };
+}
+/** Throws `config_unknown_key` unless `ama config set` accepts the key. */
+export function assertSettable(key) {
+    specFor(key);
+}
+/**
+ * Parse a command line / panel value. `undefined` means unset (`none`, `unset`; `default` too unless it
+ * is a valid enum value). `jsonValue` takes JSON (lists and objects need it).
+ */
+export function parseValue(key, raw, jsonValue = false) {
+    const m = msg().settings.errors;
+    const spec = specFor(key);
+    if (jsonValue) {
+        try {
+            return JSON.parse(raw) ?? undefined;
+        }
+        catch (error) {
+            throw invalid(m.invalidJson(key, errorText(error)));
+        }
+    }
+    const text = raw.trim();
+    const lower = text.toLowerCase();
+    if (UNSET.has(lower))
+        return undefined;
+    if (!("kind" in spec)) {
+        const type = spec.schema["type"];
+        if (type === "array" || type === "object" || spec.schema["anyOf"] !== undefined)
+            throw invalid(m.needsJson(key));
+        if (type === "boolean")
+            return parseBool(key, text);
+        if (type === "number")
+            return parseNumber(key, text, spec.schema);
+        if (Array.isArray(spec.schema["enum"]))
+            return parseEnum(key, text, spec.schema["enum"]);
+        if (text === "")
+            throw invalid(m.emptyText(key));
+        return text;
+    }
+    switch (spec.kind) {
+        case "bool":
+            if (lower === "default")
+                return undefined;
+            return parseBool(key, text);
+        case "enum":
+            return parseEnum(key, text, spec.options ?? []);
+        case "number":
+            if (lower === "default")
+                return undefined;
+            return parseNumber(key, text, spec);
+        case "optionalNumber": {
+            const keyword = spec.keywords?.find((k) => k.toLowerCase() === lower);
+            if (keyword !== undefined)
+                return keyword;
+            if (lower === "default" || lower === "unlimited" || lower === "off")
+                return undefined;
+            return parseNumber(key, text, spec);
+        }
+        case "model":
+            if (lower === "default")
+                return undefined;
+            if (!/^[^/\s]+\/\S+$/.test(text))
+                throw invalid(m.invalidModel(key, raw));
+            return text;
+        case "text":
+            if (text === "")
+                throw invalid(m.emptyText(key));
+            return text;
+    }
+}
+function parseBool(key, text) {
+    const lower = text.toLowerCase();
+    if (TRUE.has(lower))
+        return true;
+    if (FALSE.has(lower))
+        return false;
+    throw invalid(msg().settings.errors.invalidBool(key, text));
+}
+function parseEnum(key, text, options) {
+    const lower = text.toLowerCase();
+    const hit = options.find((o) => o.toLowerCase() === lower);
+    if (hit !== undefined)
+        return hit;
+    if (lower === "default")
+        return undefined;
+    throw invalid(msg().settings.errors.invalidEnum(key, text, options.join(" | ")));
+}
+function readTarget(path, scope) {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return scope === "user"
+                ? minimalConfig()
+                : { version: CONFIG_FILE_VERSION };
+        throw new ConfigEditError("config_read_failed", msg().settings.errors.readFailed(errorText(error)));
+    }
+    try {
+        const parsed = parseJsonText(text);
+        if (isObject(parsed))
+            return parsed;
+    }
+    catch (error) {
+        throw new ConfigEditError("config_read_failed", msg().settings.errors.readFailed(`${path}: ${errorText(error)}`));
+    }
+    throw new ConfigEditError("config_read_failed", msg().settings.errors.readFailed(path));
+}
+/** Refuse a project write that `restrictProjectConfig` would ignore. */
+function checkProject(key, value, next, base) {
+    if (value === undefined)
+        return;
+    const accepted = restrictAgainst(next, base);
+    const got = getPath(accepted, key);
+    const ok = Array.isArray(value) ? Array.isArray(got) : same(got, value);
+    if (ok)
+        return;
+    const m = msg().settings.errors;
+    const spec = settingSpec(key);
+    if (spec?.project === "tighten") {
+        const current = getPath(base, key) ?? settingDefault(key);
+        throw new ConfigEditError("config_project_denied", m.projectTighten(key, current === undefined ? "-" : String(current)));
+    }
+    throw new ConfigEditError("config_project_denied", m.projectDenied(key));
+}
+/** Write one key into the user or project file (or unset it with `value: undefined`). */
+export function setConfigValue(options) {
+    const { scope, key, value } = options;
+    const spec = specFor(key);
+    const before = readSnapshot(options);
+    const beforeValue = getConfigValue(before, key);
+    const path = scope === "user" ? before.userPath : before.projectPath;
+    const current = readTarget(path, scope);
+    const next = structuredClone(current);
+    setPath(next, key, value);
+    const errors = validateConfig(next).filter((d) => d.severity === "error");
+    if (hasErrors(errors)) {
+        const first = errors.find((d) => d.path === key) ?? errors[0];
+        throw invalid(msg().settings.errors.invalid(key, first.message));
+    }
+    if (scope === "project")
+        checkProject(key, value, next, before.base);
+    if (!same(current, next)) {
+        try {
+            writeConfigFile(path, next, { backup: true });
+        }
+        catch (error) {
+            throw new ConfigEditError("config_write_failed", msg().settings.errors.writeFailed(path, errorText(error)));
+        }
+    }
+    const snapshot = readSnapshot(options);
+    const after = getConfigValue(snapshot, key);
+    const registry = "kind" in spec ? spec : undefined;
+    return {
+        key,
+        scope,
+        path,
+        before: beforeValue,
+        after,
+        apply: registry?.apply,
+        prefixChanged: registry?.prefix === true && !same(beforeValue.value, after.value),
+        overriddenBy: overriddenFor(after, scope),
+        snapshot,
+    };
+}
+export function unsetConfigValue(options) {
+    return setConfigValue({ ...options, value: undefined });
+}
+/** Display text of a value (JSON for lists / objects, plain otherwise). */
+export function formatSettingValue(value) {
+    if (value === undefined)
+        return msg().settings.unset;
+    if (typeof value === "string")
+        return value;
+    return JSON.stringify(value);
+}

package/dist/config/init.d.ts

@@ -4,7 +4,8 @@
  * - 目录 0700；`config.json` 只在不存在时写最小内容（`--force` 时先备份再重写）：只有 `$schema`、
  *   `version` 与空 `providers`，不写死任何缺省值——缺省值以后调整（例如 codemode 跟随预设）对老用户
  *   同样生效，`config show` 的来源也显示 default 而不是 user；
- * - `config.schema.json` 不是用户文件，每次 init 都按当前版本重写（内容相同则不动）；
+ * - `config.schema.json` 不是用户文件，每次 init 都按当前版本与当前界面语言重写（内容相同则不动；
+ *   说明跟随界面语言，D21）；
  * - 不创建 auth.json（只有 `ama auth set` / `ama providers add` 才写，0600）。
  * - 自动初始化只在 CLI 里、配置目录不存在时触发，`AMA_NO_INIT=1` 关闭；SDK 与测试不走这里。
  */
@@ -29,6 +30,6 @@ export declare function initConfigDir(dir: string, options?: {
 }): InitResult;
 /** CLI 启动时：配置目录不存在就静默初始化；返回是否初始化了。失败不影响启动。 */
 export declare function autoInitConfigDir(dir: string, env: Readonly<Record<string, string | undefined>>): boolean;
-/** init 之后的下一步（配 key / 接中转站 / 自检）。 */
-export declare const INIT_NEXT_STEPS: string[];
+/** init 之后的下一步（配 key / 接中转站 / 自检；当前界面语言）。 */
+export declare function initNextSteps(): string[];
 export declare function describeInit(result: InitResult): string;

package/dist/config/init.js

@@ -4,12 +4,14 @@
  * - 目录 0700；`config.json` 只在不存在时写最小内容（`--force` 时先备份再重写）：只有 `$schema`、
  *   `version` 与空 `providers`，不写死任何缺省值——缺省值以后调整（例如 codemode 跟随预设）对老用户
  *   同样生效，`config show` 的来源也显示 default 而不是 user；
- * - `config.schema.json` 不是用户文件，每次 init 都按当前版本重写（内容相同则不动）；
+ * - `config.schema.json` 不是用户文件，每次 init 都按当前版本与当前界面语言重写（内容相同则不动；
+ *   说明跟随界面语言，D21）；
  * - 不创建 auth.json（只有 `ama auth set` / `ama providers add` 才写，0600）。
  * - 自动初始化只在 CLI 里、配置目录不存在时触发，`AMA_NO_INIT=1` 关闭；SDK 与测试不走这里。
  */
 import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
 import { join } from "node:path";
+import { msg } from "../i18n/index.js";
 import { CONFIG_SCHEMA_FILE, configSchemaText } from "./json-schema.js";
 import { AUTH_FILE, CONFIG_FILE } from "./paths.js";
 import { CONFIG_FILE_VERSION } from "./types.js";
@@ -76,24 +78,14 @@ export function autoInitConfigDir(dir, env) {
         return false;
     }
 }
-const STATUS_TEXT = {
-    created: "已创建",
-    exists: "已存在，未改动",
-    updated: "已更新为当前版本",
-    unchanged: "已是当前版本",
-    overwritten: "已重写（原文件备份为 .bak）",
-};
-/** init 之后的下一步（配 key / 接中转站 / 自检）。 */
-export const INIT_NEXT_STEPS = [
-    "下一步：",
-    "  ama auth set anthropic          保存内置供应商的 key（或设置 ANTHROPIC_API_KEY 等环境变量）",
-    "  ama providers add <id> --base-url <url>   接入中转站或自建服务",
-    "  ama doctor                      检查配置、key 与运行环境",
-    "  ama config show                 查看生效配置与每项来源",
-];
+/** init 之后的下一步（配 key / 接中转站 / 自检；当前界面语言）。 */
+export function initNextSteps() {
+    return msg().config.init.nextSteps.split("\n");
+}
 export function describeInit(result) {
-    const lines = [`${result.dir}${result.dirCreated ? "  已创建（0700）" : "  已存在"}`];
+    const m = msg().config.init;
+    const lines = [`${result.dir}  ${result.dirCreated ? m.dirCreated : m.dirExists}`];
     for (const file of result.files)
-        lines.push(`  ${file.path}  ${STATUS_TEXT[file.status]}`);
+        lines.push(`  ${file.path}  ${m.status[file.status]}`);
     return `${lines.join("\n")}\n`;
 }

package/dist/config/json-schema.d.ts

@@ -3,7 +3,8 @@
  * （docs/providers.md「配置目录」）。规则与 schema.ts 的 `validateConfig` 一一对应：未知字段在那里是
  * warning、这里是 `additionalProperties: false`；渠道引用（模型 `channels` 指向已定义的渠道）这类跨字段
  * 规则 JSON Schema 表达不了，只在 `validateConfig` 里查。一致性由 json-schema.test.ts 的正反例守住。
- * 顶层与各段的键（供应商内部除外）的 description / default 来自 key-docs.ts（`annotate`）。
+ * 顶层与各段的键（供应商内部除外）的 description / default 来自 key-docs.ts（`annotate`）；说明跟随界面
+ * 语言（D21），`ama init` 按当前语言重写。
  */
 type Schema = Record<string, unknown>;
 export declare const CONFIG_SCHEMA_FILE = "config.schema.json";