@armadra/agent 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -5,6 +5,32 @@ English · [简体中文](CHANGELOG.zh-CN.md)
 > This file is in English starting with 0.6.0. Release notes for 0.1 through 0.5.1 are in Chinese in
 > [CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md). New entries go into both files.
 
+## 0.6.1 (2026-10-03)
+
+- **The model picker shows only configured models; ChatGPT models can be picked**: `/model` (and the startup picker and
+  `/config` model items) lists only providers with a key, a valid OAuth sign-in or a local server, one row per model on
+  multi-channel providers (other channels in the description; type `@` in the filter for `model@channel` rows); the current
+  model is pinned when it is not listed. `Tab` switches to "all" (unconfigured providers marked "no key configured", with an
+  `ama auth set` hint), `Space` adds / removes the highlighted model to / from the new user-level `models.enabled` list
+  (`provider/model[@channel]`, `provider/*`), which, once set, is all the picker shows; `ama models enable | disable` and
+  `ama models list --enabled` edit and show it. `ama auth login chatgpt` now fetches the models available to the account
+  (read-only, no usage) into `<dataDir>/models/discovered/chatgpt.json`, `ama models discover chatgpt` rewrites it and
+  logout deletes it; the registry merges the cache into providers with an empty model table, so ChatGPT models appear in
+  `/model` and `ama models list`. Note: with only a ChatGPT sign-in and no `defaultModel`, the first cached ChatGPT model can
+  now be chosen as the default model. Docs: docs/en/tui.md, docs/en/providers.md "ChatGPT login".
+
+- **`ama auth login chatgpt` explains a refused sign-in**: when the OAuth callback carries `error=access_denied` (or another
+  error) the message now lists the likely causes (the authorization page was cancelled or plan usage was not checked; the
+  account / plan is not eligible — sharing is Plus / Pro only, Team / Enterprise workspaces may not offer it, the browser may be
+  signed in to another account; the region is not supported) and, for siwc, suggests the fallback
+  `ama auth login chatgpt --flavor codex`. Nothing is retried or switched automatically.
+
+- **`ama config set` reports the written value when a higher layer overrides it**: with e.g. `AMA_LANG=zh`,
+  `ama config set ui.language en` used to print the effective value `zh` labelled "(user)". The first line is now the value just
+  written and its layer (`ui.language = en (written to user)`), and the second line names the override and the effective value
+  (`Still overridden by AMA_LANG (zh); the effective value is zh`). `ama config get` still shows the effective value and its
+  real source.
+
 ## 0.6.0 (2026-10-03)
 
 Wave 6: the agent bar and sub-agent view, traces, memory, ChatGPT login, the `/config` settings panel, and a bilingual

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,26 @@
 
 > 从 0.6.0 起 [CHANGELOG.md](CHANGELOG.md) 为英文，本文件保留中文记录（0.1–0.5.1 的完整历史在此）。新条目两份都要加。
 
+## 0.6.1（2026-10-03）
+
+- **模型选择器只显示已配置的模型，ChatGPT 模型可选**：`/model`（以及启动选择器、`/config` 的模型项）只列有 key、OAuth 已登录或
+  本地服务的供应商；多渠道供应商每个模型一行（其它渠道写在说明里，筛选文本输入 `@` 列出 `模型@渠道` 行）；当前模型不在列表里时
+  置顶。`Tab` 切到「全部」（没配置的供应商标「未配置 key」，选中时提示 `ama auth set`），`Space` 把高亮的模型加入 / 移出新的
+  用户级清单 `models.enabled`（`provider/model[@channel]`、`provider/*`），设置后选择器只列清单内的模型；`ama models enable |
+disable` 与 `ama models list --enabled` 在命令行编辑和查看。`ama auth login chatgpt` 成功后拉取账户可用的模型（只读、不消耗
+  额度）缓存到 `<dataDir>/models/discovered/chatgpt.json`，`ama models discover chatgpt` 重写、logout 删除；注册表把缓存并入模型
+  表为空的供应商，ChatGPT 模型因此出现在 `/model` 与 `ama models list` 里。注意：只登录了 ChatGPT、没设 `defaultModel` 时，
+  缺省模型现在可能选中缓存里的第一个 ChatGPT 模型。文档：docs/tui.md、docs/providers.md「ChatGPT 登录」。
+
+- **`ama auth login chatgpt` 授权被拒时说明原因**：OAuth 回调带 `error=access_denied`（或其它 error）时，提示改为列出可能原因
+  （在授权页取消或没勾选使用 ChatGPT 套餐额度；账户 / 套餐不符合——额度共享只对 Plus / Pro 开放，Team / Enterprise 工作空间可能
+  未开放，浏览器可能登录了别的账户；所在地区受限），siwc 下另提示可改用备用 `ama auth login chatgpt --flavor codex`。不自动重试、
+  不自动换 flavor。
+
+- **`ama config set` 被更高优先级来源覆盖时，回执显示刚写入的值**：如 `AMA_LANG=zh` 下 `ama config set ui.language en`，原来
+  第一行显示覆盖后的生效值 `zh` 却标「（用户级）」。现在第一行是刚写入的值与写入层（`ui.language = en（已写入用户级）`），第二行
+  提示覆盖来源与生效值（`当前仍被 AMA_LANG（zh）覆盖，生效值为 zh`）。`ama config get` 仍显示生效值与真实来源。
+
 ## 0.6.0（2026-10-03）
 
 第六波：Agent 栏与子 Agent 视图、轨迹、记忆（Memory）、ChatGPT 登录、`/config` 设置面板、中英双语界面。设计依据与决定表见

