@armadra/agent 0.2.1 → 0.3.0

package/dist/cli/args.d.ts

@@ -2,7 +2,8 @@
  * 手写参数解析（设计 §11.1 第 2 步、§12.10、§13）。[B5]
  *
  * - 支持 `--opt value` 与 `--opt=value`；`--` 之后全部作为提示文本；可重复的参数累加。
- * - 子命令只在第一个参数是 `auth / sessions / models / doctor / config` 时识别，其余参数原样交给子命令。
+ * - 子命令只在第一个参数是 `auth / sessions / models / providers / doctor / config / init` 时识别，
+ *   其余参数原样交给子命令。
  * - 互斥：`-p` 与 `--mode rpc`；`--continue` / `--resume` / `--session-id` / `--fork` 两两互斥；
  *   `--trust` 与 `--no-trust`；`--api-key` 需要 `--model`；`--output-format` 需要 `-p`。
  * - `--resume [id]`：下一个参数形如会话 id（无空白、不以 `-` 开头）才被当作 id；
@@ -13,7 +14,7 @@ import { AmaError } from "../errors.js";
 import type { ModelThinkingLevel } from "../ai/types.js";
 import type { PermissionMode } from "../permissions/types.js";
 import type { CodemodeMode, ToolsPreset } from "../config/types.js";
-export declare const SUBCOMMANDS: readonly ["auth", "sessions", "models", "doctor", "config"];
+export declare const SUBCOMMANDS: readonly ["auth", "sessions", "models", "providers", "doctor", "config", "init"];
 export type SubcommandName = (typeof SUBCOMMANDS)[number];
 export type OutputFormat = "text" | "json" | "stream-json";
 export type QuietStartup = "normal" | "header" | "silent";
