@waterwx/dsh-novel-forge 1.2.0 → 1.3.0-alpha

package/lib/types/engine.d.ts

@@ -7,12 +7,12 @@
  */
 /**
  * 内容合规红线（平台硬性要求）：所有书籍、所有章节无条件生效，
- * 优先级高于单书大纲/圣经中的任何设定与作者自定义红线。
+ * 优先级高于单书大纲/道藏中的任何设定与作者自定义红线。
  * 注入点：章节生成系统提示 + 审稿系统提示（命中即 high）。
  */
 export declare const COMPLIANCE_REDLINES: ReadonlyArray<string>;
 import type { Context } from '@deepseek-ai/cordis';
-import type { AuditIssue, AuthorReview, BreakdownResponse, ChapterPlan, Foreshadow, NovelConfig, OutlineCandidate, Plotline, PlotlineHealthReport, PlotlinePlan, ProjectState, ReviewReport, RoleRecord, RoleStatusCard, StoryBible, StoryboardPlanResponse, StoryboardResponse, Volume, WorldState } from './protocol.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 */
@@ -45,7 +45,7 @@ export declare function readChapterFile(outputDir: string, chapter: ChapterPlan)
 /** Create a fresh project from an outline. */
 export declare function createProject(outline: string, outlinePath?: string): ProjectState;
 /** Extract the story bible from an outline. */
-export declare function extractBible(ctx: Context, config: NovelConfig, outline: string): Promise<StoryBible>;
+export declare function extractBible(ctx: Context, config: NovelConfig, outline: string, project?: ProjectState): Promise<StoryBible>;
 /** Plan volumes from an outline. */
 export declare function planVolumes(ctx: Context, config: NovelConfig, outline: string): Promise<Volume[]>;
 /**
@@ -63,32 +63,43 @@ 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 刷新单条剧情线的进度：结合编年录与各章摘要分析该线推进到哪。 */
+/** 刷新单条剧情线的进度：结合编年录与各章摘要分析该线推进到哪。 */
 export declare function refreshPlotlineProgress(ctx: Context, config: NovelConfig, project: ProjectState, line: Plotline): Promise<string>;
-/** ✨ AI 从全书提炼角色库：大纲 + 道藏 + 编年录 + 章节摘要 → 结构化角色清单。 */
+/**  AI 从全书提炼角色库：大纲 + 道藏 + 编年录 + 章节摘要 → 结构化角色清单。 */
 export declare function extractRoles(ctx: Context, config: NovelConfig, project: ProjectState): Promise<RoleRecord[]>;
-/** 动漫形象描述词（中文描述 + 英文 booru 标签 + 关键外貌标签）。 */
-export interface RoleVisualPrompt {
-    zh: string;
-    en: string;
-    tags: string[];
-    source: string;
-}
-/**
- * 为单个角色提炼「动漫形象描述词」：扫描该角色出场的已写章节正文，
- * 截取含外貌描写的段落，交给 LLM 提炼中文描述 + 英文绘图标签。
- */
-export declare function extractRoleVisual(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, roleName: string): Promise<RoleVisualPrompt>;
-/**
- * 开书想法 → AI 大纲：输入一句话想法，生成 2-3 个方向不同、可直接开书的完整大纲方案。
- * @param count 本次生成几个（默认 3，最多 3）
- * @param exclude 已暂留方案的剧情方向/卖点摘要（换批时避开，防止重复）
- */
+/**  AI 从全书提炼场景库：正文/编年录 → 高频重要场景的结构化视觉锚点。 */
+export declare function splitBookText(raw: string): Array<{
+    no: number;
+    title: string;
+    body: string;
+}>;
+/** 拆章预览（不落盘）：章节编号/标题/字数 + 跳过清单。 */
+export declare function previewBookText(raw: string): {
+    chapters: Array<{
+        no: number;
+        title: string;
+        chars: number;
+    }>;
+    skipped: string[];
+};
+/** 从全本文本导入（浏览器上传 / 服务器文件共用）：建项目、写章节文件、保存。 */
+export declare function importBookTextFromText(raw: string, outputDir: string, bookName: string): {
+    bookName: string;
+    chapters: number;
+    skipped: string[];
+};
+/** 从 txt/md 全本文件导入：编码自适应读取后拆章建项目，status=written（待审稿）。 */
+export declare function importBookText(filePath: string, outputDir: string): {
+    bookName: string;
+    chapters: number;
+    skipped: string[];
+};
+/** 保证风格词块已内嵌（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'
@@ -96,20 +107,24 @@ export declare function suggestOutlines(ctx: Context, config: NovelConfig, idea:
  *  @param budgetTokens token 预算上限（超过即截断章节取样）。
  */
 export declare function breakdownBook(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, scope?: string, preset?: 'quick' | 'standard', budgetTokens?: number): Promise<BreakdownResponse>;