package/dist/ai/providers/discovered-cache.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 发现得到的模型列表缓存：`<dataDir>/models/discovered/<provider>.json`。
+ *
+ * 模型表为空、接受任意 slug 的供应商（`chatgpt` 的订阅后端）在选择器里原本一个模型都看不到。
+ * `ama auth login chatgpt` 成功后与 `ama models discover chatgpt` 把账户可用的 slug 写进这里；组装注册表时
+ * （`mergeDiscoveredModels`）并入**模型表仍为空**的供应商，元数据用 models.dev（快照 ⊕ 用户刷新）补全。
+ * `ama auth logout chatgpt` 删掉它。只存 slug、显示名、flavor 与时间戳——没有 token、账户 id。
+ */
+import type { Model, ProviderData } from "../types.js";
+import type { ModelsDevIndex } from "./models-dev.js";
+export declare const DISCOVERED_CACHE_VERSION = 1;
+export interface DiscoveredCacheFile {
+    version: number;
+    provider: string;
+    /** ISO 时间。 */
+    fetchedAt: string;
+    /** ChatGPT 登录的 flavor（siwc / codex）；其它供应商不写。 */
+    flavor?: string;
+    models: {
+        id: string;
+        name?: string;
+    }[];
+}
+/** 缓存文件位置。 */
+export declare function discoveredCachePath(dataDir: string, provider: string): string;
+/** 读缓存；不存在、损坏或形状不对返回 undefined（不报错，选择器给提示行）。 */
+export declare function readDiscoveredCache(dataDir: string, provider: string): DiscoveredCacheFile | undefined;
+/** 写缓存（先写临时文件再改名）；返回路径。 */
+export declare function writeDiscoveredCache(dataDir: string, provider: string, input: {
+    models: readonly {
+        id: string;
+        name?: string | undefined;
+    }[];
+    flavor?: string | undefined;
+}, now?: number): string;
+/** 删缓存；删了返回 true。 */
+export declare function clearDiscoveredCache(dataDir: string, provider: string): boolean;
+/** 缓存里的模型 → 注册表模型（models.dev 补元数据，补不到用自定义缺省）。 */
+export declare function discoveredModels(file: DiscoveredCacheFile, provider: ProviderData, modelsDev: () => ModelsDevIndex | undefined): Model[];
+/** 注册表里能追加模型的最小接口（`ProviderRegistry.addModels`）。 */
+export interface DiscoveredTarget {
+    list(): readonly ProviderData[];
+    addModels(providerId: string, models: readonly Model[], source?: "discovered"): void;
+}
+/**
+ * 把缓存并入模型表为空的供应商（本地服务除外：它们每次启动现场探测）。返回并入了的供应商 id。
+ */
+export declare function mergeDiscoveredModels(registry: DiscoveredTarget, dataDir: string, modelsDev: () => ModelsDevIndex | undefined): string[];

package/dist/ai/providers/discovered-cache.js

