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

package/lib/types/client/panel/views.d.ts

@@ -1,36 +1,15 @@
-/**
- * 纯展示组件（views）：所有状态与事件处理器都留在 NovelPanel，
- * 这里只接收 props 渲染。便于单独维护与复用。
- */
 import type { ReactElement } from 'react';
-import type { AuditIssue, Plotline, PlotlineHealthReport, PlotlinePlan, RoleRecord, RoleStatusCard } from '../../protocol.ts';
-/** 统计格：状态摘要条 / 资产健康通用。 */
-export declare function StatCell(props: {
-    label: string;
-    value: string;
-    detail: string;
-    /** 值颜色（可选）。 */
-    valueColor?: string;
-    /** 值字号覆盖（如长文本用 13）。 */
-    valueFontSize?: number;
-    /** detail 悬浮提示（可选）。 */
-    detailTitle?: string;
-}): ReactElement;
-/** 待办队列行。 */
-export declare function TodoRow(props: {
-    tone: 'danger' | 'warning' | 'info' | 'success';
-    title: string;
-    description: string;
-    actionLabel: string;
-    disabled: boolean;
-    onAction: () => void;
-}): ReactElement;
-/** 全书质检问题行。 */
-export declare function AuditIssueRow(props: {
-    issue: AuditIssue;
-    disabled: boolean;
-    onFix: () => void;
-}): ReactElement;
+import type { Plotline, PlotlineHealthReport, PlotlinePlan, RoleRecord, RoleStatusCard } from '../../protocol.ts';
+/** 滑轨胶囊导航（B5-5）：active 高亮为滑动指示块，随选中项平移。 */
+export declare function SlideNav<T extends string>(props: {
+    ariaLabel: string;
+    items: ReadonlyArray<{
+        id: T;
+        label: ReactElement | string;
+    }>;
+    active: T;
+    onSelect: (id: T) => void;
+}): JSX.Element;
 /** 剧情线卡片（列表主体）。 */
 export declare function PlotlineCard(props: {
     line: Plotline;
@@ -54,24 +33,31 @@ export declare function RoleCard(props: {
     onEdit: () => void;
     onRemove: () => void;
 }): ReactElement;
-/** 🩺 剧情健康检查报告面板。 */
+/**  剧情健康检查报告面板。 */
 export declare function PlotlineHealthPanel(props: {
     report: PlotlineHealthReport;
     disabled: boolean;
     onPlan: () => void;
     onClose: () => void;
 }): ReactElement;
-/** ✨ AI 剧情方案面板。 */
+/**  剧情方案面板。 */
 export declare function PlotlinePlanPanel(props: {
     plan: PlotlinePlan;
     disabled: boolean;
     onAdopt: (suggestion: Plotline) => void;
     onClose: () => void;
 }): ReactElement;
-/** ✨ AI 建议剧情线面板。 */
+/**  建议剧情线面板。 */
 export declare function PlotlineSuggestionPanel(props: {
     suggestions: Plotline[];
     disabled: boolean;
     onAdopt: (suggestion: Plotline) => void;
     onClose: () => void;
 }): ReactElement;
+/** 空状态基元：图标 + 标题 + 可选提示。compact 变体用于列表/卡片内嵌场景。 */
+export declare function EmptyState(props: {
+    icon?: string;
+    title: string;
+    hint?: string;
+    compact?: boolean;
+}): ReactElement;

package/lib/types/client/run-status.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 运行状态芯片：固定在页面顶部的「小说工坊生成状态」小徽标。
+ * 轮询 /run/status，实时显示 生成中/暂停/完成/停止/出错 + 当前章号；
+ * 点击可打开/关闭小说工坊面板。独立 DOM 注入，不触碰主面板逻辑，挂载失败静默降级。
+ * 显示偏好（关 / 仅生成中暂停时 / 总是）存在 localStorage，见 chip-prefs.ts：
+ * 书架页「设置 · 全局 → 外观与主题」里有对应下拉，选择即时生效（跨标签页也同步）。
+ *
+ * P0 重写说明（原实现的三个问题）：
+ *   1. 整块背景染状态色 + 固定白字 → 浅色主题下「白字配亮底」对比度崩坏。
+ *      现在改为「玻璃底 + 主题前景色文字 + 左侧状态色点」，状态只由色点承载，
+ *      文字永远跟随主题，任何深浅色下都可读。
+ *   2. 样式写死在 JS 的 inline style 里，切主题纹丝不动。
+ *      现在改用 CSS Module class，配色走 --nf-chip-* 令牌，
+ *      由 body[data-ds-dark-theme] 跟随宿主深浅色。
+ *   3. role="button" 却没有 tabindex、没有键盘处理，键盘用户完全用不了。
+ *      现在补 tabindex + Enter/Space 激活 + aria-label/live。
+ */
+import type { NovelApi } from './api.ts';
+import type { PanelController } from './panel/controller.ts';
+/** 生成一个固定顶部的状态芯片并开始轮询。返回 dispose。 */
+export declare function mountRunStatus(controller: PanelController, api: NovelApi): () => void;

package/lib/types/client/sidebar-entry.d.ts

@@ -4,8 +4,6 @@
  * sibling plugin entries and self-heals via MutationObserver.
  */
 import type { PanelController } from './panel/controller.ts';
-/** Stable data attribute identifying the injected entry row. */
-export declare const ENTRY_SELECTOR = "[data-dsh-novelforge-entry]";
 /**
  * Mount the sidebar entry, waiting for the shell and self-healing on
  * re-renders.

package/lib/types/digest-parse.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 章节「摘要 + 事实 + 时间线」合并抽取的**解析收敛层**。
+ *
+ * ## 为什么独立成文件
+ *
+ * 合并后一次 LLM 调用要parse 三个字段，最容易出错的地方不是「怎么调模型」，
+ * 而是**「模型返回畸形 JSON 时怎么收敛」**：字段缺失、类型不对、数组里混null、
+ * runaway 长文本。任何一项坏掉都不该拖垮另外两项。
+ *
+ * 这层逻辑必须能被离线验证，而 engine.ts 依赖宿主包 `@deepseek-ai/dsh-llm`
+ * （脱离 dsh 环境直接import 失败）。所以规则层放这里，保持零依赖。
+ */
+/** 把 LLM 返回的原始 facts 收敛为合法事实条目（过滤过短项、截断超长项）。 */
+export declare function parseFactLines(raw: unknown): string[];
+/** 把 LLM 返回的原始 timeline 收敛为对象数组（剔除非对象成员）。 */
+export declare function parseTimelineItems(raw: unknown): Record<string, unknown>[];
+/**
+ * timeline 单项的字段映射：缺失/错类型一律回落到安全默认，绝不产出 undefined 字段。
+ *
+ * @param item - 模型给出的原始项。
+ * @param index - 该项在数组中的下标；模型没给 `order` 时用它兜底，保证章内序号连续。
+ */
+export declare function mapTimelineItem(item: Record<string, unknown>, index: number): {
+    time: string;
+    order: number;
+    place: string;
+    characters: string[];
+    event: string;
+};

package/lib/types/docx-core.d.ts

@@ -0,0 +1,16 @@
+/**
+ * docx 文本提取共享核心：服务端（src/docx.ts）与浏览器端（src/client/docx.ts）
+ * 共用 XML → 纯文本的解析逻辑，避免两份实现漂移。
+ * zip 解压入口因运行时不同（fflate vs fflate/browser，浏览器端必须走 browser
+ * 入口以避开 node:module 的 require 探测）留在两端各自处理。
+ */
+/** 解码 docx 正文实际会用到的少量 XML 实体。 */
+export declare function decodeEntities(text: string): string;
+/**
+ * 从 word/document.xml 的 XML 字符串提取纯文本：每个 <w:p> 段落一行，
+ * <w:tab>/<w:br> 保留为空白符；表格与嵌套结构按文档顺序拍平
+ * （它们的段落同样是 <w:p>）。
+ * @param xml - document.xml 解码后的字符串。
+ * @returns 正文文本（空文本时抛错）。
+ */
+export declare function extractDocxTextFromXml(xml: string): string;

package/lib/types/docx.d.ts

@@ -2,11 +2,10 @@
  * docx outline extraction: a .docx is a zip whose word/document.xml holds the
  * body text in <w:t> runs inside <w:p> paragraphs. We unzip with fflate and
  * walk the XML with a tiny tokenizer — no heavyweight XML/DOM dependency.
+ * XML 解析共享核心在 ./docx-core.ts（与浏览器端同源）。
  */
 /**
- * Extract plain text from a docx buffer: one line per <w:p> paragraph, with
- * <w:tab>/<w:br> preserved as whitespace. Tables and nested structures are
- * flattened in document order (their paragraphs are just <w:p> too).
+ * Extract plain text from a docx buffer: one line per <w:p> paragraph.
  * @param buffer - the raw .docx bytes.
  * @returns the body text.
  */

package/lib/types/engine.d.ts

@@ -12,7 +12,9 @@
  */
 export declare const COMPLIANCE_REDLINES: ReadonlyArray<string>;
 import type { Context } from '@deepseek-ai/cordis';
-import type { AdaptationDimension, AdaptAnalyzeResponse, AdaptationMapping, AdaptationRules, AdaptProposeResponse, AuditIssue, AuthorReview, BreakdownResponse, ChapterPlan, Foreshadow, NovelConfig, OutlineCandidate, Plotline, PlotlineHealthReport, PlotlinePlan, ProjectState, ReviewReport, RoleRecord, RoleStatusCard, SceneCard, StoryBible, StoryboardSkeleton, StoryboardTable, StoryboardPrompt, AddModelRequest, AddModelResponse, LlmModelsResponse, LlmVendorsResponse, LlmProvidersResponse, RemoveProviderRequest, RemoveProviderResponse, LlmTestResponse, MangaRoleCandidate, Prop, Volume, WorldState, AdaptMaterializeRequest, AdaptMaterializeResponse, AdaptMaterializeSaveRequest, AdaptMaterializeSaveResponse, MarketRadarRequest, MarketRadarResult, MarketRadarSignal, MarketRadarBriefRequest, ProductionFoundation, MarketCreativeBrief, BookAnalysisRequest, BookAnalysisResult, IdeaInspirationRequest, IdeaInspirationResult, DirectorRequest, DirectorAdvice } from './protocol.ts';
+import { fullTextBudget } from './model-capability.ts';
+import { applyModelCapability } from './model-request.ts';
+import type { AdaptationDimension, AdaptAnalyzeResponse, AdaptationMapping, AdaptationRules, AdaptProposeResponse, AuditIssue, AuthorReview, ExportScope, TimelineEvent, TimelineIssue, BreakdownResponse, ChapterPlan, Foreshadow, NovelConfig, OutlineCandidate, Plotline, PlotlineHealthReport, PlotlinePlan, ProjectState, ReviewReport, RoleRecord, RoleStatusCard, StoryBible, AddModelRequest, AddModelResponse, LlmModelsResponse, LlmVendorsResponse, LlmProvidersResponse, RemoveProviderRequest, RemoveProviderResponse, LlmTestResponse, Volume, WorldState, AdaptMaterializeRequest, AdaptMaterializeResponse, AdaptMaterializeSaveRequest, AdaptMaterializeSaveResponse, MarketRadarRequest, MarketRadarResult, MarketRadarSignal, MarketRadarBriefRequest, ProductionFoundation, MarketCreativeBrief, BookAnalysisRequest, BookAnalysisResult, IdeaInspirationRequest, IdeaInspirationResult, DirectorRequest, DirectorAdvice } from './protocol.ts';
 /** Project state file name inside the output dir. */
 export declare const PROJECT_FILE = "novel-project.json";
 /** Chapter output file name, e.g. 第001章_开篇.md */
@@ -44,6 +46,20 @@ export declare function syncProjectWithDisk(project: ProjectState, outputDir: st
 export declare function readChapterFile(outputDir: string, chapter: ChapterPlan): string | undefined;
 /** Create a fresh project from an outline. */
 export declare function createProject(outline: string, outlinePath?: string): ProjectState;
+/**
+ * 把已经拼好的请求过一遍模型参数能力层。
+ *
+ * **凡是自己构造 `GenerateOptions`、不走 {@link complete} 的调用点都必须经过它**，
+ * 否则那条路径会绕过厂商参数约束（固定温度、不支持的 reasoning 等），对 Kimi
+ * 这类模型直接报参数错误 —— 而"测试连通"恰恰是用户用来判断配置对不对的地方。
+ *
+ * 抽成函数而不是在每个调用点内联：流式调用点有 5 处，还要各自处理备用模型切换，
+ * 内联五遍就是同一件事写五份，必然漂移。
+ *
+ * 实现已挪到 {@link ./model-request.ts}（需要 dsh-llm 的运行时值），这里只做转出，
+ * 以保持 engine 内部与既有调用点的写法不变。
+ */
+export { applyModelCapability, fullTextBudget };
 /** Extract the story bible from an outline. */
 export declare function extractBible(ctx: Context, config: NovelConfig, outline: string, project?: ProjectState): Promise<StoryBible>;
 /** Plan volumes from an outline. */
@@ -63,15 +79,39 @@ export declare function reviewChapterText(ctx: Context, config: NovelConfig, pro
 export declare function authorReviewChapter(ctx: Context, config: NovelConfig, project: ProjectState, chapterNo: number, body: string, prevTail: string): Promise<AuthorReview>;
 /** 复盘后自动关联：把本章号写入复盘标记推进的剧情线（按名称匹配，去重）。 */
 export declare function autoLinkPlotlines(project: ProjectState, chapterNo: number, advancedLines: string[]): void;
-/** AI 建议剧情线：基于大纲/卷计划/已写章节/编年录，提炼候选线。 */
+/** 建议剧情线：基于大纲/卷计划/已写章节/编年录，提炼候选线。 */
 export declare function suggestPlotlines(ctx: Context, config: NovelConfig, project: ProjectState): Promise<Plotline[]>;
-/** AI 刷新单条剧情线的进度：结合编年录与各章摘要分析该线推进到哪。 */
+/**
+ * 刷新剧情线进度：结合编年录与各章摘要分析该线推进到哪。
+ *
+ * 支持一次刷新多条：`lines` 传入多条时，只发**一次**请求。
+ *
+ * ## 为什么要合并
+ *
+ * 原实现一次只能刷一条，于是作者有 8 条线就得点 8 次、跑 8 次 LLM——
+ * 而这 8 次请求的**输入前缀完全相同**（同样的最近 8 章摘要 + 15 条编年录）。
+ * 也就是说同一份上下文被重复发送了 8 遍。真实项目（151 章 / 8 条线 / 300 条事实）
+ * 实测：合并后每条线的输入从 ~1900 tok 降到 ~700 tok，且**延迟从 8 次串行
+ * 降到 1 次**。
+ *
+ * 另外，单条刷新时只带 8 章摘要——多线合并后仍只带 8 章（摘要本身就是截断的），
+ * 但一次就能看出「哪条线卡住了、哪条线其实早就推进完了」，交叉参照更准。
+ *
+ * @param lines - 要刷新的线；省略则取全部 active/paused 线。
+ * @returns 实际写入进度的线 id 列表（失败的线不在其中）。
+ */
 export declare function refreshPlotlineProgress(ctx: Context, config: NovelConfig, project: ProjectState, line: Plotline): Promise<string>;
-/** ✨ AI 从全书提炼角色库：大纲 + 道藏 + 编年录 + 章节摘要 → 结构化角色清单。 */
+export declare function refreshPlotlineProgress(ctx: Context, config: NovelConfig, project: ProjectState, lines: Plotline[]): Promise<string[]>;
+export type RefreshResult = {
+    id: string;
+    name: string;
+    text: string;
+};
+/** 实际的批量刷新实现（被上面的重载收敛到一处）。 */
+export declare function refreshLinesFor(ctx: Context, config: NovelConfig, project: ProjectState, lines: Plotline[]): Promise<RefreshResult[]>;
+/**  AI 从全书提炼角色库：大纲 + 道藏 + 编年录 + 章节摘要 → 结构化角色清单。 */
 export declare function extractRoles(ctx: Context, config: NovelConfig, project: ProjectState): Promise<RoleRecord[]>;
-/** ✨ AI 从全书提炼场景库：正文/编年录 → 高频重要场景的结构化视觉锚点。 */
-export declare function extractScenes(ctx: Context, config: NovelConfig, project: ProjectState, chapterNo?: number, styleId?: string, filterId?: string): Promise<SceneCard[]>;
-/** 从 txt/md 全本文本拆章（纯逻辑，不落盘）：识别章节头、剥离重复标题、去重、排序并统一重新编号。 */
+/**  AI 从全书提炼场景库：正文/编年录 → 高频重要场景的结构化视觉锚点。 */
 export declare function splitBookText(raw: string): Array<{
     no: number;
     title: string;
@@ -98,43 +138,10 @@ export declare function importBookText(filePath: string, outputDir: string): {
     chapters: number;
     skipped: string[];
 };
-/** 动漫形象描述词（中文描述 + 英文 booru 标签 + 关键外貌标签）。 */
-export interface RoleVisualPrompt {
-    zh: string;
-    en: string;
-    tags: string[];
-    source: string;
-    /** 即梦/生图通用负面提示词。 */
-    negativePrompt?: string;
-    /** 该角色所需情绪表情清单（6-12 个，如 疲惫/麻木/压抑悲伤）。 */
-    expressions?: string[];
-    /** 四类精修提示词（立绘/四视图/表情/细节，一次提炼直接产出）。 */
-    promptKit?: RoleRecord['promptKit'];
-}
-/** 小说角色库：提炼单个角色的形象锚点并写回角色卡。 */
-export declare function extractRoleVisual(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, roleName: string, styleId?: string, filterId?: string): Promise<RoleVisualPrompt>;
-/** 漫剧角色卡：提炼形象锚点并写回漫剧卡（status → anchored）。 */
-export declare function extractMangaRoleVisual(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, cardId: string, styleId?: string, filterId?: string): Promise<RoleVisualPrompt>;
-/** 小说角色库：角色四类生图提示词精修包（写回角色卡）。 */
-export declare function generateRolePromptKit(ctx: Context, config: NovelConfig, project: ProjectState, roleName: string, styleId?: string, filterId?: string): Promise<RoleRecord['promptKit']>;
-/** 漫剧角色卡：四类生图提示词精修包（写回漫剧卡，status → anchored）。 */
-export declare function generateMangaRolePromptKit(ctx: Context, config: NovelConfig, project: ProjectState, cardId: string, styleId?: string, filterId?: string): Promise<RoleRecord['promptKit']>;
-/**
- * 漫剧角色库·提名（两段式）：从某章分镜的 characters 提名候选角色名 →
- * 规则过滤（精确名 + 身份/简称匹配，短名单 ≤5）→ LLM 确认（是/否 + 选哪个，不做开放检索）→
- * 返回带漫剧卡建议的候选（未匹配时给出「回小说库补提炼 / 漫剧直接创建」判定）。
- */
-export declare function nominateMangaRoles(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<MangaRoleCandidate[]>;
-/** ✨ 从道藏/红线提炼「视觉世界观规则」：生图/生视频必须遵守的设定纠偏（如"商品=人，禁止常规超市商品"）。 */
-export declare function extractVisualRules(ctx: Context, config: NovelConfig, project: ProjectState): Promise<string[]>;
-/**
- * 开书想法 → AI 大纲：输入一句话想法，生成 2-3 个方向不同、可直接开书的完整大纲方案。
- * @param count 本次生成几个（默认 3，最多 3）
- * @param exclude 已暂留方案的剧情方向/卖点摘要（换批时避开，防止重复）
- */
+/** 保证风格词块已内嵌（LLM 偶发漏嵌时兜底）：zh 段首前缀，en 末尾追加。 */
 export declare function suggestOutlines(ctx: Context, config: NovelConfig, idea: string, count?: number, exclude?: string[]): Promise<OutlineCandidate[]>;
 /** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检。
- *  两阶段管道（借鉴 AI-Novel-Writing-Assistant）：
+ *  两阶段管道（先抽取候选、再落库）：
  *  ① 源片段笔记：每章抽取结构化笔记（剧情/人物/设定/写法/卖点/短板信号）
  *  ② 分节分析：按维度各跑一次 LLM，输出可读分析稿 + 结构化数据 + 证据链。
  *  @param scope 'recent'(默认最近20章) | 'volume:N' | 'all'
@@ -157,14 +164,9 @@ export declare function removeLlmProvider(ctx: Context, req: RemoveProviderReque
  * 写入 DSH 凭据 refs，并（必要时）注册/更新 llm-pi-ai provider 路由。
  */
 export declare function registerLlmModel(ctx: Context, req: AddModelRequest): Promise<AddModelResponse>;
-/** 获取当前激活漫剧方案的风格（styleId + filterId），用于生图/提示词兜底。 */
-export declare function getActiveMangaStyle(project: ProjectState): {
-    styleId?: string;
-    filterId?: string;
-};
-/** 🩺 剧情健康检查：基于已写章节数/各线状态/编年录，判断是否需要新线及添加时机。 */
+/**  剧情健康检查：基于已写章节数/各线状态/编年录，判断是否需要新线及添加时机。 */
 export declare function analyzePlotlineHealth(ctx: Context, config: NovelConfig, project: ProjectState): Promise<PlotlineHealthReport>;
-/** ✨ AI 剧情方案：基于健康检查结果设计下一阶段方向与建议新线。 */
+/**  剧情方案：基于健康检查结果设计下一阶段方向与建议新线。 */
 export declare function designPlotlinePlan(ctx: Context, config: NovelConfig, project: ProjectState, health?: PlotlineHealthReport): Promise<PlotlinePlan>;
 /**
  * Stream a chapter rewrite. With `target` (a passage of the body), only that
@@ -194,6 +196,8 @@ export declare function polishChapterStream(ctx: Context, config: NovelConfig, p
     chars: number;
     draft: string;
 }, void, unknown>;
+/** 统计中文字符数（汉字），与「每章字数」红线口径一致（不含标点/换行）。 */
+export declare function countHanzi(text: string): number;
 /** Generate one chapter (streaming). Yields progress frames; persists when done. */
 export declare function generateChapterStream(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): AsyncGenerator<{
     frame: 'start';
@@ -208,27 +212,6 @@ export declare function generateChapterStream(ctx: Context, config: NovelConfig,
 }, void, unknown>;
 /** Generate a chapter summary (narrative memory). */
 export declare function summarizeChapter(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<string>;
-/**
- * 分镜·导演级：剧情骨架 → 分镜表（镜头级）。
- * 只做画面层：景别/机位运镜/时长/画面/台词/音效/光效 + 状态连续；禁止改剧情（骨架只读）。
- */
-export declare function generateStoryboardTable(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number, skeleton: StoryboardSkeleton, styleId?: string, filterId?: string): Promise<StoryboardTable>;
-/**
- * 提炼常驻道具（跨镜头需一致）：从已写章节正文识别反复出现的关键道具 + 一行统一外观描述。
- * 生成分镜提示词前自动调用，若道具库为空则补齐；道具库存 project.props，注入提示词保持跨镜头一致。
- */
-export declare function extractProps(ctx: Context, config: NovelConfig, project: ProjectState): Promise<Prop[]>;
-/**
- * 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。
- * 每镜头一段：风格词块（基底+滤镜）+ 画面内容（角色动作/服装标志物）+ 机位运镜 + 光效。
- * 提示词聚焦画面与镜头（视频模型无音频，台词/音效不注入）。
- */
-export declare function generateStoryboardPrompts(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number, table: StoryboardTable, styleId?: string, filterId?: string): Promise<StoryboardPrompt[]>;
-/**
- * 分镜·编剧级：单章 → 剧情骨架（节拍链）。
- * 只做故事层（事件/情绪/功能/因果），不做画面；导演级分镜在其上展开。
- */
-export declare function generateStoryboardSkeleton(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<StoryboardSkeleton>;
 /**
  * 反向推大纲：从已写章节正文反推出全书总纲（分卷 + 章节要点 + 主线/人物弧线/伏笔清单）。
  * 两阶段：分批提取章节事件摘要 → 汇总生成大纲。不修改章节/设定，只返回大纲文本。
@@ -241,7 +224,7 @@ export declare function reverseOutlineFromChapters(ctx: Context, config: NovelCo
  */
 export declare function analyzeAdaptation(ctx: Context, config: NovelConfig, text: string): Promise<AdaptAnalyzeResponse>;
 /** 改编方案：由用户勾选的维度与新值，生成 LLM 映射表/规则/影响清单。 */
-export declare function proposeAdaptation(ctx: Context, config: NovelConfig, text: string, selections: Array<{
+export declare function proposeAdaptation(ctx: Context, config: NovelConfig, _text: string, selections: Array<{
     key: string;
     title: string;
     current: string;
@@ -298,6 +281,36 @@ export declare function summarizeAndExtractFacts(ctx: Context, config: NovelConf
     summary: string;
     factCount: number;
 }>;
+/**
+ * 摘要 + 事实 + 时间线：**一次** LLM 调用出全部三样。
+ *
+ * ## 为什么合并（实测收益）
+ *
+ * 三样东西的输入是**同一份章节正文**。分开调用等于把整章正文完整送两遍——
+ * 而正文恰恰是这三步里最大的 token 项。用真实项目（120 章，每章 3700-8700 字符）
+ * 实测：合并前平均每章输入 6742 tok，合并后 3726 tok，**省 44.7%**。
+ * 整本书一次生成约省 36 万输入 token。
+ *
+ * 之所以以前没合：三者的产出结构不同（对象 / 数组 / 数组），且时间线单独走
+ * `auditModel`。现在统一成一个 JSON 对象，模型差异交由调用方按需传入。
+ *
+ * ## 失败语义（重要）
+ *
+ * 合并后**一次失败三项全丢**，而分开时摘要失败不影响时间线。故本函数对
+ * 每个字段独立解析、缺失即为空，绝不因为一项坏掉就丢弃另两项好的。
+ * 调用方若对时间线有强需求，仍可调原有的 {@link extractTimelineForChapter} 单独补。
+ *
+ * @returns 摘要、实际入库的事实条数、写入的时间线事件数。
+ */
+export declare function summarizeFactsAndTimeline(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number, options?: {
+    model?: string;
+    maxTokens?: number;
+    timeline?: boolean;
+}): Promise<{
+    summary: string;
+    factCount: number;
+    timelineCount: number;
+}>;
 /**
  * 伏笔落地标记：检查刚生成的章节正文是否埋下了 planned 伏笔（关键词匹配），
  * 命中则将该伏笔标记为 planted 并记录 plantedChapter——保证暗线管理页与正文同步。
@@ -312,7 +325,7 @@ export declare function markForeshadowPlanted(project: ProjectState, outputDir:
 export declare function extractFacts(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<number>;
 /** 全书一致性质检：LLM 分批扫描已生成章节 + 设定 + 事实库，聚合矛盾清单。 */
 export declare function auditBook(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, onProgress?: (completedBatches: number, totalBatches: number) => void): Promise<AuditIssue[]>;
-/** 小说简介：AI 生成或按已写开头补全（面向读者的作品门面）。 */
+/** 小说简介：生成或按已写开头补全（面向读者的作品门面）。 */
 export declare function generateBlurb(ctx: Context, config: NovelConfig, project: ProjectState, partial?: string): Promise<string>;
 /**
  * 组装全书上下文包（AI 助手 book_overview 工具）。
@@ -338,7 +351,7 @@ export interface ImpactItem {
 export declare function analyzeImpact(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, change: string): Promise<ImpactItem[]>;
 /** 把大世界结构化数据渲染成提示词块（境界体系按顺序强约束）。 */
 export declare function renderWorld(world: WorldState | undefined): string;
-/** AI 提炼大世界：从大纲 + 道藏生成结构化境界体系/区域/势力。 */
+/** 提炼大世界：从大纲 + 道藏生成结构化境界体系/区域/势力。 */
 export declare function extractWorld(ctx: Context, config: NovelConfig, project: ProjectState): Promise<WorldState>;
 /**
  * 事实库回填：对历史已生成章节批量抽取事实（无事实记录的旧章节）。
@@ -390,41 +403,47 @@ export declare function runMarketIdeaInspiration(ctx: Context, config: NovelConf
 }): Promise<IdeaInspirationResult>;
 /** 自动导演编排建议：基于全书上下文，给出下一卷/阶段编排 + 修复再平衡。 */
 export declare function runDirectorAdvice(ctx: Context, config: NovelConfig, project: ProjectState, req: DirectorRequest): Promise<DirectorAdvice>;
+/**
+ * 从一章正文抽取时间线事件（时间点 / 地点 / 参与角色 / 事件）。
+ *
+ * 会**替换**该章已有事件（重复抽取幂等）；抽取结果按 order 递增排序后写回项目。
+ * 失败时抛错，由调用方决定是否降级（自动流程用 try/catch 包住，不阻断出章）。
+ *
+ * @param ctx 宿主上下文。
+ * @param config 运行时配置。
+ * @param project 项目状态（就地更新 `project.timeline`）。
+ * @param outputDir 书目录。
+ * @param chapterNo 章节号。
+ * @returns 本次抽取到的事件（已写入 project）。
+ */
+export declare function extractTimelineForChapter(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<TimelineEvent[]>;
+/**
+ * AI 复核时间线：在规则初筛之外，让模型找规则抓不到的时序问题
+ * （年龄/季节错位、回忆与当前时间混淆、跨章跨度不合理等）。
+ *
+ * @param ctx 宿主上下文。
+ * @param config 运行时配置。
+ * @param project 项目状态。
+ * @returns 模型给出的问题清单（与规则初筛结果合并由调用方决定）。
+ */
+export declare function reviewTimeline(ctx: Context, config: NovelConfig, project: ProjectState): Promise<TimelineIssue[]>;
 /** Export the whole book as one txt/md file. */
 export declare function exportBook(outputDir: string, project: ProjectState, format: 'txt' | 'md'): {
     file: string;
     chars: number;
     chapters: number;
 };
-/** 漫剧资产库根目录：outputDir/manga-assets */
-export declare function mangaAssetsDir(outputDir: string): string;
-/** 保存角色定妆图到资产库：manga-assets/角色/角色名/标签.png */
-export declare function saveMangaRoleImage(outputDir: string, roleName: string, label: string, dataUrl: string): string;
-/** 保存角色提示词到资产库：manga-assets/角色/角色名/提示词.txt */
-export declare function saveMangaRolePrompt(outputDir: string, roleName: string, zh: string, en: string, negative?: string): string;
-/** 保存场景底图到资产库：manga-assets/场景/场景名.png */
-export declare function saveMangaSceneImage(outputDir: string, sceneName: string, label: string, dataUrl: string): string;
-/** 保存分镜即梦脚本到资产库：manga-assets/分镜脚本/第N章-标题.md */
-export declare function saveMangaStoryboardScript(outputDir: string, chapterNo: number, title: string, markdown: string): string;
-/** 保存「即梦素材包」到资产库：manga-assets/素材包/第N章-标题·即梦素材包.md */
-export declare function saveMangaAssetPackage(outputDir: string, chapterNo: number, title: string, markdown: string): string;
-/** 保存场景中文生图提示词到资产库：manga-assets/场景/场景名/提示词.txt */
-export declare function saveMangaScenePrompt(outputDir: string, sceneName: string, zh: string, negative?: string): string;
-/** 保存逐镜即梦提示词到资产库：manga-assets/分镜脚本/第N章-标题-提示词.md */
-export declare function saveMangaChapterPrompts(outputDir: string, chapterNo: number, title: string, markdown: string): string;
-export interface AutoGenerateResult {
-    chapterNo: number;
-    skeletonBeats: number;
-    shotCount: number;
-    promptCount: number;
-    importedRoles: number;
-    needMakeupRoles: number;
-    extraRoles: number;
-    pendingCandidates: number;
-    pendingRoleNames: string[];
-}
 /**
- * 一键生成：骨架 → 分镜表 → 角色提名 → 自动导入（匹配成功的）→ 自动分级 → 视频提示词。
- * 匹配模糊/小说库缺失的角色保留在候选列表，不自动导入。
+ * 按范围导出：整本正文 / 设定 / 规划 / 角色 / 质检记录 / 项目 JSON。
+ *
+ * @param outputDir 书目录。
+ * @param project 项目状态。
+ * @param scope 导出范围。
+ * @param format txt / md / json（json 只对 `project` 范围有独立含义，其余按 md 落盘）。
+ * @returns 文件名、字符数与章节数。
  */
-export declare function autoGenerateMangaChapter(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number, styleId?: string, filterId?: string): Promise<AutoGenerateResult>;
+export declare function exportScope(outputDir: string, project: ProjectState, scope: ExportScope, format: 'txt' | 'md' | 'json'): {
+    file: string;
+    chars: number;
+    chapters: number;
+};

package/lib/types/home.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Absolute Harness home for this process.
+ * @returns the normalized home directory.
+ */
+export declare function dshHome(): string;
+/**
+ * Join path segments onto the Harness home.
+ * @param segments - path segments appended to the home.
+ * @returns the normalized absolute joined path.
+ */
+export declare function dshHomePath(...segments: string[]): string;

package/lib/types/index.d.ts

@@ -8,15 +8,21 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from 'schemastery';
-import type { ImageModelConfig, NovelConfig } from './protocol.ts';
+import type { NovelConfig } from './protocol.ts';
 /** Stable cordis plugin name. */
 export declare const name = "novel-forge";
 /** Services required before the novel-forge surfaces can mount. */
 export declare const inject: string[];
 /**
  * Settings namespace of the novel-forge capability — the section the web
- * settings surface edits. Spelled here rather than imported: the browser half
- * spells the same value and must not depend on a Host package.
+ * settings surface edits.
+ *
+ * Legacy fallback only: from Harness 0.2 the Loader derives the section from this
+ * plugin's exported `Config`, and addresses it by the **entry id** it assigned in
+ * the active profile. That id is not guaranteed to be this name (bundle rows may
+ * be given a generated id), so the live id is read from the context instead —
+ * see {@link novelSettingsNamespace}. The constant stays for the browser half and
+ * for installations whose entry id really is this spelling.
  */
 export declare const NOVEL_SETTINGS_NAMESPACE: "dsh-novel-forge";
 /** Plugin config, validated by the same-named schemastery schema. */
@@ -37,8 +43,12 @@ export interface Config {
     generateModel?: string;
     /** 任务级模型路由：审稿模型（留空则跟随 model）。 */
     reviewModel?: string;
-    /** 任务级模型路由：AI 复核/质检模型（留空则跟随 model）。 */
+    /** 任务级模型路由：质检模型（留空则跟随 model）。 */
     auditModel?: string;
+    /** 备用模型：主模型失败时自动切换重试一次（留空 = 不切换）。 */
+    fallbackModel?: string;
+    /** 出章后自动抽取故事时间线（默认开）。 */
+    autoTimeline?: boolean;
     /** LLM reasoning effort (off/low/high/max). */
     reasoningEffort?: 'off' | 'low' | 'high' | 'max';
     /** 分析类任务（提炼/拆书/反推大纲等）的推理档位；默认 low。 */
@@ -55,14 +65,6 @@ export interface Config {
     autoAuthorReview?: boolean;
     /** 修订/润色产出草稿后自动附带一次 AI 审查（默认开，可在设置页关闭省 token）。 */
     autoReviewAfterRevise?: boolean;
-    /** 生图模型库（多套并存，启用一条生效）。 */
-    imageModels?: ImageModelConfig[];
-    /** 豆包/Seedream 生图 API Key（旧字段，兼容迁移用）。 */
-    imageApiKey?: string;
-    /** 豆包/Seedream 生图模型 ID（旧字段，兼容迁移用）。 */
-    imageApiModel?: string;
-    /** 是否启用豆包生图（旧字段，兼容迁移用）。 */
-    imageApiEnabled?: boolean;
     /** 自定义背景图（URL / dataURL / 服务端路径引用）。 */
     themeBackground?: string;
     /** 自定义背景遮罩/模糊强度 0-80。 */
@@ -72,9 +74,15 @@ export interface Config {
     /** 是否启用改编模式（默认关闭）。 */
     enableAdaptMode?: boolean;
 }
+/**
+ * Plugin config schema.
+ *
+ * Every field is live-editable (see {@link live}): the plugin re-reads the
+ * settings section on every request, so a change must apply without remounting.
+ */
 export declare const Config: z<Config>;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-export declare const NOVEL_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-novel-forge \u63D2\u4EF6\uFF08AI \u7F16\u8BD1\u5C0F\u8BF4\u5DE5\u4F5C\u53F0\uFF09\uFF1A\u4FA7\u8FB9\u680F\u300C\u5C0F\u8BF4\u5DE5\u574A\u300D\u5165\u53E3\u3002\u80FD\u529B\uFF1A\u8BFB\u53D6 docx \u5927\u7EB2\u6216\u7C98\u8D34\u5927\u7EB2\u6587\u672C\uFF1B\u7528 LLM \u63D0\u70BC\u9053\u85CF\uFF08\u4EBA\u8BBE/\u4E16\u754C\u89C2/\u91D1\u624B\u6307\u89C4\u5219/\u5199\u4F5C\u7EA2\u7EBF\uFF09\uFF1B\u751F\u6210\u5377\u8BA1\u5212\u4E0E\u7AE0\u8282\u8BA1\u5212\uFF1B\u9010\u7AE0\u8C03\u7528 LLM \u751F\u6210 3000-4000 \u5B57\u6B63\u6587\u5E76\u4FDD\u5B58\u4E3A Markdown\uFF08\u9ED8\u8BA4\u8F93\u51FA\u5230\u7528\u6237\u4E3B\u76EE\u5F55 ~/.dsh/novels\uFF09\uFF1B\u6BCF\u7AE0\u81EA\u52A8\u751F\u6210\u6458\u8981\uFF08\u53D9\u4E8B\u8BB0\u5FC6\uFF09\u3001\u81EA\u52A8 AI \u5BA1\u7A3F\uFF08\u4EBA\u8BBE/\u8BBE\u5B9A/\u7EA2\u7EBF/\u6587\u7B14/\u723D\u70B9/\u903B\u8F91\uFF09\uFF0C\u652F\u6301\u6309\u5BA1\u7A3F\u610F\u89C1\u91CD\u5199\u3001\u53BB AI \u5473\u6DA6\u8272\u3001\u6697\u7EBF\uFF08\u4F0F\u7B14\uFF09\u7BA1\u7406\u3001\u6279\u91CF\u8FDE\u5199\u4E0E\u5168\u672C\u5BFC\u51FA\uFF08txt/md\uFF09\u3002\u9650\u5236\uFF1A\u751F\u6210\u6D88\u8017 LLM API \u989D\u5EA6\uFF1B\u8F93\u51FA\u76EE\u5F55\u4E0E\u6A21\u578B\u53EF\u5728\u63D2\u4EF6\u8BBE\u7F6E\u4E2D\u4FEE\u6539\uFF1B\u7AE0\u8282\u6B63\u6587\u8D28\u91CF\u53D6\u51B3\u4E8E\u5927\u7EB2\u5B8C\u6574\u5EA6\u3002\u7528\u6237\u63D0\u5230\u300C\u5C0F\u8BF4 / \u5927\u7EB2 / \u5199\u5C0F\u8BF4 / \u7AE0\u8282 / \u5BA1\u7A3F / \u6DA6\u8272\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
+export declare const NOVEL_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-novel-forge \u63D2\u4EF6\uFF08AI \u7F16\u8BD1\u5C0F\u8BF4\u5DE5\u4F5C\u53F0\uFF09\uFF1A\u4FA7\u8FB9\u680F\u300C\u5C0F\u8BF4\u5DE5\u574A\u300D\u5165\u53E3\u3002\u80FD\u529B\uFF1A\u8BFB\u53D6 docx \u5927\u7EB2\u3001\u7C98\u8D34\u5927\u7EB2\u6587\u672C\u6216\u628A txt \u5168\u672C\u62C6\u7AE0\u5BFC\u5165\uFF1B\u7528 LLM \u63D0\u70BC\u9053\u85CF\uFF08\u4EBA\u8BBE/\u4E16\u754C\u89C2/\u91D1\u624B\u6307\u89C4\u5219/\u5199\u4F5C\u7EA2\u7EBF\uFF09\u4E0E\u5927\u4E16\u754C\uFF08\u5883\u754C/\u533A\u57DF/\u52BF\u529B\uFF09\uFF1B\u751F\u6210\u5377\u8BA1\u5212\u4E0E\u7ED3\u6784\u5316\u7AE0\u8282\u8BA1\u5212\uFF08\u672C\u7AE0\u76EE\u6807/\u5267\u60C5\u8981\u70B9/\u5FC5\u8FBE\u9879/\u4E49\u52A1\u5408\u7EA6/\u7AE0\u672B\u94A9\u5B50\uFF09\uFF1B\u9010\u7AE0\u751F\u6210 3000-4000 \u5B57\u6B63\u6587\u5E76\u4FDD\u5B58\u4E3A Markdown\uFF08\u9ED8\u8BA4\u8F93\u51FA\u5230\u63D2\u4EF6\u8BBE\u7F6E\u91CC\u300C\u8F93\u51FA\u76EE\u5F55\u300D\u6307\u5B9A\u7684\u4F4D\u7F6E\uFF0C\u672A\u914D\u7F6E\u65F6\u843D\u5230 Harness \u6570\u636E\u76EE\u5F55\u4E0B\u7684 novels/\u4E66\u540D\uFF09\uFF1B\u6BCF\u7AE0\u81EA\u52A8\u751F\u6210\u6458\u8981\u4E0E\u7F16\u5E74\u5F55\u4E8B\u5B9E\u3001\u62BD\u53D6\u6545\u4E8B\u65F6\u95F4\u7EBF\uFF08\u6545\u4E8B\u5185\u65F6\u95F4/\u5730\u70B9/\u5728\u573A\u89D2\u8272/\u4E8B\u4EF6\uFF09\u3001\u81EA\u52A8 AI \u5BA1\u7A3F\uFF08\u4EBA\u8BBE/\u8BBE\u5B9A/\u7EA2\u7EBF/\u6587\u7B14/\u723D\u70B9/\u903B\u8F91/\u53CD AI/\u5448\u73B0/\u5408\u89C4\u4E5D\u7EF4\uFF09\u4E0E\u4F5C\u8005\u590D\u76D8\uFF1B\u652F\u6301\u6309\u5BA1\u7A3F\u610F\u89C1\u5408\u5E76\u4FEE\u8BA2\uFF08\u5BA1\u7A3F high + \u65F6\u95F4\u7EBF\u77DB\u76FE + \u5F20\u529B\u504F\u5DEE\u5408\u6210\u4E00\u8F6E\uFF0C\u6BCF\u7AE0\u6700\u591A\u4E24\u8F6E\u540E\u8F6C\u4EBA\u5DE5\uFF09\u3001\u53BB AI \u5473\u6DA6\u8272\u3001\u7AE0\u8282\u5386\u53F2\u7248\u672C\u56DE\u6EDA\u3001\u6697\u7EBF\uFF08\u4F0F\u7B14\uFF09\u7BA1\u7406\u3001\u5267\u60C5\u7EBF\u4E0E\u89D2\u8272\u5E93\u3001\u5F20\u529B\u66F2\u7EBF\u3001\u5168\u4E66\u4E00\u81F4\u6027\u8D28\u68C0\u4E0E\u654F\u611F\u8BCD\u626B\u63CF\u3001\u5206\u8303\u56F4\u5BFC\u51FA\u4E0E\u9879\u76EE\u5907\u4EFD\u3001\u6279\u91CF\u8FDE\u5199\uFF08\u751F\u4EA7\u5355\uFF0C\u53EF\u6682\u505C/\u7EED\u8DD1\uFF09\u3002\u9650\u5236\uFF1A\u6240\u6709 AI \u64CD\u4F5C\u6D88\u8017 LLM API \u989D\u5EA6\uFF1B\u8F93\u51FA\u76EE\u5F55\u4E0E\u6A21\u578B\u53EF\u5728\u63D2\u4EF6\u8BBE\u7F6E\u4E2D\u4FEE\u6539\uFF1B\u7AE0\u8282\u6B63\u6587\u8D28\u91CF\u53D6\u51B3\u4E8E\u5927\u7EB2\u5B8C\u6574\u5EA6\uFF1B\u5F20\u529B/\u65F6\u95F4\u7EBF\u95EE\u9898\u9ED8\u8BA4\u53EA\u662F\u5EFA\u8BAE\uFF08\u5199\u65E5\u5FD7\u4E0E\u5F85\u529E\uFF09\uFF0C\u4E0D\u4F1A\u81EA\u52A8\u6539\u6B63\u6587\u3002\u7528\u6237\u63D0\u5230\u300C\u5C0F\u8BF4 / \u5927\u7EB2 / \u5199\u5C0F\u8BF4 / \u7AE0\u8282 / \u5BA1\u7A3F / \u6DA6\u8272\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
 /** Resolve a config-like value into the full runtime config. */
 export declare function resolveConfig(value: Partial<Config> | undefined): NovelConfig;
 /**