@armadra/agent 0.2.1 → 0.4.0

package/dist/cli/args.d.ts

@@ -2,7 +2,9 @@
  * 手写参数解析（设计 §11.1 第 2 步、§12.10、§13）。[B5]
  *
  * - 支持 `--opt value` 与 `--opt=value`；`--` 之后全部作为提示文本；可重复的参数累加。
- * - 子命令只在第一个参数是 `auth / sessions / models / doctor / config` 时识别，其余参数原样交给子命令。
+ * - 位置参数 `-`：`-p` 一直等 stdin 到 EOF（有提示参数时也不设首字节超时）。
+ * - 子命令只在第一个参数是 `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,9 +13,9 @@
  */
 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"];
+import { type PermissionMode } from "../permissions/types.js";
+import { type CodemodeMode, type ToolsPreset } from "../config/types.js";
+export declare const SUBCOMMANDS: readonly ["auth", "sessions", "models", "providers", "doctor", "config", "init", "stats"];
 export type SubcommandName = (typeof SUBCOMMANDS)[number];
 export type OutputFormat = "text" | "json" | "stream-json";
 export type QuietStartup = "normal" | "header" | "silent";
@@ -54,6 +56,22 @@ export interface ParsedArgs {
     toolsPreset?: ToolsPreset;
     /** `--codemode`：覆盖 config `codemode.mode`。 */
     codemode?: CodemodeMode;
+    /** `--no-session`：会话只在内存里，不写会话文件。 */
+    noSession: boolean;
+    /** `--system-prompt <文本|@文件>`：缺省追加进系统提示的 rules 节。 */
+    systemPrompt?: string;
+    /** `--system-prompt-mode`：append（缺省）| replace（替换开头的 preamble）。 */
+    systemPromptMode?: "append" | "replace";
+    /** `--max-turns N`（只用于 -p）：一次运行最多 N 轮（模型请求 + 工具执行算一轮）。 */
+    maxTurns?: number;
+    /** 位置参数 `-`（只用于 -p）：一直等 stdin 到 EOF，不设首字节超时。 */
+    stdin: boolean;
+    /** `--no-stdin`（只用于 -p）：不读 stdin。 */
+    noStdin: boolean;
+    /** `--image <文件>`（可重复，只用于 -p）：随首条提示发送的图片。 */
+    images: string[];
+    /** `--from <会话 id>[#编号]`：用旧会话的一条用户消息作为提示（cli/from-prompt.ts）。 */
+    from?: string;
     /** 位置参数拼成的提示（空格连接）。 */
     prompt?: string;
     /** 原始位置参数。 */
@@ -70,7 +88,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\u3002\u63D0\u793A = \u53C2\u6570 + stdin \u7BA1\u9053\u5185\u5BB9\uFF1B\u6709\u63D0\u793A\u53C2\u6570\u65F6\n                               \u53EA\u7B49\u7BA1\u9053\u9996\u5B57\u8282 2 s\uFF08AMA_STDIN_WAIT_MS\uFF09\uFF0C\u6CA1\u6536\u5230\u5C31\u5FFD\u7565\u5E76\u63D0\u793A\uFF1B\n                               \u672B\u5C3E\u52A0 - \u5219\u4E00\u76F4\u7B49\u5230 EOF\uFF08\u5982 npm test | ama -p \u627E\u539F\u56E0 -\uFF09\n  --no-stdin                   -p \u4E0D\u8BFB stdin\uFF08\u7236\u8FDB\u7A0B\u7559\u7740\u7BA1\u9053\u3001\u53C8\u4E0D\u60F3\u7B49 2 s \u65F6\uFF09\n  --output-format <\u683C\u5F0F>       -p \u7684\u8F93\u51FA\uFF1Atext\uFF08\u7F3A\u7701\uFF09| json | stream-json\n  --max-turns <N>              -p \u6700\u591A\u8DD1 N \u8F6E\uFF08\u4E00\u6B21\u6A21\u578B\u8BF7\u6C42\u52A0\u5176\u5DE5\u5177\u6267\u884C\u7B97\u4E00\u8F6E\uFF09\uFF1B\u5230\u8FBE\u4E0A\u9650\u4ECD\u6709\n                               \u672A\u5B8C\u6210\u7684\u5DE5\u5177\u8C03\u7528\u65F6\u63D0\u524D\u7ED3\u675F\uFF0C\u9000\u51FA\u7801 1\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  --no-session                 \u4F1A\u8BDD\u53EA\u5728\u5185\u5B58\u91CC\uFF0C\u4E0D\u5199\u4F1A\u8BDD\u6587\u4EF6\uFF08\u4E4B\u540E\u65E0\u6CD5 --resume\uFF09\n  --from <id>[#\u7F16\u53F7]           \u7528\u65E7\u4F1A\u8BDD\u7684\u4E00\u6761\u7528\u6237\u6D88\u606F\u4F5C\u63D0\u793A\uFF08\u7F3A\u7701\u6700\u540E\u4E00\u6761\uFF1B-p \u65F6\u8FDE\u56FE\u7247\u4E00\u8D77\uFF1B\n                               \u7F16\u53F7\u89C1 ama sessions show\uFF09\n\n\u6743\u9650\u4E0E\u4FE1\u4EFB\n  --permission-mode <\u6A21\u5F0F>     default | auto-edit | plan | auto | full-auto | allowlist\n                               \uFF08auto \u7531 ama \u5224\u65AD\u6BCF\u4E00\u6B65\uFF1Ballowlist \u53EA\u653E\u884C allow \u89C4\u5219\u547D\u4E2D\u7684\uFF0C\u9002\u5408 CI\uFF09\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  --system-prompt <\u6587\u672C|@\u6587\u4EF6> \u8FFD\u52A0\u7CFB\u7EDF\u63D0\u793A\uFF1A\u7F3A\u7701\u4F5C\u4E3A\u6700\u540E\u4E00\u6761\u89C4\u5219\u8FFD\u52A0\uFF08\u5DE5\u5177\u8868\u7B49\u524D\u7F00\u4E0D\u53D8\uFF0C\u5229\u4E8E\u7F13\u5B58\uFF09\n  --system-prompt-mode <\u65B9\u5F0F>  append\uFF08\u7F3A\u7701\uFF09| replace\uFF08\u66FF\u6362\u5F00\u5934\u7684\u89D2\u8272\u8BF4\u660E\uFF0C\u5DE5\u5177\u4E0E\u9879\u76EE\u4E0A\u4E0B\u6587\u4FDD\u7559\uFF09\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-only | coordinator\n                               \uFF08codemode \u662F codemode-only \u7684\u65E7\u540D\uFF0C\u4ECD\u53EF\u7528\uFF09\n  --codemode <\u6A21\u5F0F>            codemode \u8C03\u7528\u65B9\u5F0F\uFF1Aoff | on | only\uFF08\u7F3A\u7701\u968F\u9884\u8BBE\uFF09\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 sessions search <\u5173\u952E\u8BCD|/\u6B63\u5219/> [--all] [--role user|assistant|tool] [--since 7d] [--limit N]\n                               \u8DE8\u4F1A\u8BDD\u5168\u6587\u68C0\u7D22\n  ama sessions export <id> [--format md|json|jsonl] [--output <\u6587\u4EF6>] [--branch leaf|all]\n                               \u5BFC\u51FA\u4F1A\u8BDD\uFF08\u5DF2\u8131\u654F\uFF09\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  ama stats [--since 7d] [--by day|week|month|provider|channel|model|project] [--all] [--json]\n                               \u8DE8\u4F1A\u8BDD\u7EDF\u8BA1\uFF1A\u8BF7\u6C42\u3001token\u3001\u7F13\u5B58\u547D\u4E2D\u7387\u3001\u8D39\u7528\u3001\u5DE5\u5177\u8C03\u7528\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 7 -p \u6709\u5DE5\u5177\u8C03\u7528\u88AB\u62D2\uFF08\u65E0\u4EBA\u5BA1\u6279\uFF1B\u7528\n        --permission-mode auto-edit|auto \u6216 --allow \u653E\u884C\uFF09\u00B7 78 \u5BBF\u4E3B API \u7248\u672C\u4E0D\u5339\u914D \u00B7\n        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,9 @@
  * 手写参数解析（设计 §11.1 第 2 步、§12.10、§13）。[B5]
  *
  * - 支持 `--opt value` 与 `--opt=value`；`--` 之后全部作为提示文本；可重复的参数累加。
- * - 子命令只在第一个参数是 `auth / sessions / models / doctor / config` 时识别，其余参数原样交给子命令。
+ * - 位置参数 `-`：`-p` 一直等 stdin 到 EOF（有提示参数时也不设首字节超时）。
+ * - 子命令只在第一个参数是 `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；
@@ -10,15 +12,26 @@
  * - `--provider` 不带 `--model` 不在这里报错，由 bootstrap 第 11 步报（退出码 2）。
  */
 import { AmaError } from "../errors.js";
+import { PERMISSION_MODES_STRICT_FIRST } from "../permissions/types.js";
+import { canonicalPreset } from "../config/types.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",
+    "stats",
+];
 export class UsageError extends AmaError {
     constructor(message) {
         super("invalid_arguments", message, { exitCode: 2 });
         this.name = "UsageError";
     }
 }
-const PERMISSION_MODES = ["plan", "default", "auto-edit", "full-auto"];
+const PERMISSION_MODES = PERMISSION_MODES_STRICT_FIRST;
 const THINKING_LEVELS = [
     "off",
     "minimal",
@@ -29,8 +42,8 @@ const THINKING_LEVELS = [
 ];
 const OUTPUT_FORMATS = ["text", "json", "stream-json"];
 const QUIET_LEVELS = ["normal", "header", "silent"];
-/** 帮助与报错按常用顺序列出（校验集合同 TOOLS_PRESETS_STRICT_FIRST）。 */
-const PRESET_CHOICES = ["default", "minimal", "codemode", "coordinator"];
+/** 帮助与报错按常用顺序列出（校验集合同 TOOLS_PRESET_INPUTS；`codemode` 是 `codemode-only` 的别名）。 */
+const PRESET_CHOICES = ["default", "minimal", "codemode-only", "coordinator", "codemode"];
 const SESSION_ID_LIKE = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;
 export const HELP_TEXT = `用法：ama [选项] [提示]
       ama <子命令> …
@@ -38,14 +51,21 @@ export const HELP_TEXT = `用法：ama [选项] [提示]
 模式
   （缺省）                     终端界面；stdin / stdout 非 TTY 或 TERM=dumb 时自动降级为行式
   --no-tui                     行式界面（readline + 括号粘贴）
-  -p, --print                  非交互：执行提示后退出（提示可来自参数与 stdin 管道）
+  -p, --print                  非交互：执行提示后退出。提示 = 参数 + stdin 管道内容；有提示参数时
+                               只等管道首字节 2 s（AMA_STDIN_WAIT_MS），没收到就忽略并提示；
+                               末尾加 - 则一直等到 EOF（如 npm test | ama -p 找原因 -）
+  --no-stdin                   -p 不读 stdin（父进程留着管道、又不想等 2 s 时）
   --output-format <格式>       -p 的输出：text（缺省）| json | stream-json
+  --max-turns <N>              -p 最多跑 N 轮（一次模型请求加其工具执行算一轮）；到达上限仍有
+                               未完成的工具调用时提前结束，退出码 1
+  --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
@@ -56,14 +76,20 @@ export const HELP_TEXT = `用法：ama [选项] [提示]
   --session-id <id>            使用指定 id 的会话（不存在则新建）
   --fork <id>                  从指定会话分叉出新会话
   --session-dir <目录>         会话目录（缺省 ~/.local/share/ama/sessions）
+  --no-session                 会话只在内存里，不写会话文件（之后无法 --resume）
+  --from <id>[#编号]           用旧会话的一条用户消息作提示（缺省最后一条；-p 时连图片一起；
+                               编号见 ama sessions show）
 
 权限与信任
-  --permission-mode <模式>     plan | default | auto-edit | full-auto
+  --permission-mode <模式>     default | auto-edit | plan | auto | full-auto | allowlist
+                               （auto 由 ama 判断每一步；allowlist 只放行 allow 规则命中的，适合 CI）
   --allow <规则>               追加允许规则，可重复（如 "bash(git status*)"）
   --deny <规则>                追加拒绝规则，可重复（如 "write(**/.env*)"）
   --trust / --no-trust         信任 / 不信任当前项目（项目级 Hook、Skill、提示模板）
 
 资源
+  --system-prompt <文本|@文件> 追加系统提示：缺省作为最后一条规则追加（工具表等前缀不变，利于缓存）
+  --system-prompt-mode <方式>  append（缺省）| replace（替换开头的角色说明，工具与项目上下文保留）
   --profile <文件>             宿主 profile.json（字段等价于对应参数，命令行优先）
   --host <模块>                宿主适配器模块（CJS / ESM）
   --instructions <文件>        追加指令文件，可重复
@@ -71,29 +97,46 @@ export const HELP_TEXT = `用法：ama [选项] [提示]
   --auth-file <文件>           auth.json 位置（缺省 ~/.config/ama/auth.json）
   --tools <a,b,…>              只启用这些工具
   --exclude-tools <a,b,…>      禁用这些工具
-  --tools-preset <名>          工具预设：default（缺省）| minimal | codemode | coordinator
-  --codemode <模式>            codemode 调用方式：off | on | only
+  --tools-preset <名>          工具预设：default（缺省）| minimal | codemode-only | coordinator
+                               （codemode 是 codemode-only 的旧名，仍可用）
+  --codemode <模式>            codemode 调用方式：off | on | only（缺省随预设）
 
 子命令
   ama auth set <provider>      从 stdin 读取 key 写入 auth.json（0600）
   ama auth list                列出已保存 key 的供应商（不显示 key）
   ama auth remove <provider>   删除已保存的 key
   ama sessions list|show|prune 会话管理
+  ama sessions search <关键词|/正则/> [--all] [--role user|assistant|tool] [--since 7d] [--limit N]
+                               跨会话全文检索
+  ama sessions export <id> [--format md|json|jsonl] [--output <文件>] [--branch leaf|all]
+                               导出会话（已脱敏）
   ama models list [--provider <id>]  列出模型（含来源与 key 状态）
   ama models check <provider/id>     发一次最小请求检查可用性
   ama models discover <provider> [--probe] [--write] [--limit N]
                                从中转 /v1/models 列出模型，探测协议并写入配置
+  ama models refresh-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；已有的不覆盖
+  ama stats [--since 7d] [--by day|week|month|provider|channel|model|project] [--all] [--json]
+                               跨会话统计：请求、token、缓存命中率、费用、工具调用
 
 其它
   -h, --help                   输出本帮助
   -v, --version                输出版本
 
 退出码：0 正常 · 1 运行期错误 · 2 用法错误 · 3 配置错误 · 4 无可用模型或 key ·
-        5 会话错误 · 6 宿主 / Hook 启动失败 · 78 宿主 API 版本不匹配 · 130 SIGINT · 143 SIGTERM
+        5 会话错误 · 6 宿主 / Hook 启动失败 · 7 -p 有工具调用被拒（无人审批；用
+        --permission-mode auto-edit|auto 或 --allow 放行）· 78 宿主 API 版本不匹配 ·
+        130 SIGINT · 143 SIGTERM
 `;
 const VALUE_OPTIONS = new Set([
     "profile",
@@ -119,6 +162,11 @@ const VALUE_OPTIONS = new Set([
     "exclude-tools",
     "tools-preset",
     "codemode",
+    "image",
+    "max-turns",
+    "system-prompt",
+    "system-prompt-mode",
+    "from",
 ]);
 const FLAG_ALIASES = {
     "-h": "help",
@@ -146,10 +194,14 @@ export function emptyArgs() {
         skillDirs: [],
         allow: [],
         deny: [],
+        images: [],
         continue: false,
         resume: false,
         print: false,
         noTui: false,
+        noSession: false,
+        stdin: false,
+        noStdin: false,
         positionals: [],
     };
 }
@@ -223,11 +275,30 @@ function applyValue(args, option, value) {
             args.excludeTools = [...(args.excludeTools ?? []), ...list(value)];
             break;
         case "tools-preset":
-            args.toolsPreset = choice(option, value, PRESET_CHOICES);
+            args.toolsPreset = canonicalPreset(choice(option, value, PRESET_CHOICES));
             break;
         case "codemode":
             args.codemode = choice(option, value, CODEMODE_MODES);
             break;
+        case "image":
+            args.images.push(value);
+            break;
+        case "system-prompt":
+            args.systemPrompt = value;
+            break;
+        case "system-prompt-mode":
+            args.systemPromptMode = choice(option, value, ["append", "replace"]);
+            break;
+        case "max-turns": {
+            const turns = Number(value);
+            if (!Number.isInteger(turns) || turns < 1)
+                throw new UsageError(`--max-turns 应为正整数（收到 ${value}）`);
+            args.maxTurns = turns;
+            break;
+        }
+        case "from":
+            args.from = value;
+            break;
     }
 }
 function applyFlag(args, name) {
@@ -247,6 +318,12 @@ function applyFlag(args, name) {
         case "no-tui":
             args.noTui = true;
             return true;
+        case "no-session":
+            args.noSession = true;
+            return true;
+        case "no-stdin":
+            args.noStdin = true;
+            return true;
         case "trust":
         case "no-trust": {
             const value = name === "trust";
@@ -271,12 +348,31 @@ function validate(args) {
     ].filter((f) => f !== undefined);
     if (sessionFlags.length > 1)
         throw new UsageError(`${sessionFlags.join(" 与 ")} 不能同时使用`);
+    if (args.noSession && sessionFlags.length > 0) {
+        throw new UsageError(`--no-session 与 ${sessionFlags[0]} 不能同时使用`);
+    }
     if (args.apiKey !== undefined && args.model === undefined) {
         throw new UsageError("--api-key 需要同时给出 --model");
     }
     if (args.outputFormat !== undefined && !args.print) {
         throw new UsageError("--output-format 只用于 -p / --print");
     }
+    if (args.systemPromptMode !== undefined && args.systemPrompt === undefined) {
+        throw new UsageError("--system-prompt-mode 需要同时给出 --system-prompt");
+    }
+    if (args.maxTurns !== undefined && !args.print) {
+        throw new UsageError("--max-turns 只用于 -p / --print");
+    }
+    if (args.noStdin && !args.print)
+        throw new UsageError("--no-stdin 只用于 -p / --print");
+    if (args.noStdin && args.stdin)
+        throw new UsageError("--no-stdin 与位置参数 - 不能同时使用");
+    if (args.stdin && !args.print) {
+        throw new UsageError("位置参数 - （从 stdin 读提示）只用于 -p / --print");
+    }
+    if (args.images.length > 0 && !args.print) {
+        throw new UsageError("--image 只用于 -p / --print（交互界面里写 @图片路径）");
+    }
 }
 /** 解析 argv（不含 node 与脚本路径）；用法错误抛 UsageError（退出码 2）。 */
 export function parseArgs(argv) {
@@ -291,7 +387,11 @@ export function parseArgs(argv) {
             args.positionals.push(...argv.slice(i + 1));
             break;
         }
-        if (!token.startsWith("-") || token === "-") {
+        if (token === "-") {
+            args.stdin = true;
+            continue;
+        }
+        if (!token.startsWith("-")) {
             args.positionals.push(token);
             continue;
         }

package/dist/cli/bootstrap.js

@@ -20,8 +20,10 @@ import { HookDispatcher } from "../hooks/dispatcher.js";
 import { AgentEventBus, createHostApi } from "../host/api-impl.js";
 import { activateHost, disposeHost } from "../host/loader.js";
 import { HELP_TEXT, parseArgs, UsageError } from "./args.js";
+import { applyFromOption } from "./from-prompt.js";
 import { ExitCode } from "./exit-codes.js";
 import { applyProfile, applyToolFilters, decideMode, defaultSendUser, instructionSources, resolveModel, sessionRequestOf, sourceOf, step, thinkingOf, toStartupError, } from "./startup-steps.js";
+import { resolveSystemPromptArg } from "./system-prompt-arg.js";
 /** §11.1 第 3–14 步。 */
 export async function bootstrap(argsIn, deps, io) {
     const warnings = [];
@@ -143,6 +145,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: {
@@ -153,10 +156,15 @@ export async function bootstrap(argsIn, deps, io) {
             }
             : {}),
     }));
-    const { model, provider } = await step(ExitCode.NoModel, "模型", () => resolveModel(args, providers, sessionManager, config.defaultModel, deps, interactive));
+    const { model, provider } = await step(ExitCode.NoModel, "模型", () => resolveModel(args, providers, sessionManager, config.defaultModel, deps, interactive, io.env));
     const thinkingLevel = thinkingOf(args, sessionManager, config.thinkingLevel);
     // 12. 工具注册表
-    const tools = await step(ExitCode.RuntimeError, "工具", () => deps.tools.create({ config, cwd: sessionCwd, mode }));
+    const tools = await step(ExitCode.RuntimeError, "工具", () => deps.tools.create({
+        config,
+        cwd: sessionCwd,
+        mode,
+        paths: { configDir: paths.configDir, dataDir: paths.dataDir },
+    }));
     for (const name of config.tools?.disabled ?? []) {
         if (tools.get(name) === undefined)
             warn(`config tools.disabled：未知工具 ${name}，已忽略`);
@@ -199,12 +207,14 @@ export async function bootstrap(argsIn, deps, io) {
         // 14. 组装 AgentSession、session_start、SessionStart Hook
         const unattended = mode === "print";
         const builtinDeny = config.permission?.builtinDeny;
+        const autoSafeCommands = config.permission?.autoSafeCommands;
         const permission = await step(ExitCode.Config, "权限", () => deps.permissions.create({
             mode: config.permission?.mode ?? "default",
             rules: merged.ruleSpecs,
             unattended,
             cwd: sessionCwd,
             ...(builtinDeny !== undefined ? { builtinDeny } : {}),
+            ...(autoSafeCommands !== undefined ? { autoSafeCommands } : {}),
         }));
         const hooks = new HookDispatcher({
             hooks: hookConfig.hooks,
@@ -259,6 +269,16 @@ export async function bootstrap(argsIn, deps, io) {
             unattended,
             warn,
         };
+        const overrides = {};
+        if (args.maxTurns !== undefined)
+            overrides.maxTurns = args.maxTurns;
+        if (args.noSession)
+            overrides.noSession = true;
+        const systemPrompt = await step(ExitCode.Config, "--system-prompt", () => resolveSystemPromptArg(args.systemPrompt, args.systemPromptMode, io.cwd));
+        if (systemPrompt !== undefined)
+            overrides.systemPrompt = systemPrompt;
+        if (Object.keys(overrides).length > 0)
+            assembly.overrides = overrides;
         session = await step(ExitCode.RuntimeError, "会话组装", () => deps.session.create(assembly));
         const active = session;
         let disposed;
@@ -358,11 +378,15 @@ export async function runCli(argv, deps, io) {
         return reportError(error, io);
     }
     const restore = runtime.mode === "print" || runtime.mode === "rpc" ? takeOverStdout() : () => undefined;
+    let cleanupFrom = () => undefined;
     try {
         if (runtime.mode !== "interactive")
             for (const w of runtime.warnings)
                 io.stderr(`ama: 警告：${w}\n`);
-        const context = { args, prompt: args.prompt, io };
+        // [W4-D] --from：旧会话的一条用户消息作提示（-p 时连图片，临时文件在 finally 删除）。
+        const from = applyFromOption(args, runtime, io);
+        cleanupFrom = from.cleanup;
+        const context = from.context;
         const runner = deps.modes[runtime.mode];
         if (runner === undefined)
             throw new AmaError("not_implemented", `模式 ${runtime.mode} 尚未装配`, { exitCode: 1 });
@@ -382,6 +406,7 @@ export async function runCli(argv, deps, io) {
     }
     finally {
         await runtime.dispose("exit").catch(() => undefined);
+        cleanupFrom();
         restore();
     }
 }

package/dist/cli/codemode-notice.d.ts

@@ -0,0 +1,20 @@
+/**
+ * codemode 缺省关闭的一次性提示（设计 §5.5「默认开放」）：`default` 预设跟随预设时只在沙箱 strict
+ * （Node ≥ 25）开 codemode；Node 22 / 24 下缺省关闭，启动时提示一次怎么显式开启。
+ *
+ * - 只在「跟随预设」且预设是 `default`、运行时不是 strict 时提示；显式写了 `codemode.mode`（含 off）
+ *   不提示；
+ * - 每个配置目录只提示一次：已提示过的配置目录记在 `<数据目录>/notices.json`；读写失败不影响启动
+ *   （至多多提示一次）。
+ */
+import type { SandboxCapability } from "../codemode/capability.js";
+import type { AmaConfig } from "../config/types.js";
+export declare const NOTICES_FILE = "notices.json";
+export declare function codemodeNoticeText(capability: Pick<SandboxCapability, "nodeMajor">): string;
+/** 需要提示时返回文案并记下（之后同一配置目录不再提示）；不需要时 undefined。 */
+export declare function takeCodemodeNotice(input: {
+    config: Pick<AmaConfig, "tools" | "codemode">;
+    capability: Pick<SandboxCapability, "strict" | "nodeMajor">;
+    configDir: string;
+    dataDir: string;
+}): string | undefined;

package/dist/cli/codemode-notice.js

@@ -0,0 +1,55 @@
+/**
+ * codemode 缺省关闭的一次性提示（设计 §5.5「默认开放」）：`default` 预设跟随预设时只在沙箱 strict
+ * （Node ≥ 25）开 codemode；Node 22 / 24 下缺省关闭，启动时提示一次怎么显式开启。
+ *
+ * - 只在「跟随预设」且预设是 `default`、运行时不是 strict 时提示；显式写了 `codemode.mode`（含 off）
+ *   不提示；
+ * - 每个配置目录只提示一次：已提示过的配置目录记在 `<数据目录>/notices.json`；读写失败不影响启动
+ *   （至多多提示一次）。
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveCodemodeMode } from "../tools/presets.js";
+export const NOTICES_FILE = "notices.json";
+const KEY = "codemodeNonStrictDefault";
+function readNotices(path) {
+    try {
+        const value = JSON.parse(readFileSync(path, "utf8"));
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            const shown = value[KEY];
+            return {
+                version: 1,
+                ...(Array.isArray(shown) ? { [KEY]: shown.filter((s) => typeof s === "string") } : {}),
+            };
+        }
+    }
+    catch {
+        // 不存在或损坏：按没提示过处理
+    }
+    return { version: 1 };
+}
+export function codemodeNoticeText(capability) {
+    return (`Node ${capability.nodeMajor} < 25：codemode 沙箱的网络未隔离，codemode 缺省关闭；` +
+        "用 `--codemode on` 或 config 的 codemode.mode 开启（每个配置目录只提示一次）");
+}
+/** 需要提示时返回文案并记下（之后同一配置目录不再提示）；不需要时 undefined。 */
+export function takeCodemodeNotice(input) {
+    const resolved = resolveCodemodeMode(input.config, input.capability.strict);
+    if (resolved.source !== "preset" || resolved.preset !== "default" || input.capability.strict)
+        return undefined;
+    const path = join(input.dataDir, NOTICES_FILE);
+    const notices = readNotices(path);
+    const shown = notices[KEY] ?? [];
+    if (shown.includes(input.configDir))
+        return undefined;
+    try {
+        mkdirSync(input.dataDir, { recursive: true });
+        const tmp = `${path}.${process.pid}.tmp`;
+        writeFileSync(tmp, `${JSON.stringify({ ...notices, [KEY]: [...shown, input.configDir] })}\n`);
+        renameSync(tmp, path);
+    }
+    catch {
+        // 写不进去也照常提示
+    }
+    return codemodeNoticeText(input.capability);
+}

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;
@@ -44,6 +47,11 @@ export interface SessionComposeOptions {
 export declare function stderrLog(env?: NodeJS.ProcessEnv): LogFn;
 /** config `cache` 段 + 环境变量 → 会话缓存设置；非法的环境变量值忽略并 warning。 */
 export declare function cacheSettingsFrom(config: Pick<AmaConfig, "cache">, env?: NodeJS.ProcessEnv, warn?: (message: string) => void): Partial<CacheSettings>;
+/**
+ * 模型请求的空闲超时：`AMA_IDLE_TIMEOUT_MS` > config `request.idleTimeoutMs`；都没有 → undefined
+ * （协议层取缺省 300 000）。0 关闭；非法的环境变量值忽略并 warning。
+ */
+export declare function idleTimeoutFrom(config: Pick<AmaConfig, "request">, env?: NodeJS.ProcessEnv, warn?: (message: string) => void): number | undefined;
 /** §1.4：SessionEvent → AgentEvents。 */
 export declare function bridgeEvent(event: SessionEvent, bus: AgentEventBus): void;
 /** 第 14 步：组装主会话。 */

package/dist/cli/compose-session.js

@@ -83,6 +83,11 @@ function contextFiles(record) {
 }
 function systemInput(record, active) {
     const system = { contextFiles: contextFiles(record) };
+    const override = record.assembly.overrides?.systemPrompt;
+    if (override?.mode === "replace")
+        system.preamble = override.text;
+    else if (override !== undefined)
+        system.extraRules = [override.text];
     const index = formatSkillIndex(record.state.skills, {
         hasSkillTool: false,
         hasReadTool: active.includes("read"),
@@ -145,6 +150,20 @@ export function cacheSettingsFrom(config, env = process.env, warn = () => undefi
     }
     return settings;
 }
+/**
+ * 模型请求的空闲超时：`AMA_IDLE_TIMEOUT_MS` > config `request.idleTimeoutMs`；都没有 → undefined
+ * （协议层取缺省 300 000）。0 关闭；非法的环境变量值忽略并 warning。
+ */
+export function idleTimeoutFrom(config, env = process.env, warn = () => undefined) {
+    const raw = env["AMA_IDLE_TIMEOUT_MS"];
+    if (raw !== undefined && raw.trim() !== "") {
+        const value = Number(raw);
+        if (Number.isFinite(value) && value >= 0)
+            return value;
+        warn(`AMA_IDLE_TIMEOUT_MS=${raw} 无效（应为不小于 0 的毫秒数），已忽略`);
+    }
+    return config.request?.idleTimeoutMs;
+}
 /** §1.4：SessionEvent → AgentEvents。 */
 export function bridgeEvent(event, bus) {
     switch (event.type) {
@@ -242,6 +261,15 @@ function buildSession(record, manager, model, thinkingLevel) {
         cache: cacheSettingsFrom(config, process.env, (message) => record.log("warn", message)),
         warmingDecider: () => assembly.host.warmingDecider?.(),
     };
+    const maxTurns = assembly.overrides?.maxTurns;
+    if (maxTurns !== undefined)
+        options.maxTurns = maxTurns;
+    const idle = idleTimeoutFrom(config, process.env, (message) => record.log("warn", message));
+    if (idle !== undefined)
+        options.idleTimeoutMs = idle;
+    const autoModel = config.permission?.autoModel;
+    if (autoModel !== undefined)
+        options.permissionClassifier = { model: autoModel };
     const maxChars = config.tools?.maxToolResultChars;
     if (maxChars !== undefined)
         options.maxToolResultChars = maxChars;
@@ -329,7 +357,10 @@ export async function switchSession(target, request) {
     let source;
     switch (request.kind) {
         case "new":
-            manager = SessionManager.create(sessionDirForCwd(sessionDir, old.cwd), old.cwd);
+            manager =
+                assembly.overrides?.noSession === true
+                    ? SessionManager.inMemory(old.cwd)
+                    : SessionManager.create(sessionDirForCwd(sessionDir, old.cwd), old.cwd);
             source = "new";
             break;
         case "open":

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

@@ -2,7 +2,7 @@
  * 组装根：会话存储（实施计划 §1.1 `sessions.*`）。[B6]
  *
  * 会话根目录 `sessionDir` 下按 cwd 分子目录（`sessionDirForCwd`）。
- * - `new` → 延迟落盘新建；`continue` → 本目录最近一条（没有则新建）；
+ * - `new` → 延迟落盘新建；`memory`（`--no-session`）→ 内存会话，从不落盘；`continue` → 本目录最近一条（没有则新建）；
  * - `resume{id}` / `fork{id}`：先在本目录、再在全部子目录里按 id 或唯一前缀找文件；找不到 →
  *   `session_not_found`，前缀不唯一 → `invalid_arguments` 并列出候选；
  * - `session-id{id}`：找到则打开，否则以该 id 新建；