@@ -0,0 +1,102 @@
+/**
+ * 发现得到的模型列表缓存：`<dataDir>/models/discovered/<provider>.json`。
+ *
+ * 模型表为空、接受任意 slug 的供应商（`chatgpt` 的订阅后端）在选择器里原本一个模型都看不到。
+ * `ama auth login chatgpt` 成功后与 `ama models discover chatgpt` 把账户可用的 slug 写进这里；组装注册表时
+ * （`mergeDiscoveredModels`）并入**模型表仍为空**的供应商，元数据用 models.dev（快照 ⊕ 用户刷新）补全。
+ * `ama auth logout chatgpt` 删掉它。只存 slug、显示名、flavor 与时间戳——没有 token、账户 id。
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { withCustomDefaults } from "./catalog.js";
+import { enrichEntry } from "./enrich.js";
+export const DISCOVERED_CACHE_VERSION = 1;
+/** 缓存文件位置。 */
+export function discoveredCachePath(dataDir, provider) {
+    return join(dataDir, "models", "discovered", `${provider}.json`);
+}
+function isEntry(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const { id, name } = value;
+    return typeof id === "string" && id !== "" && (name === undefined || typeof name === "string");
+}
+/** 读缓存；不存在、损坏或形状不对返回 undefined（不报错，选择器给提示行）。 */
+export function readDiscoveredCache(dataDir, provider) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(discoveredCachePath(dataDir, provider), "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return undefined;
+    const file = parsed;
+    if (file.provider !== provider || !Array.isArray(file.models))
+        return undefined;
+    return {
+        version: typeof file.version === "number" ? file.version : DISCOVERED_CACHE_VERSION,
+        provider,
+        fetchedAt: typeof file.fetchedAt === "string" ? file.fetchedAt : "",
+        ...(typeof file.flavor === "string" ? { flavor: file.flavor } : {}),
+        models: file.models
+            .filter(isEntry)
+            .map((m) => (m.name ? { id: m.id, name: m.name } : { id: m.id })),
+    };
+}
+/** 写缓存（先写临时文件再改名）；返回路径。 */
+export function writeDiscoveredCache(dataDir, provider, input, now = Date.now()) {
+    const path = discoveredCachePath(dataDir, provider);
+    const file = {
+        version: DISCOVERED_CACHE_VERSION,
+        provider,
+        fetchedAt: new Date(now).toISOString(),
+        ...(input.flavor !== undefined ? { flavor: input.flavor } : {}),
+        models: input.models.map((m) => (m.name ? { id: m.id, name: m.name } : { id: m.id })),
+    };
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    const tmp = `${path}.${process.pid}.tmp`;
+    writeFileSync(tmp, `${JSON.stringify(file, null, 2)}\n`);
+    renameSync(tmp, path);
+    return path;
+}
+/** 删缓存；删了返回 true。 */
+export function clearDiscoveredCache(dataDir, provider) {
+    const path = discoveredCachePath(dataDir, provider);
+    if (!existsSync(path))
+        return false;
+    rmSync(path, { force: true });
+    return true;
+}
+/** 缓存里的模型 → 注册表模型（models.dev 补元数据，补不到用自定义缺省）。 */
+export function discoveredModels(file, provider, modelsDev) {
+    return file.models.map((m) => {
+        const { entry } = enrichEntry(m.name ? { id: m.id, name: m.name } : { id: m.id }, modelsDev);
+        const model = withCustomDefaults(entry, provider.id, provider.api);
+        // 只挂发现时登录的 flavor 对应的渠道（订阅后端的另一条渠道用不了，不在说明与 `@` 行里出现）；
+        // 缓存没写 flavor 或渠道不存在时用供应商的缺省渠道
+        const names = (provider.channels ?? []).map((c) => c.name);
+        if (names.length > 0) {
+            const own = file.flavor !== undefined && names.includes(file.flavor) ? file.flavor : undefined;
+            model.channels = [own ?? provider.defaultChannel ?? names[0]];
+        }
+        return model;
+    });
+}
+/**
+ * 把缓存并入模型表为空的供应商（本地服务除外：它们每次启动现场探测）。返回并入了的供应商 id。
+ */
+export function mergeDiscoveredModels(registry, dataDir, modelsDev) {
+    const merged = [];
+    for (const provider of registry.list()) {
+        if (provider.models.length > 0 || !provider.requiresApiKey)
+            continue;
+        const file = readDiscoveredCache(dataDir, provider.id);
+        if (file === undefined || file.models.length === 0)
+            continue;
+        registry.addModels(provider.id, discoveredModels(file, provider, modelsDev), "discovered");
+        merged.push(provider.id);
+    }
+    return merged;
+}