+/** 对选中的提供商/模型发一次最小真实调用（maxTokens=16），验证 Key / 端点 / 模型可用。 */
+export declare function testLlmModel(ctx: Context, provider: string, model: string): Promise<LlmTestResponse>;
+/** 运行时厂商目录：DSH pi-ai 可配置提供方 + 内置适配器，作为「添加模型」下拉。 */
+export declare function listLlmVendors(ctx: Context): Promise<LlmVendorsResponse>;
+/** 查询某个 provider 当前可用模型（添加成功后可即时刷新下拉）。 */
+export declare function listLlmModels(ctx: Context, provider: string): Promise<LlmModelsResponse>;
+/** 当前已注册的提供方路由列表（提供方管理卡片）。 */
+export declare function listLlmProviders(ctx: Context): Promise<LlmProvidersResponse>;
+/** 移除一个提供方：unset 凭据 ref + 移除 llm-pi-ai providers 路由。 */
+export declare function removeLlmProvider(ctx: Context, req: RemoveProviderRequest): Promise<RemoveProviderResponse>;
 /**
- * 漫剧分镜生成：把一章正文改编为短视频漫剧分镜（吸收 manga-script-master 方法论）。
- * 产出：本集标题 + 赛道节奏说明 + 角色视觉锚点卡 + 分镜表（8-12 格）+ 结尾钩子。
- * 角色锚点优先复用角色库 imagePrompt（无则从正文提炼）。
+ * 添加模型（DSH 同款体验）：厂商直填 API Key，或自定义 OpenAI 兼容路由。
+ * 写入 DSH 凭据 refs，并（必要时）注册/更新 llm-pi-ai provider 路由。
  */
-export declare function generateStoryboard(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number, genre: string, platform: string, tool: string): Promise<StoryboardResponse>;
-/**
- * 漫剧分集计划：AI 通读一卷的章节标题+摘要+beats，按故事弧线把章节分组为漫剧集。
- * 原则（吸收 manga-script 节奏模型）：高潮章单独成集、过渡章合并、断点选在钩子最强处。
- */
-export declare function planStoryboardEpisodes(ctx: Context, config: NovelConfig, project: ProjectState, volumeNo: number, platform: string, maxEpisodes: number): Promise<StoryboardPlanResponse>;
-/** 🩺 剧情健康检查：基于已写章节数/各线状态/编年录，判断是否需要新线及添加时机。 */
+export declare function registerLlmModel(ctx: Context, req: AddModelRequest): Promise<AddModelResponse>;
+/**  剧情健康检查：基于已写章节数/各线状态/编年录，判断是否需要新线及添加时机。 */
 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
