@armadra/agent 0.2.1 → 0.4.0

package/dist/cli/main.js

@@ -4,14 +4,18 @@
  *
  * - 设 `AMA=1`、`AI_AGENT=ama`；直接执行时装 `uncaughtException` / `unhandledRejection` →
  *   stderr 一行 + 退出码 1；SIGINT / SIGTERM 交给当前模式。
- * - `--version` / `--help` 短路；子命令 `auth / sessions / models / doctor / config` 分派后返回；
+ * - `--version` / `--help` 短路；子命令 `auth / sessions / models / providers / doctor / config /
+ *   init` 分派后返回；进入对话的命令（与 `providers add`）启动前若配置目录不存在则静默初始化
+ *   （`AMA_NO_INIT=1` 关闭），只读子命令（`config show`、`doctor`、`models list` 等）不写配置目录；
  *   其余交给 `runCli()`（bootstrap → 模式）。
+ * - 设了 HTTPS_PROXY / HTTP_PROXY 时启用 Node 内置的环境变量代理（cli/proxy.ts）；不支持的 Node
+ *   版本在会联网的命令里提示一次。
  * - 运行时实现（RuntimeDeps）：`MainOptions.deps` > `registerRuntimeDeps()` > 组装根
  *   `createRuntimeDeps()`（cli/compose.ts，动态 import）。
  * - 签名 `main(argv): Promise<number>` 与「直接执行才自动运行」判定保持不变：
  *   src/bundle.ts 显式调用 `main()`。
  */
-import { realpathSync } from "node:fs";
+import { fstatSync, realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { AMA_VERSION } from "../version.js";
 import { parseArgs } from "./args.js";
@@ -21,7 +25,13 @@ import { runAuth } from "./subcommands/auth.js";
 import { runConfig } from "./subcommands/config.js";
 import { runDoctor } from "./subcommands/doctor.js";
 import { runModels } from "./subcommands/models.js";
+import { runProviders } from "./subcommands/providers.js";
+import { runInit } from "./subcommands/init.js";
+import { autoInitConfigDir } from "../config/init.js";
+import { resolveConfigDir } from "../config/paths.js";
 import { runSessions } from "./subcommands/sessions.js";
+import { runStats } from "./subcommands/stats.js";
+import { enableEnvProxy, proxyHint } from "./proxy.js";
 let registeredDeps;
 /** 集成批次注入运行时实现（B1 / B2 / B3 / B6 / B7）。 */
 export function registerRuntimeDeps(deps) {
@@ -67,6 +77,61 @@ export function readStdinDefault() {
         stdin.on("data", onData);
     });
 }