package/dist/ai/providers/model-visibility.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 模型选择器的可见性规则（`/model`、启动选择器、`/config` 的模型项、`ama models list --enabled` 共用）。
+ *
+ * - 供应商的可用状态：本地（`requiresApiKey: false`）、有 key、OAuth 已登录、OAuth 需重新登录、没配置；
+ *   前三种算「已配置」，缺省只显示它们的模型。
+ * - `models.enabled`（用户级）：`provider/model[@channel]` 或 `provider/*`；设置后只显示清单内的模型。
+ *   清单为空等同不设（写回时删掉这个键）。
+ */
+import type { ProviderData, ProviderRegistryApi } from "../types.js";
+export type ProviderAccess = "local" | "key" | "oauth" | "needsLogin" | "none";
+/** 解析 key 判断供应商的可用状态（OAuth 条目会按需刷新，与发请求前相同）。 */
+export declare function providerAccess(registry: ProviderRegistryApi, provider: ProviderData): Promise<ProviderAccess>;
+export declare function accessReady(access: ProviderAccess): boolean;
+/** `provider/model@channel` → 三段（模型 id 里可以有 `/`）。 */
+export declare function splitEnabledRef(ref: string): {
+    provider: string;
+    model: string;
+    channel?: string;
+} | undefined;
+/**
+ * 清单是否包含该行：`exact` 是逐字列出（`provider/model`，渠道行要 `provider/model@channel`），
+ * `wildcard` 只经 `provider/*` 匹配上。
+ */
+export declare function enabledMatch(list: readonly string[], ref: string): {
+    kind: "exact" | "wildcard";
+    pattern: string;
+} | undefined;
+/** 追加（去重、保持顺序）。 */
+export declare function addEnabled(list: readonly string[] | undefined, refs: readonly string[]): string[];
+/** 移出；移空返回 undefined（删掉键，恢复「显示全部已配置」）。 */
+export declare function removeEnabled(list: readonly string[] | undefined, refs: readonly string[]): string[] | undefined;
+/** 配置里的清单：非数组或空数组视为未设置。 */
+export declare function enabledList(value: unknown): readonly string[] | undefined;

package/dist/ai/providers/model-visibility.js

@@ -0,0 +1,70 @@
+/**
+ * 模型选择器的可见性规则（`/model`、启动选择器、`/config` 的模型项、`ama models list --enabled` 共用）。
+ *
+ * - 供应商的可用状态：本地（`requiresApiKey: false`）、有 key、OAuth 已登录、OAuth 需重新登录、没配置；
+ *   前三种算「已配置」，缺省只显示它们的模型。
+ * - `models.enabled`（用户级）：`provider/model[@channel]` 或 `provider/*`；设置后只显示清单内的模型。
+ *   清单为空等同不设（写回时删掉这个键）。
+ */
+import { liveToken } from "../../auth/oauth/live.js";
+/** 解析 key 判断供应商的可用状态（OAuth 条目会按需刷新，与发请求前相同）。 */
+export async function providerAccess(registry, provider) {
+    if (!provider.requiresApiKey)
+        return "local";
+    const key = await registry
+        .resolveApiKey(provider.id)
+        .catch(() => ({ apiKey: undefined, source: "none" }));
+    if (key.apiKey === undefined)
+        return "none";
+    if (key.source !== "oauth")
+        return "key";
+    return liveToken(key.apiKey)?.needsLogin === true ? "needsLogin" : "oauth";
+}
+export function accessReady(access) {
+    return access === "local" || access === "key" || access === "oauth";
+}
+/** `provider/model@channel` → 三段（模型 id 里可以有 `/`）。 */
+export function splitEnabledRef(ref) {
+    const slash = ref.indexOf("/");
+    if (slash <= 0 || slash === ref.length - 1)
+        return undefined;
+    const provider = ref.slice(0, slash);
+    const rest = ref.slice(slash + 1);
+    const at = rest.lastIndexOf("@");
+    if (at > 0)
+        return { provider, model: rest.slice(0, at), channel: rest.slice(at + 1) };
+    return { provider, model: rest };
+}
+/**
+ * 清单是否包含该行：`exact` 是逐字列出（`provider/model`，渠道行要 `provider/model@channel`），
+ * `wildcard` 只经 `provider/*` 匹配上。
+ */
+export function enabledMatch(list, ref) {
+    if (list.includes(ref))
+        return { kind: "exact", pattern: ref };
+    const parts = splitEnabledRef(ref);
+    if (parts === undefined)
+        return undefined;
+    const wildcard = `${parts.provider}/*`;
+    return list.includes(wildcard) ? { kind: "wildcard", pattern: wildcard } : undefined;
+}
+/** 追加（去重、保持顺序）。 */
+export function addEnabled(list, refs) {
+    const out = [...(list ?? [])];
+    for (const ref of refs)
+        if (!out.includes(ref))
+            out.push(ref);
+    return out;
+}
+/** 移出；移空返回 undefined（删掉键，恢复「显示全部已配置」）。 */
+export function removeEnabled(list, refs) {
+    const out = (list ?? []).filter((ref) => !refs.includes(ref));
+    return out.length > 0 ? out : undefined;
+}
+/** 配置里的清单：非数组或空数组视为未设置。 */
+export function enabledList(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const list = value.filter((x) => typeof x === "string");
+    return list.length > 0 ? list : undefined;
+}

