minimal-agent 0.10.0 → 0.12.0

package/src/cli/quickModelSetup.tsx

@@ -0,0 +1,96 @@
+import { Box, Text, useInput } from 'ink';
+import React, { useEffect, useState } from 'react';
+
+import type { ModelConfig } from '../config/configFile.js';
+import { configService } from '../config/configService.js';
+import type { Provider } from '../types.js';
+import { ProviderWizard } from './wizards/providerWizard.js';
+
+interface Props {
+  onDone: (provider: Provider) => void;
+}
+
+export function QuickModelSetup({ onDone }: Props): JSX.Element {
+  const [models, setModels] = useState<ModelConfig[] | null>(null);
+  const [index, setIndex] = useState(0);
+  const [adding, setAdding] = useState(false);
+  const [readOnly, setReadOnly] = useState(false);
+  const [message, setMessage] = useState<string | null>(null);
+  useEffect(() => {
+    void configService.reload().then((snapshot) => {
+      setReadOnly(snapshot.readOnly);
+      setModels(snapshot.config?.models ?? []);
+    });
+  }, []);
+  useInput((input, key) => {
+    if (adding || !models) return;
+    const usable = models.filter((model) => model.enabled && model.apiKey);
+    const length = usable.length + 1;
+    if (key.upArrow) setIndex((value) => (value - 1 + length) % length);
+    else if (key.downArrow) setIndex((value) => (value + 1) % length);
+    else if (key.return) {
+      if (index === usable.length) setAdding(true);
+      else {
+        const selected = usable[index];
+        if (!selected) return;
+        void configService
+          .savePatch({ baseModelId: selected.id })
+          .then(() => configService.provider())
+          .then((provider) => {
+            if (provider) onDone(provider);
+            else setMessage('该模型当前不可用，请编辑或添加模型');
+          })
+          .catch((error: Error) => setMessage(error.message));
+      }
+    }
+  });
+  if (!models) return <Text color="gray">正在读取配置...</Text>;
+  if (readOnly)
+    return (
+      <Box flexDirection="column" paddingX={1}>
+        <Text color="yellow" bold>
+          当前为环境变量只读配置，但没有可用基座模型
+        </Text>
+        <Text>
+          请检查 MINIMAL_AGENT_BASE_URL、MINIMAL_AGENT_API_KEY 和
+          MINIMAL_AGENT_MODEL，然后重新启动。
+        </Text>
+      </Box>
+    );
+  if (adding)
+    return (
+      <ProviderWizard
+        quick
+        setAsBase
+        onDone={() => {
+          void configService.provider().then((provider) => {
+            if (provider) onDone(provider);
+          });
+        }}
+        onCancel={() => setAdding(false)}
+      />
+    );
+  const usable = models.filter((model) => model.enabled && model.apiKey);
+  return (
+    <Box flexDirection="column" paddingX={1}>
+      <Text color="cyan" bold>
+        欢迎使用 minimal-agent
+      </Text>
+      <Text>请选择一个已有基座模型，或快速添加模型。</Text>
+      <Text color="gray">配置完成后可随时输入 /config 调整高级设置。</Text>
+      <Box flexDirection="column" marginTop={1}>
+        {usable.map((model, i) => (
+          <Text key={model.id} color={index === i ? 'cyan' : undefined}>
+            {index === i ? '> ' : '  '}
+            {model.displayName ?? model.model}{' '}
+            <Text color="gray">({model.model})</Text>
+          </Text>
+        ))}
+        <Text color={index === usable.length ? 'cyan' : undefined}>
+          {index === usable.length ? '> ' : '  '}＋ 添加模型
+        </Text>
+      </Box>
+      {message && <Text color="red">{message}</Text>}
+    </Box>
+  );
+}

package/src/cli/streamJson.js

