@waterwx/dsh-novel-forge 2.0.0-alpha.1 → 2.0.0

package/src/protocol.ts

@@ -4,16 +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 const NOVEL_API = {
@@ -25,6 +15,34 @@ export const NOVEL_API = {
   bible: '/api/dsh-novel-forge/bible',
   assets: '/api/dsh-novel-forge/assets',
   styleEngine: '/api/dsh-novel-forge/style-engine',
+  styleFormula: '/api/dsh-novel-forge/style-formula',
+  styleDetect: '/api/dsh-novel-forge/style-detect',
+  knowledge: '/api/dsh-novel-forge/knowledge',
+  bookAnalysis: '/api/dsh-novel-forge/book-analysis',
+  ideaInspiration: '/api/dsh-novel-forge/idea-inspiration',
+  ideaInspirationMarket: '/api/dsh-novel-forge/idea-inspiration/market',
+  director: '/api/dsh-novel-forge/director',
+  directorTodos: '/api/dsh-novel-forge/director/todos',
+  llmLive: '/api/dsh-novel-forge/llm-live/stream',
+  /** 查看某次调用实际发送的 Prompt（按 sessionId）。 */
+  llmPrompt: '/api/dsh-novel-forge/llm-live/prompt',
+  /** 清零本次运行的用量账本。 */
+  usageReset: '/api/dsh-novel-forge/usage/reset',
+  /** 章节历史版本（快照）。 */
+  snapshot: '/api/dsh-novel-forge/snapshot',
+  /** 修订指令合并（POST：汇总审稿/时间线/张力为一轮）。 */
+  revisionPlan: '/api/dsh-novel-forge/revision/plan',
+  /** 张力曲线（GET 数据 / POST 设置）。 */
+  tension: '/api/dsh-novel-forge/tension',
+  /** 提示词槽位（GET 列表 / POST 写入）。 */
+  promptSlots: '/api/dsh-novel-forge/prompt-slots',
+  /** 故事时间线（GET 列表 / POST 操作）。 */
+  timeline: '/api/dsh-novel-forge/timeline',
+  marketRadar: '/api/dsh-novel-forge/market-radar',
+  marketRadarScan: '/api/dsh-novel-forge/market-radar/scan',
+  marketRadarApply: '/api/dsh-novel-forge/market-radar/apply',
+  marketRadarSync: '/api/dsh-novel-forge/market-radar/foundation-sync',
+  marketRadarBrief: '/api/dsh-novel-forge/market-radar/brief',
   generate: '/api/dsh-novel-forge/generate',
   review: '/api/dsh-novel-forge/review',
   rewrite: '/api/dsh-novel-forge/rewrite',
@@ -52,22 +70,6 @@ export const NOVEL_API = {
   bookshelfImportText: '/api/dsh-novel-forge/bookshelf/import-text',
   /** 导入 txt/md 全本：拆章预览（不落盘）。 */
   bookshelfImportTextPreview: '/api/dsh-novel-forge/bookshelf/import-text/preview',
-  /** 漫剧方案管理：create/remove/activate。 */
-  manhuaPlans: '/api/dsh-novel-forge/manhua/plans',
-  /** 漫剧角色库：从分镜提名（规则+LLM两段式）/ 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
-  mangaRoles: '/api/dsh-novel-forge/manga/roles',
-  /** 漫剧道具库：从已写章节提炼常驻道具（跨镜头需一致）/ 保存清单。 */
-  mangaProps: '/api/dsh-novel-forge/manga/props',
-  /** 导出「即梦素材包」落盘到资产库 manga-assets/素材包/。 */
-  exportPackage: '/api/dsh-novel-forge/manga/export-package',
-  /** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
-  storyboardSkeleton: '/api/dsh-novel-forge/storyboard/skeleton',
-  /** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
-  storyboardTable: '/api/dsh-novel-forge/storyboard/table',
-  /** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
-  storyboardPrompts: '/api/dsh-novel-forge/storyboard/prompts',
-  /** 生图接口连通性测试（设置页每个模型条目用）。 */
-  imageTest: '/api/dsh-novel-forge/image-test',
   /** LLM 模型连通性测试：真实最小调用，验证 Key / 端点 / 模型可用。 */
   llmTest: '/api/dsh-novel-forge/llm-test',
   /** 添加模型：厂商直填 key 或自定义路由，写进 DSH 凭据与 llm-pi-ai 路由。 */
@@ -94,16 +96,14 @@ export const NOVEL_API = {
   blurb: '/api/dsh-novel-forge/blurb',
   /** 重命名当前书（同步项目与书架条目）。 */
   rename: '/api/dsh-novel-forge/rename',
-  /** 大世界：AI 提炼 / 保存结构化数据（境界/区域/势力）。 */
+  /** 大世界：提炼 / 保存结构化数据（境界/区域/势力）。 */
   world: '/api/dsh-novel-forge/world',
   /** 封面：GET 读取（dataUrl）/ POST 上传或移除。 */
   cover: '/api/dsh-novel-forge/blurb/cover',
   /** 剧情线管理：增删改 + 关联章节。 */
   plotlines: '/api/dsh-novel-forge/plotlines',
-  /** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+  /** 角色库：提炼 / 采纳 / 更新 / 删除。 */
   roles: '/api/dsh-novel-forge/roles',
-  scenes: '/api/dsh-novel-forge/scenes',
-  visualRules: '/api/dsh-novel-forge/visual-rules',
   /** 作者复盘补跑：对已写章节补齐 authorReview（全书流式 / 单章 JSON）。 */
   reviewBackfill: '/api/dsh-novel-forge/review/backfill',
   /** 章节复位：generating 卡死 → pending（可重新生成）。 */
@@ -112,15 +112,12 @@ export const NOVEL_API = {
   chapterApprove: '/api/dsh-novel-forge/chapter/approve',
   /** 敏感词检查：全书已写章节或指定文本。 */
   sensitiveCheck: '/api/dsh-novel-forge/sensitive-check',
-  /** 开书想法 → AI 补全大纲：输入一句话想法，生成 2-3 个可选大纲方案。 */
+  /** 开书想法 → 补全大纲：输入一句话想法，生成 2-3 个可选大纲方案。 */
   outlineSuggest: '/api/dsh-novel-forge/outline/suggest',
   /** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流）。 */
   outlineReverse: '/api/dsh-novel-forge/outline/reverse',
   /** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检（两阶段：源笔记→分节分析）。 */
   breakdown: '/api/dsh-novel-forge/breakdown',
-  /** 漫剧分镜生成：章节 → 角色锚点 + 分镜表（可适配豆包/Seedance/SD）。 */
-  /** 漫剧分集计划：读一卷 → 按故事弧线分集（高潮拆集/过渡并章）。 */
-  /** 漫画脚本：章节 → 分页分格漫画脚本（含角色视觉锚点）。 */
   /** 生产单：启动批量生产（计划补足 + 逐章生成 + 被拒分级处理）。 */
   runStart: '/api/dsh-novel-forge/run/start',
   /** 生产单控制：pause / resume / stop。 */
@@ -128,6 +125,10 @@ export const NOVEL_API = {
   /** 生产单状态（含进度统计与日志）。 */
   runStatus: '/api/dsh-novel-forge/run/status',
   config: '/api/dsh-novel-forge/config',
+  /** 输出目录迁移：dryRun 预览 / 确认后搬文件并联动配置与书架。 */
+  moveOutputDir: '/api/dsh-novel-forge/move-output-dir',
+  /** 本书参数：POST {} 读取；POST {patch} 合并保存（存 novel-project.json）。 */
+  bookSettings: '/api/dsh-novel-forge/book-settings',
   openFolder: '/api/dsh-novel-forge/open-folder',
   /** 插件自更新：在 DSH profile 目录拉取最新 npm 版（下载后需重启 DSH 生效）。 */
   pluginUpdate: '/api/dsh-novel-forge/plugin/update',
@@ -228,7 +229,7 @@ export interface BookImportTextRequest {
   text?: string
   /** 模式二：原文件名（txt/md），用于推断书名与显示。 */
   fileName?: string
-  /** 输出目录；缺省为 ~/.dsh/novels/书名。 */
+  /** 输出目录；缺省为「输出目录」设置下的书名子目录。 */
   outputDir?: string
 }
 
@@ -260,312 +261,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'      // planned, not started
@@ -588,6 +283,18 @@ export interface ChapterPlan {
   beats: string
   /** Target character count (defaults to the configured chapter size). */
   targetChars: number
+  /** 本章必达项（必须推进的局面/关系/信息/风险/决策变化）。 */
+  mustAdvance?: string[]
+  /** 本章必须保持/不得破坏的项（如人物状态、已有伏笔不提前揭）。 */
+  mustPreserve?: string[]
+  /** 本章不可违背的人物硬事实（身份/阵营/境界/当前位置/知情度）。 */
+  characterHardFacts?: string[]
+  /** 伏笔操作指令（seed/touch/pressure/partial_reveal/payoff/forbid）。 */
+  payoffDirectives?: Array<{ no?: number; operation?: 'seed' | 'touch' | 'pressure' | 'partial_reveal' | 'payoff' | 'forbid'; text?: string }>
+  /** 章末钩子要求（悬念/反转/新线索/未闭合选择）。 */
+  endingHook?: string
+  /** 本章义务合约（人类可读摘要，供生成与审稿共同锚定）。 */
+  obligation?: string
   /** Generation/review state. */
   status: ChapterStatus
   /** 进入 generating 的时间（用于超时自动复位；未在生成时无此字段）。 */
@@ -604,6 +311,10 @@ export interface ChapterPlan {
   review?: ReviewReport
   /** 作者复盘：钩子兑现/结尾钩子/剧情线推进/连续性/节奏趋势（生成后自动）。 */
   authorReview?: AuthorReview
+  /** 本章目标张力 0-100（规划或作者设定；用于张力曲线）。 */
+  tension?: number
+  /** 本章实际张力 0-100（审稿时模型打分；缺省时回落到 review.tension）。 */
+  tensionActual?: number
   /**
    * 待确认草稿：润色（去AI味）或整章重写的产物正文。生成时先存这里，
    * 用户看过对比后点「采纳」才覆盖正文文件；点「放弃」则丢弃。刷新页面不丢失。
@@ -627,23 +338,46 @@ export interface AuthorReview {
   continuity: string
   /** 近期节奏趋势提示（拖沓/爽点密度等）。 */
   trend: string
+  /** 本章发生的关键状态变化（人物状态/世界局面/关系/资源），用于回灌整本与事实库。 */
+  stateChanges?: string[]
+  /** 本章新引入或升级的冲突（供整本控制层与后续卷节奏参考）。 */
+  newConflicts?: string[]
+  /** 本章埋下/推进的新线索（供知识与伏笔系统回灌）。 */
+  clues?: string[]
+  /** 本章缺席但值得注意的角色及风险（卷级职责/缺席风险）。 */
+  absentRisks?: string[]
   /** 复盘时间。 */
   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. */
   item: string
   /** Concrete suggestion for fixing it. */
   suggestion: string
+  /** 命中的反 AI 规则名（结构化，便于统计）。 */
+  ruleName?: string
+  /** 规则类别：forbidden / risk / encourage。 */
+  ruleType?: 'forbidden' | 'risk' | 'encourage'
+  /** 问题细分类（如 套话 句式 段落 心理 设定）。 */
+  category?: string
+  /** 命中的原文摘录。 */
+  excerpt?: string
+  /** 判定理由。 */
+  reason?: string
+  /** 是否可自动改写。 */
+  canAutoRewrite?: boolean
 }
 
 /** AI review report for one chapter. */
@@ -656,6 +390,14 @@ export interface ReviewReport {
   verdict: string
   /** Individual findings. */
   issues: ReviewIssue[]
+  /** 风险分 0-100（越高越需人工处理；源自 LLM 复核与本地扫描）。 */
+  riskScore?: number
+  /** 本地 AI 味指数 0-100（越高越像 AI；LLM 复核锚点，供 UI 展示）。 */
+  aiFlavor?: number
+  /** 本地扫描命中的高频套话（按次数降序，取前若干）。 */
+  aiPhrases?: Array<{ word: string; count: number }>
+  /** 本章张力 0-100（审稿模型评分；用于张力曲线的"实际"值）。 */
+  tension?: number
   /** When the review ran. */
   reviewedAt: string
 }
@@ -672,6 +414,146 @@ export interface Volume {
   chapterStart: number
   /** Last chapter number (inclusive). */
   chapterEnd: number
+  /** 卷级战略（这一卷的定位/承转，如「立威卷」「冲突升级卷」）。 */
+  strategy?: string
+  /** 卷节奏板（这一卷的节奏安排：起-承-转-合/爽点密度/关键节点）。 */
+  pacing?: string
+}
+
+/** 开书定盘：面向读者的承诺与流派定位（生成/规划均可引用）。 */
+export interface BookContract {
+  /** 一句话卖点/题材承诺。 */
+  promise?: string
+  /** 主推进模式名（从推进模式库选）。 */
+  primaryModeName?: string
+  /** 辅助推进模式名。 */
+  secondaryModeNames?: string[]
+  /** 整体文风基调（一句话）。 */
+  tone?: string
+  /** 目标平台（如「番茄」）。 */
+  targetPlatform?: string
+}
+
+/** 书内知识库文档（供生成/规划时检索注入的参考资料）。 */
+export interface KnowledgeDoc {
+  id: string
+  title: string
+  content: string
+  updatedAt: string
+}
+
+/** POST /knowledge request：增删改知识库文档。 */
+export interface KnowledgeRequest {
+  action: 'add' | 'remove' | 'replace'
+  doc?: { id?: string; title: string; content: string }
+  id?: string
+}
+
+/** POST /book-analysis request。 */
+export interface BookAnalysisRequest {
+  text: string
+}
+
+/** 书分析/拆书结果。 */
+export interface BookAnalysisResult {
+  sellingPoints: string[]
+  structure: string[]
+  lessons: string[]
+  risks: string[]
+}
+
+/** POST /idea-inspiration request。 */
+export interface IdeaInspirationRequest {
+  idea: string
+  count?: number
+}
+
+/** 创意灵感结果：多方向开书灵感。 */
+export interface IdeaInspirationResult {
+  ideas: Array<{ title: string; hook: string; genre: string; pov: string; payoff: string }>
+}
+
+/** POST /director request。 */
+export interface DirectorRequest {
+  focus?: string
+}
+
+/** 自动导演编排建议（下一卷/阶段编排 + 修复再平衡）。 */
+export interface DirectorAdvice {
+  summary: string
+  nextArc: string[]
+  pacing: string
+  risks: string[]
+  fixes: string[]
+}
+
+/** 自动导演「采纳」后生成的书内待办项。 */
+export interface DirectorTodo {
+  id: string
+  text: string
+  /** 来源：风险 或 修复。 */
+  source: 'risk' | 'fix'
+  done: boolean
+  createdAt: string
+}
+
+/** 题材雷达：单条市场信号。 */
+export interface MarketRadarSignal {
+  id: string
+  kind: 'genre' | 'protagonist' | 'advantage' | 'opening' | 'relationship' | 'title_pattern' | 'opportunity' | 'crowding'
+  title: string
+  detail: string
+  /** 趋势：current / rising / stable / falling。 */
+  direction?: 'current' | 'rising' | 'stable' | 'falling'
+  /** 是否建议优先考虑。 */
+  recommended?: boolean
+}
+
+/** 题材雷达：生产底座（引用内置题材/推进模式库，或给出新资产）。 */
+export interface ProductionFoundation {
+  genre: { existingId?: string; name: string; description: string; template?: string }
+  primaryStoryMode: { existingId?: string; name: string; driver: string; readerExpectation: string }
+  secondaryStoryMode?: { existingId?: string; name: string; driver: string; readerExpectation: string }
+}
+
+/** 题材雷达：开书创意简报（可执行，严禁照搬具体作品/命名）。 */
+export interface MarketCreativeBrief {
+  promptBlock: string
+  openingIdea: string
+  coreAdvantage: string
+  bookSellingPoint: string
+  first30ChapterPromise: string
+}
+
+/** 题材雷达结果。 */
+export interface MarketRadarResult {
+  signals: MarketRadarSignal[]
+  productionFoundation: ProductionFoundation
+  /** 开书创意简报（可选；用「用信号创作」接口单独生成）。 */
+  creativeBrief?: MarketCreativeBrief
+  /**
+   * 本次分析的报告 id（服务端生成）。
+   *
+   * 前端据此判断「是否换了一份新报告」：只有报告变了才重置信号勾选，否则重渲染/
+   * 轮询会把作者手选的信号冲掉。缺省（旧版产物）时前端按「首次看到」处理。
+   */
+  reportId?: string
+}
+
+/** POST /market-radar request。 */
+export interface MarketRadarRequest {
+  platform?: string
+  genre?: string
+  keywords?: string
+  feedText?: string
+  /** 已扫描的上榜记录（来自真实榜单抓取），用于让分析基于真实榜单证据。 */
+  candidates?: Array<{ title: string; author?: string; tags?: string[]; synopsis?: string; category?: string; heatLabel?: string }>
+}
+
+/** POST /market-radar/brief request：用选中的信号 + 影响模式生成开书创意。 */
+export interface MarketRadarBriefRequest {
+  influenceMode: 'follow_hot' | 'differentiate' | 'light'
+  signals: MarketRadarSignal[]
 }
 
 /** A character card from the story bible. */
@@ -705,6 +587,175 @@ export interface StoryBible {
 }
 
 /** 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
@@ -746,6 +797,8 @@ export interface AuditResponse {
   auditedChapters: number
   /** 质检时间。 */
   auditedAt: string
+  /** 本次质检使用的模型（auditModel 或全局 model）。 */
+  model?: string
 }
 
 /** 全书质检的实时状态（通过 /status 暴露给面板/外部读取）。 */
@@ -817,7 +870,7 @@ export interface PlotlineHealthReport {
   }>
 }
 
-/** AI 剧情方案：下一阶段目标 + 建议新线。 */
+/** 剧情方案：下一阶段目标 + 建议新线。 */
 export interface PlotlinePlan {
   /** 下一阶段（未来 5-10 章）剧情方向。 */
   direction: string
@@ -828,7 +881,7 @@ export interface PlotlinePlan {
 /** POST /plotlines 响应。 */
 export interface PlotlinesResponse {
   plotlines: Plotline[]
-  /** op=suggest 时的 AI 建议候选线。 */
+  /** op=suggest 时的 建议候选线。 */
   suggestions?: Plotline[]
   /** op=health 时的健康检查报告。 */
   health?: PlotlineHealthReport
@@ -949,7 +1002,7 @@ export interface RoleStatusCard {
   appearances: number
 }
 
-/** 角色库条目（主表：作者维护 + AI 提炼 + 编年录自动聚合）。 */
+/** 角色库条目（主表：作者维护 + 提炼 + 编年录自动聚合）。 */
 export interface RoleRecord {
   /** 角色名（唯一键）。 */
   name: string
@@ -969,192 +1022,17 @@ 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 {
@@ -1178,12 +1056,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 请求：局部修补道藏。 */
@@ -1195,10 +1067,10 @@ export interface BiblePatchRequest {
   characters?: CharacterCard[]
 }
 
-/** POST /blurb 请求：AI 生成/补全或手动保存小说简介。 */
+/** POST /blurb 请求：生成/补全或手动保存小说简介。 */
 export interface BlurbRequest {
   action: 'generate' | 'save'
-  /** 已写好的开头（AI 补全时使用；留空 = 全量生成）。 */
+  /** 已写好的开头（补全时使用；留空 = 全量生成）。 */
   partial?: string
   /** 手动保存的完整简介（action=save 时）。 */
   text?: string
@@ -1270,7 +1142,7 @@ export interface WorldState {
   factions: WorldFaction[]
 }
 
-/** POST /world 请求：AI 提炼或手动保存。 */
+/** POST /world 请求：提炼或手动保存。 */
 export interface WorldRequest {
   action: 'generate' | 'save'
   /** action=save 时的完整世界数据。 */
@@ -1302,57 +1174,61 @@ export interface ProjectState {
   assets?: ProjectAssets
   /** 事实库/时间线：每章生成后抽取，注入后续章节保持一致性。 */
   facts?: ChapterFact[]
-  /** 小说简介（面向读者的作品门面，AI 生成或手动保存）。 */
+  /** 书内知识库文档（可检索资料/设定/参考）。 */
+  knowledgeDocs?: KnowledgeDoc[]
+  /** 自动导演待办：风险/修复「采纳」后生成的随手清单。 */
+  todos?: DirectorTodo[]
+  /** 小说简介（面向读者的作品门面，生成或手动保存）。 */
   blurb?: string
+  /** 开书定盘：书籍级承诺与流派定位（前30章承诺/主副模式/文风/平台）。 */
+  bookContract?: BookContract
   /** 封面文件名（相对输出目录，如 cover.png）。 */
   coverPath?: string
   /** 大世界结构化数据（境界体系/区域/势力）。 */
   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）。 */
@@ -1383,7 +1259,9 @@ export interface LlmVendor {
 
 /** 预置的常见厂商（id=provider 路由；添加模型下拉兜底用，其余厂商由运行时目录动态补充）。 */
 export const LLM_VENDORS: LlmVendor[] = [
-  { id: 'deepseek-official', name: 'DeepSeek', route: 'deepseek-official', apiKeyEnv: 'DEEPSEEK_API_KEY', defaultModel: 'deepseek-v4-flash', models: ['deepseek-v4-flash', 'deepseek-v4-pro', 'deepseek-chat', 'deepseek-reasoner'], builtin: true },
+  // 注意：本列表只是「运行时目录不可用」时的兜底建议值；实际以 ctx.llm.listModels() 为准
+  // （见 engine.ts listLlmVendors），避免 DSH 侧模型改名后这里的条目过期。
+  { id: 'deepseek-official', name: 'DeepSeek', route: 'deepseek-official', apiKeyEnv: 'DEEPSEEK_API_KEY', defaultModel: 'deepseek-flash', models: ['deepseek-flash', 'deepseek-v4-pro'], builtin: true },
   { id: 'zai-coding-cn', name: '智谱 GLM', route: 'zai-coding-cn', apiKeyEnv: 'ZAI_CODING_CN_API_KEY', defaultModel: 'glm-5.3-flash', models: ['glm-4.5-air', 'glm-4.7', 'glm-5-turbo', 'glm-5.1', 'glm-5.2', 'glm-5.3', 'glm-5.3-flash', 'glm-5v-turbo'] },
   { id: 'qwen-token-plan-cn', name: '千问百炼', route: 'qwen-token-plan-cn', apiKeyEnv: 'QWEN_TOKEN_PLAN_CN_API_KEY', defaultModel: 'qwen3.7-max', models: ['qwen3.6-flash', 'qwen3.6-plus', 'qwen3.7-max', 'qwen3.7-plus', 'qwen3.8-max', 'qwen3.8-max-preview'] },
   { id: 'openrouter', name: 'OpenRouter', route: 'openrouter', apiKeyEnv: 'OPENROUTER_API_KEY', defaultModel: 'z-ai/glm-5.3-flash', models: ['z-ai/glm-4.6', 'z-ai/glm-4.7', 'z-ai/glm-5', 'z-ai/glm-5-turbo', 'z-ai/glm-5.1', 'z-ai/glm-5.2', 'z-ai/glm-5.3-flash', 'auto', 'deepseek/deepseek-v4-flash', 'anthropic/claude-sonnet-4.6'] },
@@ -1434,24 +1312,6 @@ export interface RemoveProviderResponse {
   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'
@@ -1487,8 +1347,21 @@ 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
+  /** 审稿用模型（缺省用 model；建议用更强的 reasoner/pro）。 */
+  reviewModel?: string
+  /** 全书质检(审计)用模型（缺省用 model）。 */
+  auditModel?: string
+  /**
+   * 备用模型：主模型调用失败（网络/限流/额度/服务不可用）时自动切换重试一次。
+   * 留空表示不切换。批量连写时能显著减少"整批中断"。
+   */
+  fallbackModel?: string
+  /** 是否在出章后自动抽取故事时间线（失败不阻断出章）。默认开。 */
+  autoTimeline?: boolean
   /** LLM reasoning effort: off = no thinking; low/high/max = thinking intensity. */
   reasoningEffort: 'off' | 'low' | 'high' | 'max'
   /** 分析类任务（提炼/拆书/反推大纲等）的推理档位；默认 low，不受上面写作档位影响。 */
@@ -1505,16 +1378,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 = 不遮罩）。 */
@@ -1527,7 +1390,180 @@ 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 实况 / 用量
+
+/** 单次 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. */
@@ -1536,11 +1572,26 @@ 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
   /** 区间终点（含）。 */
@@ -1715,13 +1766,41 @@ export interface ChapterResponse {
 }
 
 /** 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 const EXPORT_SCOPE_VALUES: readonly ExportScope[] = ['book', 'settings', 'plan', 'characters', 'review', 'project']
+
+/** 导出范围的中文标签。 */
+export const EXPORT_SCOPE_LABELS: Record<ExportScope, string> = {
+  book: '整本正文',
+  settings: '项目设定',
+  plan: '规划（卷/章节）',
+  characters: '角色',
+  review: '质检记录',
+  project: '项目备份 JSON',
+}
+
 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. */
@@ -1730,6 +1809,13 @@ export interface ConfigPatch {
   outputDir?: string
   provider?: string
   model?: string
+  generateModel?: string
+  reviewModel?: string
+  auditModel?: string
+  /** 备用模型（主模型失败时自动切换重试一次；空串 = 关闭）。 */
+  fallbackModel?: string
+  /** 出章后自动抽取故事时间线（默认开）。 */
+  autoTimeline?: boolean
   reasoningEffort?: 'off' | 'low' | 'high' | 'max'
   analysisReasoning?: 'off' | 'low' | 'high' | 'max'
   chapterChars?: number
@@ -1738,9 +1824,6 @@ export interface ConfigPatch {
   autoReview?: boolean
   autoAuthorReview?: boolean
   autoReviewAfterRevise?: boolean
-  imageApiKey?: string
-  imageApiModel?: string
-  imageApiEnabled?: boolean
   /** 自定义背景图（URL / dataURL / 服务端路径引用）。 */
   themeBackground?: string
   /** 自定义背景遮罩/模糊强度 0-80。 */
@@ -1748,12 +1831,20 @@ 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
+}
+
 // ------------------------------------------------------------ assistant
 
 /** One assistant conversation message (persisted per project). */
@@ -1778,6 +1869,8 @@ export type AssistantFrame =
   | { type: 'tool'; name: string; status: 'start' | 'done' | 'error'; detail?: string }
   /** Live output while a tool runs (e.g. chapter text being generated). */
   | { type: 'toolDelta'; name: string; text: string }
+  /** 工具完整结果（供前端渲染成结构化卡片，如拆书/导演）。 */
+  | { type: 'toolResult'; name: string; text: string }
   | { type: 'done' }
   | { type: 'error'; message: string }
 
@@ -1790,16 +1883,22 @@ export interface AssistantHistoryResponse {
 
 /** 题材基底库：一本书属于哪个阅读市场。树形（题材→子题材→下级）。 */
 export interface GenreNode {
+  /** 稳定标识（内置库交叉引用）。 */
+  id?: string
   /** 题材名称（标签，如「仙侠修真」「都市异能」）。 */
   name: string
   /** 题材特征、常见爽点、叙事重心或读者期待。 */
   description: string
+  /** 该题材的写法指引（开书定盘/卷计划用，区别于「读者期待」）。 */
+  template?: string
   /** 子题材。 */
   children: GenreNode[]
 }
 
 /** 推进模式库：读者为什么继续看下一章。 */
 export interface ProgressionMode {
+  /** 稳定标识（与内置库交叉引用）。 */
+  key?: string
   /** 模式名称（如「升级变强」「经营扩张」「解谜揭露」）。 */
   name: string
   /** 核心驱动力：靠什么制造追读动力。 */
@@ -1812,12 +1911,34 @@ export interface ProgressionMode {
   risks: string[]
   /** 主模式或辅助模式。 */
   primary: boolean
+  /** 该模式的写法指引（开书定盘/卷计划用）。 */
+  template?: string
+  /** 推进单位序列（每章如何推进，如「立威→打破质疑→扩大影响→碾压」）。 */
+  progressionUnits?: string[]
+  /** 允许出现的冲突形态。 */
+  allowedConflictForms?: string[]
+  /** 应避免的冲突形态（跑偏信号）。 */
+  forbiddenConflictForms?: string[]
+  /** 冲突烈度上限（low/medium/high），用于卷/章计划和审稿对齐。 */
+  conflictCeiling?: 'low' | 'medium' | 'high'
+  /** 单章推进单位说明。 */
+  chapterUnit?: string
+  /** 卷末应兑现的回报。 */
+  volumeReward?: string
+  /** 主驱动必须持续出现的信号（读者期待确认）。 */
+  mandatorySignals?: string[]
+  /** 反信号：出现即跑偏。 */
+  antiSignals?: string[]
+  /** 优先用的问题解决方式。 */
+  resolutionStyle?: string
 }
 
 /** 反 AI 规则：一条「要避免的问题 + 修正方向」。 */
 export interface AntiAiRule {
   /** 规则名（如「禁止解释型心理描写」「AI 高频套话」）。 */
   name: string
+  /** 稳定标识（与 defaultAntiAiRuleKeys 交叉引用；缺省用 name）。 */
+  key?: string
   /** 要避免的表达问题，具体可检查。 */
   avoid: string
   /** 推荐修正方向。 */
@@ -1826,15 +1947,60 @@ export interface AntiAiRule {
   detectPatterns?: string[]
   /** 是否内置全局规则（内置规则随插件发布，项目规则为用户自定义）。 */
   builtin?: boolean
-  /** 规则类型：forbidden=禁止类（命中即问题）/ encourage=鼓励类（不命中不算错，只作建议）。缺省按名称「鼓励」前缀推断。 */
-  severity?: 'forbidden' | 'encourage'
+  /** 规则类别：forbidden=禁止类（命中即问题）/ risk=风险类（需注意但不硬伤）/ encourage=鼓励类（不命中不算错，只作建议）。 */
+  severity?: 'forbidden' | 'risk' | 'encourage'
+  /** 问题严重度（用于审稿优先级；缺省按类别推断）。 */
+  riskLevel?: 'low' | 'medium' | 'high'
+  /** 生成时直接注入的约束指令（缺失时回退到 avoid）。 */
+  promptInstruction?: string
+  /** 是否允许自动改写（risk 类通常 false）。 */
+  autoRewrite?: boolean
+  /** 是否为全局基线规则（新书默认启用，防止规则丢失后降级）。 */
+  globalBaselineEnabled?: boolean
   /** 是否启用（缺省 true）。 */
   enabled?: boolean
   /** 作用域（缺省 all）。 */
   scope?: Array<'writing' | 'review' | 'polish' | 'all'>
 }
 
-/** 预置写法模板（来自 AI-Novel-Writing-Assistant 内置数据，一键绑定无需样本文本）。 */
+/** 预置叙事风格模板（一键绑定无需样本文本）。 */
+export interface StyleTemplateNarrativeRules {
+  progressionMode?: string
+  sceneUnitPattern?: string[]
+  multiPov?: boolean
+  looping?: boolean
+  endingStyle?: string
+  povSwitchStyle?: string
+  summary?: string
+}
+
+export interface StyleTemplateCharacterRules {
+  allowSelfReflection?: boolean
+  emotionExpression?: string
+  defenseMechanisms?: string[]
+  facePriority?: boolean
+  dialogueStyle?: string
+  summary?: string
+}
+
+export interface StyleTemplateLanguageRules {
+  register?: string
+  roughness?: number
+  allowIncompleteSentences?: boolean
+  allowSwearing?: boolean
+  sentenceVariation?: string
+  allowUselessDetails?: boolean
+  summary?: string
+}
+
+export interface StyleTemplateRhythmRules {
+  pace?: string
+  paragraphDensity?: string
+  allowFragmentedFlow?: boolean
+  actionOverExplanation?: boolean
+  summary?: string
+}
+
 export interface StyleTemplate {
   /** 模板 key（如 power-up-escalation）。 */
   key: string
@@ -1846,18 +2012,42 @@ export interface StyleTemplate {
   category: string
   /** 适用题材。 */
   applicableGenres: string[]
-  /** 叙述规则。 */
+  /** 标签（便于筛选）。 */
+  tags?: string[]
+  /** 一句话分析（模板定位说明）。 */
+  analysisMarkdown?: string
+  /** 叙述规则（结构化）。 */
+  narrative?: StyleTemplateNarrativeRules
+  /** 角色规则（结构化）。 */
+  character?: StyleTemplateCharacterRules
+  /** 语言规则（结构化）。 */
+  language?: StyleTemplateLanguageRules
+  /** 节奏规则（结构化）。 */
+  rhythm?: StyleTemplateRhythmRules
+  /** 叙述规则（扁平，兼容旧数据）。 */
   proseRules: string[]
-  /** 角色/台词规则。 */
+  /** 角色/台词规则（扁平，兼容旧数据）。 */
   dialogueRules: string[]
-  /** 语言规则。 */
+  /** 语言规则（扁平，兼容旧数据）。 */
   languageRules: string[]
-  /** 节奏规则。 */
+  /** 节奏规则（扁平，兼容旧数据）。 */
   rhythmRules: string[]
   /** 该模板默认绑定的反 AI 规则 key（内置规则名）。 */
   defaultAntiAiRuleKeys: string[]
 }
 
+/** 起始风格画像：无样本文本也能快速绑定一套写法。 */
+export interface StarterStyleProfile {
+  /** stable key（如 starter-power-up）。 */
+  key: string
+  /** 绑定到的写法模板 key。 */
+  templateKey: string
+  /** 画像名。 */
+  name: string
+  /** 画像说明。 */
+  description: string
+}
+
 /** 剧情桥段库：可复用的情节套路/桥段（作者阅读经验沉淀，与书内 Plotline 不同层）。 */
 export interface PlotBeatTemplate {
   /** 模板 key（如 face-slap / exit-wedding）。 */
@@ -1896,6 +2086,32 @@ export interface StyleAsset {
   boundaries: string[]
   /** 来源样本文本（可空）。 */
   sourceText?: string
+  /** 仿写预设：imitate=高保真仿写 / balanced=平衡 / transfer=迁移（去指纹）。 */
+  preset?: 'imitate' | 'balanced' | 'transfer'
+  /** 指纹风险：仿写时照搬原作独特表达的风险。 */
+  fingerprintRisk?: 'low' | 'medium' | 'high'
+  /** 净化后的写作指引（可安全用于生成，去掉了会暴露来源的具体细节）。 */
+  writingGuidance?: string[]
+  /** 禁止照搬的原作特有实体（人名/地名/核心设定句式），生成时需避开。 */
+  forbiddenEntities?: string[]
+  /** 创建时间。 */
+  createdAt: string
+}
+
+/** 写作公式（从样本文本分层提取的"这套文怎么写"浓缩，供生成/改写复用）。 */
+export interface StyleFormula {
+  /** 稳定 key。 */
+  key: string
+  /** 公式名。 */
+  name: string
+  /** 提取深度：basic=骨架 / standard=完整 / deep=逐句细化。 */
+  depth: 'basic' | 'standard' | 'deep'
+  /** 重点聚焦域（如 开场/对话/节奏/爽点密度）。 */
+  focusAreas: string[]
+  /** 公式正文（Markdown）。 */
+  formula: string
+  /** 应用指引（生成/改写时如何套用）。 */
+  applyGuidance: string
   /** 创建时间。 */
   createdAt: string
 }
@@ -1912,6 +2128,8 @@ export interface ProjectAssets {
   antiAiRules: AntiAiRule[]
   /** 绑定的写法资产。 */
   styleAssets: StyleAsset[]
+  /** 写作公式（分层提取：basic/standard/deep）。 */
+  styleFormulas?: StyleFormula[]
   /** 资产更新时间。 */
   updatedAt?: string
 }
@@ -1927,6 +2145,8 @@ export interface AssetsResponse {
   styleTemplates: StyleTemplate[]
   /** 内置推进模式候选。 */
   progressionLibrary: ProgressionMode[]
+  /** 起始风格画像（无样本文本快速绑定写法）。 */
+  starterStyleProfiles: StarterStyleProfile[]
   /** 内置剧情桥段库（可复用套路）。 */
   plotBeatLibrary: PlotBeatTemplate[]
 }
@@ -1938,6 +2158,7 @@ export interface AssetsPatch {
   auxiliaryProgressions?: ProgressionMode[]
   antiAiRules?: AntiAiRule[]
   styleAssets?: StyleAsset[]
+  styleFormulas?: StyleFormula[]
 }
 
 /** POST /style-engine request：从样本文本提取写法资产。 */
@@ -2012,8 +2233,8 @@ export interface AdaptationDimension {
   current: string
   /** 该值在正文中的出现证据（章节/频次，可空）。 */
   evidence?: string
-  /** AI 建议的候选新值（可空）。 */
-  candidates?: string[]
+  /** 建议的候选新值（可空，每套含名称与一句话说明）。 */
+  candidates?: Array<{ name: string; desc?: string }>
   /** 联动影响说明（改了会影响哪些章节/角色/伏笔/术语）。 */
   impact: string
   /** 风险评级。 */
@@ -2135,7 +2356,7 @@ export interface AdaptSaveRequest {
   text: string
   /** 新书名（缺省为「改编新书」；建议用「<原著>·改编版」）。 */
   bookName?: string
-  /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+  /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
   outputDir?: string
   /** 可附带反推大纲（写进新项目，便于后续续写/编辑）。 */
   outline?: string
@@ -2161,7 +2382,7 @@ export interface AdaptMaterializeRequest {
   text: string
   /** 新书名（缺省为「<源书名>·改编版」）。 */
   bookName?: string
-  /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+  /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
   outputDir?: string
   /** 反推大纲（来自分析；缺少时用源文章题兜底）。 */
   outline?: string
@@ -2197,7 +2418,7 @@ export interface AdaptMaterializeResponse {
 export interface AdaptMaterializeSaveRequest {
   /** 新书名（缺省为「改编版」）。 */
   bookName?: string
-  /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+  /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
   outputDir?: string
   /** 改编后总纲。 */
   outline: string