package/dist/ai/providers/registry.d.ts

@@ -63,6 +63,8 @@ export declare class ProviderRegistry implements ProviderRegistryApi {
     private readonly envBaseUrls;
     /** baseUrl 指向非官方主机的内置供应商：接受目录外的 model id。 */
     private readonly relayed;
+    /** 模型表只来自发现缓存的供应商：表外的 id 照样合成（与空表相同）。 */
+    private readonly openTables;
     /** config 里写了自己 `channels` 的供应商（内置渠道不因改 baseUrl 作废）。 */
     private readonly userChannels;
     /** config 里写了供应商级 `api` 的供应商（单渠道回落时目录模型跟它走）。 */

package/dist/ai/providers/registry.js

@@ -57,6 +57,8 @@ export class ProviderRegistry {
     envBaseUrls = new Map();
     /** baseUrl 指向非官方主机的内置供应商：接受目录外的 model id。 */
     relayed = new Set();
+    /** 模型表只来自发现缓存的供应商：表外的 id 照样合成（与空表相同）。 */
+    openTables = new Set();
     /** config 里写了自己 `channels` 的供应商（内置渠道不因改 baseUrl 作废）。 */
     userChannels = new Set();
     /** config 里写了供应商级 `api` 的供应商（单渠道回落时目录模型跟它走）。 */
@@ -344,6 +346,8 @@ export class ProviderRegistry {
         const provider = this.providers.get(providerId);
         if (!provider)
             return;
+        if (source === "discovered" && provider.models.length === 0 && provider.requiresApiKey)
+            this.openTables.add(providerId);
         for (const raw of models) {
             this.raw.delete(`${providerId}/${raw.id}`);
             const model = this.materialize(provider, { ...raw, provider: providerId });
@@ -408,7 +412,8 @@ export class ProviderRegistry {
                 const model = provider.models.find((m) => m.id === id);
                 if (model)
                     return { ok: true, model, provider };
-                const relayed = provider.models.length === 0 || this.relayed.has(provider.id);
+                const open = this.relayed.has(provider.id) || this.openTables.has(provider.id);
+                const relayed = provider.models.length === 0 || open;
                 if (synthesize && relayed && id.length > 0) {
                     const synthesized = this.synthesize(provider, id);
                     if (channel !== undefined && provider.channels?.some((c) => c.name === channel))

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

@@ -4,7 +4,9 @@
  * - login：flavor 取 `--flavor` > 用户级 `auth.chatgpt.flavor` > siwc；`--paste` / `--device`（只 codex）/ 缺省
  *   浏览器；codex 首次在 TTY 下一次性确认「非官方、仅个人使用」（非 TTY 需 `--yes`），`acknowledgedAt` 入条目；
  *   成功后在刷新锁下写 auth.json（0600）。
- * - logout：SIWC 先撤销 refresh token（失败照样删本地，提示到 ChatGPT 设置里断开）；codex 只删本地。
+ *   成功后查一次模型列表写发现缓存（`<dataDir>/models/discovered/chatgpt.json`，失败静默）。
+ * - logout：SIWC 先撤销 refresh token（失败照样删本地，提示到 ChatGPT 设置里断开）；codex 只删本地；
+ *   同时删发现缓存。
  * - status：flavor、计划、掩码邮箱、access token 剩余、needsLogin；codex 另查 `wham/usage` 显示配额。
  *
  * 输出里从不出现 token、code、账户 id；错误按码渲染（i18n），不回显响应原文。

package/dist/auth/chatgpt/cli.js

@@ -4,7 +4,9 @@
  * - login：flavor 取 `--flavor` > 用户级 `auth.chatgpt.flavor` > siwc；`--paste` / `--device`（只 codex）/ 缺省
  *   浏览器；codex 首次在 TTY 下一次性确认「非官方、仅个人使用」（非 TTY 需 `--yes`），`acknowledgedAt` 入条目；
  *   成功后在刷新锁下写 auth.json（0600）。
- * - logout：SIWC 先撤销 refresh token（失败照样删本地，提示到 ChatGPT 设置里断开）；codex 只删本地。
+ *   成功后查一次模型列表写发现缓存（`<dataDir>/models/discovered/chatgpt.json`，失败静默）。
+ * - logout：SIWC 先撤销 refresh token（失败照样删本地，提示到 ChatGPT 设置里断开）；codex 只删本地；
+ *   同时删发现缓存。
  * - status：flavor、计划、掩码邮箱、access token 剩余、needsLogin；codex 另查 `wham/usage` 显示配额。
  *
  * 输出里从不出现 token、code、账户 id；错误按码渲染（i18n），不回显响应原文。
@@ -19,7 +21,8 @@ import { UsageError } from "../../cli/args.js";
 import { ExitCode } from "../../cli/exit-codes.js";
 import { openBrowser } from "../oauth/browser.js";
 import { readOAuthEntry, withRefreshLock, writeOAuthEntry } from "../oauth/token-store.js";
-import { fetchCodexUsage } from "./backend-client.js";
+import { clearDiscoveredCache, writeDiscoveredCache } from "../../ai/providers/discovered-cache.js";
+import { fetchCodexUsage, listChatGptModels } from "./backend-client.js";
 import { maskEmail } from "./claims.js";
 import { loginChatGpt, revokeChatGpt } from "./login.js";
 import { CHATGPT_PROVIDER_ID, chatgptBaseUrl } from "./presets.js";
@@ -55,7 +58,7 @@ export function loginErrorText(error, flavor) {
         case "oauth_timeout":
             return m.timeout;
         case "oauth_denied":
-            return m.denied(detail.error ?? "error");
+            return m.denied(detail.error ?? "error", flavor === "siwc");
         case "oauth_state_mismatch":
             return m.stateMismatch;
         case "oauth_no_code":
@@ -184,9 +187,32 @@ export async function runLogin(args, io, deps = {}) {
         io.stdout(`${m.freePlanHint(entry.planType)}\n`);
     if (flavor === "siwc")
         io.stdout(`${m.siwcLimitHint}\n`);
-    io.stdout(`${m.modelHint}\n`);
+    const count = await cacheModels(io, entry, config, deps);
+    io.stdout(`${count === undefined ? m.modelHint : m.modelsCached(count)}\n`);
     return ExitCode.Ok;
 }
+/**
+ * 登录后查一次账户可用的模型（只读的模型列表接口，不消耗额度）并写发现缓存，`/model` 由此列出；
+ * 任何失败静默（返回 undefined，调用方改提示 `ama models discover chatgpt`）。
+ */
+async function cacheModels(io, entry, config, deps) {
+    try {
+        const models = await listChatGptModels(deps.fetch ?? fetch, chatgptBaseUrl(entry.flavor, io.env), {
+            flavor: entry.flavor,
+            accessToken: entry.accessToken,
+            accountId: entry.accountId,
+            originator: config?.originator,
+        });
+        if (models.length === 0)
+            return undefined;
+        const dataDir = resolveDataDir({ env: io.env });
+        writeDiscoveredCache(dataDir, CHATGPT_PROVIDER_ID, { models, flavor: entry.flavor });
+        return models.length;
+    }
+    catch {
+        return undefined;
+    }
+}
 export async function runLogout(args, io, deps = {}) {
     const m = msg().auth.logout;
     const provider = providerOf(args, "logout");
@@ -205,6 +231,7 @@ export async function runLogout(args, io, deps = {}) {
         io.stderr(`ama: ${loginErrorText(error, entry.flavor)}\n`);
         return ExitCode.RuntimeError;
     }
+    clearDiscoveredCache(resolveDataDir({ env: io.env }), provider);
     const text = revoked === undefined
         ? m.local(provider, args.path)
         : revoked