@@ -23,11 +23,19 @@ import { getWorkingDir } from '../bootstrap/workingDir.js';
 import { forceCompact } from '../context/compact.js';
 import { recordRecentDir } from '../context/recentDirs.js';
 import { updateSessionMetadata } from '../context/sessionRegistry.js';
+import { workspaceIndexService } from '../context/workspaceIndex.js';
 import { saveContext } from '../context/persistContext.js';
 import { setAskHandler } from '../askBridge.js';
 import { normalizeImageDetail } from '../multimodal.js';
 import { runWithPlugins } from '../plugins/pluginRunner.js';
+import { buildBaseSystemPrompt, buildTransientPromptBundle } from '../prompts/system.js';
+import { getOrCreateSessionState, sessionStateKey } from '../session/sessionState.js';
+import { hydrateSessionWorktree } from '../tools/worktree/sessionWorktree.js';
+import { ALL_TOOLS } from '../tools/index.js';
+import { createPromptCacheContext } from '../llm/promptCache.js';
+import { createAgentRuntimeContext, filterToolsForRuntime, memoryContextFromRuntime, } from '../runtime/agentRuntimeContext.js';
 import { extractImageOptions, extractPromptArgs } from './print.js';
+import { createCliComputerRun } from './computerUse.js';
 /** 一行一个 JSON 事件写 stdout。EPIPE 时静默。 */
 function emitLine(ev) {
     try {
@@ -185,14 +193,24 @@ export async function runStreamJsonMode(provider, args, initialHistory, options)
     if (options.compact) {
         try {
             emitLine({ type: 'compact_start' });
-            const r = await forceCompact(history, provider);
+            const r = await forceCompact(history, provider, undefined, undefined, createPromptCacheContext(`workspace:${options.workspace?.cwd ?? getWorkingDir()}:session:${options.workspace?.sessionId ?? 'default'}`));
             history.length = 0;
             history.push(...r.messages);
-            emitLine({ type: 'compact_done', before: r.before, after: r.after });
+            emitLine({
+                type: 'compact_done',
+                before: r.before,
+                after: r.after,
+                trigger: 'manual',
+                mode: r.mode,
+                degraded: r.degraded,
+                ...(r.fallbackReason ? { fallbackReason: r.fallbackReason } : {}),
+                ...(r.messagesRemoved !== undefined ? { messagesRemoved: r.messagesRemoved } : {}),
+                ...(r.tokensFreed !== undefined ? { tokensFreed: r.tokensFreed } : {}),
+            });
             emitLine({ type: 'turn_done' });
         }
-        catch (e) {
-            emitLine({ type: 'error', error: `压缩失败：${e.message}`, code: 'compact_failed' });
+        catch {
+            emitLine({ type: 'error', error: '手动压缩失败。', code: 'compact_failed' });
         }
         await finalize();
         return;
@@ -251,6 +269,57 @@ export async function runStreamJsonMode(provider, args, initialHistory, options)
         void finalize().finally(() => process.exit(130));
     });
     try {
+        const workspaceRoot = options.workspace?.cwd ?? getWorkingDir();
+        const workspace = await workspaceIndexService.findByPath(workspaceRoot).catch(() => null);
+        const sessionId = options.workspace?.sessionId ?? 'default';
+        const sessionState = getOrCreateSessionState(sessionStateKey({
+            surface: 'headless', workspaceId: workspace?.id,
+            cwd: workspace?.id ? undefined : workspaceRoot, sessionId,
+        }));
+        await hydrateSessionWorktree({ sessionState, workspaceId: workspace?.id, sessionId, cwd: workspaceRoot });
+        const cwd = sessionState.activeWorktree?.path ?? workspaceRoot;
+        const conversationKey = `workspace:${workspace?.id ?? workspaceRoot}:session:${sessionId}`;
+        const computerRun = options.computerUseMode && options.computerUseMode !== 'disabled'
+            ? createCliComputerRun({
+                mode: options.computerUseMode,
+                surface: 'cli',
+                conversationKey,
+                userInput: prompt,
+                allowedFileRoots: [cwd],
+                supervised: true,
+                diagnosticTraceDir: options.computerUseTraceDir,
+            })
+            : undefined;
+        const runtimeContext = createAgentRuntimeContext({
+            surface: 'headless',
+            profile: 'main',
+            cwd,
+            workspaceId: workspace?.id,
+            sessionId,
+            owner: options.memoryAccess === 'denied' ? 'untrusted' : 'local-owner',
+            memoryAccess: options.memoryAccess ?? 'read-only',
+            interactiveAsk: control,
+            computer: computerRun,
+        });
+        const turnTools = filterToolsForRuntime(ALL_TOOLS, runtimeContext);
+        const stablePrompt = await buildBaseSystemPrompt(cwd, turnTools);
+        if (history[0]?.role === 'system')
+            history[0] = { ...history[0], content: stablePrompt };
+        else
+            history.unshift({ role: 'system', content: stablePrompt });
+        const transientBundle = await buildTransientPromptBundle({
+            cwd,
+            tools: turnTools,
+            runtime: {
+                surface: 'headless',
+                cwd,
+                workspaceId: workspace?.id,
+                sessionId,
+                interactiveAsk: control,
+                memoryAccess: runtimeContext.memoryAccess,
+                currentUserInput: prompt,
+            },
+        }).catch(() => undefined);
         for await (const event of runWithPlugins(prompt, {
             provider,
             history,
@@ -260,6 +329,13 @@ export async function runStreamJsonMode(provider, args, initialHistory, options)
             parseInlineImages: true,
             imageDetail: cliImageOptions.imageDetail,
             imageMaxLongSidePixel: cliImageOptions.imageMaxLongSidePixel,
+            runtimeContext,
+            sessionState,
+            allowedTools: turnTools.map((tool) => tool.name),
+            ...(transientBundle ? { transientBundle } : {}),
+            promptCache: createPromptCacheContext(`workspace:${workspace?.id ?? cwd}:session:${sessionId}`),
+            memoryContext: memoryContextFromRuntime(runtimeContext),
+            ...(computerRun ? { computerRun } : {}),
         })) {
             // event 是 LoopEvent | PluginEvent，原样逐行 emit；前端不识别的插件私有事件会静默忽略
             emitLine(event);

package/src/cli/streamJson.ts

@@ -0,0 +1,433 @@
+/**
+ * ============================================================
+ *  src/cli/streamJson.ts —— `-p --output-format stream-json` 流式事件模式
+ * ------------------------------------------------------------
+ *  与 print.ts 的 text/json 一次性契约**并列、互不影响**（print.ts 一行未动）：
+ *    - text  : 纯文本答案（向后兼容）
+ *    - json  : 退出时一行结局契约
+ *    - stream-json（本文件）: 把 runQuery 的**每个 LoopEvent 作为一行 JSON**
+ *      实时写 stdout（jsonl）。给 webchat 本地服务 broker 用 —— 它 spawn 本模式、
+ *      逐行转发成 WebSocket event 帧。也是给网关预留的"流式子进程"契约。
+ *
+ *  约定：
+ *    - stdout 只允许 jsonl 事件流（一行一个 JSON.stringify(LoopEvent)），含「问答 over wire」
+ *      的出站事件 `{type:'ask',requestId,questions}`（AskUserQuestion 在远程通道弹问题）。
+ *    - stdin 是**逐行 JSON 控制通道**（见 attachStdinChannel）：首行 `{type:'prompt',text}` 为本轮输入，
+ *      后续 `{type:'ask_answer',requestId,answers}` 回灌用户选择。兼容：首行非控制消息 → 整段当裸 prompt。
+ *      argv 也可给 prompt（此时 stdin 全部行按 ask_answer 解析）。--compact 走压缩动作（无需 prompt）。
+ *    - 跑完 / 中断 / 出错都先 saveContext 再退出（finalize 还会 unref stdin，让本轮结束后进程能退出）。
+ * ============================================================
+ */
+
+import crypto from 'node:crypto';
+import { getWorkingDir } from '../bootstrap/workingDir.js';
+import { forceCompact } from '../context/compact.js';
+import { recordRecentDir } from '../context/recentDirs.js';
+import { updateSessionMetadata } from '../context/sessionRegistry.js';
+import { workspaceIndexService } from '../context/workspaceIndex.js';
+import { saveContext } from '../context/persistContext.js';
+import { setAskHandler, type AskAnswer } from '../askBridge.js';
+// attachStdinChannel 的公开签名引用 AskAnswer → 从本模块一并 re-export，
+// 供消费者（含 test/streamJson.askChannel.test.ts）从同一入口导入。
+export type { AskAnswer } from '../askBridge.js';
+import { normalizeImageDetail } from '../multimodal.js';
+import type { ImageInputSpec, Message, Provider } from '../types.js';
+import { runWithPlugins } from '../plugins/pluginRunner.js';
+import { buildBaseSystemPrompt, buildTransientPromptBundle } from '../prompts/system.js';
+import { getOrCreateSessionState, sessionStateKey } from '../session/sessionState.js';
+import { hydrateSessionWorktree } from '../tools/worktree/sessionWorktree.js';
+import { ALL_TOOLS } from '../tools/index.js';
+import { createPromptCacheContext } from '../llm/promptCache.js';
+import {
+  createAgentRuntimeContext,
+  filterToolsForRuntime,
+  memoryContextFromRuntime,
+} from '../runtime/agentRuntimeContext.js';
+import { extractImageOptions, extractPromptArgs } from './print.js';
+import type { ComputerUseCliMode } from './computerUse.js';
+import { createCliComputerRun } from './computerUse.js';
+
+interface StreamJsonOptions {
+  maxTurns?: number;
+  /** true 时执行一次压缩（对应 Web 的 /compact），忽略 prompt。 */
+  compact?: boolean;
+  /**
+   * `--session <id>` 解析出的会话文件路径（main.tsx 算好传入）。缺省退回
+   * saveContext 的默认路径（= default session）。必须和 initialHistory 的
+   * 加载路径一致，否则出现"读 session A、存回 default"的读写分裂。
+   */
+  sessionFile?: string;
+  workspace?: { cwd: string; sessionId: string };
+  /** 本机长期记忆权限，由 main.tsx 判定后传入；stream-json 默认 denied（见 resolveMemoryAccess）。 */
+  memoryAccess?: import('../runtime/agentRuntimeContext.js').MemoryAccessInput;
+  /** 非交互 Computer Use 必须显式启用；缺省 disabled。 */
+  computerUseMode?: ComputerUseCliMode;
+  /** Explicit opt-in directory for chronological Computer Use diagnostics. */
+  computerUseTraceDir?: string;
+}
+
+/** 一行一个 JSON 事件写 stdout。EPIPE 时静默。 */
+function emitLine(ev: unknown): void {
+  try {
+    process.stdout.write(`${JSON.stringify(ev)}\n`);
+  } catch {
+    /* ignore */
+  }
+}
+
+function firstUserTitle(history: Message[]): string | undefined {
+  const u = history.find((m) => m.role === 'user');
+  if (!u) return undefined;
+  if (typeof u.content === 'string') return u.content;
+  return u.content.find((p) => p.type === 'text')?.text;
+}
+
+type PromptImageWire =
+  | string
+  | {
+      source?: unknown;
+      url?: unknown;
+      detail?: unknown;
+      maxLongSidePixel?: unknown;
+      max_long_side_pixel?: unknown;
+    };
+
+function parseWireImages(raw: unknown): ImageInputSpec[] {
+  if (!Array.isArray(raw)) return [];
+  const out: ImageInputSpec[] = [];
+  for (const item of raw as PromptImageWire[]) {
+    if (typeof item === 'string') {
+      out.push({ source: item });
+      continue;
+    }
+    if (!item || typeof item !== 'object') continue;
+    const source =
+      typeof item.source === 'string'
+        ? item.source
+        : typeof item.url === 'string'
+          ? item.url
+          : undefined;
+    if (!source) continue;
+    const detail =
+      typeof item.detail === 'string'
+        ? normalizeImageDetail(item.detail)
+        : undefined;
+    const rawMax = item.maxLongSidePixel ?? item.max_long_side_pixel;
+    const maxLongSidePixel =
+      typeof rawMax === 'number' && Number.isFinite(rawMax)
+        ? Math.floor(rawMax)
+        : undefined;
+    out.push({ source, detail, maxLongSidePixel });
+  }
+  return out;
+}
+
+/**
+ * stdin 控制通道：把 stdin 从「一次性裸 prompt」升级为**逐行 JSON 控制通道**，
+ * 支撑「问答 over wire」的入站半边。两种控制消息：
+ *   - `{ type:'prompt', text }`     —— 首行，本轮的用户输入（替代裸 prompt）
+ *   - `{ type:'ask_answer', requestId, answers }` —— AskUserQuestion 的回答，按 requestId 关联
+ *
+ * 向后兼容：首个非空行**不是** `{type:'prompt'}` 控制消息时，判定为 legacy 模式 ——
+ * 整段 stdin 当裸 prompt 读到 EOF（保 `echo "x" | minimal-agent -p --output-format stream-json` 仍可用，
+ * legacy 下天然无交互、一次性）。argv 已给 prompt 时，stdin 全部行都按 ask_answer 解析。
+ *
+ * 返回 `{ prompt, control }`：`control=true` **仅**当 prompt 来自 `{type:'prompt'}` 控制行
+ * （= broker 在管理本子进程、会回灌 ask_answer）；argv / 裸管道 / TTY / EOF 兜底均为 `false`
+ * （无人回灌 → 调用方据此**不注册** wire ask handler，让 askBridge 内置「自动选推荐项」兜底，
+ * 避免模型提问后永等挂死）。同时把 ask_answer 路由给 onAskAnswer。stdin 全程保持打开，
+ * 直到子进程结束（broker 在 turn 末 end stdin）。
+ */
+export function attachStdinChannel(opts: {
+  argvPrompt?: string;
+  onAskAnswer: (requestId: string, answers: AskAnswer[]) => void;
+  /** 输入流；默认 process.stdin（测试可注入 PassThrough 驱动）。 */
+  input?: NodeJS.ReadableStream & { isTTY?: boolean };
+}): Promise<{ prompt: string; control: boolean; imageInputs?: ImageInputSpec[] }> {
+  const input = opts.input ?? process.stdin;
+  return new Promise<{ prompt: string; control: boolean; imageInputs?: ImageInputSpec[] }>((resolvePrompt) => {
+    let promptResolved = false;
+    const resolveOnce = (
+      text: string,
+      control: boolean,
+      imageInputs?: ImageInputSpec[],
+    ): void => {
+      if (promptResolved) return;
+      promptResolved = true;
+      resolvePrompt(
+        imageInputs && imageInputs.length > 0
+          ? { prompt: text, control, imageInputs }
+          : { prompt: text, control },
+      );
+    };
+    // argv 给的 prompt：直连 CLI、无控制通道（broker 走 stdin 的 {type:'prompt'}，不用 argv）。
+    if (opts.argvPrompt !== undefined) resolveOnce(opts.argvPrompt, false);
+
+    // 无 stdin 管道（TTY）：argv 没给 prompt 也只能返回空（调用方据空报错）。
+    if (input.isTTY) {
+      resolveOnce('', false);
+      return;
+    }
+
+    let buf = '';
+    let legacy = false;
+    input.setEncoding('utf8');
+    input.on('data', (chunk: string) => {
+      buf += chunk;
+      if (legacy) return; // legacy：整段累积到 EOF
+      let nl: number;
+      while ((nl = buf.indexOf('\n')) >= 0) {
+        const line = buf.slice(0, nl);
+        buf = buf.slice(nl + 1);
+        if (!line.trim()) continue;
+        let msg:
+          | {
+              type?: string;
+              text?: unknown;
+              images?: unknown;
+              requestId?: unknown;
+              answers?: unknown;
+            }
+          | null = null;
+        try {
+          msg = JSON.parse(line);
+        } catch {
+          msg = null;
+        }
+        if (!promptResolved) {
+          if (msg && msg.type === 'prompt' && typeof msg.text === 'string') {
+            resolveOnce(msg.text, true, parseWireImages(msg.images)); // 控制行 → 存在控制通道
+          } else {
+            // 首行不是 prompt 控制消息 → legacy：把它放回去，整段当裸 prompt 读到 EOF
+            legacy = true;
+            buf = buf.length ? `${line}\n${buf}` : line;
+            return;
+          }
+        } else if (msg && msg.type === 'ask_answer' && typeof msg.requestId === 'string') {
+          opts.onAskAnswer(msg.requestId, Array.isArray(msg.answers) ? (msg.answers as AskAnswer[]) : []);
+        }
+      }
+    });
+    input.on('end', () => {
+      // legacy 一次性：EOF 时整段 stdin = 裸 prompt，无控制通道
+      if (!promptResolved) resolveOnce(buf.trim(), false);
+    });
+  });
+}
+
+export async function runStreamJsonMode(
+  provider: Provider,
+  args: string[],
+  initialHistory: Message[],
+  options: StreamJsonOptions,
+): Promise<void> {
+  process.stdout.on('error', (err: NodeJS.ErrnoException) => {
+    if (err.code === 'EPIPE') process.stdout.destroy();
+  });
+
+  const history = initialHistory;
+  // 收尾守卫用「缓存 promise」而非「布尔 once」（与 print.ts finalizeOnce 同构）：
+  // SIGINT handler 与 for-await 的 AbortError catch 是两条并发退出路径，布尔 once
+  // 会让后到的路径立即返回、抢在 saveContext 落盘完成前 process.exit → 会话丢失。
+  // 缓存 promise 让所有路径 await 同一次真实收尾。
+  let finalizePromise: Promise<void> | null = null;
+  const finalize = (): Promise<void> => {
+    finalizePromise ??= (async () => {
+      // 释放 stdin：attachStdinChannel 的 'data' 监听会让进程在本轮结束后**仍存活**
+      // （等下一行输入）→ broker 永远收不到子进程 close、web 端 conn.running 卡死。
+      // turn 已结束（无挂起提问），unref 让 stdout 排空后进程自然退出；中途挂起期间
+      // 不会走到这里，故等答案时进程仍被 stdin 监听保活。
+      try {
+        process.stdin.unref();
+      } catch {
+        /* 某些 stdin 类型无 unref，忽略 */
+      }
+      setAskHandler(null); // 注销 handler，避免全局污染（测试复用 / 同进程多次调用）
+      await saveContext(history, options.sessionFile);
+    })();
+    return finalizePromise;
+  };
+
+  // --- 压缩动作（/compact）：不需要 prompt ---
+  if (options.compact) {
+    try {
+      emitLine({ type: 'compact_start' });
+      const r = await forceCompact(
+        history,
+        provider,
+        undefined,
+        undefined,
+        createPromptCacheContext(
+          `workspace:${options.workspace?.cwd ?? getWorkingDir()}:session:${options.workspace?.sessionId ?? 'default'}`,
+        ),
+      );
+      history.length = 0;
+      history.push(...r.messages);
+      emitLine({
+        type: 'compact_done',
+        before: r.before,
+        after: r.after,
+        trigger: 'manual',
+        mode: r.mode,
+        degraded: r.degraded,
+        ...(r.fallbackReason ? { fallbackReason: r.fallbackReason } : {}),
+        ...(r.messagesRemoved !== undefined ? { messagesRemoved: r.messagesRemoved } : {}),
+        ...(r.tokensFreed !== undefined ? { tokensFreed: r.tokensFreed } : {}),
+      });
+      emitLine({ type: 'turn_done' });
+    } catch {
+      emitLine({ type: 'error', error: '手动压缩失败。', code: 'compact_failed' });
+    }
+    await finalize();
+    return;
+  }
+
+  // --- 普通一轮 ---
+  // 「问答 over wire」入站半边：pendingAsks 持本轮未决提问（requestId → resolver）。
+  const pendingAsks = new Map<
+    string,
+    { resolve: (a: AskAnswer[]) => void; reject: (e: Error) => void }
+  >();
+  const rejectAllAsks = (reason: string): void => {
+    for (const p of pendingAsks.values()) p.reject(new Error(reason));
+    pendingAsks.clear();
+  };
+
+  const promptArgs = extractPromptArgs(args);
+  const cliImageOptions = extractImageOptions(args);
+  const { prompt, control, imageInputs: stdinImageInputs } = await attachStdinChannel({
+    argvPrompt: promptArgs.length > 0 ? promptArgs.join(' ') : undefined,
+    onAskAnswer: (requestId, answers) => {
+      const p = pendingAsks.get(requestId);
+      if (p) {
+        pendingAsks.delete(requestId);
+        p.resolve(answers);
+      }
+    },
+  });
+
+  // 仅当存在控制通道（broker 经 `{type:'prompt'}` 启动、会回灌 ask_answer）才注册 wire handler：
+  // 工具调 requestUserChoice → emit `ask` 到 stdout、挂起等 stdin 回灌。无控制通道（argv / 裸管道 /
+  // TTY）时**不注册** → 落 askBridge 内置「自动选推荐项」兜底，避免模型提问后永等挂死。
+  // loop 在 prompt resolve 后才启动 → 此处注册时机安全（注册前不会有 ask 触发）。
+  if (control) {
+    setAskHandler(
+      (questions) =>
+        new Promise<AskAnswer[]>((resolve, reject) => {
+          const requestId = crypto.randomUUID();
+          pendingAsks.set(requestId, { resolve, reject });
+          emitLine({ type: 'ask', requestId, questions });
+        }),
+    );
+  }
+
+  if (!prompt.trim()) {
+    emitLine({ type: 'error', error: '未提供 prompt（argv / stdin 都为空）', code: 'llm_error' });
+    process.exit(1);
+  }
+
+  // 记录最近目录（侧栏用）；title 优先用历史里第一条用户消息（稳定），否则用当前 prompt
+  await recordRecentDir(getWorkingDir(), firstUserTitle(history) ?? prompt);
+  if (options.workspace) {
+    await updateSessionMetadata(options.workspace.cwd, options.workspace.sessionId, {
+      lastMessagePreview: prompt,
+    }).catch(() => {});
+  }
+
+  const abortController = new AbortController();
+  let interrupted = false;
+  process.on('SIGINT', () => {
+    if (interrupted) process.exit(130);
+    interrupted = true;
+    abortController.abort();
+    rejectAllAsks('已中断'); // 挂起的提问立即落败，工具回 ok:false → loop 收口 interrupted
+    emitLine({ type: 'interrupted' });
+    void finalize().finally(() => process.exit(130));
+  });
+
+  try {
+    const workspaceRoot = options.workspace?.cwd ?? getWorkingDir();
+    const workspace = await workspaceIndexService.findByPath(workspaceRoot).catch(() => null);
+    const sessionId = options.workspace?.sessionId ?? 'default';
+    const sessionState = getOrCreateSessionState(sessionStateKey({
+      surface: 'headless', workspaceId: workspace?.id,
+      cwd: workspace?.id ? undefined : workspaceRoot, sessionId,
+    }));
+    await hydrateSessionWorktree({ sessionState, workspaceId: workspace?.id, sessionId, cwd: workspaceRoot });
+    const cwd = sessionState.activeWorktree?.path ?? workspaceRoot;
+    const conversationKey = `workspace:${workspace?.id ?? workspaceRoot}:session:${sessionId}`;
+    const computerRun = options.computerUseMode && options.computerUseMode !== 'disabled'
+      ? createCliComputerRun({
+          mode: options.computerUseMode,
+          surface: 'cli',
+          conversationKey,
+          userInput: prompt,
+          allowedFileRoots: [cwd],
+          supervised: true,
+          diagnosticTraceDir: options.computerUseTraceDir,
+        })
+      : undefined;
+    const runtimeContext = createAgentRuntimeContext({
+      surface: 'headless',
+      profile: 'main',
+      cwd,
+      workspaceId: workspace?.id,
+      sessionId,
+      owner: options.memoryAccess === 'denied' ? 'untrusted' : 'local-owner',
+      memoryAccess: options.memoryAccess ?? 'read-only',
+      interactiveAsk: control,
+      computer: computerRun,
+    });
+    const turnTools = filterToolsForRuntime(ALL_TOOLS, runtimeContext);
+    const stablePrompt = await buildBaseSystemPrompt(cwd, turnTools);
+    if (history[0]?.role === 'system') history[0] = { ...history[0], content: stablePrompt };
+    else history.unshift({ role: 'system', content: stablePrompt });
+    const transientBundle = await buildTransientPromptBundle({
+      cwd,
+      tools: turnTools,
+      runtime: {
+        surface: 'headless',
+        cwd,
+        workspaceId: workspace?.id,
+        sessionId,
+        interactiveAsk: control,
+        memoryAccess: runtimeContext.memoryAccess,
+        currentUserInput: prompt,
+      },
+    }).catch(() => undefined);
+    for await (const event of runWithPlugins(prompt, {
+      provider,
+      history,
+      signal: abortController.signal,
+      maxTurns: options.maxTurns,
+      imageInputs: [...cliImageOptions.imageInputs, ...(stdinImageInputs ?? [])],
+      parseInlineImages: true,
+      imageDetail: cliImageOptions.imageDetail,
+      imageMaxLongSidePixel: cliImageOptions.imageMaxLongSidePixel,
+      runtimeContext,
+      sessionState,
+      allowedTools: turnTools.map((tool) => tool.name),
+      ...(transientBundle ? { transientBundle } : {}),
+      promptCache: createPromptCacheContext(
+        `workspace:${workspace?.id ?? cwd}:session:${sessionId}`,
+      ),
+      memoryContext: memoryContextFromRuntime(runtimeContext),
+      ...(computerRun ? { computerRun } : {}),
+    })) {
+      // event 是 LoopEvent | PluginEvent，原样逐行 emit；前端不识别的插件私有事件会静默忽略
+      emitLine(event);
+    }
+  } catch (e) {
+    if ((e as Error).name === 'AbortError') {
+      // SIGINT 路径已 emit 过 interrupted → 不重发（stdout jsonl 语义：一次中断一行）
+      if (!interrupted) emitLine({ type: 'interrupted' });
+      await finalize();
+      process.exit(130);
+    }
+    emitLine({ type: 'error', error: (e as Error).message, code: 'llm_error' });
+    await finalize();
+    process.exit(1);
+  }
+
+  await finalize();
+}

package/src/cli/wizards/advisorWizard.js

@@ -121,6 +121,7 @@ export function AdvisorWizard({ existing, models, onDone, onCancel }) {
                                 model: newModelDraft.model,
                                 contextWindow: newModelDraft.contextWindow,
                                 supportsVision: newModelDraft.supportsVision,
+                                promptCache: { mode: 'auto' },
                                 enabled: true,
                             },
                         }],