@waterwx/dsh-novel-forge 2.1.1-alpha → 2.1.1

package/lib/types/protocol.d.ts

@@ -4,8 +4,6 @@
  * state file format, and the NDJSON generation stream frames all live here so
  * both halves spell exactly one vocabulary.
  */
-import type { ShotSizeId, CameraMoveId, CompositionId, LightingId } from './shot-language.ts';
-import type { StoryFunctionId, EmotionId } from './story-beat-language.ts';
 /** The /api/dsh-novel-forge route family (same-origin, loopback-fenced). */
 export declare const NOVEL_API: {
     readonly status: "/api/dsh-novel-forge/status";
@@ -25,6 +23,20 @@ export declare const NOVEL_API: {
     readonly director: "/api/dsh-novel-forge/director";
     readonly directorTodos: "/api/dsh-novel-forge/director/todos";
     readonly llmLive: "/api/dsh-novel-forge/llm-live/stream";
+    /** 查看某次调用实际发送的 Prompt（按 sessionId）。 */
+    readonly llmPrompt: "/api/dsh-novel-forge/llm-live/prompt";
+    /** 清零本次运行的用量账本。 */
+    readonly usageReset: "/api/dsh-novel-forge/usage/reset";
+    /** 章节历史版本（快照）。 */
+    readonly snapshot: "/api/dsh-novel-forge/snapshot";
+    /** 修订指令合并（POST：汇总审稿/时间线/张力为一轮）。 */
+    readonly revisionPlan: "/api/dsh-novel-forge/revision/plan";
+    /** 张力曲线（GET 数据 / POST 设置）。 */
+    readonly tension: "/api/dsh-novel-forge/tension";
+    /** 提示词槽位（GET 列表 / POST 写入）。 */
+    readonly promptSlots: "/api/dsh-novel-forge/prompt-slots";
+    /** 故事时间线（GET 列表 / POST 操作）。 */
+    readonly timeline: "/api/dsh-novel-forge/timeline";
     readonly marketRadar: "/api/dsh-novel-forge/market-radar";
     readonly marketRadarScan: "/api/dsh-novel-forge/market-radar/scan";
     readonly marketRadarApply: "/api/dsh-novel-forge/market-radar/apply";
@@ -57,22 +69,6 @@ export declare const NOVEL_API: {
     readonly bookshelfImportText: "/api/dsh-novel-forge/bookshelf/import-text";
     /** 导入 txt/md 全本：拆章预览（不落盘）。 */
     readonly bookshelfImportTextPreview: "/api/dsh-novel-forge/bookshelf/import-text/preview";
-    /** 漫剧方案管理：create/remove/activate。 */
-    readonly manhuaPlans: "/api/dsh-novel-forge/manhua/plans";
-    /** 漫剧角色库：从分镜提名（规则+LLM两段式）/ 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
-    readonly mangaRoles: "/api/dsh-novel-forge/manga/roles";
-    /** 漫剧道具库：从已写章节提炼常驻道具（跨镜头需一致）/ 保存清单。 */
-    readonly mangaProps: "/api/dsh-novel-forge/manga/props";
-    /** 导出「即梦素材包」落盘到资产库 manga-assets/素材包/。 */
-    readonly exportPackage: "/api/dsh-novel-forge/manga/export-package";
-    /** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
-    readonly storyboardSkeleton: "/api/dsh-novel-forge/storyboard/skeleton";
-    /** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
-    readonly storyboardTable: "/api/dsh-novel-forge/storyboard/table";
-    /** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
-    readonly storyboardPrompts: "/api/dsh-novel-forge/storyboard/prompts";
-    /** 生图接口连通性测试（设置页每个模型条目用）。 */
-    readonly imageTest: "/api/dsh-novel-forge/image-test";
     /** LLM 模型连通性测试：真实最小调用，验证 Key / 端点 / 模型可用。 */
     readonly llmTest: "/api/dsh-novel-forge/llm-test";
     /** 添加模型：厂商直填 key 或自定义路由，写进 DSH 凭据与 llm-pi-ai 路由。 */
@@ -99,16 +95,14 @@ export declare const NOVEL_API: {
     readonly blurb: "/api/dsh-novel-forge/blurb";
     /** 重命名当前书（同步项目与书架条目）。 */
     readonly rename: "/api/dsh-novel-forge/rename";
-    /** 大世界：AI 提炼 / 保存结构化数据（境界/区域/势力）。 */
+    /** 大世界：提炼 / 保存结构化数据（境界/区域/势力）。 */
     readonly world: "/api/dsh-novel-forge/world";
     /** 封面：GET 读取（dataUrl）/ POST 上传或移除。 */
     readonly cover: "/api/dsh-novel-forge/blurb/cover";
     /** 剧情线管理：增删改 + 关联章节。 */
     readonly plotlines: "/api/dsh-novel-forge/plotlines";
-    /** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+    /** 角色库：提炼 / 采纳 / 更新 / 删除。 */
     readonly roles: "/api/dsh-novel-forge/roles";
-    readonly scenes: "/api/dsh-novel-forge/scenes";
-    readonly visualRules: "/api/dsh-novel-forge/visual-rules";
     /** 作者复盘补跑：对已写章节补齐 authorReview（全书流式 / 单章 JSON）。 */
     readonly reviewBackfill: "/api/dsh-novel-forge/review/backfill";
     /** 章节复位：generating 卡死 → pending（可重新生成）。 */
@@ -117,15 +111,12 @@ export declare const NOVEL_API: {
     readonly chapterApprove: "/api/dsh-novel-forge/chapter/approve";
     /** 敏感词检查：全书已写章节或指定文本。 */
     readonly sensitiveCheck: "/api/dsh-novel-forge/sensitive-check";
-    /** 开书想法 → AI 补全大纲：输入一句话想法，生成 2-3 个可选大纲方案。 */
+    /** 开书想法 → 补全大纲：输入一句话想法，生成 2-3 个可选大纲方案。 */
     readonly outlineSuggest: "/api/dsh-novel-forge/outline/suggest";
     /** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流）。 */
     readonly outlineReverse: "/api/dsh-novel-forge/outline/reverse";
     /** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检（两阶段：源笔记→分节分析）。 */
     readonly breakdown: "/api/dsh-novel-forge/breakdown";
-    /** 漫剧分镜生成：章节 → 角色锚点 + 分镜表（可适配豆包/Seedance/SD）。 */
-    /** 漫剧分集计划：读一卷 → 按故事弧线分集（高潮拆集/过渡并章）。 */
-    /** 漫画脚本：章节 → 分页分格漫画脚本（含角色视觉锚点）。 */
     /** 生产单：启动批量生产（计划补足 + 逐章生成 + 被拒分级处理）。 */
     readonly runStart: "/api/dsh-novel-forge/run/start";
     /** 生产单控制：pause / resume / stop。 */
@@ -133,6 +124,10 @@ export declare const NOVEL_API: {
     /** 生产单状态（含进度统计与日志）。 */
     readonly runStatus: "/api/dsh-novel-forge/run/status";
     readonly config: "/api/dsh-novel-forge/config";
+    /** 输出目录迁移：dryRun 预览 / 确认后搬文件并联动配置与书架。 */
+    readonly moveOutputDir: "/api/dsh-novel-forge/move-output-dir";
+    /** 本书参数：POST {} 读取；POST {patch} 合并保存（存 novel-project.json）。 */
+    readonly bookSettings: "/api/dsh-novel-forge/book-settings";
     readonly openFolder: "/api/dsh-novel-forge/open-folder";
     /** 插件自更新：在 DSH profile 目录拉取最新 npm 版（下载后需重启 DSH 生效）。 */
     readonly pluginUpdate: "/api/dsh-novel-forge/plugin/update";
@@ -230,7 +225,7 @@ export interface BookImportTextRequest {
     text?: string;
     /** 模式二：原文件名（txt/md），用于推断书名与显示。 */
     fileName?: string;
-    /** 输出目录；缺省为 ~/.dsh/novels/书名。 */
+    /** 输出目录；缺省为「输出目录」设置下的书名子目录。 */
     outputDir?: string;
 }
 /** POST /bookshelf/import-text 响应。 */
@@ -262,305 +257,6 @@ export interface BookImportTextPreviewResponse {
     /** 因内容过短被跳过的章节标题列表。 */
     skipped: string[];
 }
-/** 分镜·编剧级：剧情骨架中的一节拍。 */
-export interface StoryboardBeat {
-    /** 节拍 id（如 b1、b2）。 */
-    id: string;
-    /** 事件一句话（发生了什么）。 */
-    event: string;
-    /** 情绪走向（情绪词 id 数组，来自 story-beat-language 词库，链式）。 */
-    emotion: EmotionId[];
-    /** 叙事功能（枚举 id，来自 story-beat-language 词库）。 */
-    function: StoryFunctionId;
-    /** 因果：承接上一节拍的原因（可选）。 */
-    cause?: string;
-}
-/** 分镜·编剧级：单章剧情骨架。 */
-export interface StoryboardSkeleton {
-    chapterNo: number;
-    /** 本章弧线一句话（起承转合）。 */
-    arc: string;
-    /** 剧情节拍链（时间顺序，因果连贯）。 */
-    beats: StoryboardBeat[];
-    /** 本章全部出镜角色（正文中的确切称谓，去重；漫剧角色库提名地基）。 */
-    characters?: string[];
-}
-/** POST /storyboard/skeleton 请求：生成单章剧情骨架。 */
-export interface StoryboardSkeletonRequest {
-    chapterNo: number;
-}
-/** POST /storyboard/skeleton 响应。 */
-export interface StoryboardSkeletonResponse {
-    skeleton: StoryboardSkeleton;
-}
-/** 分镜·导演级：一个镜头。 */
-export interface StoryboardShot {
-    /** 镜头 id（如 s1、s2）。 */
-    id: string;
-    /** 挂载的节拍 id（骨架中的 b1…）。 */
-    beatId: string;
-    /** 景别（枚举 id，来自 shot-language 词库）。 */
-    shot: ShotSizeId;
-    /** 机位与运镜（枚举 id 数组，来自 shot-language 词库）。 */
-    camera: CameraMoveId[];
-    /** 构图（可选，枚举 id）。 */
-    composition?: CompositionId;
-    /** 时长（秒，即梦白名单：5/6/7/8/10）。 */
-    duration: number;
-    /** 画面内容：角色动作 + 表情 + 服装/标志物 + 主体位置。 */
-    visual: string;
-    /** 台词/旁白（无则空字符串）。 */
-    line: string;
-    /** 音效（无则空字符串）。 */
-    sound: string;
-    /** 光效（枚举 id 数组，来自 shot-language 词库）。 */
-    light: LightingId[];
-    /** 承接上一镜头结尾状态（位置/动作/情绪/服装）。 */
-    prevState: string;
-    /** 本镜头结束状态。 */
-    nextState: string;
-    /** 本镜头出镜角色（引用小说库规范名/漫剧卡名，1-4 个；漫剧角色库提名地基）。 */
-    characters?: string[];
-    /** 本镜头已绑定漫剧卡的 id（定妆图引用，供出图/生视频时按卡取参考图）。 */
-    mangaRoleIds?: string[];
-    /** 即梦自然语言运镜描述（如「镜头从中景缓慢推进到近景」），提示词层直接使用，无需再转换。 */
-    jimengCamera?: string;
-    /** 本镜参考图 id 列表（角色定妆图+场景图），即梦图生视频时逐条投喂。 */
-    referenceImageIds?: string[];
-}
-/** 分镜·导演级：单章分镜表。 */
-export interface StoryboardTable {
-    chapterNo: number;
-    shots: StoryboardShot[];
-    /** 生成时注入的场景卡名称（前端标注消费关系）。 */
-    usedScenes?: string[];
-    /** 本章全部出镜角色（各镜头 characters 去重汇总；骨架有则兜底）。 */
-    characters?: string[];
-    /** 本章已绑定漫剧卡的 id（去重汇总，定妆图引用）。 */
-    mangaRoleIds?: string[];
-}
-/** POST /storyboard/table 请求：骨架 → 分镜表。 */
-export interface StoryboardTableRequest {
-    chapterNo: number;
-    /** 编剧级骨架（前端已生成/编辑后的版本）。 */
-    skeleton: StoryboardSkeleton;
-    /** 漫剧方案基底风格 id（style-library）；提供时按风格措辞画面描述。 */
-    styleId?: string;
-    /** 可选滤镜风格 id（stackable）。 */
-    filterId?: string;
-}
-/** POST /storyboard/table 响应。 */
-export interface StoryboardTableResponse {
-    table: StoryboardTable;
-}
-/** 分镜·提示词级：一个镜头的即梦视频提示词。 */
-export interface StoryboardPrompt {
-    /** 对应镜头 id（s1…）。 */
-    shotId: string;
-    /** 即梦/视频模型可粘贴的中文提示词（画面+运镜+光效+风格词块）。 */
-    text: string;
-    /** 本镜头绑定的漫剧卡 id（定妆图引用：出图/生视频时按卡取 imageUrl/立绘）。 */
-    mangaRoleIds?: string[];
-    /** Seedance 专用：运镜方式（推/拉/摇/移/跟/升降/固定，含具体起止）。 */
-    camera?: string;
-    /** Seedance 专用：运动幅度（轻微/中等/强烈）。 */
-    motion?: 'low' | 'medium' | 'high';
-    /** 负面提示词（即梦末尾追加：不要文字/水印/变形/多手/多指等）。 */
-    negativePrompt?: string;
-    /** 本镜头场景名（绑定场景底图参考）。 */
-    sceneName?: string;
-}
-/** 分镜持久化：单章的分镜产出（骨架 + 分镜表 + 视频提示词，可分别存在）。 */
-export interface ChapterStoryboard {
-    chapterNo: number;
-    skeleton?: StoryboardSkeleton;
-    table?: StoryboardTable;
-    prompts?: StoryboardPrompt[];
-    updatedAt: string;
-}
-/** POST /storyboard/prompts 请求：分镜表 → 视频提示词。 */
-export interface StoryboardPromptsRequest {
-    chapterNo: number;
-    /** 分镜表（前端已生成的镜头列表）。 */
-    table: StoryboardTable;
-    /** 基底风格 id。 */
-    styleId?: string;
-    /** 可选滤镜风格 id。 */
-    filterId?: string;
-}
-/** POST /storyboard/prompts 响应。 */
-export interface StoryboardPromptsResponse {
-    prompts: StoryboardPrompt[];
-}
-/** 漫剧方案：同一本书的多套视觉演绎（基底风格 + 可选滤镜）。 */
-export interface MangaPlan {
-    /** 方案 id。 */
-    id: string;
-    /** 方案名（如《保质期》3D 皮克斯版）。 */
-    name: string;
-    /** 基底风格 id（style-library 中非 stackable 风格）。 */
-    styleId: string;
-    /** 可选滤镜风格 id（style-library 中 stackable 风格）。 */
-    filterId?: string;
-    /** 可选题材（玄幻/武侠/二次元/都市/科幻...），注入对应题材生成规则。 */
-    genre?: string;
-    /** 是否激活（分镜/角色图生成时使用）。 */
-    active: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-/** POST /manhua/plans 请求：漫剧方案管理。 */
-export interface MangaPlansRequest {
-    op: 'create' | 'remove' | 'activate';
-    /** create：方案名。 */
-    name?: string;
-    /** create：基底风格 id。 */
-    styleId?: string;
-    /** create：可选滤镜风格 id。 */
-    filterId?: string;
-    /** create：题材（注入对应题材规则）。 */
-    genre?: string;
-    /** remove/activate：方案 id。 */
-    id?: string;
-}
-/** POST /manhua/plans 响应。 */
-export interface MangaPlansResponse {
-    plans: MangaPlan[];
-}
-/** 漫剧角色卡：制作角色（要建模/出图/锁一致性的「上镜角色」），与小说角色库弱关联。 */
-export interface MangaRoleCard {
-    /** 稳定 id。 */
-    id: string;
-    /** 来源小说角色名（只读追溯，非强外键；禁止反向写回小说库）。 */
-    sourceRoleName?: string;
-    /** 漫剧用名（可短剧化改名）。 */
-    name: string;
-    /** 身份一句话。 */
-    identity: string;
-    /** 核心功能：主角/导师/感情线/反派/搭档/线人/功能性。 */
-    coreFunction: 'protagonist' | 'mentor' | 'love_interest' | 'antagonist' | 'sidekick' | 'informant' | 'functional';
-    /** 与主角的关系。 */
-    protagonistRelation: 'enemy' | 'friend' | 'mentor' | 'lover' | 'exploit' | 'neutral';
-    /** 口头禅/说话方式（配音一致性）。 */
-    speechStyle: string;
-    /** ≤3 个极致性格标签。 */
-    traits: string[];
-    /** 1-2 个辨识度外貌点。 */
-    appearance: string;
-    /** 角色定妆级别：protagonist主角(完整四件套) / supporting配角(仅立绘) / extra路人(不做定妆)。默认 protagonist。 */
-    tier?: 'protagonist' | 'supporting' | 'extra';
-    /** 3-5 个关键剧情节点。 */
-    keyScenes: string[];
-    /** 上场集数（分镜提名导入时记录）。 */
-    appearsInEpisodes: number[];
-    /** 待匹配 → 待确认 → 已导入 → 已定妆 → 已归档。 */
-    status: 'pending_match' | 'pending_confirm' | 'imported' | 'anchored' | 'archived';
-    /** 形象资产（沿用小说角色库同款结构）。 */
-    imagePrompt?: RoleRecord['imagePrompt'];
-    /** 情绪表情清单（锚点提炼时产出）。 */
-    expressions?: string[];
-    /** 四类精修生图提示词（立绘/四视图/表情/细节）。 */
-    promptKit?: RoleRecord['promptKit'];
-    /** 角色参考图。 */
-    imageUrl?: string;
-    /** 图集（图像锚点）。 */
-    gallery?: RoleImage[];
-    /** 生成锚点/精修时的方案风格 id（旧风格检测用）。 */
-    promptStyleId?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-/** 分镜提名 → 小说角色库匹配的一条候选。 */
-export interface MangaRoleCandidate {
-    /** 分镜里的原始称谓（正文确切用法）。 */
-    rawName: string;
-    /** matched=命中小说角色；ambiguous=多个候选待定；not_in_library=小说库没有；already_imported=已建漫剧卡（跳过）。 */
-    verdict: 'matched' | 'ambiguous' | 'not_in_library' | 'already_imported';
-    /** 规则阶段候选短名单（≤5，精确名优先 + 身份/简称匹配）。 */
-    matches: Array<{
-        roleName: string;
-        reason: string;
-    }>;
-    /** LLM/规则确认的命中角色名（ambiguous 时可能为空）。 */
-    matchedRoleName?: string;
-    /** not_in_library 时给出建议：backfill=正文有该称谓但小说库漏提炼（回小说库补）；manga_new=漫剧新增角色（直接建卡）。 */
-    novelHint?: 'backfill' | 'manga_new';
-    /** 智能分级：protagonist=主角（必做定妆）、supporting=配角（建议做定妆）、extra=路人/功能性（默认不导入，折叠显示）。 */
-    tier?: 'protagonist' | 'supporting' | 'extra';
-    /** 采纳时预填的漫剧卡建议。 */
-    suggested: {
-        name: string;
-        identity: string;
-        coreFunction: MangaRoleCard['coreFunction'];
-        protagonistRelation: MangaRoleCard['protagonistRelation'];
-        speechStyle: string;
-        traits: string[];
-        appearance: string;
-        keyScenes: string[];
-    };
-}
-/** POST /manga/roles 请求：漫剧角色库操作。 */
-export interface MangaRolesRequest {
-    op: 'nominate' | 'adopt' | 'update' | 'remove' | 'visual' | 'promptKit' | 'image' | 'removeImage' | 'imageGenerate' | 'mode' | 'autoGenerate' | 'openAssets';
-    /** op='mode'：短剧精简模式开关。 */
-    shortDramaMode?: boolean;
-    /** op='nominate'：从哪章分镜提名角色。 */
-    chapterNo?: number;
-    /** op='adopt' / op='update'：漫剧角色卡。 */
-    card?: MangaRoleCard;
-    /** op='remove' / 'visual' / 'promptKit' / 'image' / 'removeImage' / 'imageGenerate'：漫剧卡 id。 */
-    id?: string;
-    /** op='visual' / 'promptKit'：漫剧方案基底风格 id。 */
-    styleId?: string;
-    /** 可选滤镜风格 id。 */
-    filterId?: string;
-    /** op='image'：定妆图 dataURL。 */
-    dataUrl?: string;
-    /** op='image'：图集用途标签（立绘/四视图/表情-x/场景/细节）；缺省视为角色参考图（imageUrl）。 */
-    label?: string;
-    /** op='imageGenerate'：漫画风格预设 id（可选）。 */
-    style?: string;
-    /** op='imageGenerate'：生图模型库条目 id（缺省用启用条目）。 */
-    modelId?: string;
-    /** op='autoGenerate' 时返回一键生成结果。 */
-    autoGenerate?: {
-        chapterNo: number;
-        skeletonBeats: number;
-        shotCount: number;
-        promptCount: number;
-        importedRoles: number;
-        needMakeupRoles: number;
-        extraRoles: number;
-        pendingCandidates: number;
-        pendingRoleNames: string[];
-    };
-}
-/** POST /manga/roles 响应。 */
-export interface MangaRolesResponse {
-    cards: MangaRoleCard[];
-    /** op='nominate' 时的 AI 提名候选。 */
-    candidates?: MangaRoleCandidate[];
-    /** op='visual' 时的形象锚点（已写入漫剧卡）。 */
-    visual?: RoleRecord['imagePrompt'];
-    /** op='promptKit' 时的四类精修提示词包（已写入漫剧卡）。 */
-    promptKit?: RoleRecord['promptKit'];
-    /** op='image' / 'imageGenerate' 时的定妆图 dataURL（已写入漫剧卡）。 */
-    imageUrl?: string;
-    /** op='mode' 时的短剧精简模式状态。 */
-    shortDramaMode?: boolean;
-    /** op='autoGenerate' 时返回一键生成结果。 */
-    autoGenerate?: {
-        chapterNo: number;
-        skeletonBeats: number;
-        shotCount: number;
-        promptCount: number;
-        importedRoles: number;
-        needMakeupRoles: number;
-        extraRoles: number;
-        pendingCandidates: number;
-        pendingRoleNames: string[];
-    };
-}
 /** Chapter lifecycle states (the writing pipeline's state machine). */
 export type ChapterStatus = 'pending' | 'generating' | 'written' | 'reviewing' | 'approved' | 'rejected' | 'error';
 /** One chapter in the plan. */
@@ -607,6 +303,10 @@ export interface ChapterPlan {
     review?: ReviewReport;
     /** 作者复盘：钩子兑现/结尾钩子/剧情线推进/连续性/节奏趋势（生成后自动）。 */
     authorReview?: AuthorReview;
+    /** 本章目标张力 0-100（规划或作者设定；用于张力曲线）。 */
+    tension?: number;
+    /** 本章实际张力 0-100（审稿时模型打分；缺省时回落到 review.tension）。 */
+    tensionActual?: number;
     /**
      * 待确认草稿：润色（去AI味）或整章重写的产物正文。生成时先存这里，
      * 用户看过对比后点「采纳」才覆盖正文文件；点「放弃」则丢弃。刷新页面不丢失。
@@ -640,12 +340,14 @@ export interface AuthorReview {
     /** 复盘时间。 */
     reviewedAt: string;
 }
-/** 审稿维度（结构化定位问题类别；与 review-policy.ts 的 REVIEW_DIMENSIONS 对齐）。 */
+/** 审稿维度（结构化定位问题类别）。权威清单是 reviewSystemPrompt 里的九条维度。 */
 export type ReviewDimension = 'character' | 'setting' | 'redline' | 'writing' | 'pacing' | 'logic' | 'anti-ai' | 'presentation' | 'compliance';
 /** One review finding. */
+/** 问题严重度（审稿 / 时间线 / 张力共用）。 */
+export type Severity = 'high' | 'medium' | 'low';
 export interface ReviewIssue {
     /** Severity: high = must fix, medium = should fix, low = suggestion. */
-    severity: 'high' | 'medium' | 'low';
+    severity: Severity;
     /** 问题维度（可选；缺省由前端按 item 推断）。 */
     dimension?: ReviewDimension;
     /** What the problem is. */
@@ -684,6 +386,8 @@ export interface ReviewReport {
         word: string;
         count: number;
     }>;
+    /** 本章张力 0-100（审稿模型评分；用于张力曲线的"实际"值）。 */
+    tension?: number;
     /** When the review ran. */
     reviewedAt: string;
 }
@@ -827,6 +531,13 @@ export interface MarketRadarResult {
     productionFoundation: ProductionFoundation;
     /** 开书创意简报（可选；用「用信号创作」接口单独生成）。 */
     creativeBrief?: MarketCreativeBrief;
+    /**
+     * 本次分析的报告 id（服务端生成）。
+     *
+     * 前端据此判断「是否换了一份新报告」：只有报告变了才重置信号勾选，否则重渲染/
+     * 轮询会把作者手选的信号冲掉。缺省（旧版产物）时前端按「首次看到」处理。
+     */
+    reportId?: string;
 }
 /** POST /market-radar request。 */
 export interface MarketRadarRequest {
@@ -878,6 +589,157 @@ export interface StoryBible {
     generatedAt?: string;
 }
 /** A planted/active/resolved foreshadowing thread. */
+/** 修订建议来源：审稿 / 时间线 / 张力。 */
+export type RevisionSource = 'review' | 'timeline' | 'tension';
+/** 一条待修订条目（合并层排序后的最小单位）。 */
+export interface RevisionItem {
+    /** 稳定 id（source:chapter:index）。 */
+    id: string;
+    source: RevisionSource;
+    severity: Severity;
+    /** 归属章节号（0 = 全书级）。 */
+    chapterNo: number;
+    item: string;
+    suggestion: string;
+    /** 去重时合并掉的同类条数（>=2 时展示）。 */
+    count?: number;
+}
+/** POST /revision/plan 请求：把该章三类建议合并成一份修订指令。 */
+export interface RevisionPlanRequest {
+    op: 'plan';
+    chapterNo?: number;
+    /** 显式指定的审稿意见（面板勾选后传入；缺省取已落盘报告）。 */
+    reviewIssues?: ReviewIssue[];
+    includeTimeline?: boolean;
+    includeTension?: boolean;
+    bookId?: string;
+}
+/** POST /revision/plan 响应。 */
+export interface RevisionPlanResponse {
+    chapterNo: number;
+    items: RevisionItem[];
+    /** 唯一修订指令（面板直接把它交给 /rewrite）。 */
+    instruction: string;
+    counts: Record<RevisionSource, number>;
+    /** 因上限被截断的条数。 */
+    omitted: number;
+    /** 验证基准（复核时逐条核对本轮下发的全部条目）。 */
+    baseline: ReviewReport;
+    /** 一行摘要。 */
+    summary: string;
+}
+/**
+ * 张力曲线形状预设：
+ * `escalation` 递进爬升 / `suspense` 悬疑加压 / `wave` 波浪呼吸 /
+ * `frontLoad` 前紧后稳 / `flat` 平稳推进 / `custom` 自定义。
+ */
+export type TensionCurvePreset = 'escalation' | 'suspense' | 'wave' | 'frontLoad' | 'flat' | 'custom';
+/** 张力曲线配置（随项目保存）。 */
+export interface TensionCurveConfig {
+    preset: TensionCurvePreset;
+    /** preset=custom 时的逐章采样（0-100；缺省按章节数取默认值）。 */
+    custom?: number[];
+}
+/** 张力曲线的一条问题（实际 vs 目标 / 曲线形状）。 */
+export interface TensionIssue {
+    severity: 'high' | 'medium' | 'low';
+    chapters: number[];
+    item: string;
+    suggestion: string;
+}
+/** 张力曲线数据点（面板绘图用）。 */
+export interface TensionCurvePoint {
+    no: number;
+    title: string;
+    /** 目标张力。 */
+    target?: number;
+    /** 实际张力（审稿打分）。 */
+    actual?: number;
+    /** 参考曲线在此处的取值。 */
+    reference?: number;
+}
+/** GET /tension 响应。 */
+export interface TensionResponse {
+    preset: TensionCurvePreset;
+    points: TensionCurvePoint[];
+    /** 规则核对发现的问题。 */
+    issues: TensionIssue[];
+}
+/** POST /tension 请求。 */
+export interface TensionRequest {
+    op: 'preset' | 'set' | 'clear';
+    preset?: TensionCurvePreset;
+    chapterNo?: number;
+    /** op=set 时的目标张力（0-100）。 */
+    tension?: number;
+}
+/** 允许作者编辑的提示词槽位 id（白名单）。 */
+export type PromptSlotId = 'styleExtra' | 'antiAiExtra' | 'dialogueExtra' | 'endingHookExtra';
+/** 一个提示词槽位的当前内容。 */
+export interface PromptSlotState {
+    id: PromptSlotId;
+    label: string;
+    hint: string;
+    placeholder: string;
+    maxChars: number;
+    value: string;
+}
+/** GET /prompt-slots 响应。 */
+export interface PromptSlotsResponse {
+    slots: PromptSlotState[];
+}
+/** POST /prompt-slots 请求：设置或清空一个槽位。 */
+export interface PromptSlotsRequest {
+    id: PromptSlotId;
+    /** 空串 = 清空该槽位（恢复默认）。 */
+    value: string;
+}
+/**
+ * 故事时间线事件：从章节正文抽取的「故事内时间点 + 地点 + 参与角色 + 事件」。
+ * 用途：后续章节的时间连续性与地点衔接（比编年录更强调"顺序"）。
+ */
+export interface TimelineEvent {
+    /** 稳定 id（时间线内唯一）。 */
+    id: string;
+    /** 所属章节号。 */
+    chapterNo: number;
+    /** 故事内时间点（如「第三日黄昏」「入宗三个月后」「同日夜」）。 */
+    time: string;
+    /** 相对顺序（同书内递增；无法判断时缺省）。用于检测时间倒流。 */
+    order?: number;
+    /** 地点。 */
+    place: string;
+    /** 参与角色（角色名）。 */
+    characters: string[];
+    /** 事件一句话。 */
+    event: string;
+    /** 来源：模型抽取 / 作者手改。 */
+    source: 'extracted' | 'manual';
+    createdAt: string;
+}
+/** 时间线矛盾（规则初筛 + AI 复核）。 */
+export interface TimelineIssue {
+    severity: 'high' | 'medium' | 'low';
+    /** 定位到的章节（可多个）。 */
+    chapters: number[];
+    /** 问题描述。 */
+    item: string;
+    /** 建议修法。 */
+    suggestion: string;
+}
+/** GET /timeline 响应。 */
+export interface TimelineResponse {
+    events: TimelineEvent[];
+    /** 规则初筛发现的问题（瞬时计算，不落盘）。 */
+    issues?: TimelineIssue[];
+}
+/** POST /timeline 请求：op=extract 抽单章 / check 全量检查 / update 手改 / remove 删除 / clear 清空。 */
+export interface TimelineRequest {
+    op: 'extract' | 'check' | 'update' | 'remove' | 'clear';
+    chapterNo?: number;
+    event?: TimelineEvent;
+    id?: string;
+}
 export interface Foreshadow {
     /** Stable id. */
     id: string;
@@ -984,7 +846,7 @@ export interface PlotlineHealthReport {
         note: string;
     }>;
 }
-/** AI 剧情方案：下一阶段目标 + 建议新线。 */
+/** 剧情方案：下一阶段目标 + 建议新线。 */
 export interface PlotlinePlan {
     /** 下一阶段（未来 5-10 章）剧情方向。 */
     direction: string;
@@ -994,12 +856,18 @@ export interface PlotlinePlan {
 /** POST /plotlines 响应。 */
 export interface PlotlinesResponse {
     plotlines: Plotline[];
-    /** op=suggest 时的 AI 建议候选线。 */
+    /** op=suggest 时的 建议候选线。 */
     suggestions?: Plotline[];
     /** op=health 时的健康检查报告。 */
     health?: PlotlineHealthReport;
     /** op=plan 时的剧情方案。 */
     plan?: PlotlinePlan;
+    /**
+     * 部分失败时的说明（如批量刷新里有线没返回进度）。
+     * HTTP 仍是 200：整体成功，只是有遗漏——**如实上报**比静默留空好，
+     * 否则作者会以为"刷新过了但内容没变"。
+     */
+    error?: string;
 }
 /** 一条敏感词命中。 */
 export interface SensitiveHit {
@@ -1103,7 +971,7 @@ export interface RoleStatusCard {
     /** 出场次数。 */
     appearances: number;
 }
-/** 角色库条目（主表：作者维护 + AI 提炼 + 编年录自动聚合）。 */
+/** 角色库条目（主表：作者维护 + 提炼 + 编年录自动聚合）。 */
 export interface RoleRecord {
     /** 角色名（唯一键）。 */
     name: string;
@@ -1123,192 +991,14 @@ export interface RoleRecord {
     knowledge: string[];
     /** 首次出场章节（编年录聚合，可手动修正）。 */
     firstChapter?: number;
-    /** 动漫形象描述词（AI 绘图用：中文描述 + 英文标签 + 关键外貌标签）。 */
-    imagePrompt?: {
-        /** 中文外貌描述：连贯一段（发色/瞳色/服装/气质/标志物）。 */
-        zh: string;
-        /** 英文绘图标签：booru 风格逗号分隔。 */
-        en: string;
-        /** 中文关键标签（发色/瞳色/服装/气质/标志物）。 */
-        tags: string[];
-        /** 依据来源说明（哪几章哪些描写）。 */
-        source?: string;
-        /** 即梦/生图通用负面提示词（低质量/变形/多手/文字水印等）。 */
-        negativePrompt?: string;
-    };
-    /** 角色参考图（dataURL 或 URL）。用于漫画/漫剧出图时锁定角色一致性。 */
-    imageUrl?: string;
-    /** 角色图集（图像锚点）：立绘/四视图/表情/场景/细节等，label 标注用途。 */
-    gallery?: RoleImage[];
-    /** 该角色所需的情绪表情清单（提炼时 LLM 补全 6-12 个，如"疲惫/麻木/压抑悲伤"）。 */
-    expressions?: string[];
-    /** LLM 精修的四类生图提示词包（前端拼装版之外的高质量版，promptKit 接口生成）。 */
-    promptKit?: {
-        /** 立绘：全身/半身正视图。 */
-        portrait?: {
-            zh: string;
-            en: string;
-        };
-        /** 四视图：正面/侧面/背面设定表。 */
-        sheet?: {
-            zh: string;
-            en: string;
-        };
-        /** 表情：同一脸部锚换情绪，每表情一段。 */
-        expressions?: {
-            name: string;
-            zh: string;
-            en: string;
-        }[];
-        /** 细节：标志物局部特写。 */
-        details?: {
-            zh: string;
-            en: string;
-        };
-    };
-    /** 生成形象锚点/精修提示词时的漫剧方案基底风格 id（= 方案 styleId；用于检测旧风格并提示重生成）。 */
-    promptStyleId?: string;
-    /** 漫画/漫剧重要性：main=必须建卡保证一致；support=有锚点即可；extra=路人随机生成不约束。 */
-    importance?: 'main' | 'support' | 'extra';
-}
-/** 角色图集条目：一张已定型的角色图（图像锚点）。 */
-export interface RoleImage {
-    /** 用途标签：立绘 / 四视图 / 表情-疲惫 / 场景 / 细节 等。 */
-    label: string;
-    /** dataURL 或 URL。 */
-    dataUrl: string;
 }
-/** 道具卡：常驻道具（跨镜头需保持一致），含一行统一描述。 */
-export interface Prop {
-    /** 道具名（如「外卖电动车」）。 */
-    name: string;
-    /** 外观/统一描述（注入提示词保持一致）。 */
-    desc: string;
-}
-/** POST /manga/props 请求。 */
-export interface MangaPropsRequest {
-    op: 'extract' | 'save';
-    /** op=save 时的道具清单（整体替换）。 */
-    props?: Prop[];
-}
-/** POST /manga/props 响应。 */
-export interface MangaPropsResponse {
-    props: Prop[];
-}
-/** 场景库条目：从正文提炼的「镜头场景」视觉锚点（漫剧分镜/生图用）。 */
-export interface SceneCard {
-    /** 场景名（唯一键），如「旧茶渡·地下石殿」。 */
-    name: string;
-    /** 一句话定位：空间/氛围/功能。 */
-    summary: string;
-    /** 幕归属：第一幕·后场 / 第二幕·卖场 / …（便于按剧情段落组织）。 */
-    act?: string;
-    /** 时间光态：夜间闭店后 / 雨夜 / 凌晨 / 频闪灯… */
-    moment?: string;
-    /** 关键情节镜头 1-3 条：该场景拍什么（人物动作+情绪+镜头推进）。 */
-    beats?: string[];
-    /** 人物在场状态：主角/关键角色在该场景的状态一句话。 */
-    characterState?: string;
-    /** 环境构成：空间结构/陈设/标志物。 */
-    elements: string[];
-    /** 色调与光影（含 HEX 色板，可空）。 */
-    palette: string[];
-    /** 氛围关键词：压抑/神秘/空旷… */
-    moods: string[];
-    /** 中文生图提示词（连贯一段，写实电影感）。 */
-    zh: string;
-    /** 英文生图提示词（逗号分隔标签）。 */
-    en: string;
-    /** 关键标签。 */
-    tags: string[];
-    /** 依据来源（哪几章哪些描写）。 */
-    source?: string;
-    /** 场景图集（图像锚点）：全景/局部/氛围 等。 */
-    gallery?: RoleImage[];
-    /** 生成时的漫剧方案基底风格 id（场景卡随方案风格措辞）。 */
-    styleId?: string;
-    /** 场景分级：core核心场景（反复出现，精修多图）/ secondary次要场景（1-2次，一张图）/ passing路过场景（不做图）。 */
-    tier?: 'core' | 'secondary' | 'passing';
-    /** 负面提示词（场景生图/生视频用，默认无人物无文字无水印）。 */
-    negativePrompt?: string;
-    /** 出场章节列表（用于自动分级统计）。 */
-    appearsInChapters?: number[];
-}
-/** POST /scenes 请求：场景库提炼 / 采纳 / 更新 / 删除 / 图集。 */
-export interface ScenesRequest {
-    op: 'extract' | 'adopt' | 'update' | 'remove' | 'image' | 'removeImage' | 'imageGenerate';
-    /** op='extract' 时的漫剧基底风格 id（场景卡按方案风格措辞）。 */
-    styleId?: string;
-    /** op='extract' 时的可选滤镜风格 id。 */
-    filterId?: string;
-    /** op='extract' 时按章提取；不传则全书提取（前4章）。 */
-    chapterNo?: number;
-    /** adopt / update 时传入的场景卡（adopt 可修改后采纳）。 */
-    scene?: SceneCard;
-    /** remove / image 时的场景名。 */
-    name?: string;
-    /** op='image' 时的图片 dataURL 与用途标签（全景/局部/氛围）。 */
-    dataUrl?: string;
-    label?: string;
-    /** op='imageGenerate' 时的生图模型 id（缺省用启用模型）。 */
-    modelId?: string;
-}
-/** POST /visual-rules 请求：视觉世界观规则提炼 / 保存。 */
-export interface VisualRulesRequest {
-    op: 'extract' | 'save';
-    /** op=save 时的规则数组。 */
-    rules?: string[];
-}
-/** POST /visual-rules 响应。 */
-export interface VisualRulesResponse {
-    rules: string[];
-}
-/** POST /scenes 响应。 */
-export interface ScenesResponse {
-    scenes: SceneCard[];
-    /** op=extract 时的 AI 候选场景。 */
-    candidates?: SceneCard[];
-    /** op=imageGenerate 时返回的生成图 dataURL。 */
-    dataUrl?: string;
-}
-/** POST /roles 请求：角色库增删改 + AI 提炼 + 参考图上传。 */
+/** POST /roles 请求：角色库增删改 + 提炼 + 参考图上传。 */
 export interface RolesRequest {
-    op: 'extract' | 'adopt' | 'update' | 'remove' | 'visual' | 'image' | 'removeImage' | 'imageGenerate' | 'promptKit';
+    op: 'extract' | 'adopt' | 'update' | 'remove';
     /** adopt / update 时传入的角色（adopt 可修改后采纳）。 */
     role?: RoleRecord;
     /** remove 时的角色名。 */
     name?: string;
-    /** op='image' 时的参考图 dataURL。 */
-    dataUrl?: string;
-    /** op='image' 时的图集用途标签（立绘/四视图/表情-x/场景/细节）；缺省视为角色参考图（imageUrl）。 */
-    label?: string;
-    /** op='imageGenerate' 时的漫画风格预设 id（用于统一角色图与漫画页风格）。 */
-    style?: string;
-    /** op='imageGenerate' 时指定生图模型库条目 id（缺省用启用条目）。 */
-    modelId?: string;
-    /** op='visual' / op='promptKit' 时的漫剧基底风格 id（角色图按方案风格重出）。 */
-    styleId?: string;
-    /** op='visual' / op='promptKit' 时的可选滤镜风格 id。 */
-    filterId?: string;
-}
-/** POST /image-test 请求：测一个生图接口的连通性与延迟（不落盘）。 */
-export interface ImageTestRequest {
-    /** OpenAI 兼容生图接口地址。 */
-    baseURL: string;
-    /** API Key。 */
-    apiKey: string;
-    /** 模型 id（顺带校验是否在接口模型列表里，可选）。 */
-    model?: string;
-}
-/** POST /image-test 响应。 */
-export interface ImageTestResponse {
-    ok: boolean;
-    /** 连通延迟（毫秒）。 */
-    ms?: number;
-    /** 失败原因。 */
-    message?: string;
-    /** 模型 id 是否出现在接口的模型列表（探测成功时才有）。 */
-    modelFound?: boolean;
 }
 /** POST /llm-test 请求：对选中的提供商/模型发一次最小真实调用。 */
 export interface LlmTestRequest {
@@ -1330,12 +1020,6 @@ export interface RolesResponse {
     roles: RoleRecord[];
     /** op=extract 时的 AI 候选角色。 */
     candidates?: RoleRecord[];
-    /** op=visual 时的动漫形象描述词（已写入角色卡）。 */
-    visual?: RoleRecord['imagePrompt'];
-    /** op=promptKit 时的四类提示词精修包（已写入角色卡）。 */
-    promptKit?: RoleRecord['promptKit'];
-    /** op=image 时的角色参考图 dataURL。 */
-    imageUrl?: string;
 }
 /** POST /bible/patch 请求：局部修补道藏。 */
 export interface BiblePatchRequest {
@@ -1345,10 +1029,10 @@ export interface BiblePatchRequest {
     /** 角色卡整体替换（人物志编辑知情度等）。 */
     characters?: CharacterCard[];
 }
-/** POST /blurb 请求：AI 生成/补全或手动保存小说简介。 */
+/** POST /blurb 请求：生成/补全或手动保存小说简介。 */
 export interface BlurbRequest {
     action: 'generate' | 'save';
-    /** 已写好的开头（AI 补全时使用；留空 = 全量生成）。 */
+    /** 已写好的开头（补全时使用；留空 = 全量生成）。 */
     partial?: string;
     /** 手动保存的完整简介（action=save 时）。 */
     text?: string;
@@ -1411,7 +1095,7 @@ export interface WorldState {
     regions: WorldRegion[];
     factions: WorldFaction[];
 }
-/** POST /world 请求：AI 提炼或手动保存。 */
+/** POST /world 请求：提炼或手动保存。 */
 export interface WorldRequest {
     action: 'generate' | 'save';
     /** action=save 时的完整世界数据。 */
@@ -1445,7 +1129,7 @@ export interface ProjectState {
     knowledgeDocs?: KnowledgeDoc[];
     /** 自动导演待办：风险/修复「采纳」后生成的随手清单。 */
     todos?: DirectorTodo[];
-    /** 小说简介（面向读者的作品门面，AI 生成或手动保存）。 */
+    /** 小说简介（面向读者的作品门面，生成或手动保存）。 */
     blurb?: string;
     /** 开书定盘：书籍级承诺与流派定位（前30章承诺/主副模式/文风/平台）。 */
     bookContract?: BookContract;
@@ -1455,47 +1139,45 @@ export interface ProjectState {
     world?: WorldState;
     /** 剧情线（主线/支线/人物线/悬念线）。 */
     plotlines?: Plotline[];
-    /** 角色库（作者维护 + AI 提炼的主表）。 */
+    /** 角色库（作者维护 + 提炼的主表）。 */
     roles?: RoleRecord[];
-    /** 漫剧角色库（制作角色投影：从分镜提名导入，独立于小说角色库）。 */
-    mangaRoles?: MangaRoleCard[];
-    /** 短剧精简模式：漫剧角色库按 5-8 上镜角色 / 功能标签 / 关系闭环 / 人设极致化约束。 */
-    shortDramaMode?: boolean;
-    /** 场景库（作者维护 + AI 提炼的主表）。 */
-    scenes?: SceneCard[];
-    /** 道具库：常驻道具（如外卖电动车/外卖箱），统一描述，注入提示词保持跨镜头一致。 */
-    props?: Prop[];
-    /** 视觉世界观规则（生图/生视频必须遵守，从道藏提炼，注入所有提示词）。 */
-    visualRules?: string[];
-    /** 分镜工作台产出（骨架/分镜表，按章持久化，刷新/切换不丢）。 */
-    storyboards?: ChapterStoryboard[];
-    /** 漫剧方案列表（同一本书的多套视觉演绎：基底风格 + 可选滤镜）。 */
-    mangaPlans?: MangaPlan[];
     /** 人物志：角色当前状态聚合结果（从编年录刷新后存档，打开页面直接显示）。 */
     roleStatus?: RoleStatusCard[];
-    /** 漫剧分镜结果缓存：章号 → 分镜（持久化，刷新不丢）。 */
-    /** 漫剧分集计划缓存：卷号/0=全书 → 分集计划（持久化，刷新不丢）。 */
-    /** 漫画脚本缓存：章号 → 漫画脚本（持久化，刷新不丢）。 */
+    /** 故事时间线（逐章抽取：时间点 / 地点 / 参与角色 / 事件）。 */
+    timeline?: TimelineEvent[];
+    /** 张力曲线配置（形状预设 + 自定义采样）。 */
+    tensionCurve?: TensionCurveConfig;
+    /** 作者自定义的提示词槽位（白名单见 prompt-slots.ts）。 */
+    promptSlots?: Partial<Record<PromptSlotId, string>>;
+    /** 本书参数（写作/审稿/推理/模型快切；未设字段回退全局 config）。 */
+    bookSettings?: BookSettings;
     /** ISO timestamps. */
     createdAt: string;
     updatedAt: string;
 }
-/** 生图模型配置（模型库条目，可多套并存，启用一条生效）。 */
-export interface ImageModelConfig {
-    /** 条目 id（本地唯一）。 */
-    id: string;
-    /** 展示名（如「豆包 Seedream」「即梦」）。 */
-    name: string;
-    /** OpenAI 兼容生图接口地址（如 https://ark.cn-beijing.volces.com/api/v3）。 */
-    baseURL: string;
-    /** API Key。 */
-    apiKey: string;
-    /** 生图模型 id（如 doubao-seedream-5-0-pro-260628）。 */
-    model: string;
-    /** 是否启用（同时只启用一条）。 */
-    enabled: boolean;
+/** 本书参数（存 novel-project.json.bookSettings；未设字段回退全局 config）。 */
+export interface BookSettings {
+    /** 本书使用的提供方路由（快切器写入）。 */
+    provider?: string;
+    /** 本书使用的主模型 id。 */
+    model?: string;
+    /** 本书写作推理档位。 */
+    reasoningEffort?: 'off' | 'low' | 'high' | 'max';
+    /** 本书分析类任务推理档位。 */
+    analysisReasoning?: 'off' | 'low' | 'high' | 'max';
+    /** 本书每章目标字数。 */
+    chapterChars?: number;
+    /** 本书单章最大输出 tokens。 */
+    maxTokens?: number;
+    /** 本书审稿通过分。 */
+    reviewPassScore?: number;
+    /** 本书是否写完自动审稿。 */
+    autoReview?: boolean;
+    /** 本书是否自动作者复盘。 */
+    autoAuthorReview?: boolean;
+    /** 本书是否修稿后自动复审。 */
+    autoReviewAfterRevise?: boolean;
 }
-/** Runtime config surface exposed to the panel (subset of plugin Config). */
 /** 手动添加的模型库条目（只存插件内，不改 DSH 全局）。 */
 export interface SavedModel {
     /** 唯一 id（前端生成的短 id）。 */
@@ -1568,24 +1250,6 @@ export interface RemoveProviderResponse {
     ok: boolean;
     message?: string;
 }
-/** GET /llm-providers 响应：当前已注册的提供方路由。 */
-export interface LlmProvidersResponse {
-    providers: {
-        id: string;
-        name: string;
-    }[];
-}
-/** POST /llm-remove 请求：移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
-export interface RemoveProviderRequest {
-    provider: string;
-    /** 该提供方对应的 DSH 凭据引用名（用于 unset）。 */
-    apiKeyEnv?: string;
-}
-/** POST /llm-remove 响应。 */
-export interface RemoveProviderResponse {
-    ok: boolean;
-    message?: string;
-}
 /** POST /llm-add 请求：添加一个模型（厂商直填 key，或自定义路由）。 */
 export interface AddModelRequest {
     mode: 'vendor' | 'custom';
@@ -1619,7 +1283,7 @@ export interface NovelConfig {
     outputDir: string;
     /** LLM provider route (e.g. deepseek-official). */
     provider: string;
-    /** LLM model id (e.g. deepseek-v4-flash). */
+    /** LLM model id (e.g. deepseek-flash). */
     model: string;
     /** 生成正文用模型（缺省用 model）。 */
     generateModel?: string;
@@ -1627,6 +1291,23 @@ export interface NovelConfig {
     reviewModel?: string;
     /** 全书质检(审计)用模型（缺省用 model）。 */
     auditModel?: string;
+    /**
+     * 备用模型：主模型调用失败（网络/限流/额度/服务不可用）时自动切换重试一次。
+     * 留空表示不切换。批量连写时能显著减少"整批中断"。
+     */
+    fallbackModel?: string;
+    /**
+     * 备用模型的输出 token 上限（仅在设了 `fallbackModel` 时有意义）。
+     *
+     * 为什么需要它：模型能力表（model-capability.ts）不含上下文窗口数据，
+     * 所以「换模型后自动下调 maxTokens」没有可靠依据，此处不猜。改为让作者按
+     * 备用模型的**实际**输出上限填写——长文路径（正文/改写/润色）换到备用模型时
+     * 会改用该值，避免沿用主模型的 20000 而必然撞 max-tokens 截断。
+     * 留空 = 沿用主模型预算（行为与旧版一致）。
+     */
+    fallbackMaxTokens?: number;
+    /** 是否在出章后自动抽取故事时间线（失败不阻断出章）。默认开。 */
+    autoTimeline?: boolean;
     /** LLM reasoning effort: off = no thinking; low/high/max = thinking intensity. */
     reasoningEffort: 'off' | 'low' | 'high' | 'max';
     /** 分析类任务（提炼/拆书/反推大纲等）的推理档位；默认 low，不受上面写作档位影响。 */
@@ -1643,16 +1324,6 @@ export interface NovelConfig {
     autoAuthorReview: boolean;
     /** 修订/润色产出草稿后是否自动附带一次 AI 审查（工作区显示新稿评分与剩余问题）。 */
     autoReviewAfterRevise: boolean;
-    /** 生图模型库（多套并存，启用一条生效；旧 imageApiKey/imageApiModel 自动迁移为一条）。 */
-    imageModels?: ImageModelConfig[];
-    /** 运行时生效的生图接口地址（= 启用条目，兼容旧代码读取）。 */
-    imageBaseUrl?: string;
-    /** 运行时生效的生图 API Key（= 启用条目，兼容旧代码读取）。 */
-    imageApiKey?: string;
-    /** 运行时生效的生图模型 id（= 启用条目，兼容旧代码读取）。 */
-    imageApiModel?: string;
-    /** 是否启用生图（= 存在启用条目）。 */
-    imageApiEnabled?: boolean;
     /** 自定义背景图（URL 或 dataURL 或服务端路径引用；空 = 使用主题默认背景）。 */
     themeBackground?: string;
     /** 自定义背景遮罩/模糊强度 0-80（0 = 不遮罩）。 */
@@ -1664,7 +1335,170 @@ export interface NovelConfig {
     /** 手动添加的模型库（「我的模型」条目；只存插件内）。 */
     savedModels?: SavedModel[];
 }
+/** POST /move-output-dir request：dryRun=true 仅预览；确认时须带 to。 */
+export interface MoveOutputDirRequest {
+    /** 新输出目录（绝对路径）。 */
+    to?: string;
+    /** 只列出当前目录内容，不搬移。 */
+    dryRun?: boolean;
+}
+/** POST /move-output-dir response。 */
+export interface MoveOutputDirResponse {
+    from: string;
+    to?: string;
+    /** 当前（或迁移后）目录内容清单。 */
+    files: string[];
+    bytes: number;
+    /** 联动重指向的书架条目数。 */
+    movedBooks: number;
+    /** settings 默认输出目录是否同步更新。 */
+    defaultUpdated: boolean;
+}
+/** POST /book-settings request：patch 省略 = 读取；字段传 null = 删除本书覆盖（回退全局）。 */
+export interface BookSettingsRequest {
+    patch?: {
+        [K in keyof BookSettings]?: BookSettings[K] | null;
+    };
+}
+/** POST /book-settings response。 */
+export interface BookSettingsResponse {
+    /** 本书已设置的参数（未设字段缺省 = 回退全局）。 */
+    settings: BookSettings;
+    /** 应用回退链后的生效配置（全局 + 本书覆盖）。 */
+    effective: NovelConfig;
+    /** 当前是否有打开的书。 */
+    hasBook: boolean;
+}
 /** GET /status response. */
+/**
+ * 创作阶段契约（宿主计算的「当前阶段 → 本轮允许的动作」）。
+ * 计算逻辑在 stage-contract.ts；这里是宿主与面板/助手共享的线上形状。
+ */
+export interface StageInfo {
+    /** 阶段标识。 */
+    id: 'outline' | 'bible' | 'plan' | 'write' | 'wait' | 'review' | 'revise' | 'export';
+    /** 中文阶段名。 */
+    label: string;
+    /** 建议的下一步动作（助手工具名；无对应工具时为空数组）。 */
+    recommend: string[];
+    /** 本阶段允许的写操作（作者只说了「继续」时的唯一命令集）。 */
+    allow: string[];
+    /** 为什么处于该阶段。 */
+    reason: string;
+}
+/** 单次 LLM 调用的 token 用量（来自 dsh-llm 的 usage chunk）。 */
+export interface LlmTokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    /** 供应商给出的总用量（缺失时由输入+输出推导）。 */
+    totalTokens?: number;
+    /** 思考（reasoning）通道用量。 */
+    reasoningTokens?: number;
+    /** 命中缓存的输入用量。 */
+    cacheReadTokens?: number;
+}
+/** LLM 实况帧：宿主 → 浏览器的 SSE 事件（每次调用一组 session_* 事件）。 */
+export interface LlmLiveFrame {
+    type: 'session_started' | 'output_delta' | 'reasoning_delta' | 'phase_changed' | 'session_completed';
+    /** 宿主生成，形如 ll-<base36>-<n>。 */
+    sessionId: string;
+    /** 本次调用用途（如 正文生成/审稿/章节规划）。 */
+    label?: string;
+    /** 使用模型。 */
+    model?: string;
+    /** 事件时间（ISO）。 */
+    at: string;
+    /** session_started：交互上下文。 */
+    context?: {
+        taskId?: string;
+        interactionId: string;
+    };
+    /** output_delta / reasoning_delta：本次增量文本。 */
+    content?: string;
+    /** session 累计字符数。 */
+    totalChars?: number;
+    /** reasoning 累计字符数。 */
+    totalReasoningChars?: number;
+    /** phase_changed：新阶段。 */
+    phase?: 'requesting' | 'streaming' | 'completed' | 'failed';
+    /** phase_changed：阶段描述。 */
+    phaseMessage?: string;
+    /** session_completed：最终预览（截断）。 */
+    preview?: string;
+    /** session_completed：失败信息。 */
+    error?: string;
+    /** session_completed：本次用量（供应商未上报时缺省）。 */
+    usage?: LlmTokenUsage;
+    /** session_completed：本次调用耗时（毫秒）。 */
+    elapsedMs?: number;
+    /** session_completed：首字耗时（毫秒；未拿到文本时缺省）。 */
+    firstTokenMs?: number;
+    /** session_started：是否已记录可查看的 Prompt（面板据此显示「查看 Prompt」）。 */
+    hasPrompt?: boolean;
+    /** session_started：Prompt 字符数（system + user）。 */
+    promptChars?: number;
+}
+/** 按用途分组的用量。 */
+export interface LlmUsageBucket {
+    label: string;
+    calls: number;
+    failed: number;
+    inputTokens: number;
+    outputTokens: number;
+    reasoningTokens: number;
+    elapsedMs: number;
+}
+/** 本次运行（进程内，重启归零）的 LLM 用量汇总。 */
+export interface LlmUsageSummary {
+    calls: number;
+    failed: number;
+    inputTokens: number;
+    outputTokens: number;
+    reasoningTokens: number;
+    totalTokens: number;
+    elapsedMs: number;
+    /** 供应商未上报 usage 的调用次数（用于说明数据为何不完整）。 */
+    callsWithoutUsage: number;
+    byLabel: LlmUsageBucket[];
+}
+/** 一次调用的 Prompt 记录（供面板查看「实际发送了什么」）。 */
+export interface LlmPromptRecord {
+    sessionId: string;
+    label?: string;
+    model?: string;
+    at: string;
+    system?: string;
+    user?: string;
+    /** system + user 的字符数（记录被截断时仍给出原始长度）。 */
+    chars: number;
+    /** 记录本身是否被截断。 */
+    truncated?: boolean;
+}
+/** 章节历史版本（快照）：覆盖写入前自动留存，可回滚。 */
+export interface ChapterSnapshot {
+    id: string;
+    chapterNo: number;
+    /** 快照文件（相对书目录）。 */
+    file: string;
+    /** 留存原因（生成覆盖 / 采纳草稿 / 修订 / 手工）。 */
+    reason: string;
+    chars: number;
+    at: string;
+}
+/** GET /snapshot 响应。 */
+export interface SnapshotResponse {
+    snapshots: ChapterSnapshot[];
+    /** 快照占用字节数。 */
+    bytes: number;
+}
+/** POST /snapshot 请求：op=create 手工存档 / restore 回滚 / remove 删除 / prune 只留最近 N 个。 */
+export interface SnapshotRequest {
+    op: 'create' | 'restore' | 'remove' | 'prune';
+    chapterNo?: number;
+    id?: string;
+    /** prune：每章保留数量。 */
+    keep?: number;
+}
 export interface StatusResponse {
     config: NovelConfig;
     /** The persisted project, when one exists in the output dir. */
@@ -1673,10 +1507,25 @@ export interface StatusResponse {
     generatedFiles: string[];
     /** 全书质检实时状态（用于面板/外部读取进度）。 */
     audit?: AuditStatus;
+    /** 宿主按项目真实状态算出的创作阶段（面板角标 / 外部自动化共用）。 */
+    stage?: StageInfo;
+    /** 本次运行（进程内）的 LLM 用量汇总：调用次数 / 输入·输出·思考 token / 耗时。 */
+    usage?: LlmUsageSummary;
+    /**
+     * 截断声明：本次响应中被裁掉的字段说明（如「编年录：共 320 条，仅返回最近 80 条」）。
+     * 消费方不得把缺失字段当作"不存在"，需要完整数据时走专用接口。
+     */
+    truncations?: string[];
 }
 /** 生产单状态（生产单 = 区间批量生产执行器：计划补足 + 逐章生成 + 被拒分级处理）。 */
 export interface RunState {
     runId: string;
+    /**
+     * 本批次归属的书名（可选，兼容旧 run-state.json）。
+     * 生产单是全局单实例，而 /run/status 恢复时会扫书架取第一个有 run-state 的目录，
+     * 因此"这是哪本书的批次"必须显式带上，否则芯片/面板只能显示一个无法归属的状态。
+     */
+    bookName?: string;
     /** 区间起点（含）。 */
     startNo: number;
     /** 区间终点（含）。 */
@@ -1698,6 +1547,15 @@ export interface RunState {
     };
     /** 两轮修订仍不过、保留草稿待人工的章号。 */
     pendingManual: number[];
+    /**
+     * 连续失败次数：章号 → 已失败几次。用于熔断，避免同一章反复烧 token。
+     *
+     * 为什么需要它：主循环只跳过 `approved` 章，失败章的 `status` 是 `error`，
+     * 下一轮扫描仍会选中它 → 失败→重跑→失败形成死循环，每轮白烧一次正文生成。
+     * 达 {@link MAX_CHAPTER_FAILURES} 次后该章转入 `pendingManual` 并跳过。
+     * 落盘以保证 web 重启（`status()` 会把 running 降级为 paused）后熔断计数不丢。
+     */
+    failedAttempts?: Record<string, number>;
     /** 运行日志（保留最近 300 条）。 */
     log: Array<{
         at: string;
@@ -1876,13 +1734,31 @@ export interface ChapterResponse {
     markdown: string;
 }
 /** POST /export request/response. */
+/**
+ * 导出范围：
+ * - `book`       整本正文（txt / md）
+ * - `settings`   项目设定（总纲 / 道藏 / 大世界 / 写作资产 / 卷首语）
+ * - `plan`       规划（卷计划 + 章节计划，含每章目标/要点/钩子/硬事实）
+ * - `characters` 角色（角色库 + 人物志当前状态）
+ * - `review`     质检记录（逐章审稿 + 作者复盘 + 伏笔/剧情线状态）
+ * - `project`    项目 JSON（完整状态，用于备份/迁移；仅 json 格式）
+ */
+export type ExportScope = 'book' | 'settings' | 'plan' | 'characters' | 'review' | 'project';
+/** 导出范围全集（宿主校验用；顺序即 UI 展示顺序）。 */
+export declare const EXPORT_SCOPE_VALUES: readonly ExportScope[];
+/** 导出范围的中文标签。 */
+export declare const EXPORT_SCOPE_LABELS: Record<ExportScope, string>;
 export interface ExportRequest {
-    format: 'txt' | 'md';
+    format: 'txt' | 'md' | 'json';
+    /** 缺省 `book`（兼容旧调用）。 */
+    scope?: ExportScope;
 }
 export interface ExportResponse {
     file: string;
     chars: number;
     chapters: number;
+    scope: ExportScope;
+    format: 'txt' | 'md' | 'json';
 }
 /** POST /config request: patch any subset of the runtime config. */
 export interface ConfigPatch {
@@ -1893,6 +1769,10 @@ export interface ConfigPatch {
     generateModel?: string;
     reviewModel?: string;
     auditModel?: string;
+    /** 备用模型（主模型失败时自动切换重试一次；空串 = 关闭）。 */
+    fallbackModel?: string;
+    /** 出章后自动抽取故事时间线（默认开）。 */
+    autoTimeline?: boolean;
     reasoningEffort?: 'off' | 'low' | 'high' | 'max';
     analysisReasoning?: 'off' | 'low' | 'high' | 'max';
     chapterChars?: number;
@@ -1901,9 +1781,6 @@ export interface ConfigPatch {
     autoReview?: boolean;
     autoAuthorReview?: boolean;
     autoReviewAfterRevise?: boolean;
-    imageApiKey?: string;
-    imageApiModel?: string;
-    imageApiEnabled?: boolean;
     /** 自定义背景图（URL / dataURL / 服务端路径引用）。 */
     themeBackground?: string;
     /** 自定义背景遮罩/模糊强度 0-80。 */
@@ -1911,11 +1788,18 @@ export interface ConfigPatch {
     /** 玻璃透明度 0-100（100=当前原样）。 */
     themeOpacity?: number;
     enableAdaptMode?: boolean;
-    /** 生图模型库（完整替换保存）。 */
-    imageModels?: ImageModelConfig[];
     /** 手动添加的模型库（完整替换保存）。 */
     savedModels?: SavedModel[];
 }
+/** POST /config response: the config the host will read next, plus persistence caveats. */
+export interface ConfigResponse {
+    config: NovelConfig;
+    /**
+     * 已生效但**未持久化**时的说明（宿主 settings 段不可寻址：段 id 未知或宿主
+     * 未登记）。有值时设置只在本次进程内有效，重启回退，面板照此提示用户。
+     */
+    settingsWarning?: string;
+}
 /** One assistant conversation message (persisted per project). */
 export interface AssistantMessage {
     role: 'user' | 'assistant' | 'tool';
@@ -2040,7 +1924,7 @@ export interface AntiAiRule {
     /** 作用域（缺省 all）。 */
     scope?: Array<'writing' | 'review' | 'polish' | 'all'>;
 }
-/** 预置写法模板（来自 AI-Novel-Writing-Assistant 内置数据，一键绑定无需样本文本）。 */
+/** 预置叙事风格模板（一键绑定无需样本文本）。 */
 export interface StyleTemplateNarrativeRules {
     progressionMode?: string;
     sceneUnitPattern?: string[];
@@ -2108,7 +1992,7 @@ export interface StyleTemplate {
     /** 该模板默认绑定的反 AI 规则 key（内置规则名）。 */
     defaultAntiAiRuleKeys: string[];
 }
-/** 起始风格画像：无样本文本也能快速绑定一套写法（对齐上游 DEFAULT_STARTER_STYLE_PROFILES）。 */
+/** 起始风格画像：无样本文本也能快速绑定一套写法。 */
 export interface StarterStyleProfile {
     /** stable key（如 starter-power-up）。 */
     key: string;
@@ -2288,7 +2172,7 @@ export interface AdaptationDimension {
     current: string;
     /** 该值在正文中的出现证据（章节/频次，可空）。 */
     evidence?: string;
-    /** AI 建议的候选新值（可空，每套含名称与一句话说明）。 */
+    /** 建议的候选新值（可空，每套含名称与一句话说明）。 */
     candidates?: Array<{
         name: string;
         desc?: string;
@@ -2431,7 +2315,7 @@ export interface AdaptSaveRequest {
     text: string;
     /** 新书名（缺省为「改编新书」；建议用「<原著>·改编版」）。 */
     bookName?: string;
-    /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+    /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
     outputDir?: string;
     /** 可附带反推大纲（写进新项目，便于后续续写/编辑）。 */
     outline?: string;
@@ -2455,7 +2339,7 @@ export interface AdaptMaterializeRequest {
     text: string;
     /** 新书名（缺省为「<源书名>·改编版」）。 */
     bookName?: string;
-    /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+    /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
     outputDir?: string;
     /** 反推大纲（来自分析；缺少时用源文章题兜底）。 */
     outline?: string;
@@ -2489,7 +2373,7 @@ export interface AdaptMaterializeResponse {
 export interface AdaptMaterializeSaveRequest {
     /** 新书名（缺省为「改编版」）。 */
     bookName?: string;
-    /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+    /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
     outputDir?: string;
     /** 改编后总纲。 */
     outline: string;