@@ -139,6 +154,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';
@@ -149,14 +166,75 @@ export declare function generateChapterStream(ctx: Context, config: NovelConfig,
     frame: 'done';
     file: string;
     chars: number;
+    warn?: string;
 }, void, unknown>;
 /** Generate a chapter summary (narrative memory). */
 export declare function summarizeChapter(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<string>;
 /**
- * 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
- * 批量生成时整体开销约省 25%）。
- * @returns 摘要与新增事实条数（失败返回空，调用方 best-effort）。
+ * 反向推大纲：从已写章节正文反推出全书总纲（分卷 + 章节要点 + 主线/人物弧线/伏笔清单）。
+ * 两阶段：分批提取章节事件摘要 → 汇总生成大纲。不修改章节/设定，只返回大纲文本。
+ */
+export declare function reverseOutlineFromChapters(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, onProgress?: (done: number, total: number, phase: string) => void): Promise<string>;
+/**
+ * 改编模式 P0：全文分析 → 原文设定卡片 / 可改范围矩阵。
+ * 拆章统计 + 取样正文，让 LLM 一次输出结构化 JSON：
+ * { bookName, outline, dimensions: [{key,title,mutability,current,evidence,candidates,impact,risk}] }。
  */
+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<{
+    key: string;
+    title: string;
+    current: string;
+    target: string;
+    mutability: string;
+}>, dimensions?: AdaptationDimension[]): Promise<AdaptProposeResponse>;
+/** 剧本术语替换执行：按映射表做精确替换并统计命中。 */
+export declare function applyAdaptationReplacements(text: string, mappings: AdaptationMapping[]): {
+    adaptedText: string;
+    hits: Array<{
+        source: string;
+        target: string;
+        count: number;
+    }>;
+};
+/** 改编模式 rewrite：逐章 LLM 重写（结构性改写，不只是换词）。
+ * @returns 改写后的全文 + 逐章结果 + 保留原章的章号。 */
+export declare function rewriteAdaptationBook(ctx: Context, config: NovelConfig, text: string, mappings: AdaptationMapping[], rules?: AdaptationRules, options?: {
+    maxChapters?: number;
+    startNo?: number;
+    endNo?: number;
+    onProgress?: (info: {
+        completed: number;
+        total: number;
+        no: number;
+        title: string;
+    }) => void;
+}): Promise<{
+    adaptedText: string;
+    rewritten: Array<{
+        no: number;
+        title: string;
+        chars: number;
+    }>;
+    skipped: number[];
+    hits: Array<{
+        source: string;
+        target: string;
+        count: number;
+    }>;
+}>;
+/**
+ * 改编模式 P3：从源全文 + 用户编辑后的改编方案，提炼新书资料并保存为「待写新书」。
+ * 流程：源文导入临时项目 → 复用 extractBible/extractRoles/extractWorld 提炼 →
+ * 按映射表把术语/人名/势力映射到新书命名层 → planVolumes/planChapters 生成待写计划 → 保存。
+ * @returns 提炼后的新书资料（不含书架 book，由路由负责登记书架）。
+ */
+export declare function materializeAdaptedBook(ctx: Context, config: NovelConfig, args: Omit<AdaptMaterializeRequest, 'outputDir'> & {
+    outputDir: string;
+}): Promise<Omit<AdaptMaterializeResponse, 'book'>>;
+/** 把预览/微调后的新书资料写入输出目录并返回摘要（书架登记由路由负责）。 */
+export declare function saveMaterializedBook(outDir: string, bookName: string, data: Omit<AdaptMaterializeSaveRequest, 'bookName' | 'outputDir'>): Omit<AdaptMaterializeSaveResponse, 'book'>;
 export declare function summarizeAndExtractFacts(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<{
     summary: string;
     factCount: number;
@@ -175,7 +253,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 工具）。
@@ -185,7 +263,7 @@ export declare function generateBlurb(ctx: Context, config: NovelConfig, project
 export declare function bookOverview(project: ProjectState, scope?: 'recent' | 'full' | number): string;
 /** 一条影响分析结果（改动波及处）。 */
 export interface ImpactItem {
-    /** 位置：章节号 / 大纲 / 设定圣经 / 大世界 / 事实库 / 简介。 */
+    /** 位置：章节号 / 大纲 / 道藏 / 大世界 / 事实库 / 简介。 */
     location: string;
     /** 原文片段（定位用）。 */
     quote: string;
@@ -201,7 +279,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>;
 /**
  * 事实库回填：对历史已生成章节批量抽取事实（无事实记录的旧章节）。
@@ -224,10 +302,76 @@ export declare function extractStyleAsset(ctx: Context, config: NovelConfig, sam
     dialogueRules: string[];
     descriptionRules: string[];
     boundaries: string[];
+    preset?: 'imitate' | 'balanced' | 'transfer';
+    fingerprintRisk?: 'low' | 'medium' | 'high';
+    writingGuidance?: string[];
+    forbiddenEntities?: string[];
 }>;
+/** 分层提取写作公式（basic/standard/deep）。 */
+export declare function extractStyleFormula(ctx: Context, config: NovelConfig, sampleText: string, depth: 'basic' | 'standard' | 'deep'): Promise<{
+    name: string;
+    focusAreas: string[];
+    formula: string;
+    applyGuidance: string;
+}>;
+/** 题材雷达：输入平台/题材/榜单文本 → 信号 + 生产底座 + 开书创意。 */
+export declare function runMarketRadar(ctx: Context, config: NovelConfig, req: MarketRadarRequest): Promise<MarketRadarResult>;
+/** 开书创意简报：用选中的市场信号 + 影响模式生成可执行 constraint / creative seed。 */
+export declare function runMarketCreativeBrief(ctx: Context, config: NovelConfig, req: MarketRadarBriefRequest): Promise<MarketCreativeBrief>;
+/** 书分析/拆书：输入一本书/章节文本 → 卖点/结构/可借鉴点/风险。 */
+export declare function runBookAnalysis(ctx: Context, config: NovelConfig, req: BookAnalysisRequest): Promise<BookAnalysisResult>;
+/** 创意灵感：一句话/题材 → 多方向开书灵感。 */
+export declare function runIdeaInspiration(ctx: Context, config: NovelConfig, req: IdeaInspirationRequest): Promise<IdeaInspirationResult>;
+/** 雷达→灵感：基于市场信号/生产底座/创意简报，生成贴合市场的开书灵感。 */
+export declare function runMarketIdeaInspiration(ctx: Context, config: NovelConfig, req: {
+    signals?: MarketRadarSignal[];
+    foundation?: ProductionFoundation;
+    brief?: MarketCreativeBrief;
+    count?: number;
+}): 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;
 };
+/**
+ * 按范围导出：整本正文 / 设定 / 规划 / 角色 / 质检记录 / 项目 JSON。
+ *
+ * @param outputDir 书目录。
+ * @param project 项目状态。
+ * @param scope 导出范围。
+ * @param format txt / md / json（json 只对 `project` 范围有独立含义，其余按 md 落盘）。
+ * @returns 文件名、字符数与章节数。
+ */
+export declare function exportScope(outputDir: string, project: ProjectState, scope: ExportScope, format: 'txt' | 'md' | 'json'): {
+    file: string;
+    chars: number;
+    chapters: number;
+};

package/lib/types/global-assets.d.ts

@@ -0,0 +1,6 @@
+import type { GenreNode, ProgressionMode } from './protocol.ts';
+export declare function globalGenreLibrary(): GenreNode[];
+export declare function globalProgressionLibrary(): ProgressionMode[];
+/** 新增/已有则跳过；返回 true=新增。 */
+export declare function addGlobalGenre(g: GenreNode): boolean;
+export declare function addGlobalMode(m: ProgressionMode): boolean;

package/lib/types/index.d.ts

@@ -18,7 +18,7 @@ export declare const inject: string[];
  * settings surface edits. Spelled here rather than imported: the browser half
  * spells the same value and must not depend on a Host package.
  */
-export declare const NOVEL_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+export declare const NOVEL_SETTINGS_NAMESPACE: "dsh-novel-forge";
 /** Plugin config, validated by the same-named schemastery schema. */
 export interface Config {
     /** When true (default), a system-prompt section announces the plugin to every agent. */
@@ -33,8 +33,20 @@ export interface Config {
     provider?: string;
     /** LLM model id. */
     model?: string;
+    /** 任务级模型路由：正文生成模型（留空则跟随 model）。 */
+    generateModel?: string;
+    /** 任务级模型路由：审稿模型（留空则跟随 model）。 */
+    reviewModel?: string;
+    /** 任务级模型路由：质检模型（留空则跟随 model）。 */
+    auditModel?: string;
+    /** 备用模型：主模型失败时自动切换重试一次（留空 = 不切换）。 */
+    fallbackModel?: string;
+    /** 出章后自动抽取故事时间线（默认开）。 */
+    autoTimeline?: boolean;
     /** LLM reasoning effort (off/low/high/max). */
     reasoningEffort?: 'off' | 'low' | 'high' | 'max';
+    /** 分析类任务（提炼/拆书/反推大纲等）的推理档位；默认 low。 */
+    analysisReasoning?: 'off' | 'low' | 'high' | 'max';
     /** Target characters per chapter. */
     chapterChars?: number;
     /** Max output tokens per chapter call. */
@@ -47,10 +59,18 @@ export interface Config {
     autoAuthorReview?: boolean;
     /** 修订/润色产出草稿后自动附带一次 AI 审查（默认开，可在设置页关闭省 token）。 */
     autoReviewAfterRevise?: boolean;
+    /** 自定义背景图（URL / dataURL / 服务端路径引用）。 */
+    themeBackground?: string;
+    /** 自定义背景遮罩/模糊强度 0-80。 */
+    themeBackgroundBlur?: number;
+    /** 玻璃透明度 0-100（100=当前原样）。 */
+    themeOpacity?: number;
+    /** 是否启用改编模式（默认关闭）。 */
+    enableAdaptMode?: boolean;
 }
 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\uFF08\u9ED8\u8BA4 D:\\ryan work\\harness\\novels\\\u5F52\u589F\u7389\u4E3B \u5927\u7EB2\uFF09\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\uFF0C\u5373\u8BBE\u5B9A\u5723\u7ECF\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 D:\\ryan work\\harness\\novels\\\u5F52\u589F\u7389\u4E3B\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 / \u5F52\u589F\u7389\u4E3B\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\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";
 /** Resolve a config-like value into the full runtime config. */
 export declare function resolveConfig(value: Partial<Config> | undefined): NovelConfig;
 /**

package/lib/types/llm-live.d.ts

@@ -0,0 +1,75 @@
+/**
+ * LLM 实况 feed：以「每次 LLM 调用」为粒度，把生命周期事件（开始/流式正文/阶段变化/完成）
+ * 推给订阅者，并提供环形缓冲供新连上的客户端重放。
+ *
+ * 同时承担三件与用量有关的事（进程内，不落盘）：
+ *   1) **用量账本**：每次调用结束后按用途累计 token / 耗时，供 /status 展示；
+ *   2) **Prompt 记录**：保存每次调用实际发送的 system + user（环形，按需查询）；
+ *   3) **首字耗时**：调用方在拿到第一个文本增量时打点，用于观察模型响应速度。
+ */
+import type { BlockAssembler, TokenUsage } from '@deepseek-ai/dsh-llm';
+import type { LlmLiveFrame, LlmPromptRecord, LlmTokenUsage, LlmUsageSummary } from './protocol.ts';
+export type { LlmLiveFrame };
+export type LlmLivePhase = 'requesting' | 'streaming' | 'completed' | 'failed';
+type Listener = (frame: LlmLiveFrame) => void;
+export declare function nextSessionId(): string;
+export declare function subscribeLiveFeed(listener: Listener): () => void;
+export declare function emitLive(frame: LlmLiveFrame): void;
+export declare function liveLatest(): LlmLiveFrame[];
+export declare function clearLiveFeed(): void;
+/** 把 dsh-llm 的 usage 转成线上形状。 */
+export declare function toLiveUsage(usage: TokenUsage | undefined): LlmTokenUsage | undefined;
+/** 本次运行的用量汇总（按耗时降序排列用途，便于看谁最贵）。 */
+export declare function liveUsage(): LlmUsageSummary;
+/** 清零用量账本（面板「重新计数」用）。 */
+export declare function resetLiveUsage(): void;
+/** 记一条 Prompt（超长截断并标记）。 */
+export declare function recordPrompt(input: {
+    sessionId: string;
+    label?: string;
+    model?: string;
+    system?: string;
+    user?: string;
+}): LlmPromptRecord;
+/** 取一条 Prompt 记录（不存在返回 undefined）。 */
+export declare function livePrompt(sessionId: string): LlmPromptRecord | undefined;
+/** 清空 Prompt 记录。 */
+export declare function clearLivePrompts(): void;
+/** 一次调用的打点句柄。 */
+export interface LiveCallHandle {
+    sessionId: string;
+    startedAt: number;
+    /** 用途（用于 session_completed 的用量分组）。 */
+    label: string;
+    /** 实际使用的模型。 */
+    model: string;
+    /** 首字耗时（毫秒），由 markFirstToken 写入。 */
+    firstTokenMs?: number;
+}
+/**
+ * 开始一次 LLM 调用：发 session_started、记 Prompt、起计时。
+ *
+ * @param input 用途/模型/实际发送的 system 与 user。
+ * @returns 打点句柄（结束时交给 endLiveCall）。
+ */
+export declare function beginLiveCall(input: {
+    label: string;
+    model: string;
+    system?: string;
+    user?: string;
+}): LiveCallHandle;
+/** 首字打点（调用方在收到第一个文本增量时调用，只记第一次）。 */
+export declare function markFirstToken(handle: LiveCallHandle): void;
+/**
+ * 结束一次 LLM 调用：从 assembler 取用量，发 session_completed（含 token/耗时/首字）。
+ *
+ * @param handle beginLiveCall 的句柄。
+ * @param assembler 本次调用的 BlockAssembler。
+ * @param extra 字符数/预览/失败信息等。
+ */
+export declare function endLiveCall(handle: LiveCallHandle, assembler: BlockAssembler, extra?: {
+    chars?: number;
+    preview?: string;
+    phase?: 'completed' | 'failed';
+    error?: string;
+}): void;

package/lib/types/llm-retry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 模型失败恢复规则（纯逻辑，可离线单测）。
+ *
+ * 解决的问题：批量连写时，主模型偶发限流/超时/额度耗尽会让**整批中断**，
+ * 而换一个模型重试一次往往就能过去。规则：
+ *   1) 只对「可重试」错误切换模型——用户主动取消、参数/契约类错误不重试；
+ *   2) 备用模型为空或与主模型相同则不切换；
+ *   3) 备用模型也失败时，抛**原始错误**（保留主因，不掩盖现场）；
+ *   4) 每次调用最多切换一次。
+ */
+/**
+ * 判断一次 LLM 失败是否值得换模型重试。
+ *
+ * @param error 捕获到的异常。
+ * @returns 可重试时为 true。
+ */
+export declare function isRetryableLlmError(error: unknown): boolean;
+/**
+ * 判断是否应当切换到备用模型。
+ *
+ * @param fallbackModel 配置的备用模型（空串 = 未配置）。
+ * @param primaryModel 本次实际使用的主模型。
+ * @param error 捕获到的异常。
+ * @returns 应当切换时为 true。
+ */
+export declare function shouldSwitchModel(fallbackModel: string | undefined, primaryModel: string, error: unknown): boolean;
+/**
+ * 用主模型执行；失败且满足切换条件时，用备用模型再执行一次。
+ *
+ * @param input 主模型 / 备用模型 / 实际执行函数（接收本次要用的模型 id）。
+ * @returns 执行结果（备用模型成功时返回其结果）。
+ * @throws 主模型失败且未切换时抛原错误；切换后仍失败时同样抛**主模型的原始错误**。
+ */
+export declare function withModelFallback<T>(input: {
+    model: string;
+    fallbackModel?: string;
+    onSwitch?: (from: string, to: string, error: unknown) => void;
+}, run: (model: string) => Promise<T>): Promise<T>;

package/lib/types/market-radar-scan.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 热门题材雷达：真实榜单扫榜（聚合各平台榜单源，容错）。
+ */
+import { type CollectedRankingItem, type MarketRadarPlatform } from './market-radar-sources.ts';
+export interface MarketRadarGroup {
+    platform: MarketRadarPlatform;
+    platformLabel: string;
+    listKey: string;
+    listLabel: string;
+    status: 'ok' | 'error';
+    error?: string;
+    items: CollectedRankingItem[];
+}
+export interface MarketScanResult {
+    scannedAt: string;
+    groups: MarketRadarGroup[];
+}
+export declare function getLastMarketScan(): MarketScanResult | null;
+export declare function scanMarketRanking(platforms?: string[]): Promise<MarketScanResult>;

package/lib/types/market-radar-sources.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 「热门题材雷达」真实榜单抓取源（公开榜单页面的地址与选择器，属事实性配置）。
+ * 用全局 fetch 抓取公开榜单移动版页面，正则抽取元数据；无第三方依赖。
+ */
+export type MarketRadarPlatform = 'fanqie' | 'qidian' | 'jinjiang';
+export interface MarketRadarListSource {
+    platform: MarketRadarPlatform;
+    platformLabel: string;
+    listKey: string;
+    listLabel: string;
+    channel: string;
+    sourceUrl: string;
+}
+export interface CollectedRankingItem {
+    rank: number;
+    title: string;
+    author?: string;
+    category?: string;
+    tags: string[];
+    synopsis?: string;
+    heatLabel?: string;
+    serialStatus?: string;
+    sourceUrl: string;
+}
+export declare const MARKET_RADAR_SOURCES: MarketRadarListSource[];
+export declare function hasPrivateUseCharacters(value: string | null | undefined): boolean;
+export declare function parseFanqieRanking(html: string, source: MarketRadarListSource): CollectedRankingItem[];
+export declare function parseFanqieDetail(html: string, item: CollectedRankingItem): CollectedRankingItem;
+export declare function parseQidianRanking(html: string, source: MarketRadarListSource): CollectedRankingItem[];
+export declare function parseJinjiangRanking(html: string, source: MarketRadarListSource): CollectedRankingItem[];
+export declare function collectMarketSource(source: MarketRadarListSource): Promise<CollectedRankingItem[]>;

package/lib/types/migrate-output.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 输出目录迁移（Migrate Output Dir）— 把一本书/默认输出目录的内容搬到新位置。
+ *
+ * 安全纪律（数据零丢失排序）：
+ *  1. copy 全部内容到新目录（源目录始终原样保留）；
+ *  2. 调用方完成配置写入 / 书架重指向后，最后一步才删源目录；
+ *  3. 中途任何失败，最坏情况只是新目录多一份副本，源数据零丢失。
+ */
+/** 目录内容清单（相对路径 + 总字节）。 */
+export interface DirContents {
+    files: string[];
+    bytes: number;
+}
+/** 规范化路径用于比较（统一分隔符，Windows 忽略大小写）。 */
+export declare function normalizeDir(dir: string): string;
+/** 列出目录全部内容（递归；子目录以 `name/` 形式占位列出）。 */
+export declare function listDirContents(dir: string): DirContents;
+/**
+ * 把 from 全部内容复制到 to（源目录保留，删除由调用方在收尾执行）。
+ * 目标必须不存在或为空目录（防覆盖无关数据）；禁止互相嵌套的目录对。
+ * @returns 复制的顶层条目数。
+ */
+export declare function copyDirContents(from: string, to: string): number;
+/** 删除源目录（仅复制 + 配置/书架重指向全部成功后调用）。 */
+export declare function removeDir(dir: string): void;