+/** fd 0 的类型；fstat 失败（已关闭）按 `null` 处理。 */
+export function stdinKindDefault() {
+    try {
+        const stat = fstatSync(0);
+        if (stat.isFile())
+            return "file";
+        if (stat.isFIFO())
+            return "fifo";
+        if (stat.isSocket())
+            return "socket";
+        if (stat.isCharacterDevice())
+            return process.stdin.isTTY === true ? "tty" : "null";
+        return "other";
+    }
+    catch {
+        return "null";
+    }
+}
+/** 等 stdin 首字节至多 `timeoutMs`；超时则停止读取并返回 undefined，否则读到 EOF。 */
+export function readStdinFirstByteDefault(timeoutMs) {
+    const stdin = process.stdin;
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let timer;
+        const cleanup = () => {
+            clearTimeout(timer);
+            stdin.off("data", onData);
+            stdin.off("end", onEnd);
+            stdin.off("error", onError);
+        };
+        const onData = (chunk) => {
+            clearTimeout(timer);
+            timer = undefined;
+            chunks.push(chunk);
+        };
+        const onEnd = () => {
+            cleanup();
+            resolve(Buffer.concat(chunks).toString("utf8"));
+        };
+        const onError = (error) => {
+            cleanup();
+            reject(error);
+        };
+        timer = setTimeout(() => {
+            cleanup();
+            // 不再读：释放句柄，父进程留着不关的管道不会让进程挂住
+            stdin.pause();
+            stdin.destroy();
+            resolve(undefined);
+        }, timeoutMs);
+        stdin.on("data", onData);
+        stdin.once("end", onEnd);
+        stdin.once("error", onError);
+    });
+}
 export function defaultIo() {
     return {
         stdout: (text) => void process.stdout.write(text),
@@ -76,6 +141,8 @@ export function defaultIo() {
         env: process.env,
         cwd: process.cwd(),
         readStdin: readStdinDefault,
+        readStdinFirstByte: readStdinFirstByteDefault,
+        stdinKind: stdinKindDefault,
     };
 }
 let hooksInstalled = false;
@@ -116,6 +183,19 @@ export async function main(argv, options = {}) {
         const parsed = parseArgs(argv);
         if (parsed.kind !== "subcommand")
             noTui = parsed.args.noTui;
+        const informational = parsed.kind === "run" ? parsed.args.help || parsed.args.version : parsed.name === "init";
+        // 首次自动初始化只在会进入对话的命令（和接入供应商）里做；只读子命令不写配置目录
+        const startsWork = parsed.kind === "run" || (parsed.name === "providers" && parsed.argv[0] === "add");
+        if (!informational && startsWork)
+            autoInitConfigDir(resolveConfigDir({ env: io.env }), io.env);
+        // 进程级副作用（全局 dispatcher）：只在真正的进程入口做，测试里调 main() 不碰
+        if (!informational && options.processHooks !== false) {
+            const proxy = enableEnvProxy(io.env);
+            const online = parsed.kind === "run" || parsed.name === "models" || parsed.name === "providers";
+            const hint = online ? proxyHint(proxy) : undefined;
+            if (hint !== undefined)
+                io.stderr(hint);
+        }
         if (parsed.kind === "subcommand") {
             switch (parsed.name) {
                 case "auth":
@@ -124,10 +204,16 @@ export async function main(argv, options = {}) {
                     return await runSessions(parsed.argv, io, await resolveDeps());
                 case "models":
                     return await runModels(parsed.argv, io, await resolveDeps());
+                case "providers":
+                    return await runProviders(parsed.argv, io, await resolveDeps());
                 case "doctor":
                     return await runDoctor(parsed.argv, io, await resolveDeps());
                 case "config":
                     return await runConfig(parsed.argv, io, await resolveDeps());
+                case "init":
+                    return runInit(parsed.argv, io);
+                case "stats":
+                    return await runStats(parsed.argv, io);
             }
         }
         if (parsed.args.version) {

package/dist/cli/proxy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 环境变量代理（W4-C）：Node 的全局 fetch 缺省不读 `HTTPS_PROXY` / `HTTP_PROXY` / `NO_PROXY`。
+ *
+ * - 没设代理变量 → 什么都不做。
+ * - 运行时已接管（`NODE_USE_ENV_PROXY=1` 或 `--use-env-proxy`，且 Node 支持）→ 不重复设置。
+ * - Node 有 `http.setGlobalProxyFromEnv()`（24.x / 26.x 等）→ 进程启动时调用一次，等价于
+ *   `NODE_USE_ENV_PROXY=1`（fetch 与 http/https 全局 agent 都走代理，`NO_PROXY` 生效）。零依赖。
+ * - 不支持的 Node 版本 → 只在会联网的命令里于 stderr 提示一次（不中断）。
+ *
+ * `ama doctor` 用 `describeProxy()` 显示同一份状态；代理 URL 里的账号密码打码。
+ */
+export interface ProxyEnv {
+    httpsProxy?: string;
+    httpProxy?: string;
+    noProxy?: string;
+}
+export type ProxyState = "none"
+/** 运行时已按环境变量接管（NODE_USE_ENV_PROXY / --use-env-proxy）。 */
+ | "runtime"
+/** ama 启动时调用 http.setGlobalProxyFromEnv() 启用。 */
+ | "enabled"
+/** 设了代理变量，但当前 Node 不支持内置代理。 */
+ | "unsupported"
+/** 代理 URL 无法解析。 */
+ | "invalid";
+export interface ProxyStatus {
+    env: ProxyEnv;
+    state: ProxyState;
+    error?: string;
+}
+type SetGlobalProxy = (env?: NodeJS.ProcessEnv) => () => void;
+export interface ProxyRuntime {
+    setGlobalProxyFromEnv?: SetGlobalProxy | undefined;
+    execArgv: readonly string[];
+    version: string;
+}
+export declare function readProxyEnv(env: Readonly<Record<string, string | undefined>>): ProxyEnv;
+export declare function defaultProxyRuntime(): ProxyRuntime;
+/** 只判断不启用：没设代理 / 运行时已接管 / 能启用 / 不支持 / URL 无法解析。 */
+export declare function inspectProxy(env: Readonly<Record<string, string | undefined>>, runtime?: ProxyRuntime): ProxyStatus;
+/** 按上面的规则启用代理（进程级副作用）；同一进程只做一次，之后返回同一份状态。 */
+export declare function enableEnvProxy(env: Readonly<Record<string, string | undefined>>, runtime?: ProxyRuntime): ProxyStatus;
+/** 测试用：清掉进程内记住的状态。 */
+export declare function resetProxyForTest(): void;
+/** 代理 URL 里的账号密码打码。 */
+export declare function redactProxyUrl(value: string): string;
+/** 不能启用时给一次 stderr 提示（每个进程至多一次）；能用或没设代理返回 undefined。 */
+export declare function proxyHint(status: ProxyStatus, nodeVersion?: string): string | undefined;
+/** `ama doctor` 的代理段落。 */
+export declare function describeProxy(status: ProxyStatus): string[];
+export {};

package/dist/cli/proxy.js

@@ -0,0 +1,135 @@
+/**
+ * 环境变量代理（W4-C）：Node 的全局 fetch 缺省不读 `HTTPS_PROXY` / `HTTP_PROXY` / `NO_PROXY`。
+ *
+ * - 没设代理变量 → 什么都不做。
+ * - 运行时已接管（`NODE_USE_ENV_PROXY=1` 或 `--use-env-proxy`，且 Node 支持）→ 不重复设置。
+ * - Node 有 `http.setGlobalProxyFromEnv()`（24.x / 26.x 等）→ 进程启动时调用一次，等价于
+ *   `NODE_USE_ENV_PROXY=1`（fetch 与 http/https 全局 agent 都走代理，`NO_PROXY` 生效）。零依赖。
+ * - 不支持的 Node 版本 → 只在会联网的命令里于 stderr 提示一次（不中断）。
+ *
+ * `ama doctor` 用 `describeProxy()` 显示同一份状态；代理 URL 里的账号密码打码。
+ */
+import * as http from "node:http";
+function pick(env, name) {
+    const value = env[name.toLowerCase()] ?? env[name.toUpperCase()];
+    return value !== undefined && value.trim() !== "" ? value.trim() : undefined;
+}
+export function readProxyEnv(env) {
+    const out = {};
+    const https = pick(env, "https_proxy");
+    const plain = pick(env, "http_proxy");
+    const no = pick(env, "no_proxy");
+    if (https !== undefined)
+        out.httpsProxy = https;
+    if (plain !== undefined)
+        out.httpProxy = plain;
+    if (no !== undefined)
+        out.noProxy = no;
+    return out;
+}
+export function defaultProxyRuntime() {
+    const fn = http.setGlobalProxyFromEnv;
+    return {
+        setGlobalProxyFromEnv: typeof fn === "function" ? fn.bind(http) : undefined,
+        execArgv: process.execArgv,
+        version: process.versions.node,
+    };
+}
+/** Node ≥ 24，或 22.21+：认 NODE_USE_ENV_PROXY / --use-env-proxy。 */
+function runtimeReadsEnvProxy(version) {
+    const [major = 0, minor = 0] = version.split(".").map(Number);
+    return major >= 24 || (major === 22 && minor >= 21);
+}
+let current;
+let hinted = false;
+/** 只判断不启用：没设代理 / 运行时已接管 / 能启用 / 不支持 / URL 无法解析。 */
+export function inspectProxy(env, runtime = defaultProxyRuntime()) {
+    if (current !== undefined)
+        return current;
+    const proxy = readProxyEnv(env);
+    if (proxy.httpsProxy === undefined && proxy.httpProxy === undefined)
+        return { env: proxy, state: "none" };
+    const flagged = env["NODE_USE_ENV_PROXY"] === "1" ||
+        runtime.execArgv.includes("--use-env-proxy") ||
+        (env["NODE_OPTIONS"] ?? "").includes("--use-env-proxy");
+    if (flagged && runtimeReadsEnvProxy(runtime.version))
+        return { env: proxy, state: "runtime" };
+    if (runtime.setGlobalProxyFromEnv === undefined)
+        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: "enabled" };
+}
+/** 按上面的规则启用代理（进程级副作用）；同一进程只做一次，之后返回同一份状态。 */
+export function enableEnvProxy(env, runtime = defaultProxyRuntime()) {
+    if (current !== undefined)
+        return current;
+    const status = inspectProxy(env, runtime);
+    if (status.state === "enabled") {
+        try {
+            runtime.setGlobalProxyFromEnv?.({ ...env });
+        }
+        catch (error) {
+            current = { env: status.env, state: "invalid", error: error.message };
+            return current;
+        }
+    }
+    current = status;
+    return current;
+}
+/** 测试用：清掉进程内记住的状态。 */
+export function resetProxyForTest() {
+    current = undefined;
+    hinted = false;
+}
+/** 代理 URL 里的账号密码打码。 */
+export function redactProxyUrl(value) {
+    try {
+        const url = new URL(value);
+        if (url.username === "" && url.password === "")
+            return value;
+        url.username = url.username === "" ? "" : "***";
+        url.password = url.password === "" ? "" : "***";
+        return url.toString();
+    }
+    catch {
+        return value.replace(/\/\/[^@/]*@/, "//***@");
+    }
+}
+/** 不能启用时给一次 stderr 提示（每个进程至多一次）；能用或没设代理返回 undefined。 */
+export function proxyHint(status, nodeVersion = process.versions.node) {
+    if (hinted)
+        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");
+    }
+    if (status.state === "invalid") {
+        hinted = true;
+        return `ama: 代理变量无法解析，请求将直连：${status.error ?? ""}\n`;
+    }
+    return undefined;
+}
+/** `ama doctor` 的代理段落。 */
+export function describeProxy(status) {
+    const { env } = status;
+    const lines = [];
+    if (env.httpsProxy !== undefined)
+        lines.push(`HTTPS_PROXY=${redactProxyUrl(env.httpsProxy)}`);
+    if (env.httpProxy !== undefined)
+        lines.push(`HTTP_PROXY=${redactProxyUrl(env.httpProxy)}`);
+    if (env.noProxy !== undefined)
+        lines.push(`NO_PROXY=${env.noProxy}`);
+    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 ?? ""}`,
+    };
+    lines.push(state[status.state]);
+    return lines;
+}

package/dist/cli/startup-screen.d.ts

@@ -6,10 +6,39 @@
  * - normal：标题行 + 模型 / 信任 / 已加载资源清单 / 警告数
  * - header：只有标题行（版本与按键提示）
  * - silent：不输出
+ *
+ * 交互模式（终端界面视觉设计 v1 §3.1）用结构化的 `startupInfo()` 自己排版（框 / 无框两态）；
+ * `buildStartupScreen` 的纯文本行保留给 line 模式与测试。
  */
+import type { PermissionMode } from "../permissions/types.js";
 import type { Runtime } from "./runtime.js";
 export type StartupScreenLevel = "normal" | "header" | "silent";
 export declare function startupScreenLevel(runtime: Pick<Runtime, "config">): StartupScreenLevel;
 export declare function headerLine(): string;
 export type StartupScreenRuntime = Pick<Runtime, "config" | "trust" | "resources" | "model" | "thinkingLevel" | "hooks" | "host" | "paths" | "warnings">;
 export declare function buildStartupScreen(runtime: StartupScreenRuntime, level?: StartupScreenLevel): string[];
+/** 交互模式启动头的结构化字段（§3.1）。 */
+export interface StartupInfo {
+    version: string;
+    /** `provider/id[@渠道]`。 */
+    model: string;
+    thinking: string;
+    /** 会话目录（家目录缩写为 `~`）。 */
+    cwd: string;
+    trusted: boolean;
+    /** 信任来源的短名（trust.json / 命令行 / 本次确认 / profile / 缺省）。 */
+    trustSource: string;
+    permissionMode: PermissionMode;
+    preset: string;
+    codemode: "off" | "on" | "only";
+    /** 上下文文件的文件名（外层在前）。 */
+    contextFiles: string[];
+    skills: number;
+    prompts: number;
+    hooks: number;
+    host?: string;
+    warnings: number;
+}
+/** 家目录前缀缩写为 `~`（`/` 与 `\` 两种分隔都认，余下部分原样保留）。 */
+export declare function tildePath(path: string, home: string | undefined): string;
+export declare function startupInfo(runtime: StartupScreenRuntime & Pick<Runtime, "session">, home?: string): StartupInfo;

package/dist/cli/startup-screen.js

@@ -6,7 +6,13 @@
  * - normal：标题行 + 模型 / 信任 / 已加载资源清单 / 警告数
  * - header：只有标题行（版本与按键提示）
  * - silent：不输出
+ *
+ * 交互模式（终端界面视觉设计 v1 §3.1）用结构化的 `startupInfo()` 自己排版（框 / 无框两态）；
+ * `buildStartupScreen` 的纯文本行保留给 line 模式与测试。
  */
+import { basename } from "node:path";
+import { formatModelRef } from "../ai/providers/channels.js";
+import { effectiveCodemodeMode } from "../tools/presets.js";
 import { AMA_VERSION } from "../version.js";
 export function startupScreenLevel(runtime) {
     return runtime.config.ui?.quietStartup ?? "normal";
@@ -54,3 +60,44 @@ export function buildStartupScreen(runtime, level = startupScreenLevel(runtime))
         lines.push(`警告：${runtime.warnings.length} 条（ama doctor 查看）`);
     return lines;
 }
+const TRUST_SOURCE = {
+    flag: "命令行",
+    "trust-file": "trust.json",
+    prompt: "本次确认",
+    profile: "profile",
+    default: "缺省",
+};
+/** 家目录前缀缩写为 `~`（`/` 与 `\` 两种分隔都认，余下部分原样保留）。 */
+export function tildePath(path, home) {
+    if (home === undefined || home === "")
+        return path;
+    const trimmed = /[\\/]$/.test(home) ? home.slice(0, -1) : home;
+    if (path === trimmed)
+        return "~";
+    const next = path[trimmed.length];
+    return path.startsWith(trimmed) && (next === "/" || next === "\\")
+        ? `~${path.slice(trimmed.length)}`
+        : path;
+}
+export function startupInfo(runtime, home) {
+    const { resources } = runtime;
+    const info = {
+        version: AMA_VERSION,
+        model: formatModelRef(runtime.model),
+        thinking: runtime.thinkingLevel,
+        cwd: tildePath(runtime.paths.cwd, home),
+        trusted: runtime.trust.trusted,
+        trustSource: TRUST_SOURCE[runtime.trust.source],
+        permissionMode: runtime.session.state.permissionMode,
+        preset: runtime.config.tools?.preset ?? "default",
+        codemode: effectiveCodemodeMode(runtime.config),
+        contextFiles: resources.contextFiles.map((f) => basename(f.path)),
+        skills: resources.skills.length,
+        prompts: resources.prompts.length,
+        hooks: runtime.hooks.list().length,
+        warnings: runtime.warnings.length,
+    };
+    if (runtime.host !== undefined)
+        info.host = runtime.host.adapter.id;
+    return info;
+}

package/dist/cli/startup-steps.d.ts

@@ -26,7 +26,7 @@ export interface ModelChoice {
     provider: ProviderData;
 }
 /** 第 11 步：解析模型与 key。 */
-export declare function resolveModel(args: ParsedArgs, registry: ProviderRegistryApi, manager: SessionManagerApi, defaultModel: string | undefined, deps: RuntimeDeps, interactive: boolean): Promise<ModelChoice>;
+export declare function resolveModel(args: ParsedArgs, registry: ProviderRegistryApi, manager: SessionManagerApi, defaultModel: string | undefined, deps: RuntimeDeps, interactive: boolean, env?: Readonly<Record<string, string | undefined>>): Promise<ModelChoice>;
 export declare function thinkingOf(args: ParsedArgs, manager: SessionManagerApi, fallback: ModelThinkingLevel | undefined): ModelThinkingLevel;
 /** 第 12 步之后：`--tools` / `--exclude-tools`（宿主工具注册后再校验，宿主工具名也可用）。 */
 export declare function applyToolFilters(args: ParsedArgs, runtimeTools: Runtime["tools"]): void;

package/dist/cli/startup-steps.js

@@ -2,11 +2,14 @@
  * 启动序列的单步辅助（设计 §11.1）：错误映射、模式判定、profile 合并、会话请求、
  * 模型与思考级别解析、工具过滤、指令文件。[B5] 由 cli/bootstrap.ts 编排。
  */
+import { describeLookupFailure } from "../ai/providers/suggest.js";
+import { formatModelRef } from "../ai/providers/channels.js";
 import { statSync } from "node:fs";
 import { isAbsolute, resolve } from "node:path";
 import { AmaError, StartupError, isAmaError } from "../errors.js";
 import { UsageError } from "./args.js";
-import { pickDefaultModel } from "./default-model.js";
+import { noModelGuidance, pickDefaultModel } from "./default-model.js";
+import { hideFakeProvider } from "./fake-visibility.js";
 import { ExitCode } from "./exit-codes.js";
 /** 把非 StartupError 包成指定退出码；StartupError / UsageError 原样透传。 */
 export async function step(exitCode, label, fn) {
@@ -66,6 +69,8 @@ export function applyProfile(args, profile) {
     return merged;
 }
 export function sessionRequestOf(args) {
+    if (args.noSession)
+        return { kind: "memory" };
     if (args.continue)
         return { kind: "continue" };
     if (args.resume)
@@ -79,7 +84,7 @@ export function sessionRequestOf(args) {
 export function sourceOf(request, manager) {
     if (request.kind === "fork")
         return "fork";
-    if (request.kind === "new")
+    if (request.kind === "new" || request.kind === "memory")
         return "startup";
     return manager.entries().length > 0 ? "resume" : "startup";
 }
@@ -93,7 +98,7 @@ export function lastEntry(manager, predicate) {
     return undefined;
 }
 /** 第 11 步：解析模型与 key。 */
-export async function resolveModel(args, registry, manager, defaultModel, deps, interactive) {
+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（不回退到该供应商的缺省模型）`);
     }
