@sendevia/pi-ask-author 1.1.0 → 1.1.1

package/dist/llm-texts.d.ts

@@ -1,6 +1,6 @@
 /**
  * @file llm-texts.ts
- * @description 面向大语言模型的协议文案：工具元数据、TypeBox 字段描述与返回封套模板
+ * @description 面向大语言模型的协议文案：工具元数据、TypeBox 字段描述、实时推演系统提示词与返回封套模板
  *
  * 核心架构特性：
  * - 全部文案恒为英文，不参与语言切换，保证封套与工具声明的前缀缓存稳定
@@ -16,14 +16,14 @@ export declare const LLM_TEXTS: {
         /** 工具调用名（LLM 协议标识，注册为 `ask_author`；不出现在作者界面） */
         readonly name: "ask_author";
         /** 工具说明（LLM 端英文；一句话能力概要与适用场景） */
-        readonly description: "Ask the author to choose between concrete narrative directions. Supports one question or a batch of related questions, with options, optional Markdown draft previews, author notes, and conditional follow-ups based on earlier answers.";
+        readonly description: "Ask the author to decide between concrete narrative options in an interactive terminal form. Handles a single question or a batch, optional draft previews, author notes, conditional questions, and live follow-up questions generated while the author answers.";
         /** `Available tools` 区块单行条目（LLM 端英文；动词引导，无句末标点，缺省则工具不进入该区块） */
-        readonly promptSnippet: "Ask the author to choose narrative directions with options, draft previews, and conditional follow-ups";
+        readonly promptSnippet: "Ask the author to pick narrative directions in a terminal form";
         /**
          * `Guidelines` 区块附加条目（LLM 端英文；分类标签前缀 + 行为要求）
          * 约定：宿主把条目扁平追加进 `Guidelines` 且不加工具名前缀，故每条首词必须显式点名 `ask_author`
          */