@@ -54,6 +55,8 @@ export interface ParsedArgs {
     toolsPreset?: ToolsPreset;
     /** `--codemode`：覆盖 config `codemode.mode`。 */
     codemode?: CodemodeMode;
+    /** `--image <文件>`（可重复，只用于 -p）：随首条提示发送的图片。 */
+    images: string[];
     /** 位置参数拼成的提示（空格连接）。 */
     prompt?: string;
     /** 原始位置参数。 */
@@ -70,7 +73,7 @@ export type ParseResult = {
 export declare class UsageError extends AmaError {
     constructor(message: string);
 }
-export declare const HELP_TEXT = "\u7528\u6CD5\uFF1Aama [\u9009\u9879] [\u63D0\u793A]\n      ama <\u5B50\u547D\u4EE4> \u2026\n\n\u6A21\u5F0F\n  \uFF08\u7F3A\u7701\uFF09                     \u7EC8\u7AEF\u754C\u9762\uFF1Bstdin / stdout \u975E TTY \u6216 TERM=dumb \u65F6\u81EA\u52A8\u964D\u7EA7\u4E3A\u884C\u5F0F\n  --no-tui                     \u884C\u5F0F\u754C\u9762\uFF08readline + \u62EC\u53F7\u7C98\u8D34\uFF09\n  -p, --print                  \u975E\u4EA4\u4E92\uFF1A\u6267\u884C\u63D0\u793A\u540E\u9000\u51FA\uFF08\u63D0\u793A\u53EF\u6765\u81EA\u53C2\u6570\u4E0E stdin \u7BA1\u9053\uFF09\n  --output-format <\u683C\u5F0F>       -p \u7684\u8F93\u51FA\uFF1Atext\uFF08\u7F3A\u7701\uFF09| json | stream-json\n  --mode rpc                   stdio JSONL \u534F\u8BAE\uFF08\u4F9B\u5D4C\u5165\uFF09\n  --tui-mode <\u6A21\u5F0F>            \u663E\u793A\u6A21\u5F0F\uFF0C\u7B2C\u4E00\u671F\u53EA\u6709 regular\uFF08\u4E3B\u5C4F\uFF09\n  --quiet-startup <\u6863>         \u542F\u52A8\u753B\u9762\uFF1Anormal | header | silent\n\n\u6A21\u578B\n  --model <provider/id>        \u6A21\u578B\uFF08\u53EF\u914D\u5408 --provider \u53EA\u5199 id\uFF09\n  --provider <id>              \u4F9B\u5E94\u5546\uFF08\u5FC5\u987B\u540C\u65F6\u7ED9 --model\uFF09\n  --api-key <key>              \u53EA\u7528\u4E8E\u672C\u6B21\u542F\u52A8\u7684 key\uFF08\u9700\u8981 --model\uFF1B\u4F18\u5148\u7528 ama auth set\uFF09\n  --thinking <\u7EA7\u522B>            off | minimal | low | medium | high | xhigh\n\n\u4F1A\u8BDD\n  -c, --continue               \u7EE7\u7EED\u672C\u76EE\u5F55\u6700\u8FD1\u7684\u4F1A\u8BDD\n  -r, --resume [id]            \u6062\u590D\u4F1A\u8BDD\uFF08\u4EA4\u4E92\u6A21\u5F0F\u65E0 id \u65F6\u5F39\u9009\u62E9\u5668\uFF09\n  --session-id <id>            \u4F7F\u7528\u6307\u5B9A id \u7684\u4F1A\u8BDD\uFF08\u4E0D\u5B58\u5728\u5219\u65B0\u5EFA\uFF09\n  --fork <id>                  \u4ECE\u6307\u5B9A\u4F1A\u8BDD\u5206\u53C9\u51FA\u65B0\u4F1A\u8BDD\n  --session-dir <\u76EE\u5F55>         \u4F1A\u8BDD\u76EE\u5F55\uFF08\u7F3A\u7701 ~/.local/share/ama/sessions\uFF09\n\n\u6743\u9650\u4E0E\u4FE1\u4EFB\n  --permission-mode <\u6A21\u5F0F>     plan | default | auto-edit | full-auto\n  --allow <\u89C4\u5219>               \u8FFD\u52A0\u5141\u8BB8\u89C4\u5219\uFF0C\u53EF\u91CD\u590D\uFF08\u5982 \"bash(git status*)\"\uFF09\n  --deny <\u89C4\u5219>                \u8FFD\u52A0\u62D2\u7EDD\u89C4\u5219\uFF0C\u53EF\u91CD\u590D\uFF08\u5982 \"write(**/.env*)\"\uFF09\n  --trust / --no-trust         \u4FE1\u4EFB / \u4E0D\u4FE1\u4EFB\u5F53\u524D\u9879\u76EE\uFF08\u9879\u76EE\u7EA7 Hook\u3001Skill\u3001\u63D0\u793A\u6A21\u677F\uFF09\n\n\u8D44\u6E90\n  --profile <\u6587\u4EF6>             \u5BBF\u4E3B profile.json\uFF08\u5B57\u6BB5\u7B49\u4EF7\u4E8E\u5BF9\u5E94\u53C2\u6570\uFF0C\u547D\u4EE4\u884C\u4F18\u5148\uFF09\n  --host <\u6A21\u5757>                \u5BBF\u4E3B\u9002\u914D\u5668\u6A21\u5757\uFF08CJS / ESM\uFF09\n  --instructions <\u6587\u4EF6>        \u8FFD\u52A0\u6307\u4EE4\u6587\u4EF6\uFF0C\u53EF\u91CD\u590D\n  --skill-dir <\u76EE\u5F55>           \u8FFD\u52A0 Skill \u76EE\u5F55\uFF0C\u53EF\u91CD\u590D\n  --auth-file <\u6587\u4EF6>           auth.json \u4F4D\u7F6E\uFF08\u7F3A\u7701 ~/.config/ama/auth.json\uFF09\n  --tools <a,b,\u2026>              \u53EA\u542F\u7528\u8FD9\u4E9B\u5DE5\u5177\n  --exclude-tools <a,b,\u2026>      \u7981\u7528\u8FD9\u4E9B\u5DE5\u5177\n  --tools-preset <\u540D>          \u5DE5\u5177\u9884\u8BBE\uFF1Adefault\uFF08\u7F3A\u7701\uFF09| minimal | codemode | coordinator\n  --codemode <\u6A21\u5F0F>            codemode \u8C03\u7528\u65B9\u5F0F\uFF1Aoff | on | only\n\n\u5B50\u547D\u4EE4\n  ama auth set <provider>      \u4ECE stdin \u8BFB\u53D6 key \u5199\u5165 auth.json\uFF080600\uFF09\n  ama auth list                \u5217\u51FA\u5DF2\u4FDD\u5B58 key \u7684\u4F9B\u5E94\u5546\uFF08\u4E0D\u663E\u793A key\uFF09\n  ama auth remove <provider>   \u5220\u9664\u5DF2\u4FDD\u5B58\u7684 key\n  ama sessions list|show|prune \u4F1A\u8BDD\u7BA1\u7406\n  ama models list [--provider <id>]  \u5217\u51FA\u6A21\u578B\uFF08\u542B\u6765\u6E90\u4E0E key \u72B6\u6001\uFF09\n  ama models check <provider/id>     \u53D1\u4E00\u6B21\u6700\u5C0F\u8BF7\u6C42\u68C0\u67E5\u53EF\u7528\u6027\n  ama models discover <provider> [--probe] [--write] [--limit N]\n                               \u4ECE\u4E2D\u8F6C /v1/models \u5217\u51FA\u6A21\u578B\uFF0C\u63A2\u6D4B\u534F\u8BAE\u5E76\u5199\u5165\u914D\u7F6E\n  ama models cache-probe <provider/id> [--tokens N] [--gap-ms MS] [--yes] [--json]\n                               \u5224\u65AD\u7AEF\u70B9\u662F\u5426\u62A5\u544A\u7F13\u5B58\u547D\u4E2D\n  ama doctor                   \u914D\u7F6E\u5C42\u7EA7\u3001\u4FE1\u4EFB\u3001key \u6765\u6E90\u3001Hook\u3001\u7EC8\u7AEF\u80FD\u529B\n  ama config show [--json]     \u751F\u6548\u914D\u7F6E\u4E0E\u6BCF\u9879\u6765\u6E90\u3001\u5C06\u4F7F\u7528\u7684\u6A21\u578B\n\n\u5176\u5B83\n  -h, --help                   \u8F93\u51FA\u672C\u5E2E\u52A9\n  -v, --version                \u8F93\u51FA\u7248\u672C\n\n\u9000\u51FA\u7801\uFF1A0 \u6B63\u5E38 \u00B7 1 \u8FD0\u884C\u671F\u9519\u8BEF \u00B7 2 \u7528\u6CD5\u9519\u8BEF \u00B7 3 \u914D\u7F6E\u9519\u8BEF \u00B7 4 \u65E0\u53EF\u7528\u6A21\u578B\u6216 key \u00B7\n        5 \u4F1A\u8BDD\u9519\u8BEF \u00B7 6 \u5BBF\u4E3B / Hook \u542F\u52A8\u5931\u8D25 \u00B7 78 \u5BBF\u4E3B API \u7248\u672C\u4E0D\u5339\u914D \u00B7 130 SIGINT \u00B7 143 SIGTERM\n";
+export declare const HELP_TEXT = "\u7528\u6CD5\uFF1Aama [\u9009\u9879] [\u63D0\u793A]\n      ama <\u5B50\u547D\u4EE4> \u2026\n\n\u6A21\u5F0F\n  \uFF08\u7F3A\u7701\uFF09                     \u7EC8\u7AEF\u754C\u9762\uFF1Bstdin / stdout \u975E TTY \u6216 TERM=dumb \u65F6\u81EA\u52A8\u964D\u7EA7\u4E3A\u884C\u5F0F\n  --no-tui                     \u884C\u5F0F\u754C\u9762\uFF08readline + \u62EC\u53F7\u7C98\u8D34\uFF09\n  -p, --print                  \u975E\u4EA4\u4E92\uFF1A\u6267\u884C\u63D0\u793A\u540E\u9000\u51FA\uFF08\u63D0\u793A\u53EF\u6765\u81EA\u53C2\u6570\u4E0E stdin \u7BA1\u9053\uFF09\n  --output-format <\u683C\u5F0F>       -p \u7684\u8F93\u51FA\uFF1Atext\uFF08\u7F3A\u7701\uFF09| json | stream-json\n  --image <\u6587\u4EF6>               -p \u968F\u63D0\u793A\u53D1\u9001\u56FE\u7247\uFF08\u53EF\u91CD\u590D\uFF1Bpng / jpg / gif / webp\uFF0C\u5355\u5F20 \u2264 5 MB\uFF09\uFF1B\n                               \u4EA4\u4E92\u754C\u9762\u91CC\u5199 @\u56FE\u7247\u8DEF\u5F84 \u6216\u7C98\u8D34\u56FE\u7247\u8DEF\u5F84\n  --mode rpc                   stdio JSONL \u534F\u8BAE\uFF08\u4F9B\u5D4C\u5165\uFF09\n  --tui-mode <\u6A21\u5F0F>            \u663E\u793A\u6A21\u5F0F\uFF0C\u7B2C\u4E00\u671F\u53EA\u6709 regular\uFF08\u4E3B\u5C4F\uFF09\n  --quiet-startup <\u6863>         \u542F\u52A8\u753B\u9762\uFF1Anormal | header | silent\n\n\u6A21\u578B\n  --model <provider/id>        \u6A21\u578B\uFF08\u53EF\u914D\u5408 --provider \u53EA\u5199 id\uFF1B@\u6E20\u9053 \u6307\u5B9A\u6E20\u9053\uFF0C\u5982 packy/kimi-k2.5@messages\uFF09\n  --provider <id>              \u4F9B\u5E94\u5546\uFF08\u5FC5\u987B\u540C\u65F6\u7ED9 --model\uFF09\n  --api-key <key>              \u53EA\u7528\u4E8E\u672C\u6B21\u542F\u52A8\u7684 key\uFF08\u9700\u8981 --model\uFF1B\u4F18\u5148\u7528 ama auth set\uFF09\n  --thinking <\u7EA7\u522B>            off | minimal | low | medium | high | xhigh\n\n\u4F1A\u8BDD\n  -c, --continue               \u7EE7\u7EED\u672C\u76EE\u5F55\u6700\u8FD1\u7684\u4F1A\u8BDD\n  -r, --resume [id]            \u6062\u590D\u4F1A\u8BDD\uFF08\u4EA4\u4E92\u6A21\u5F0F\u65E0 id \u65F6\u5F39\u9009\u62E9\u5668\uFF09\n  --session-id <id>            \u4F7F\u7528\u6307\u5B9A id \u7684\u4F1A\u8BDD\uFF08\u4E0D\u5B58\u5728\u5219\u65B0\u5EFA\uFF09\n  --fork <id>                  \u4ECE\u6307\u5B9A\u4F1A\u8BDD\u5206\u53C9\u51FA\u65B0\u4F1A\u8BDD\n  --session-dir <\u76EE\u5F55>         \u4F1A\u8BDD\u76EE\u5F55\uFF08\u7F3A\u7701 ~/.local/share/ama/sessions\uFF09\n\n\u6743\u9650\u4E0E\u4FE1\u4EFB\n  --permission-mode <\u6A21\u5F0F>     plan | default | auto-edit | full-auto\n  --allow <\u89C4\u5219>               \u8FFD\u52A0\u5141\u8BB8\u89C4\u5219\uFF0C\u53EF\u91CD\u590D\uFF08\u5982 \"bash(git status*)\"\uFF09\n  --deny <\u89C4\u5219>                \u8FFD\u52A0\u62D2\u7EDD\u89C4\u5219\uFF0C\u53EF\u91CD\u590D\uFF08\u5982 \"write(**/.env*)\"\uFF09\n  --trust / --no-trust         \u4FE1\u4EFB / \u4E0D\u4FE1\u4EFB\u5F53\u524D\u9879\u76EE\uFF08\u9879\u76EE\u7EA7 Hook\u3001Skill\u3001\u63D0\u793A\u6A21\u677F\uFF09\n\n\u8D44\u6E90\n  --profile <\u6587\u4EF6>             \u5BBF\u4E3B profile.json\uFF08\u5B57\u6BB5\u7B49\u4EF7\u4E8E\u5BF9\u5E94\u53C2\u6570\uFF0C\u547D\u4EE4\u884C\u4F18\u5148\uFF09\n  --host <\u6A21\u5757>                \u5BBF\u4E3B\u9002\u914D\u5668\u6A21\u5757\uFF08CJS / ESM\uFF09\n  --instructions <\u6587\u4EF6>        \u8FFD\u52A0\u6307\u4EE4\u6587\u4EF6\uFF0C\u53EF\u91CD\u590D\n  --skill-dir <\u76EE\u5F55>           \u8FFD\u52A0 Skill \u76EE\u5F55\uFF0C\u53EF\u91CD\u590D\n  --auth-file <\u6587\u4EF6>           auth.json \u4F4D\u7F6E\uFF08\u7F3A\u7701 ~/.config/ama/auth.json\uFF09\n  --tools <a,b,\u2026>              \u53EA\u542F\u7528\u8FD9\u4E9B\u5DE5\u5177\n  --exclude-tools <a,b,\u2026>      \u7981\u7528\u8FD9\u4E9B\u5DE5\u5177\n  --tools-preset <\u540D>          \u5DE5\u5177\u9884\u8BBE\uFF1Adefault\uFF08\u7F3A\u7701\uFF09| minimal | codemode | coordinator\n  --codemode <\u6A21\u5F0F>            codemode \u8C03\u7528\u65B9\u5F0F\uFF1Aoff | on | only\n\n\u5B50\u547D\u4EE4\n  ama auth set <provider>      \u4ECE stdin \u8BFB\u53D6 key \u5199\u5165 auth.json\uFF080600\uFF09\n  ama auth list                \u5217\u51FA\u5DF2\u4FDD\u5B58 key \u7684\u4F9B\u5E94\u5546\uFF08\u4E0D\u663E\u793A key\uFF09\n  ama auth remove <provider>   \u5220\u9664\u5DF2\u4FDD\u5B58\u7684 key\n  ama sessions list|show|prune \u4F1A\u8BDD\u7BA1\u7406\n  ama models list [--provider <id>]  \u5217\u51FA\u6A21\u578B\uFF08\u542B\u6765\u6E90\u4E0E key \u72B6\u6001\uFF09\n  ama models check <provider/id>     \u53D1\u4E00\u6B21\u6700\u5C0F\u8BF7\u6C42\u68C0\u67E5\u53EF\u7528\u6027\n  ama models discover <provider> [--probe] [--write] [--limit N]\n                               \u4ECE\u4E2D\u8F6C /v1/models \u5217\u51FA\u6A21\u578B\uFF0C\u63A2\u6D4B\u534F\u8BAE\u5E76\u5199\u5165\u914D\u7F6E\n  ama models refresh-catalog   \u5F3A\u5236\u5237\u65B0 models.dev \u6A21\u578B\u5143\u6570\u636E\u7F13\u5B58\n  ama providers add <id> --base-url <url> [--key-env VAR] [--probe] [--channel n=api@url] [--yes]\n                               \u4E00\u952E\u63A5\u5165\uFF1A\u5217\u6A21\u578B\u3001\u8865 models.dev \u5143\u6570\u636E\u3001\u63A2\u6D4B\u6E20\u9053\u3001\u5199\u5165\u914D\u7F6E\n  ama providers list|channels <id>|remove <id>|refresh <id>\n                               \u4F9B\u5E94\u5546 \u2192 \u6E20\u9053 \u2192 \u6A21\u578B\uFF1B\u5220\u9664\uFF1B\u91CD\u62C9\u6A21\u578B\u5217\u8868\n  ama models cache-probe <provider/id> [--tokens N] [--gap-ms MS] [--yes] [--json]\n                               \u5224\u65AD\u7AEF\u70B9\u662F\u5426\u62A5\u544A\u7F13\u5B58\u547D\u4E2D\n  ama doctor                   \u914D\u7F6E\u5C42\u7EA7\u3001\u4FE1\u4EFB\u3001key \u6765\u6E90\u3001Hook\u3001\u7EC8\u7AEF\u80FD\u529B\n  ama config show [--json]     \u751F\u6548\u914D\u7F6E\u4E0E\u6BCF\u9879\u6765\u6E90\u3001\u5C06\u4F7F\u7528\u7684\u6A21\u578B\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\n  ama init [--force]           \u5EFA\u914D\u7F6E\u76EE\u5F55\uFF080700\uFF09\u4E0E config.json\u3001config.schema.json\uFF1B\u5DF2\u6709\u7684\u4E0D\u8986\u76D6\n\n\u5176\u5B83\n  -h, --help                   \u8F93\u51FA\u672C\u5E2E\u52A9\n  -v, --version                \u8F93\u51FA\u7248\u672C\n\n\u9000\u51FA\u7801\uFF1A0 \u6B63\u5E38 \u00B7 1 \u8FD0\u884C\u671F\u9519\u8BEF \u00B7 2 \u7528\u6CD5\u9519\u8BEF \u00B7 3 \u914D\u7F6E\u9519\u8BEF \u00B7 4 \u65E0\u53EF\u7528\u6A21\u578B\u6216 key \u00B7\n        5 \u4F1A\u8BDD\u9519\u8BEF \u00B7 6 \u5BBF\u4E3B / Hook \u542F\u52A8\u5931\u8D25 \u00B7 78 \u5BBF\u4E3B API \u7248\u672C\u4E0D\u5339\u914D \u00B7 130 SIGINT \u00B7 143 SIGTERM\n";
 export declare function emptyArgs(): ParsedArgs;
 /** 解析 argv（不含 node 与脚本路径）；用法错误抛 UsageError（退出码 2）。 */
 export declare function parseArgs(argv: readonly string[]): ParseResult;

package/dist/cli/args.js

@@ -2,7 +2,8 @@
  * 手写参数解析（设计 §11.1 第 2 步、§12.10、§13）。[B5]
  *
  * - 支持 `--opt value` 与 `--opt=value`；`--` 之后全部作为提示文本；可重复的参数累加。
- * - 子命令只在第一个参数是 `auth / sessions / models / doctor / config` 时识别，其余参数原样交给子命令。
+ * - 子命令只在第一个参数是 `auth / sessions / models / providers / doctor / config / init` 时识别，
+ *   其余参数原样交给子命令。
  * - 互斥：`-p` 与 `--mode rpc`；`--continue` / `--resume` / `--session-id` / `--fork` 两两互斥；
  *   `--trust` 与 `--no-trust`；`--api-key` 需要 `--model`；`--output-format` 需要 `-p`。
  * - `--resume [id]`：下一个参数形如会话 id（无空白、不以 `-` 开头）才被当作 id；
@@ -11,7 +12,15 @@
  */
 import { AmaError } from "../errors.js";
 import { CODEMODE_MODES } from "../config/types.js";
-export const SUBCOMMANDS = ["auth", "sessions", "models", "doctor", "config"];
+export const SUBCOMMANDS = [
+    "auth",
+    "sessions",
+    "models",
+    "providers",
+    "doctor",
+    "config",
+    "init",
+];
 export class UsageError extends AmaError {
     constructor(message) {
         super("invalid_arguments", message, { exitCode: 2 });
@@ -40,12 +49,14 @@ export const HELP_TEXT = `用法：ama [选项] [提示]
   --no-tui                     行式界面（readline + 括号粘贴）
   -p, --print                  非交互：执行提示后退出（提示可来自参数与 stdin 管道）
   --output-format <格式>       -p 的输出：text（缺省）| json | stream-json
+  --image <文件>               -p 随提示发送图片（可重复；png / jpg / gif / webp，单张 ≤ 5 MB）；
+                               交互界面里写 @图片路径 或粘贴图片路径
   --mode rpc                   stdio JSONL 协议（供嵌入）
   --tui-mode <模式>            显示模式，第一期只有 regular（主屏）
   --quiet-startup <档>         启动画面：normal | header | silent
 
 模型
-  --model <provider/id>        模型（可配合 --provider 只写 id）
+  --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
@@ -83,10 +94,18 @@ export const HELP_TEXT = `用法：ama [选项] [提示]
   ama models check <provider/id>     发一次最小请求检查可用性
   ama models discover <provider> [--probe] [--write] [--limit N]
                                从中转 /v1/models 列出模型，探测协议并写入配置
+  ama models refresh-catalog   强制刷新 models.dev 模型元数据缓存
+  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；已有的不覆盖
 
 其它
   -h, --help                   输出本帮助
@@ -119,6 +138,7 @@ const VALUE_OPTIONS = new Set([
     "exclude-tools",
     "tools-preset",
     "codemode",
+    "image",
 ]);
 const FLAG_ALIASES = {
     "-h": "help",
@@ -146,6 +166,7 @@ export function emptyArgs() {
         skillDirs: [],
         allow: [],
         deny: [],
+        images: [],
         continue: false,
         resume: false,
         print: false,
@@ -228,6 +249,9 @@ function applyValue(args, option, value) {
         case "codemode":
             args.codemode = choice(option, value, CODEMODE_MODES);
             break;
+        case "image":
+            args.images.push(value);
+            break;
     }
 }
 function applyFlag(args, name) {
@@ -277,6 +301,9 @@ function validate(args) {
     if (args.outputFormat !== undefined && !args.print) {
         throw new UsageError("--output-format 只用于 -p / --print");
     }
+    if (args.images.length > 0 && !args.print) {
+        throw new UsageError("--image 只用于 -p / --print（交互界面里写 @图片路径）");
+    }
 }
 /** 解析 argv（不含 node 与脚本路径）；用法错误抛 UsageError（退出码 2）。 */
 export function parseArgs(argv) {

package/dist/cli/bootstrap.js

@@ -143,6 +143,7 @@ export async function bootstrap(argsIn, deps, io) {
             ? resolve(io.cwd, args.authFile)
             : defaultAuthFilePath(paths.configDir),
         authEnv: profile?.authEnv ?? true,
+        dataDir: paths.dataDir,
         ...(args.apiKey !== undefined && args.model !== undefined
             ? {
                 cliApiKey: {

package/dist/cli/compose-providers.js

@@ -10,6 +10,7 @@
  * - 零配置（设计 §10.0）：没有 `defaultModel`、也没有任何需要 key 的供应商配了 key 时，探测本地
  *   ollama / lmstudio（短超时），把枚举到的模型加进注册表，供 `pickDefaultModel` 选用。
  */
+import { loadModelsDevIndex } from "../ai/providers/models-dev-cache.js";
 import { ProviderRegistry, discoverLocalModels } from "../ai/providers/registry.js";
 export const LOCAL_PROBE_TIMEOUT_MS = 300;
 export const NO_LOCAL_PROBE_ENV = "AMA_NO_LOCAL_PROBE";
@@ -45,6 +46,7 @@ export function withExtraProviders(config, providers) {
 }
 export async function buildProviderRegistry(input, options = {}) {
     const config = withExtraProviders(input.config, options.providers);
+    const dataDir = input.dataDir;
     const make = (cliApiKey) => new ProviderRegistry({
         config,
         apis: options.apis,
@@ -57,6 +59,7 @@ export async function buildProviderRegistry(input, options = {}) {
             env: options.env,
         },
         onWarning: options.warn,
+        ...(dataDir !== undefined ? { modelsDev: () => loadModelsDevIndex(dataDir) } : {}),
     });
     let registry = make();
     const cli = input.cliApiKey;

package/dist/cli/compose-session.d.ts

@@ -15,6 +15,7 @@
  * - 会话切换：`switchSession()` 复用同一份装配材料建新会话，`assembly.onSessionReplaced(next)`
  *   让宿主访问、Hook 公共字段与退出 dispose 跟随新会话。
  */
+import type { ProviderRegistryApi } from "../ai/types.js";
 import { AgentSessionImpl } from "../agent/session.js";
 import type { AgentSession, CacheSettings, SessionEvent } from "../agent/types.js";
 import { type AmaConfig } from "../config/types.js";
@@ -32,6 +33,8 @@ export interface ComposeState {
     warnings: string[];
     /** 当前会话（工具工厂的 `session()`）。 */
     session: AgentSession | undefined;
+    /** 第 11 步建好的供应商注册表（read 工具判断当前模型收不收图片）。 */
+    providers?: ProviderRegistryApi;
 }
 export declare function emptyComposeState(): ComposeState;
 export type LogFn = (level: "debug" | "info" | "warn" | "error", message: string) => void;

package/dist/cli/compose.d.ts

@@ -23,7 +23,7 @@
  * 需要会话时用 `ctx.session()`，嵌套调用其它工具用 `ToolContext.tools.executeTool`（走完整门禁）。
  */
 import type { ApiRegistry } from "../ai/apis/api.js";
-import type { ProviderData } from "../ai/types.js";
+import type { ModelRef, ProviderData } from "../ai/types.js";
 import type { AgentSession } from "../agent/types.js";
 import type { AmaConfig } from "../config/types.js";
 import type { Rule } from "../permissions/types.js";
@@ -82,6 +82,8 @@ export declare function createTools(input: {
     cwd: string;
     mode: RuntimeMode;
 }, options: ComposeOptions, state: ComposeState): PresetToolRegistry;
+/** 当前模型是否收图片（read 工具用）；查不到模型时按收（交给协议层过滤）。 */
+export declare function modelAcceptsImages(state: ComposeState, model: ModelRef | undefined): boolean;
 /** 第 14 步前：内置 deny（builtinDeny 过滤）+ 用户规则；非法规则 warning 后跳过。 */
 export declare function buildRules(specs: readonly {
     effect: "allow" | "deny";

package/dist/cli/compose.js

@@ -22,6 +22,7 @@
  * 第 12 步建注册表时调用，产物以 `builtin` 来源注册（受预设管理）；工厂拿不到会话对象本身，执行期
  * 需要会话时用 `ctx.session()`，嵌套调用其它工具用 `ToolContext.tools.executeTool`（走完整门禁）。
  */
+import { formatModelRef } from "../ai/providers/channels.js";
 import { PermissionPipeline } from "../permissions/pipeline.js";
 import { BUILTIN_DENY_RULES, parseRule } from "../permissions/rules.js";
 import { discoverSkills, skillSources } from "../skills/discover.js";
@@ -58,7 +59,10 @@ export function createTools(input, options, state) {
     const bash = input.config.tools?.bashTimeoutMs !== undefined
         ? { defaultTimeoutMs: input.config.tools.bashTimeoutMs }
         : {};
-    const builtins = builtinTools({ bash });
+    const builtins = builtinTools({
+        bash,
+        read: { supportsImages: (ctx) => modelAcceptsImages(state, ctx.model) },
+    });
     const ctx = {
         ...input,
         registry,
@@ -94,6 +98,13 @@ export function createTools(input, options, state) {
     state.warnings.push(...preset.warnings);
     return registry;
 }
+/** 当前模型是否收图片（read 工具用）；查不到模型时按收（交给协议层过滤）。 */
+export function modelAcceptsImages(state, model) {
+    if (model === undefined || state.providers === undefined)
+        return true;
+    const found = state.providers.findModel(formatModelRef(model));
+    return found.ok ? found.model.input.includes("image") : true;
+}
 /** 第 14 步前：内置 deny（builtinDeny 过滤）+ 用户规则；非法规则 warning 后跳过。 */
 export function buildRules(specs, builtinDeny, warn) {
     const rules = [];
@@ -142,14 +153,18 @@ export function createRuntimeDeps(options = {}) {
     const state = emptyComposeState();
     const deps = {
         providers: {
-            create: (input) => buildProviderRegistry(input, {
-                providers: options.providers,
-                apis: options.apis,
-                env: options.env,
-                includeFake: options.includeFake,
-                probeLocal: options.probeLocal,
-                warn: (message) => state.warnings.push(message),
-            }),
+            create: async (input) => {
+                const registry = await buildProviderRegistry(input, {
+                    providers: options.providers,
+                    apis: options.apis,
+                    env: options.env,
+                    includeFake: options.includeFake,
+                    probeLocal: options.probeLocal,
+                    warn: (message) => state.warnings.push(message),
+                });
+                state.providers = registry;
+                return registry;
+            },
         },
         sessions: createSessionStore(),
         tools: { create: (input) => createTools(input, options, state) },

package/dist/cli/deps.d.ts

@@ -51,6 +51,8 @@ export interface ProviderBuildInput {
         modelRef: string;
         provider?: string;
     };
+    /** 数据目录：读 models.dev 缓存（`<dataDir>/models-dev.json`，只读不联网）；缺省不补元数据。 */
+    dataDir?: string;
 }
 export interface ResourceDiscoveryInput {
     cwd: string;

package/dist/cli/main.d.ts

@@ -4,7 +4,8 @@
  *
  * - 设 `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` 分派后返回；其余命令启动前若配置目录不存在则静默初始化（`AMA_NO_INIT=1` 关闭）；
  *   其余交给 `runCli()`（bootstrap → 模式）。
  * - 运行时实现（RuntimeDeps）：`MainOptions.deps` > `registerRuntimeDeps()` > 组装根
  *   `createRuntimeDeps()`（cli/compose.ts，动态 import）。

package/dist/cli/main.js

@@ -4,7 +4,8 @@
  *
  * - 设 `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` 分派后返回；其余命令启动前若配置目录不存在则静默初始化（`AMA_NO_INIT=1` 关闭）；
  *   其余交给 `runCli()`（bootstrap → 模式）。
  * - 运行时实现（RuntimeDeps）：`MainOptions.deps` > `registerRuntimeDeps()` > 组装根
  *   `createRuntimeDeps()`（cli/compose.ts，动态 import）。
@@ -21,6 +22,10 @@ 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";
 let registeredDeps;
 /** 集成批次注入运行时实现（B1 / B2 / B3 / B6 / B7）。 */
@@ -116,6 +121,9 @@ 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";
+        if (!informational)
+            autoInitConfigDir(resolveConfigDir({ env: io.env }), io.env);
         if (parsed.kind === "subcommand") {
             switch (parsed.name) {
                 case "auth":
@@ -124,10 +132,14 @@ 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);
             }
         }
         if (parsed.args.version) {

package/dist/cli/startup-steps.js

@@ -2,6 +2,7 @@
  * 启动序列的单步辅助（设计 §11.1）：错误映射、模式判定、profile 合并、会话请求、
  * 模型与思考级别解析、工具过滤、指令文件。[B5] 由 cli/bootstrap.ts 编排。
  */
+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";
@@ -119,7 +120,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 };
         }

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

@@ -10,7 +10,7 @@
 import type { AmaConfig } 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      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";
     label: string;
@@ -30,10 +30,19 @@ 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 来自环境变量的内置供应商。 */

package/dist/cli/subcommands/config.js

@@ -7,9 +7,16 @@
  * `ANTHROPIC_BASE_URL`）的内置供应商，列出协议、生效 baseUrl 与来源、config 里每个模型的协议
  * （模型级 `api` 生效后的值）。
  */
+import { metadataOf, modelFlags, sourcesLine } from "./model-meta.js";
 import { loadConfigFile } from "../../config/load.js";
 import { DEFAULT_CONFIG, PROFILE_DEFAULTS, mergeProjectAndCli } from "../../config/merge.js";
-import { CONFIG_FILE, projectFile } from "../../config/paths.js";
+import { AUTH_FILE, CONFIG_FILE, HOOKS_FILE, projectFile, resolveConfigDir, resolveDataDir, } from "../../config/paths.js";
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { modelsDevCachePath } from "../../ai/providers/models-dev-cache.js";
+import { initConfigDir } from "../../config/init.js";
+import { CONFIG_SCHEMA_FILE } from "../../config/json-schema.js";
 import { baseUrlEnvOf } from "../../ai/providers/registry.js";
 import { classifyKeyValue } from "../../config/auth-file.js";
 import { effectiveCodemodeMode, resolvePreset } from "../../tools/presets.js";
@@ -19,7 +26,47 @@ import { pickDefaultModel } from "../default-model.js";
 import { ExitCode } from "../exit-codes.js";
 import { buildRegistry, loadUserLevel } from "./context.js";
 export const CONFIG_USAGE = `用法：ama config show [--json] [--profile <文件>] [--auth-file <文件>]
+      ama config path    配置目录、数据目录与各文件路径
+      ama config edit    用 $VISUAL / $EDITOR 打开 config.json（没有编辑器时打印路径）
 `;
+/** `ama config path`：目录与文件路径，标出是否存在。 */
+function showPaths(io) {
+    const configDir = resolveConfigDir({ env: io.env });
+    const dataDir = resolveDataDir({ env: io.env });
+    const mark = (path) => `${path}${existsSync(path) ? "" : "  （不存在）"}`;
+    const lines = [
+        `配置目录  ${mark(configDir)}`,
+        `  config.json         ${mark(join(configDir, CONFIG_FILE))}`,
+        `  config.schema.json  ${mark(join(configDir, CONFIG_SCHEMA_FILE))}`,
+        `  auth.json           ${mark(join(configDir, AUTH_FILE))}`,
+        `  hooks.json          ${mark(join(configDir, HOOKS_FILE))}`,
+        `数据目录  ${mark(dataDir)}`,
+        `  sessions/           ${mark(join(dataDir, "sessions"))}`,
+        `  models-dev.json     ${mark(modelsDevCachePath(dataDir))}`,
+        `项目级    ${mark(projectFile(io.cwd, CONFIG_FILE))}`,
+    ];
+    io.stdout(`${lines.join("\n")}\n`);
+    return ExitCode.Ok;
+}
+/** `ama config edit`：不存在先 init；`$VISUAL` / `$EDITOR`（可带参数）打开，没有就打印路径。 */
+function editConfig(io) {
+    const configDir = resolveConfigDir({ env: io.env });
+    const path = join(configDir, CONFIG_FILE);
+    if (!existsSync(path))
+        initConfigDir(configDir);
+    const editor = (io.env["VISUAL"] ?? io.env["EDITOR"] ?? "").trim();
+    if (editor === "") {
+        io.stdout(`${path}\n（没有设置 $VISUAL / $EDITOR，请用编辑器打开上面的文件）\n`);
+        return ExitCode.Ok;
+    }
+    const quoted = process.platform === "win32" ? `"${path}"` : `'${path.replace(/'/g, `'\\''`)}'`;
+    const result = spawnSync(`${editor} ${quoted}`, { stdio: "inherit", shell: true });
+    if (result.error !== undefined || result.status !== 0) {
+        io.stderr(`ama: 编辑器退出异常（${editor}）；文件在 ${path}\n`);
+        return ExitCode.RuntimeError;
+    }
+    return ExitCode.Ok;
+}
 function isObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -82,7 +129,27 @@ export function describeProviders(config, registry) {
             api: provider.api,
             baseUrl: provider.baseUrl,
             ...(env !== undefined ? { baseUrlEnv: env } : {}),
-            models: provider.models.filter((m) => ids.has(m.id)).map((m) => ({ id: m.id, api: m.api })),
+            ...(provider.channels !== undefined
+                ? {
+                    channels: provider.channels.map((c) => ({
+                        name: c.name,
+                        api: c.api,
+                        baseUrl: c.baseUrl,
+                    })),
+                }
+                : {}),
+            models: provider.models
+                .filter((m) => ids.has(m.id))
+                .map((m) => {
+                const sources = sourcesLine(metadataOf(registry, provider.id, m.id));
+                return {
+                    id: m.id,
+                    api: m.api,
+                    ...(m.channels !== undefined ? { channels: [...m.channels] } : {}),
+                    flags: modelFlags(m),
+                    ...(sources !== undefined ? { sources } : {}),
+                };
+            }),
         });
     }
     return out;
@@ -94,8 +161,13 @@ function providerLines(providers) {
     for (const p of providers) {
         const env = p.baseUrlEnv !== undefined ? `（baseUrl 来自环境变量 ${p.baseUrlEnv}）` : "";
         lines.push(`  ${p.id}  ${p.api}  ${p.baseUrl}${env}`);
-        for (const m of p.models)
-            lines.push(`    ${p.id}/${m.id}  ${m.api}`);
+        for (const c of p.channels ?? [])
+            lines.push(`    @${c.name}  ${c.api}  ${c.baseUrl}`);
+        for (const m of p.models) {
+            lines.push(`    ${p.id}/${m.id}  ${m.api}  ${m.flags}`);
+            if (m.sources !== undefined)
+                lines.push(`      ${m.sources}`);
+        }
     }
     return lines;
 }
@@ -156,6 +228,10 @@ export async function runConfig(argv, io, deps) {
         io.stdout(CONFIG_USAGE);
         return ExitCode.Ok;
     }
+    if (action === "path")
+        return showPaths(io);
+    if (action === "edit")
+        return editConfig(io);
     if (action !== "show")
         throw new UsageError(`未知的 config 子命令：${action}`);
     const level = loadUserLevel(io, {

package/dist/cli/subcommands/context.js

@@ -37,5 +37,6 @@ export async function buildRegistry(level, io, deps) {
         cwd: io.cwd,
         authFile: level.authFile,
         authEnv: level.profile?.authEnv ?? true,
+        dataDir: level.dataDir,
     });
 }

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

@@ -0,0 +1,6 @@
+/**
+ * `ama init [--force]`（docs/providers.md「配置目录」）：建配置目录与缺省文件，逐个报告状态。
+ */
+import type { CliIo } from "../deps.js";
+export declare const INIT_USAGE = "\u7528\u6CD5\uFF1Aama init [--force]   \u5EFA\u914D\u7F6E\u76EE\u5F55\uFF080700\uFF09\u4E0E config.json\u3001config.schema.json\n                          \u5DF2\u6709\u7684 config.json \u4E0D\u8986\u76D6\uFF08--force \u5148\u5907\u4EFD\u4E3A .bak \u518D\u91CD\u5199\uFF09\uFF1B\u4E0D\u521B\u5EFA auth.json\n";
+export declare function runInit(argv: readonly string[], io: CliIo): number;

package/dist/cli/subcommands/init.js

@@ -0,0 +1,22 @@
+/**
+ * `ama init [--force]`（docs/providers.md「配置目录」）：建配置目录与缺省文件，逐个报告状态。
+ */
+import { describeInit, initConfigDir } from "../../config/init.js";
+import { resolveConfigDir } from "../../config/paths.js";
+import { parseSubArgs, UsageError } from "../args.js";
+import { ExitCode } from "../exit-codes.js";
+export const INIT_USAGE = `用法：ama init [--force]   建配置目录（0700）与 config.json、config.schema.json
+                          已有的 config.json 不覆盖（--force 先备份为 .bak 再重写）；不创建 auth.json
+`;
+export function runInit(argv, io) {
+    const { positionals, flags } = parseSubArgs(argv, [], ["force"]);
+    if (flags.has("help")) {
+        io.stdout(INIT_USAGE);
+        return ExitCode.Ok;
+    }
+    if (positionals.length > 0)
+        throw new UsageError(`多余的参数：${positionals.join(" ")}`);
+    const result = initConfigDir(resolveConfigDir({ env: io.env }), { force: flags.has("force") });
+    io.stdout(describeInit(result));
+    return ExitCode.Ok;
+}

package/dist/cli/subcommands/model-meta.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 模型元数据的一行描述（`ama models list`、`ama config show`、`ama providers`）：上下文、输出、思考、
+ * 图片、渠道，以及每个字段来自哪里（config / 目录 / models.dev / 缺省）与 models.dev 匹配。
+ */
+import { type ModelMetadata } from "../../ai/providers/enrich.js";
+import type { Model, ProviderRegistryApi } from "../../ai/types.js";
+export declare function compactTokens(n: number | undefined): string;
+/** 注册表若是 ProviderRegistry（或同形状），取模型元数据来源；否则 undefined。 */
+export declare function metadataOf(registry: ProviderRegistryApi, providerId: string, modelId: string): ModelMetadata | undefined;
+/** `ctx 262k · out 64k · 思考 · 图片 · 渠道 chat,messages`。 */
+export declare function modelFlags(model: Model): string;
+/**
+ * 来源说明：全部来自内置目录时返回 undefined（不刷屏）；否则
+ * `来源 ctx models.dev · out config · 图片 models.dev · …；models.dev 原厂 moonshotai/kimi-k2.5`。
+ */
+export declare function sourcesLine(metadata: ModelMetadata | undefined): string | undefined;

package/dist/cli/subcommands/model-meta.js

@@ -0,0 +1,54 @@
+/**
+ * 模型元数据的一行描述（`ama models list`、`ama config show`、`ama providers`）：上下文、输出、思考、
+ * 图片、渠道，以及每个字段来自哪里（config / 目录 / models.dev / 缺省）与 models.dev 匹配。
+ */
+import { sourceText } from "../../ai/providers/enrich.js";
+import { matchLabel } from "../../ai/providers/models-dev.js";
+export function compactTokens(n) {
+    if (n === undefined)
+        return "?";
+    if (n >= 1_000_000)
+        return `${Math.round(n / 100_000) / 10}M`;
+    if (n >= 1000)
+        return `${Math.round(n / 1000)}k`;
+    return String(n);
+}
+/** 注册表若是 ProviderRegistry（或同形状），取模型元数据来源；否则 undefined。 */
+export function metadataOf(registry, providerId, modelId) {
+    const r = registry;
+    return typeof r.modelMetadata === "function" ? r.modelMetadata(providerId, modelId) : undefined;
+}
+/** `ctx 262k · out 64k · 思考 · 图片 · 渠道 chat,messages`。 */
+export function modelFlags(model) {
+    return [
+        `ctx ${compactTokens(model.contextWindow)}`,
+        `out ${compactTokens(model.maxTokens)}`,
+        model.reasoning ? "思考" : undefined,
+        model.input.includes("image") ? "图片" : undefined,
+        model.channels !== undefined ? `渠道 ${model.channels.join(",")}` : undefined,
+    ]
+        .filter((x) => x !== undefined)
+        .join(" · ");
+}
+/**
+ * 来源说明：全部来自内置目录时返回 undefined（不刷屏）；否则
+ * `来源 ctx models.dev · out config · 图片 models.dev · …；models.dev 原厂 moonshotai/kimi-k2.5`。
+ */
+export function sourcesLine(metadata) {
+    if (metadata === undefined)
+        return undefined;
+    const values = Object.values(metadata.sources);
+    if (values.every((s) => s === "catalog" || s === "default") && !metadata.looked)
+        return undefined;
+    const label = {
+        contextWindow: "ctx",
+        maxTokens: "out",
+        input: "图片",
+        reasoning: "思考",
+        cost: "价格",
+    };
+    const parts = Object.keys(label).map((field) => `${label[field]} ${sourceText(metadata.sources[field])}`);
+    const match = metadata.looked ? `；models.dev ${matchLabel(metadata.match)}` : "";
+    const tools = metadata.toolCall === false ? "；不支持工具调用" : "";
+    return `来源 ${parts.join(" · ")}${match}${tools}`;
+}