@@ -101,13 +106,8 @@ export async function resolveModel(args, registry, manager, defaultModel, deps,
         const found = registry.findModel(ref);
         if (found.ok)
             return { model: found.model, provider: found.provider };
-        const hint = found.candidates.length > 0 ? `；候选：${found.candidates.slice(0, 20).join(", ")}` : "";
-        const what = found.reason === "provider_not_found"
-            ? "供应商不存在"
-            : found.reason === "ambiguous"
-                ? "模型名有歧义"
-                : "模型不存在";
-        throw new StartupError("model_not_found", `${label}${what}：${ref}${hint}`, ExitCode.NoModel);
+        const code = found.reason === "provider_not_found" ? "provider_not_found" : "model_not_found";
+        throw new StartupError(code, `${label}${describeLookupFailure(ref, found)}`, ExitCode.NoModel);
     };
     let choice;
     if (args.model !== undefined) {
@@ -119,7 +119,11 @@ export async function resolveModel(args, registry, manager, defaultModel, deps,
     else {
         const change = lastEntry(manager, (e) => e.type === "model_change");
         if (change?.type === "model_change") {
-            const found = registry.findModel(`${change.provider}/${change.modelId}`);
+            const found = registry.findModel(formatModelRef({
+                provider: change.provider,
+                id: change.modelId,
+                ...(change.channel !== undefined ? { channel: change.channel } : {}),
+            }));
             if (found.ok)
                 choice = { model: found.model, provider: found.provider };
         }
@@ -132,13 +136,16 @@ export async function resolveModel(args, registry, manager, defaultModel, deps,
         }
     }
     const pick = async (reason) => {
-        const picked = interactive ? await deps.ui?.pickModel?.(registry, reason) : undefined;
+        // 选择器不列测试供应商 fake（AMA_SHOW_FAKE=1 或 AMA_FAKE_SCRIPT 时照列）
+        const picked = interactive
+            ? await deps.ui?.pickModel?.(hideFakeProvider(registry, env), reason)
+            : undefined;
         if (picked === undefined)
             throw new StartupError("no_api_key", reason, ExitCode.NoModel);
         return lookup(picked, "");
     };
     if (choice === undefined) {
-        return pick("没有可用模型：用 `ama auth set <provider>` 保存 key，或设置对应环境变量，或 --model 指定");
+        return pick(noModelGuidance(registry));
     }
     if (choice.provider.requiresApiKey) {
         const key = await registry.resolveApiKey(choice.provider.id);

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

@@ -3,16 +3,20 @@
  * 每一项标出来自哪一层（default / user / profile / project），并给出将使用的模型与原因
  * （`config.defaultModel` 或零配置选择）。只读；config 里的字面量 apiKey 只显示种类。[B6]
  *
+ * 缺省值来自 config/key-docs.ts 的 DISPLAY_DEFAULTS（含 DEFAULT_CONFIG 不写的 cache / codemode 等段），
+ * `codemode.mode` 不写时显示跟随预设的结果与原因；`--tools-preset` / `--codemode` 作为 cli 层叠加；
+ * 预设写的是旧名（codemode）时显示规范名并提示。
+ *
  * [W3-B12] 「供应商」节：config 里出现的供应商与 baseUrl 来自环境变量（`OPENAI_BASE_URL` /
  * `ANTHROPIC_BASE_URL`）的内置供应商，列出协议、生效 baseUrl 与来源、config 里每个模型的协议
  * （模型级 `api` 生效后的值）。
  */
-import type { AmaConfig } from "../../config/types.js";
+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";
+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";
 type Layer = {
-    name: "default" | "user" | "profile" | "project";
+    name: "default" | "user" | "profile" | "project" | "cli";
     label: string;
     value: unknown;
 };
@@ -30,15 +34,36 @@ export interface ProviderDescription {
     baseUrl: string;
     /** baseUrl 来自的环境变量。 */
     baseUrlEnv?: string;
-    /** config 里列出的模型及其生效协议。 */
+    /** 渠道（多渠道供应商）。 */
+    channels?: {
+        name: string;
+        api: Api;
+        baseUrl: string;
+    }[];
+    /** config 里列出的模型及其生效协议、渠道与元数据来源。 */
     models: {
         id: string;
         api: Api;
+        channels?: string[];
+        flags: string;
+        sources?: string;
     }[];
 }
 /** config 里出现的供应商 + baseUrl 来自环境变量的内置供应商。 */
 export declare function describeProviders(config: AmaConfig, registry: ProviderRegistryApi | undefined): ProviderDescription[];
 /** 每个生效叶子的来源：累加型列表列出所有贡献层，其余取最后设置它的层。 */
 export declare function sourcesOf(effective: AmaConfig, layers: readonly Layer[]): Map<string, string>;
+export interface CodemodeDescription {
+    mode: CodemodeMode;
+    /** config：显式 codemode.mode；preset：跟随预设。 */
+    source: "config" | "preset";
+    /** 人读原因。 */
+    reason: string;
+    strict: boolean;
+    /** 生效模式不是 off 但 codemode 工具不可用（requireStrict）时的说明。 */
+    unavailable?: string;
+}
+/** codemode 生效模式与原因（跟随预设时写明预设与运行时 Node 是否隔离网络）。 */
+export declare function describeCodemode(config: AmaConfig, nodeVersion?: string): CodemodeDescription;
 export declare function runConfig(argv: readonly string[], io: CliIo, deps: Pick<RuntimeDeps, "providers"> | undefined): Promise<number>;
 export {};