-        readonly promptGuidelines: readonly ["ask_author: Call it directly when the author must choose a plot branch, character action, scene direction, or setting; do not ask the same question in chat first.", "ask_author: Use flat mode (formTitle + question + options) for one decision, or the questions array for related decisions. Batch related choices into one call instead of consecutive calls, always give a concise formTitle, and add tabLabel when a long question title needs a short tab name.", "ask_author: Label options with concrete actions and put consequences in description. Add preview only when a Markdown draft or storyboard helps the author judge.", "ask_author: Omit optional fields that use defaults. Add a question id only when a later showIf references it, and point showIf at an earlier question id plus one of its option labels, or answered.", "ask_author: The author may choose multiple options, add notes, and edit drafts. Confirmed drafts return as [Draft directive: ...] lines.", "ask_author: [Author Decision Cancelled] means drop the decision. [Author Consultation Error] means fix the arguments and retry once, then continue without the confirmation."];
+        readonly promptGuidelines: readonly ["ask_author: Use it when the author must choose a plot branch, character action, scene direction, or setting; do not ask the same question in chat first.", "ask_author: Prefer one call over several: flat mode (formTitle + question + options) for a single decision, the questions array for related decisions.", "ask_author: Write option labels as concrete actions, put consequences in description, and add preview only when a Markdown draft or storyboard helps the choice.", "ask_author: Give a short formTitle and a tabLabel for every long question title; omit fields that use defaults.", "ask_author: Add a question id only when a showIf or expansion.insert.after refers to it; showIf may only point at an earlier question's option label or answered.", 'ask_author: Pass expansion when follow-up decisions depend on the answers: declare only the first question and let the same model add questions and options on each confirmation; expansion.insert picks "follow" (default), "tail", or {"after":"question_id"}.', "ask_author: The author can multi-select, add notes, and edit drafts; confirmed drafts return as [Draft directive: ...] lines. Treat [Author Decision Cancelled] as no decision, and [Author Consultation Error] as a request to fix the arguments once."];
     };
     /** LLM 端 TypeBox 字段描述字典（单句浓缩英文，仅声明语义、必要性与省略规则；数量约束来自 {@link MAX_OPTIONS} / {@link MAX_QUESTIONS} 插值） */
     readonly schema: {
@@ -32,53 +32,98 @@ export declare const LLM_TEXTS: {
         /** 选项情节推演（可选；作者端渲染为「情节设定推演」预览面板） */
         readonly optionDesc: "Consequences or rationale (optional)";
         /** 选项草稿预览（可选；作者端渲染为「正文草稿/分镜头试撰写」预览面板） */
-        readonly optionPreview: "Markdown draft or storyboard excerpt (optional)";
+        readonly optionPreview: "Markdown draft or storyboard for this option (optional)";
         /** 选项批注占位符（可选；作者端作为选项补充说明编辑器的输入框占位文本） */
-        readonly optionCustomPlaceholder: "Placeholder for the option note (optional)";
+        readonly optionCustomPlaceholder: "Placeholder for the author's note on this option (optional)";
         /** 选项显示条件（可选；条件不成立时该选项不展示） */
-        readonly optionShowIf: "Show only when an earlier answer matches (condition or array; all must hold)";
-        /** 题目 ID（可选；仅在后续 showIf 引用时需要） */
-        readonly questionId: "Stable id for showIf references (optional)";
+        readonly optionShowIf: "Show only if an earlier answer matches; array means all must hold (optional)";
+        /** 题目 ID（可选；仅在后续 showIf 或 `expansion.insert.after` 引用时需要） */
+        readonly questionId: "Id referenced by showIf and expansion.insert.after (optional)";
         /** 题目标题（必须填写；作者端呈现为题头与总览页条目） */
         readonly questionTitle: "Question text";
         /** Tab 栏短标签（可选；缺省时 Tab 栏显示 `Q<序号>`，显式给出可让作者在一屏内区分多题） */
-        readonly questionTabLabel: "Short label for the tab bar (default: Q<index>)";
+        readonly questionTabLabel: "Short tab label (default: Q<index>)";
         /** 题目背景说明（可选；作者端呈现为题头下方的上下文行） */
-        readonly questionDesc: "Context for the question (optional)";
+        readonly questionDesc: "Context shown under the question (optional)";
         /** 多选开关（可选；默认 false，开启后作者端展示多选模式标签与方框勾选指示符） */
         readonly questionMultiSelect: "Allow multiple selections (default false)";
         /** 最小勾选数（可选；默认 1，仅多选生效，作者端据此标注强制下限） */
-        readonly questionMinSelect: "Minimum selections (default 1)";
+        readonly questionMinSelect: "Minimum selections, multi-select only (default 1)";
         /** 最大勾选数（可选；默认全部选项，仅多选生效，小于选项总数时作者端追加上限标注） */
-        readonly questionMaxSelect: "Maximum selections (default: all options)";
-        /** 零勾选提交开关（可选；默认 false，仅多选生效，开启后作者端标注可不选） */
-        readonly questionAllowEmpty: "Allow submitting with no selection (default false)";
+        readonly questionMaxSelect: "Maximum selections, multi-select only (default: all options)";
+        /** 零勾选提交开关（可选；默认 false，单选与多选均生效） */
+        readonly questionAllowEmpty: "Allow submitting without a selection (default false)";
         /** 候选选项列表（必须填写；1~{@link MAX_OPTIONS} 项；建议 2~10 项） */
-        readonly questionOptions: "Candidate options (1-30, 2-10 recommended)";
+        readonly questionOptions: "Options (1-30, 2-10 recommended)";
         /** 自由批注开关（可选；默认 true，开启后作者端可额外提交非选项文本） */
         readonly questionAllowCustom: "Allow author notes (default true)";
         /** 作者批注占位符（可选；作者端作为题目补充说明编辑器的输入框占位文本） */
-        readonly questionCustomPlaceholder: "Placeholder for the author note (optional)";
+        readonly questionCustomPlaceholder: "Placeholder for the author's note (optional)";
         /** 题目显示条件（可选；条件不成立时该题不展示，也不计入答卷） */
-        readonly questionShowIf: "Show only when an earlier answer matches (condition or array; all must hold)";
+        readonly questionShowIf: "Show only if an earlier answer matches; array means all must hold (optional)";
         /** 显示条件引用的题目 ID（必须为本次表单中更早出现的题目） */
-        readonly conditionQuestionId: "Id of an earlier question";
+        readonly conditionQuestionId: "Earlier question id";
         /** 显示条件匹配的选项（引用题目的选项标签；作者选中该选项时条件成立） */
-        readonly conditionOption: "Option label that activates the condition";
+        readonly conditionOption: "Option label of that question that activates the condition";
         /** 显示条件的作答存在性（缺省等价于 true；与 option 同时给出时忽略） */
-        readonly conditionAnswered: "Match any answer (default true) or no answer (false); ignored with option";
+        readonly conditionAnswered: "Any answer (default true) or no answer (false); ignored when option is set";
         /** 问卷标题（必须填写；作者端呈现为卡片标题与总览页标题） */
         readonly formTitle: "Short title for the consultation";
         /** 问卷背景（可选；作者端呈现为问卷级上下文） */
         readonly formDesc: "Overall context (optional)";
         /** 批量模式题目数组（可选；1~{@link MAX_QUESTIONS} 题；与平铺单题模式互斥） */
-        readonly formQuestions: "Related questions (1-20); batch related decisions into one call";
+        readonly formQuestions: "Questions (1-20); batch related decisions in one call";
         /** 平铺模式的题目标题（可选；与批量模式的 `questionTitle` 同义） */
         readonly formSingleQuestion: "Question for flat mode";
         /** 平铺单题模式字段描述的统一区分前缀（LLM 端英文，`schema.ts` 逐字段拼接） */
         readonly flatPrefix: "(Flat single-question mode only) ";
         /** 平铺模式候选选项列表（可选；1~{@link MAX_OPTIONS} 项；建议 2~10 项） */
         readonly flatQuestionOptions: "Options for flat mode (1-30, 2-10 recommended)";
+        /** 实时推演开关（可选；开启后作者确认答案时由同一模型追加题目与选项） */
+        readonly expansion: "Generate follow-up questions and options while the author answers; insert controls where they land (optional)";
+        /** 推演题目总量上限（可选；缺省为全部可用题目数） */
+        readonly expansionMaxQuestions: "Question cap including declared ones (default 20)";
+        /** 推演方向指示（可选；作为长期要求传给推演模型） */
+        readonly expansionGuidance: "Standing hint for what the expansion should probe (optional)";
+        /** 推演题目插入位置（三选一预设） */
+        readonly expansionInsert: '"follow" (default, after the answered question), "tail" (end of the form), or {"after":"question_id"} (optional)';
+        /** 自定义插入位置的锚点题目 ID */
+        readonly expansionInsertAfter: "Declared question id to insert after";
+    };
+    /**
+     * 实时推演协议（作者确认答案后由同一模型追加题目与选项；全英文，输出约束为纯 JSON）
+     */
+    readonly expansion: {
+        /** 推演系统提示词（约束输出结构与新增范围，禁止复述既有内容） */
+        readonly systemPrompt: `You extend an interactive author decision form while the author answers it.
+
+Input JSON: formTitle, formDescription, guidance, insert, maxAdditionalQuestions, questions (with ids), answers (selected labels and notes).
+
+Return JSON only:
+{"questions":[{"id":"unique_id","title":"...","description":"...","options":[{"label":"...","description":"..."}]}],"options":[{"questionId":"existing_id","options":[{"label":"..."}]}]}
+
+Rules:
+- Add at most maxAdditionalQuestions questions; fewer is better.
+- New questions may also set multiSelect, minSelect, maxSelect, allowEmpty; every option needs a label.
+- Add options to a declared question only when the answers reveal a choice it cannot express; use its id and unused labels.
+- Give new questions unique ids and 2-6 concrete options; put consequences in description.
+- Never repeat a declared question or a declared label.
+- showIf takes {"questionId":"id","option":"label"} or {"questionId":"id","answered":true} and may only reference a question above the insertion point or one of your earlier new questions.
+- Reply {"questions":[],"options":[]} when the answers already determine the next step.
+- No prose, no code fences, no trailing commas.`;
+        /** 推演用户消息前缀（英文单行，后接 JSON 载荷） */
+        readonly userPreamble: "Extend this author decision form. Input JSON:";
+        /** 推演失败诊断（英文短句；作者界面经 `status.expansionFailed` 呈现，不直接展示原文） */
+        readonly errors: {
+            /** 当前会话没有可用模型 */
+            readonly noModel: "no model is available for live expansion";
+            /** 推演请求被中止 */
+            readonly aborted: "live expansion was aborted";
+            /** 供应商返回错误终止 */
+            readonly providerFailed: "the expansion request failed";
+            /** 回复不是可解析的 JSON 对象 */
+            readonly invalidReply: "the expansion reply was not a JSON object";
+        };
     };
     /**
      * LLM 端返回封套与纠正指令模板（全英文确定性结构，提升 Prompt Cache 命中率）
@@ -109,6 +154,8 @@ export declare const LLM_TEXTS: {
             readonly runtimeError: (details: string) => string;
             /** 自适应条件引用无效（对应作者端 `status.errorInvalidCondition`） */
             readonly invalidCondition: (details: string) => string;
+            /** 请求了实时推演但当前会话没有可用模型 */
+            readonly expansionUnavailable: "Live expansion was requested but no model is available in this session.";
         };
         /** 错误封套纠正指引行字典（英文单句，与 `errorReasons` 一一对应） */
         readonly errorGuidances: {
@@ -119,7 +166,9 @@ export declare const LLM_TEXTS: {
             /** `runtimeError` 的纠正指引 */
             readonly runtimeError: "Check the arguments and retry with valid questions and options.";
             /** `invalidCondition` 的纠正指引 */
-            readonly invalidCondition: "Reference an earlier question id plus one of its option labels, or use answered.";
+            readonly invalidCondition: "Reference an earlier question id plus one of its option labels, use answered, or point expansion.insert.after at a declared question id.";
+            /** `expansionUnavailable` 的纠正指引 */
+            readonly expansionUnavailable: "Drop the expansion field and declare the questions directly, or retry in a session with a model selected.";
         };
         /** 自适应条件引用校验的英文诊断消息（拼入错误封套原因行） */
         readonly adaptiveErrors: {
@@ -129,6 +178,8 @@ export declare const LLM_TEXTS: {
             readonly forwardQuestion: (questionId: string) => string;
             /** 条件引用的选项标签在目标题目中不存在 */
             readonly unknownOption: (questionId: string, option: string) => string;
+            /** 推演插入锚点引用的题目 ID 不存在 */
+            readonly unknownInsertAnchor: (questionId: string) => string;
         };
         /** 空答卷封套正文（作者未作答时的英文处置指令，位于首尾标识之间） */
         readonly envelopeEmpty: "The author submitted no answers. Use your defaults, or ask a follow-up if the decision is crucial.";

package/dist/model.d.ts

@@ -9,10 +9,11 @@
  * - 封套语言单一：自动生成的占位题目/标签在封套编译期替换为英文占位（`Question N` / `Option N`），作者界面保留中文占位
  * - 答卷完整性：显示中的题目即使显式跳过或仅批注提交也产出条目，多选题目恒产出条目，不存在静默消失的作答
  * - 自适应显隐：题目与选项可声明 `showIf` 条件且仅允许引用更早题目；显隐快照按 `revision` 缓存，隐藏项的选择不计入作答与答卷
+ * - 实时推演：`pushExpansion` 按 `expansion.insert` 把新题目插到跟随位、队尾或自定义锚点之后，把新选项追加到目标题目末尾，插入与撤回都会平移后续题目的条件、作答状态与推演记录索引
  *
- * 依赖方向：model.ts → format.ts / schema.ts / texts.ts（纯函数工具、Schema 单一类型源与文案字典，无回边）；不引用 `Theme` 与 TUI 组件，渲染细节全部上移组件层
+ * 依赖方向：model.ts → format.ts / layout.ts / schema.ts / texts.ts（纯函数工具、上限常量、Schema 单一类型源与文案字典，无回边）；不引用 `Theme` 与 TUI 组件，渲染细节全部上移组件层
  */
-import type { QuestionOption, RawParams } from "./schema.js";
+import type { ExpansionPayload, InsertPosition, QuestionOption, RawParams } from "./schema.js";
 /**
  * 显示条件的归一化形态：引用的题目索引与选项索引均已解析
  * - `option`：指定题目中某个选项当前处于选中状态
@@ -150,6 +151,22 @@ export interface MenuItem {
 }
 /** 勾选 toggle 操作语义（三个操作语义类型均不导出，由组件层消费并映射为状态栏提示） */
 type ToggleResult = "selected" | "deselected" | "limit";
+/** 一次推演追加的记录，作为撤回的最小单元 */
+export interface ExpansionRecord {
+    /** 触发推演的题目索引（0-based） */
+    readonly questionIndex: number;
+    /** 触发时该题的答案签名（选中项标签按序拼接） */
+    readonly signature: string;
+    /** 追加题目在题目列表中的起始位置（即触发题目的下一题） */
+    readonly insertAt: number;
+    /** 本次插入的题目数 */
+    readonly addedQuestions: number;
+    /** 本次向既有题目追加的选项 */
+    readonly addedOptions: readonly {
+        readonly questionIndex: number;
+        readonly count: number;
+    }[];
+}
 /** 全选/清空操作语义 */
 type SelectAllResult = "cleared" | "filled";
 /** 批注保存操作语义 */
@@ -169,8 +186,14 @@ export declare class AskAuthorFormModel {
     readonly formTitle: string;
     /** 问卷全局背景阐述（可选） */
     readonly formDescription?: string;
-    /** 归一化后的题目列表 */
-    readonly questions: NormalizedQuestion[];
+    /** 推演允许的题目总量上限（含初始题目） */
+    readonly expansionMaxQuestions: number;
+    /** 推演题目的插入位置预设（缺省为跟随触发题目） */
+    readonly expansionInsert: InsertPosition;
+    /** 归一化后的题目列表（推演会向末尾追加，外部只读） */
+    private readonly questionList;
+    /** 推演追加记录栈（按追加顺序；撤回时从栈顶开始） */
+    private readonly expansions;
     /** 作答状态版本号：单调递增，作为组件层派生缓存的失效键 */
     private revisionValue;
     /** 各题作答状态映射（题目索引 0-based） */
@@ -182,6 +205,10 @@ export declare class AskAuthorFormModel {
      * @param rawParams - 经 prepareArguments 规整的入参；`questions` 缺省或为空数组时回退单题平铺模式，`options` 亦为空则题目列表为空
      */
     constructor(rawParams: RawParams);
+    /** 归一化后的题目列表（推演会插入新题目，调用方只读） */
+    get questions(): NormalizedQuestion[];
+    /** 推演题目插入位置的可读描述（供推演模型判定哪些题目位于插入点之前） */
+    get expansionInsertLabel(): string;
     /** 当前作答状态版本号（组件层派生缓存失效键） */
     get revision(): number;
     /** 问卷题目总数 */
@@ -252,6 +279,88 @@ export declare class AskAuthorFormModel {
     getSelectedIndex(qIndex: number): number | undefined;
     /** 推进作答状态版本号（全部 mutation 方法的统一出口） */
     private bumpRevision;
+    /**
+     * 获取推演追加记录快照
+     * @returns 按追加顺序排列的新数组（调用方可安全持有）
+     */
+    getExpansions(): readonly ExpansionRecord[];
+    /**
+     * 计算指定题目的答案签名（判断该题推演结果是否仍然有效）
+     * @param qIndex - 题目顺序索引（0-based）
+     * @returns 可见选中项标签按索引升序以 `|` 拼接的签名；未作答或题目越界时为 undefined
+     */
+    answerSignature(qIndex: number): string | undefined;
+    /**
+     * 计算推演题目的插入位置
+     * @param insert - 插入位置预设（跟随触发题目 / 队尾 / 指定题目之后）
+     * @param triggerIndex - 触发推演的题目索引（0-based，仅 `follow` 使用）
+     * @returns 插入位置（0-based；`questionList.length` 表示队尾）
+     * @throws AdaptiveConditionError 自定义锚点引用的题目不存在时抛出
+     */
+    private resolveInsertIndex;
+    /**
+     * 写入一次推演结果（新题目按 {@link expansionInsert} 指定的位置插入，新选项追加到目标题目的选项末尾）
+     * @param input - 记录元数据与推演载荷；超出 {@link expansionMaxQuestions} 的新题目被截断
+     * @returns 本次追加记录（无实际追加时计数均为 0，记录仍入栈以标记该答案已推演）
+     * @throws AdaptiveConditionError 追加内容的条件引用未知题目、后置题目或不存在的选项时抛出（本次追加整体不生效）
+     */
+    pushExpansion(input: {
+        questionIndex: number;
+        signature: string;
+        payload: ExpansionPayload;
+    }): ExpansionRecord;
+    /**
+     * 撤回指定题目及其后续题目的推演结果（作者改动答案后调用）
+     * @param questionIndex - 起始题目索引（0-based）；触发题目不早于该索引的记录全部撤回
+     * @returns 撤回的记录数；无记录被撤回时为 0（状态与 `revision` 均不变）
+     */
+    retractFrom(questionIndex: number): number;
+    /**
+     * 判定指定题目在确认时是否会发起实时推演
+     * 条件：表单开启推演、该题可见、题目总数未达上限，且该题尚未用当前答案推演过
+     * @param qIndex - 题目顺序索引（0-based）
+     * @param enabled - 本表单是否开启推演（由组件层持有）
+     * @returns 确认本题将发起新的推演请求时为 true
+     */
+    canExpandOnConfirm(qIndex: number, enabled: boolean): boolean;
+    /**
+     * 归一化并在指定位置插入新题目（全部条件先校验，任一非法项抛出时整个批次不生效）
+     * @param at - 插入位置（原有索引不小于该值的题目整体后移）
+     * @param raws - 推演给出的原始题目
+     * @returns 实际插入的题目数
+     */
+    private insertQuestions;
+    /**
+     * 把索引不小于指定值的题目引用整体平移（插入或移除题目后维持既有条件、作答状态与推演记录的指向）
+     * @param from - 起始索引（0-based）
+     * @param delta - 位移量（插入为正、移除为负）
+     */
+    private remapQuestionIndices;
+    /**
+     * 向既有题目追加选项（全部条件先校验，任一非法项抛出时整个批次不生效）
+     * @param additions - 按题目 ID 归集的追加选项
+     * @returns 每题实际追加的选项数
+     */
+    private appendOptions;
+    /**
+     * 回滚单条推演记录（先回滚选项追加，再移除插入的题目块）
+     * @param record - 待回滚的推演记录
+     */
+    private rollback;
+    /**
+     * 剪除被移除选项上的选中与批注状态
+     * @param questionIndex - 题目顺序索引（0-based）
+     * @param keptCount - 保留的选项数
+     */
+    private dropOptionsFromState;
+    /**
+     * 生成不与既有题目重复的题目 ID
+     * @param id - 推演给出的原始 ID（可为自动占位）
+     * @param index - 题目顺序索引（0-based）
+     * @param used - 已占用的 ID 集合（就地更新）
+     * @returns 未占用的题目 ID
+     */
+    private uniqueQuestionId;
     /**
      * 派生指定题目的左侧菜单项列表（预设选项 + 自由补充入口 + 确认推进按钮）
      * 菜单项标签与确认按钮明细随当前作答状态派生：多选展示已选数/下限，单选展示已选项标签、自定义方案名或「未选」

package/dist/sanitize.d.ts

@@ -5,14 +5,29 @@
  * 核心架构特性：
  * - 容错范围：JSON 串包裹 / `raw` 包装键 / 字段别名 / 纯字符串选项 / 空选项兜底
  * - 白名单收敛：产物仅含 `RawParams` 声明字段（丢弃未知键），保障宿主 Schema 校验通过
+ * - 推演载荷清洗：`sanitizeExpansionPayload` 丢弃引用未知题目的选项追加、重复标签、与既有 ID 冲突的新题目与无选项题目
  * - 防御纵深：本层做类型收敛 / 别名映射 / 结构规整 / 区间兜底，模型层再幂等兜底一次
  *
- * 依赖方向：sanitize.ts → format.ts / texts.ts / schema.ts（类型）；仅由 index.ts 装配
+ * 依赖方向：sanitize.ts → format.ts / layout.ts / texts.ts / schema.ts（类型）；被 index / expansion / tool-card 消费
  */
-import type { RawParams } from "./schema.js";
+import type { ExpansionPayload, RawParams } from "./schema.js";
 /**
  * 入参防御性清洗（`prepareArguments` 钩子）；容错面见文件头，各字段先收敛为本地强类型 `const` 再组装为显式白名单产物
  * @param args - 工具调用原始入参（不可信边界）
  * @returns 仅含 Schema 声明字段的 `RawParams` 白名单对象；输入完全不可辨识时仅返回兜底 `formTitle`
  */
 export declare function sanitizeAskAuthorArgs(args: unknown): RawParams;
+/** 推演载荷的归集上下文：表单当前已声明的题目 ID 与各题已有选项标签 */
+export interface ExpansionContext {
+    /** 已声明的题目 ID（按题目顺序） */
+    readonly questionIds: readonly string[];
+    /** 题目 ID → 已有选项标签 */
+    readonly optionLabels: ReadonlyMap<string, readonly string[]>;
+}
+/**
+ * 规整推演模型的回复载荷（不可信边界）：丢弃引用未知题目的选项追加、与既有标签重复的选项以及与既有题目 ID 冲突的新题目
+ * @param value - 已解析的回复对象（非对象时视为无新增）
+ * @param context - 表单当前已声明的题目与选项标签
+ * @returns 仅含合法追加项的推演载荷；全部条目被过滤时返回空载荷（表单停止增长）
+ */
+export declare function sanitizeExpansionPayload(value: unknown, context: ExpansionContext): ExpansionPayload;

package/dist/schema.d.ts

@@ -6,8 +6,9 @@
  * - 字段名称、可选性与区间约束（`minItems` / `maxItems` / `minimum`）仅在 TypeBox 定义一次，运行时类型经 `Static<typeof>` 派生
  * - 默认值不写入 Schema：题目内字段由 `sanitize.ts` 规整时填入（`multiSelect`→false、`allowCustom`→true），模型层再按同一语义兜底
  * - LLM 端字段描述保持单句浓缩英文（取自 `TEXTS.schema`）
+ * - 推演载荷（`ExpansionPayload` / `OptionAddition`）的接口类型也在此声明，供 sanitize / model / expansion 共用
  *
- * 依赖方向：schema.ts → typebox / texts.ts（上限常量与字段描述）；被 sanitize / model / index 消费
+ * 依赖方向：schema.ts → typebox / layout.ts / texts.ts（上限常量与字段描述）；被 sanitize / model / expansion / index 消费
  */
 import { Type, type Static } from "typebox";
 /** 显示条件参数 Schema：引用更早题目的作答状态，决定本题或本选项是否出现 */
@@ -112,12 +113,38 @@ export declare const QuestionSchema: Type.TObject<{
         answered: Type.TOptional<Type.TBoolean>;
     }>>]>>;
 }>;
+/** 推演题目的插入位置预设：跟随触发题目 / 排到队尾 / 指定题目之后 */
+export declare const InsertPositionSchema: Type.TUnion<[Type.TLiteral<"follow">, Type.TLiteral<"tail">, Type.TObject<{
+    after: Type.TString;
+}>]>;
+/** 实时推演参数 Schema：作者确认答案后由同一模型追加题目与选项 */
+export declare const ExpansionSchema: Type.TObject<{
+    /** 推演后的题目总量上限（含已声明的题目） */
+    maxQuestions: Type.TOptional<Type.TInteger>;
+    /** 长期生效的推演方向指示 */
+    guidance: Type.TOptional<Type.TString>;
+    /** 推演题目的插入位置（缺省为跟随触发题目） */
+    insert: Type.TOptional<Type.TUnion<[Type.TLiteral<"follow">, Type.TLiteral<"tail">, Type.TObject<{
+        after: Type.TString;
+    }>]>>;
+}>;
 /** `ask_author` 工具完整参数 Schema（必须填写 `formTitle`；批量问卷传递 `questions`，单题平铺传递顶层 `question` + `options`） */
 export declare const AskAuthorParams: Type.TObject<{
     /** 问卷总任务标题（必须填写；简明概括请示主题） */
     formTitle: Type.TString;
     /** 问卷全局背景或前述情境（可选；平铺单题模式下同时充当该题描述） */
     description: Type.TOptional<Type.TString>;
+    /** 实时推演开关（可选；开启后作者每次确认答案都追加后续题目与选项） */
+    expansion: Type.TOptional<Type.TObject<{
+        /** 推演后的题目总量上限（含已声明的题目） */
+        maxQuestions: Type.TOptional<Type.TInteger>;
+        /** 长期生效的推演方向指示 */
+        guidance: Type.TOptional<Type.TString>;
+        /** 推演题目的插入位置（缺省为跟随触发题目） */
+        insert: Type.TOptional<Type.TUnion<[Type.TLiteral<"follow">, Type.TLiteral<"tail">, Type.TObject<{
+            after: Type.TString;
+        }>]>>;
+    }>>;
     /** 关联多题批量问卷列表（可选；批量模式使用，上限 `MAX_QUESTIONS` 题） */
     questions: Type.TOptional<Type.TArray<Type.TObject<{
         /** 题目唯一标识符（可选；缺省由模型层按顺序生成，跨题重复由模型层去重） */
@@ -239,3 +266,21 @@ export type QuestionInput = Static<typeof QuestionSchema>;
 export type VisibilityConditionInput = Static<typeof ShowIfConditionSchema>;
 /** `showIf` 字段的运行时类型：单个条件或条件数组 */
 export type ShowIfInput = VisibilityConditionInput | VisibilityConditionInput[];
+/** 实时推演配置的运行时类型（由 `ExpansionSchema` 经 `Static<>` 派生） */
+export type ExpansionConfig = Static<typeof ExpansionSchema>;
+/** 推演题目插入位置的运行时类型：预设字符串或指定题目之后的锚点 */
+export type InsertPosition = Static<typeof InsertPositionSchema>;
+/** 推演向既有题目追加的一组选项 */
+export interface OptionAddition {
+    /** 目标题目的 ID（必须是表单中已存在的题目） */
+    readonly questionId: string;
+    /** 待追加的选项（标签与既有选项不重复） */
+    readonly options: QuestionOption[];
+}
+/** 一次推演的产出：待追加的新题目与向既有题目追加的选项 */
+export interface ExpansionPayload {
+    /** 追加到题目列表末尾的新题目 */
+    readonly questions: QuestionInput[];
+    /** 向既有题目追加的选项 */
+    readonly optionAdditions: OptionAddition[];
+}

package/dist/texts.d.ts

@@ -37,39 +37,70 @@ export declare const TEXTS: {
     /** 工具注册元数据：`name` / `description` / `promptSnippet` / `promptGuidelines` 面向 LLM（英文高信噪比），`label` 面向作者（TUI 工具行标题） */
     readonly tool: {
         readonly name: "ask_author";
-        readonly description: "Ask the author to choose between concrete narrative directions. Supports one question or a batch of related questions, with options, optional Markdown draft previews, author notes, and conditional follow-ups based on earlier answers.";
-        readonly promptSnippet: "Ask the author to choose narrative directions with options, draft previews, and conditional follow-ups";
-        readonly promptGuidelines: readonly ["ask_author: Call it directly when the author must choose a plot branch, character action, scene direction, or setting; do not ask the same question in chat first.", "ask_author: Use flat mode (formTitle + question + options) for one decision, or the questions array for related decisions. Batch related choices into one call instead of consecutive calls, always give a concise formTitle, and add tabLabel when a long question title needs a short tab name.", "ask_author: Label options with concrete actions and put consequences in description. Add preview only when a Markdown draft or storyboard helps the author judge.", "ask_author: Omit optional fields that use defaults. Add a question id only when a later showIf references it, and point showIf at an earlier question id plus one of its option labels, or answered.", "ask_author: The author may choose multiple options, add notes, and edit drafts. Confirmed drafts return as [Draft directive: ...] lines.", "ask_author: [Author Decision Cancelled] means drop the decision. [Author Consultation Error] means fix the arguments and retry once, then continue without the confirmation."];
+        readonly description: "Ask the author to decide between concrete narrative options in an interactive terminal form. Handles a single question or a batch, optional draft previews, author notes, conditional questions, and live follow-up questions generated while the author answers.";
+        readonly promptSnippet: "Ask the author to pick narrative directions in a terminal form";
+        readonly promptGuidelines: readonly ["ask_author: Use it when the author must choose a plot branch, character action, scene direction, or setting; do not ask the same question in chat first.", "ask_author: Prefer one call over several: flat mode (formTitle + question + options) for a single decision, the questions array for related decisions.", "ask_author: Write option labels as concrete actions, put consequences in description, and add preview only when a Markdown draft or storyboard helps the choice.", "ask_author: Give a short formTitle and a tabLabel for every long question title; omit fields that use defaults.", "ask_author: Add a question id only when a showIf or expansion.insert.after refers to it; showIf may only point at an earlier question's option label or answered.", 'ask_author: Pass expansion when follow-up decisions depend on the answers: declare only the first question and let the same model add questions and options on each confirmation; expansion.insert picks "follow" (default), "tail", or {"after":"question_id"}.', "ask_author: The author can multi-select, add notes, and edit drafts; confirmed drafts return as [Draft directive: ...] lines. Treat [Author Decision Cancelled] as no decision, and [Author Consultation Error] as a request to fix the arguments once."];
         readonly label: string;
     };
     /** LLM 端 TypeBox 字段描述字典 */
     readonly schema: {
         readonly optionLabel: "Concrete action or choice label";
         readonly optionDesc: "Consequences or rationale (optional)";
-        readonly optionPreview: "Markdown draft or storyboard excerpt (optional)";
-        readonly optionCustomPlaceholder: "Placeholder for the option note (optional)";
-        readonly optionShowIf: "Show only when an earlier answer matches (condition or array; all must hold)";
-        readonly questionId: "Stable id for showIf references (optional)";
+        readonly optionPreview: "Markdown draft or storyboard for this option (optional)";
+        readonly optionCustomPlaceholder: "Placeholder for the author's note on this option (optional)";
+        readonly optionShowIf: "Show only if an earlier answer matches; array means all must hold (optional)";
+        readonly questionId: "Id referenced by showIf and expansion.insert.after (optional)";
         readonly questionTitle: "Question text";
-        readonly questionTabLabel: "Short label for the tab bar (default: Q<index>)";
-        readonly questionDesc: "Context for the question (optional)";
+        readonly questionTabLabel: "Short tab label (default: Q<index>)";
+        readonly questionDesc: "Context shown under the question (optional)";
         readonly questionMultiSelect: "Allow multiple selections (default false)";
-        readonly questionMinSelect: "Minimum selections (default 1)";
-        readonly questionMaxSelect: "Maximum selections (default: all options)";
-        readonly questionAllowEmpty: "Allow submitting with no selection (default false)";
-        readonly questionOptions: "Candidate options (1-30, 2-10 recommended)";
+        readonly questionMinSelect: "Minimum selections, multi-select only (default 1)";
+        readonly questionMaxSelect: "Maximum selections, multi-select only (default: all options)";
+        readonly questionAllowEmpty: "Allow submitting without a selection (default false)";
+        readonly questionOptions: "Options (1-30, 2-10 recommended)";
         readonly questionAllowCustom: "Allow author notes (default true)";
-        readonly questionCustomPlaceholder: "Placeholder for the author note (optional)";
-        readonly questionShowIf: "Show only when an earlier answer matches (condition or array; all must hold)";
-        readonly conditionQuestionId: "Id of an earlier question";
-        readonly conditionOption: "Option label that activates the condition";
-        readonly conditionAnswered: "Match any answer (default true) or no answer (false); ignored with option";
+        readonly questionCustomPlaceholder: "Placeholder for the author's note (optional)";
+        readonly questionShowIf: "Show only if an earlier answer matches; array means all must hold (optional)";
+        readonly conditionQuestionId: "Earlier question id";
+        readonly conditionOption: "Option label of that question that activates the condition";
+        readonly conditionAnswered: "Any answer (default true) or no answer (false); ignored when option is set";
         readonly formTitle: "Short title for the consultation";
         readonly formDesc: "Overall context (optional)";
-        readonly formQuestions: "Related questions (1-20); batch related decisions into one call";
+        readonly formQuestions: "Questions (1-20); batch related decisions in one call";
         readonly formSingleQuestion: "Question for flat mode";
         readonly flatPrefix: "(Flat single-question mode only) ";
         readonly flatQuestionOptions: "Options for flat mode (1-30, 2-10 recommended)";
+        readonly expansion: "Generate follow-up questions and options while the author answers; insert controls where they land (optional)";
+        readonly expansionMaxQuestions: "Question cap including declared ones (default 20)";
+        readonly expansionGuidance: "Standing hint for what the expansion should probe (optional)";
+        readonly expansionInsert: '"follow" (default, after the answered question), "tail" (end of the form), or {"after":"question_id"} (optional)';
+        readonly expansionInsertAfter: "Declared question id to insert after";
+    };
+    /** 实时推演协议（系统提示词、用户消息前缀与诊断文案） */
+    readonly expansion: {
+        readonly systemPrompt: `You extend an interactive author decision form while the author answers it.
+
+Input JSON: formTitle, formDescription, guidance, insert, maxAdditionalQuestions, questions (with ids), answers (selected labels and notes).
+
+Return JSON only:
+{"questions":[{"id":"unique_id","title":"...","description":"...","options":[{"label":"...","description":"..."}]}],"options":[{"questionId":"existing_id","options":[{"label":"..."}]}]}
+
+Rules:
+- Add at most maxAdditionalQuestions questions; fewer is better.
+- New questions may also set multiSelect, minSelect, maxSelect, allowEmpty; every option needs a label.
+- Add options to a declared question only when the answers reveal a choice it cannot express; use its id and unused labels.
+- Give new questions unique ids and 2-6 concrete options; put consequences in description.
+- Never repeat a declared question or a declared label.
+- showIf takes {"questionId":"id","option":"label"} or {"questionId":"id","answered":true} and may only reference a question above the insertion point or one of your earlier new questions.
+- Reply {"questions":[],"options":[]} when the answers already determine the next step.
+- No prose, no code fences, no trailing commas.`;
+        readonly userPreamble: "Extend this author decision form. Input JSON:";
+        readonly errors: {
+            readonly noModel: "no model is available for live expansion";
+            readonly aborted: "live expansion was aborted";
+            readonly providerFailed: "the expansion request failed";
+            readonly invalidReply: "the expansion reply was not a JSON object";
+        };
     };
     /** LLM 端返回封套与纠正指令模板 */
     readonly markdown: {
@@ -82,17 +113,20 @@ export declare const TEXTS: {
             readonly noQuestions: "No questions or options were provided.";
             readonly runtimeError: (details: string) => string;
             readonly invalidCondition: (details: string) => string;
+            readonly expansionUnavailable: "Live expansion was requested but no model is available in this session.";
         };
         readonly errorGuidances: {
             readonly nonTui: "Use defaults, or ask the user in chat if the decision is crucial.";
             readonly noQuestions: "Provide at least one question with concrete options.";
             readonly runtimeError: "Check the arguments and retry with valid questions and options.";
-            readonly invalidCondition: "Reference an earlier question id plus one of its option labels, or use answered.";
+            readonly invalidCondition: "Reference an earlier question id plus one of its option labels, use answered, or point expansion.insert.after at a declared question id.";
+            readonly expansionUnavailable: "Drop the expansion field and declare the questions directly, or retry in a session with a model selected.";
         };
         readonly adaptiveErrors: {
             readonly unknownQuestion: (questionId: string) => string;
             readonly forwardQuestion: (questionId: string) => string;
             readonly unknownOption: (questionId: string, option: string) => string;
+            readonly unknownInsertAnchor: (questionId: string) => string;
         };
         readonly envelopeEmpty: "The author submitted no answers. Use your defaults, or ask a follow-up if the decision is crucial.";
         readonly noSelection: "(No selection; the author skipped this question)";
@@ -124,12 +158,15 @@ export declare const TEXTS: {
     /** Tab 导航栏标签文案（各题目页与答卷提交页） */
     readonly tabs: {
         readonly questionTab: (...args: Array<string | number>) => string;
+        readonly expansionPlaceholder: string;
         readonly submitTab: string;
     };
     /** 作答视图与预览面板的结构化文案（`modeMulti` 由多选模式片段组合而成） */
     readonly view: {
         readonly modeSingle: string;
         readonly conditionalBadge: string;
+        readonly expansionBadge: string;
+        readonly expansionPendingHint: string;
         readonly modeMultiAtLeast: (...args: Array<string | number>) => string;
         readonly modeMultiOptional: (...args: Array<string | number>) => string;
         readonly modeMultiUnconstrained: (...args: Array<string | number>) => string;
@@ -143,13 +180,11 @@ export declare const TEXTS: {
         readonly storyDraftPanelTitle: string;
         readonly customNotePanelTitle: string;
         readonly confirmPanelTitle: string;
-        readonly customNotePanelCurrent: string;
         readonly previewScrollInfo: (...args: Array<string | number>) => string;
         readonly previewNoDraft: string;
         readonly customNotePanelTips: readonly string[];
         readonly confirmPanelTips: readonly string[];
         readonly sectionTitle: (...args: Array<string | number>) => string;
-        readonly fieldLabel: (...args: Array<string | number>) => string;
         readonly italicLine: (...args: Array<string | number>) => string;
         readonly modeMulti: typeof modeMultiLabel;
     };
@@ -186,6 +221,11 @@ export declare const TEXTS: {
         readonly errorNoQuestions: string;
         readonly errorInvalidCondition: (...args: Array<string | number>) => string;
         readonly errorExecutionFailed: (...args: Array<string | number>) => string;
+        readonly expansionRunning: string;
+        readonly expansionAdded: (...args: Array<string | number>) => string;
+        readonly expansionRetracted: string;
+        readonly expansionStopped: string;
+        readonly expansionFailed: (...args: Array<string | number>) => string;
     };
     /** 底部按键帮助行片段（经 `common.helpSeparator` 拼接；条目按按键字母序排列） */
     readonly help: {

package/dist/view-question.d.ts

@@ -25,6 +25,8 @@ export interface QuestionViewState {
     readonly statusMessage: string | null;
     /** 当前题目的菜单项（由模型派生并记忆化） */
     readonly menuItems: readonly MenuItem[];
+    /** 本题确认后是否会发起实时推演（题头展示推演标记） */
+    readonly expandable: boolean;
 }
 /** 预览视口观察值：渲染后回传组件，供输入路径归一化滚动位移 */
 export interface PreviewViewport {