@waterwx/dsh-novel-forge 1.10.1 → 2.0.1-alpha

package/lib/types/ai-scan.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 本地 AI 味扫描器（不调 LLM，确定性检测）
+ *
+ * 用途：生成/润色后自动扫描，结果作为「事实锚点」注入审稿提示词，
+ * 让 LLM 做判断而非机械统计。也可用于 UI 展示 AI 味指标。
+ */
+export interface AiScanResult {
+    /** 总评分 0-100，越高越像 AI 写的 */
+    aiScore: number;
+    /** 命中的套话及次数 */
+    clicheHits: Array<{
+        word: string;
+        count: number;
+    }>;
+    /** 段落长度方差（过高=段落过于整齐） */
+    paragraphLengthVariance: number;
+    /** 连续解释性叙事段数（≥3 视为问题） */
+    consecutiveExpositoryParagraphs: number;
+    /** 句式重复率（相同开头句式占比） */
+    sentenceRepetitionRate: number;
+    /** 过长段落数（>300字） */
+    longParagraphCount: number;
+    /** 过短段落数（<20字） */
+    shortParagraphCount: number;
+    /** 对话占比（0-1） */
+    dialogueRatio: number;
+    /** 问题摘要，可直接注入审稿提示词 */
+    summary: string;
+}
+export declare function scanAiFlavor(text: string): AiScanResult;
+/** 扫描前后对比（润色时用） */
+export declare function compareAiScan(before: AiScanResult, after: AiScanResult): {
+    improved: boolean;
+    deltaScore: number;
+    details: string[];
+};

package/lib/types/assets.d.ts

@@ -23,7 +23,7 @@ export declare const BUILTIN_PLOT_BEATS: PlotBeatTemplate[];
 export declare function emptyProjectAssets(): ProjectAssets;
 /** 合并项目资产与内置库：返回「生效的反 AI 规则」（内置全局 + 项目自定义）。 */
 export declare function effectiveAntiAiRules(assets: ProjectAssets | undefined): AntiAiRule[];
-/** 把生效规则渲染成提示词块（压缩：avoid/fix 截断，省 token）。 */
+/** 把生效规则渲染成提示词块（禁止/鼓励分列，压缩省 token）。 */
 export declare function renderAntiAiRules(assets: ProjectAssets | undefined): string;
 /** 渲染题材与推进模式提示词块。 */
 export declare function renderGenreAndProgression(assets: ProjectAssets | undefined): string;

package/lib/types/client/api.d.ts

@@ -74,7 +74,7 @@ export declare class NovelApi {
         ok: boolean;
         filled: number;
     }>;
-    /** 设定圣经局部修补。 */
+    /** 道藏局部修补。 */
     biblePatch(patch: import('../protocol.ts').BiblePatchRequest): Promise<{
         bible: import('../protocol.ts').StoryBible;
     }>;
@@ -116,10 +116,17 @@ export declare class NovelApi {
     roles(req: import('../protocol.ts').RolesRequest): Promise<import('../protocol.ts').RolesResponse>;
     /** 漫剧角色库：从分镜提名 / 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
     mangaRoles(req: import('../protocol.ts').MangaRolesRequest): Promise<import('../protocol.ts').MangaRolesResponse>;
+    /** 导出「即梦素材包」落盘到资产库 manga-assets/素材包/。 */
+    exportPackage(chapterNo: number, title: string, markdown: string): Promise<{
+        ok: boolean;
+        file: string;
+    }>;
     /** 场景库：AI 提炼 / 采纳 / 更新 / 删除 / 图集。 */
     scenes(req: import('../protocol.ts').ScenesRequest): Promise<import('../protocol.ts').ScenesResponse>;
     /** 视觉世界观规则：提炼 / 保存。 */
     visualRules(req: import('../protocol.ts').VisualRulesRequest): Promise<import('../protocol.ts').VisualRulesResponse>;
+    /** 道具库：从已写章节提炼常驻道具 / 保存清单。 */
+    mangaProps(req: import('../protocol.ts').MangaPropsRequest): Promise<import('../protocol.ts').MangaPropsResponse>;
     /** 小说简介：AI 生成/补全（partial 留空 = 全量），或手动保存。 */
     blurb(action: 'generate' | 'save', text?: string, partial?: string): Promise<{
         blurb: string;

package/lib/types/client/index.d.ts

@@ -4,7 +4,7 @@
  * problems are logged, never thrown — the web shell fails the whole boot when
  * a plugin apply throws.
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
 /** Required services (fiber inject waiting). */
 export declare const inject: string[];
 /**

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

@@ -1,7 +1,7 @@
 import type { NovelApi } from '../api.ts';
 import type { BookshelfSnapshot } from '../../protocol.ts';
 import { type ProgressLine } from './ProgressConsole.tsx';
-export declare function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenSettings, onTheme, onBackground, onOpacity, adaptEnabled, progress, busy, busyLabel, liveBar, onClearProgress }: {
+export declare function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenSettings, onTheme, onBackground, onOpacity, onEndfieldAccent, adaptEnabled, progress, busy, busyLabel, liveBar, onClearProgress }: {
     api: NovelApi;
     shelf: BookshelfSnapshot;
     onOpenBook: (id: string) => void;
@@ -11,11 +11,13 @@ export declare function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBo
     /** 兼容旧入口：首页设置现为独立设置页，此回调保留但不再使用。 */
     onOpenSettings?: () => void;
     /** 主题/模式/密度变化回调（供面板根容器实时生效）。 */
-    onTheme?: (theme: 'liquid' | 'neumorph' | 'macos' | 'clay', mode: 'system' | 'light' | 'dark', density: 'comfort' | 'compact' | 'spacious') => void;
+    onTheme?: (theme: 'liquid' | 'neumorph' | 'macos' | 'clay' | 'endfield', mode: 'system' | 'light' | 'dark', density: 'comfort' | 'compact' | 'spacious') => void;
     /** 自定义背景变化回调。 */
     onBackground?: (bg: string | undefined, blur: number) => void;
     /** 玻璃透明度变化回调。 */
     onOpacity?: (n: number) => void;
+    /** 终末地强调色变化回调。 */
+    onEndfieldAccent?: (accent: 'valley' | 'wuling') => void;
     /** 是否启用改编模式（默认 false=隐藏入口）。 */
     adaptEnabled?: boolean;
     /** AI 进度实时状态（与书内共享同一份）。 */

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

@@ -1,11 +1,11 @@
 /**
  * 漫剧工作台·全流程步骤条（唯一导航，方案X）：
- * ①创建方案 → ②视觉规则 → ③剧情骨架 → ④分镜表 → ⑤导入角色 → ⑥角色定妆 → ⑦视频提示词 → ⑧场景库 → ⑨导出使用。
+ * ①创建方案 → ②一键生成 → ③分镜 → ④角色定妆 → ⑤场景底图 → ⑥导出使用。
  * 每个步骤对应一个独立页面主体；完成度自动判定（读 project 现有字段）。
  */
 import type { ProjectState } from '../../protocol.ts';
 /** 步骤 → 页面主体的一一对应目标。 */
-export type FlowTarget = 'plan' | 'rules' | 'skeleton' | 'table' | 'import' | 'makeup' | 'prompts' | 'scenes' | 'export';
+export type FlowTarget = 'plan' | 'rules' | 'skeleton' | 'table' | 'import' | 'makeup' | 'prompts' | 'scenes' | 'props' | 'export';
 export interface FlowStep {
     no: number;
     label: string;
@@ -13,9 +13,10 @@ export interface FlowStep {
     done: boolean;
     target: FlowTarget;
 }
-/** 依据 project 数据计算 9 步完成度（与存储顺序无关，按生产顺序排列）。 */
-export declare function computeFlowSteps(project: ProjectState | null): FlowStep[];
-export declare function FlowGuide({ project, onNavigate, }: {
+/** 依据 project 数据计算 6 步完成度（与存储顺序无关，按生产顺序排列）。 */
+export declare function computeFlowSteps(project: ProjectState | null, exported?: boolean): FlowStep[];
+export declare function FlowGuide({ project, onNavigate, exported, }: {
     project: ProjectState | null;
     onNavigate: (target: FlowTarget) => void;
+    exported?: boolean;
 }): import("react").JSX.Element;

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

@@ -1,6 +1,6 @@
 import type { NovelApi } from '../api.ts';
 import type { ImageModelConfig, ProjectState } from '../../protocol.ts';
-export declare function MangaRoleLibrary({ api, project, refresh, styleId, filterId, imageApiEnabled, imageModels, focus, showCards, onProgress, }: {
+export declare function MangaRoleLibrary({ api, project, refresh, styleId, filterId, focus, showCards, chapterNo: externalChapter, onProgress, }: {
     api: NovelApi;
     project: ProjectState | null;
     refresh: () => void | Promise<void>;
@@ -14,5 +14,7 @@ export declare function MangaRoleLibrary({ api, project, refresh, styleId, filte
     focus?: 'import' | 'cards';
     /** 是否显示「已建漫剧卡」列表（第⑤步导入页可隐藏，只留导入区）。 */
     showCards?: boolean;
+    /** 全局当前章节（从工作台顶部导航条传入）。 */
+    chapterNo?: number | null;
     onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
 }): import("react").JSX.Element;

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

@@ -1,15 +1,12 @@
 import type { NovelApi } from '../api.ts';
-import type { ChapterPlan, ImageModelConfig, ProjectState } from '../../protocol.ts';
-export declare function MangaWorkspace({ api, project, chapters, onProjectChanged, imageApiEnabled, imageModels, onProgress, }: {
+import type { ChapterPlan, ProjectState } from '../../protocol.ts';
+export declare function MangaWorkspace({ api, project, chapters, onProjectChanged, onProgress, }: {
     api: NovelApi;
     project: ProjectState | null;
     chapters: ChapterPlan[];
     /** 方案/资产变更已持久化后触发（刷新项目）。 */
     onProjectChanged?: () => void | Promise<void>;
     /** 是否启用生图（漫剧卡出定妆图）。 */
-    imageApiEnabled?: boolean;
-    /** 生图模型库（出定妆图时可选择模型）。 */
-    imageModels?: ImageModelConfig[];
     /** 上报到「AI进度」控制台（漫剧工作台内所有 LLM/方案操作）。 */
     onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,8 @@
+import type { NovelApi } from '../api.ts';
+import type { ProjectState } from '../../protocol.ts';
+export declare function PropLibrary({ api, project, refresh, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    refresh: () => void | Promise<void>;
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): import("react").JSX.Element;

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

@@ -1,6 +1,6 @@
 import type { NovelApi } from '../api.ts';
 import type { ProjectState } from '../../protocol.ts';
-export declare function SceneLibrary({ api, project, refresh, styleId, filterId, onProgress, }: {
+export declare function SceneLibrary({ api, project, refresh, styleId, filterId, chapterNo: externalChapter, onProgress, }: {
     api: NovelApi;
     project: ProjectState | null;
     /** 场景库变更已持久化后触发（刷新项目）。 */
@@ -9,6 +9,8 @@ export declare function SceneLibrary({ api, project, refresh, styleId, filterId,
     styleId?: string;
     /** 可选滤镜风格 id。 */
     filterId?: string;
+    /** 全局当前章节（从工作台顶部导航条传入）。 */
+    chapterNo?: number | null;
     /** 上报到「AI进度」控制台。 */
     onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
 }): import("react").JSX.Element;

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

@@ -1,14 +1,16 @@
 import type { NovelApi } from '../api.ts';
 type SettingsTab = 'model' | 'writing' | 'image' | 'files' | 'appearance';
 type ThemeMode = 'system' | 'light' | 'dark';
-type ThemeName = 'liquid' | 'neumorph' | 'macos' | 'clay';
+type ThemeName = 'liquid' | 'neumorph' | 'macos' | 'clay' | 'endfield';
+type EndfieldAccent = 'valley' | 'wuling';
 type ThemeDensity = 'comfort' | 'compact' | 'spacious';
-export declare function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, onBackground, onOpacity }: {
+export declare function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, onBackground, onOpacity, onEndfieldAccent }: {
     api: NovelApi;
     onTheme?: (theme: ThemeName, mode: ThemeMode, density: ThemeDensity) => void;
     onSettingsTab?: (tab: SettingsTab) => void;
     onEditorFontSize?: (n: number) => void;
     onBackground?: (bg: string | undefined, blur: number) => void;
     onOpacity?: (n: number) => void;
+    onEndfieldAccent?: (accent: EndfieldAccent) => void;
 }): import("react").JSX.Element;
 export {};

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 { 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, Volume, WorldState, AdaptMaterializeRequest, AdaptMaterializeResponse, AdaptMaterializeSaveRequest, AdaptMaterializeSaveResponse } from './protocol.ts';
+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 } 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 */
@@ -70,7 +70,7 @@ export declare function refreshPlotlineProgress(ctx: Context, config: NovelConfi
 /** ✨ AI 从全书提炼角色库：大纲 + 道藏 + 编年录 + 章节摘要 → 结构化角色清单。 */
 export declare function extractRoles(ctx: Context, config: NovelConfig, project: ProjectState): Promise<RoleRecord[]>;
 /** ✨ AI 从全书提炼场景库：正文/编年录 → 高频重要场景的结构化视觉锚点。 */
-export declare function extractScenes(ctx: Context, config: NovelConfig, project: ProjectState, styleId?: string, filterId?: string): Promise<SceneCard[]>;
+export declare function extractScenes(ctx: Context, config: NovelConfig, project: ProjectState, chapterNo?: number, styleId?: string, filterId?: string): Promise<SceneCard[]>;
 /** 从 txt/md 全本文本拆章（纯逻辑，不落盘）：识别章节头、剥离重复标题、去重、排序并统一重新编号。 */
 export declare function splitBookText(raw: string): Array<{
     no: number;
@@ -104,6 +104,8 @@ export interface RoleVisualPrompt {
     en: string;
     tags: string[];
     source: string;
+    /** 即梦/生图通用负面提示词。 */
+    negativePrompt?: string;
     /** 该角色所需情绪表情清单（6-12 个，如 疲惫/麻木/压抑悲伤）。 */
     expressions?: string[];
     /** 四类精修提示词（立绘/四视图/表情/细节，一次提炼直接产出）。 */
@@ -140,13 +142,6 @@ 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>;
-/** 生图接口连通性测试（设置页模型条目用）：GET {baseURL}/models，计时返回延迟。 */
-export declare function testImageEndpoint(baseURL: string, apiKey: string, model?: string): Promise<{
-    ok: boolean;
-    ms: number;
-    message?: string;
-    modelFound?: boolean;
-}>;
 /** 对选中的提供商/模型发一次最小真实调用（maxTokens=16），验证 Key / 端点 / 模型可用。 */
 export declare function testLlmModel(ctx: Context, provider: string, model: string): Promise<LlmTestResponse>;
 /** 运行时厂商目录：DSH pi-ai 可配置提供方 + 内置适配器，作为「添加模型」下拉。 */
@@ -162,10 +157,11 @@ export declare function removeLlmProvider(ctx: Context, req: RemoveProviderReque
  * 写入 DSH 凭据 refs，并（必要时）注册/更新 llm-pi-ai provider 路由。
  */
 export declare function registerLlmModel(ctx: Context, req: AddModelRequest): Promise<AddModelResponse>;
-/** 小说角色库：生成角色定妆图并写回角色卡（imageUrl）。 */
-export declare function generateRoleReferenceImage(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, name: string, style?: string, modelId?: string): Promise<string>;
-/** 漫剧角色卡：生成定妆图并写回漫剧卡（imageUrl）。 */
-export declare function generateMangaRoleReferenceImage(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, cardId: string, style?: string, modelId?: string): Promise<string>;
+/** 获取当前激活漫剧方案的风格（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 剧情方案：基于健康检查结果设计下一阶段方向与建议新线。 */
@@ -208,6 +204,7 @@ 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>;
@@ -216,6 +213,11 @@ export declare function summarizeChapter(ctx: Context, config: NovelConfig, proj
  * 只做画面层：景别/机位运镜/时长/画面/台词/音效/光效 + 状态连续；禁止改剧情（骨架只读）。
  */
 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[]>;
 /**
  * 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。
  * 每镜头一段：风格词块（基底+滤镜）+ 画面内容（角色动作/服装标志物）+ 机位运镜 + 光效。
@@ -292,11 +294,6 @@ export declare function materializeAdaptedBook(ctx: Context, config: NovelConfig
 }): Promise<Omit<AdaptMaterializeResponse, 'book'>>;
 /** 把预览/微调后的新书资料写入输出目录并返回摘要（书架登记由路由负责）。 */
 export declare function saveMaterializedBook(outDir: string, bookName: string, data: Omit<AdaptMaterializeSaveRequest, 'bookName' | 'outputDir'>): Omit<AdaptMaterializeSaveResponse, 'book'>;
-/**
- * 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
- * 批量生成时整体开销约省 25%）。
- * @returns 摘要与新增事实条数（失败返回空，调用方 best-effort）。
- */
 export declare function summarizeAndExtractFacts(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<{
     summary: string;
     factCount: number;
@@ -325,7 +322,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;
@@ -341,7 +338,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 提炼大世界：从大纲 + 设定圣经生成结构化境界体系/区域/势力。 */
+/** AI 提炼大世界：从大纲 + 道藏生成结构化境界体系/区域/势力。 */
 export declare function extractWorld(ctx: Context, config: NovelConfig, project: ProjectState): Promise<WorldState>;
 /**
  * 事实库回填：对历史已生成章节批量抽取事实（无事实记录的旧章节）。
@@ -371,3 +368,35 @@ export declare function exportBook(outputDir: string, project: ProjectState, for
     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[];
+}
+/**
+ * 一键生成：骨架 → 分镜表 → 角色提名 → 自动导入（匹配成功的）→ 自动分级 → 视频提示词。
+ * 匹配模糊/小说库缺失的角色保留在候选列表，不自动导入。
+ */
+export declare function autoGenerateMangaChapter(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number, styleId?: string, filterId?: string): Promise<AutoGenerateResult>;

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. */
@@ -68,7 +68,7 @@ export interface Config {
 }
 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\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\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\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/manga-genre-rules.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 题材规则库（可插拔）—— 漫剧分镜/提示词生成的「题材专用规则」。
+ * 参考短剧工业导演规范：不同题材用不同的视觉语言 / 打斗 / 特效规则，
+ * 按漫剧方案的 genre 注入 generateStoryboardPrompts，避免「一套模板跑所有题材」。
+ * 每个题材给一组「生成提示词时必须遵守的题材规则」；未选题材则不注入（走通用规则）。
+ */
+export interface GenreRule {
+    /** 题材 id。 */
+    id: string;
+    /** 题材名（展示）。 */
+    label: string;
+    /** 该题材的生成提示词核心规则（每行一条，注入生成时）。 */
+    rules: string[];
+}
+/** 内置题材（通用题材 default 为空规则）。 */
+export declare const GENRES: GenreRule[];
+/** 通用题材（空规则，走通用生成）。 */
+export declare const DEFAULT_GENRE: GenreRule;
+/** 按题材 id 取规则（未找到返回通用）。 */
+export declare function getGenreRules(id?: string): string[];
+/** 取题材 label（展示用）。 */
+export declare function getGenreLabel(id?: string): string;

package/lib/types/novel-context.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 统一上下文组装与相关设定检索
+ *
+ * 取代各阶段各自拼装 prompt，消除「生成看得到、审稿看不到」的断层。
+ * 所有阶段通过 buildChapterContext 获取同一来源的事实与设定。
+ */
+import type { ProjectState, ChapterPlan, StoryBible, RoleRecord, ChapterFact, Foreshadow, Plotline } from './protocol';
+export interface ChapterContext {
+    /** 平台合规红线（永远全量） */
+    complianceRedLines: string[];
+    /** 本书写作红线（永远全量） */
+    bookRedLines: string[];
+    /** 当前章相关角色卡（全量信息） */
+    relevantRoles: Array<{
+        name: string;
+        role: string;
+        traits: string[];
+        goals?: string;
+        knowledge?: string[];
+    }>;
+    /** 当前章相关道藏规则 */
+    relevantWorldRules: string[];
+    /** 活跃剧情线 */
+    activePlotlines: Plotline[];
+    /** 未回收伏笔 */
+    activeForeshadows: Foreshadow[];
+    /** 上一章结尾原文 */
+    prevChapterTail: string;
+    /** 上一章摘要 */
+    prevChapterSummary?: string;
+    /** 最近事实（近因记忆，top20） */
+    recentFacts: string[];
+    /** 相关旧事实（按本章 beats 检索，top15） */
+    relatedFacts: string[];
+    /** 当前卷大纲 */
+    currentVolumeOutline: string;
+    /** 本章 beats */
+    beats: string;
+    /** 本章标题 */
+    chapterTitle: string;
+}
+export interface ContextBuildOptions {
+    /** 阶段：writing/review/revise/polish/plan */
+    stage?: 'writing' | 'review' | 'revise' | 'polish' | 'plan';
+    /** 是否注入完整角色卡（false 时只注入角色名+定位） */
+    fullRoleCards?: boolean;
+    /** 相关事实检索上限 */
+    relatedFactsLimit?: number;
+    /** 最近事实数量 */
+    recentFactsLimit?: number;
+}
+/**
+ * 相关事实检索：trigram 重合度 + 角色名命中加权 + 近因加权
+ * 从 generateChapterStream 抽取，扩展为通用函数。
+ */
+export declare function retrieveRelatedFacts(facts: ChapterFact[], beatsText: string, roleNames: string[], limit?: number): string[];
+/**
+ * 相关角色检索：beats 中出现的角色 + 主角/主要反派永远全量
+ */
+export declare function retrieveRelevantRoles(bible: StoryBible | undefined, roles: RoleRecord[] | undefined, beatsText: string): ChapterContext['relevantRoles'];
+/**
+ * 构建章节统一上下文
+ *
+ * 各阶段调用此函数获取同一来源的事实与设定，消除上下文断层。
+ * 检索结果不足时自动回退全量，保证不丢失关键信息。
+ */
+export declare function buildChapterContext(project: ProjectState, chapter: ChapterPlan, outputDir: string, options?: ContextBuildOptions): ChapterContext;
+/**
+ * 将上下文渲染为 prompt 文本块
+ * 各阶段可按需选择注入哪些块。
+ */
+export declare function renderContextBlocks(ctx: ChapterContext): {
+    rolesBlock: string;
+    worldRulesBlock: string;
+    factsBlock: string;
+    plotlinesBlock: string;
+    foreshadowsBlock: string;
+    continuityBlock: string;
+    redLinesBlock: string;
+};

package/lib/types/prompt-utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 提示词共享常量与工具
+ *
+ * 所有 JSON 输出规则、通用约束集中在此，避免各阶段重复定义、互相打架。
+ */
+/** JSON 输出规则（所有要求模型输出 JSON 的地方共用） */
+export declare const JSON_OUTPUT_RULES: string[];
+/** JSON 输出规则的紧凑版（适合放在提示词末尾） */
+export declare const JSON_OUTPUT_RULES_COMPACT: string;
+/**
+ * 估算 prompt 的 token 数（粗略估算，用于上下文预算控制）
+ * 中文约 1.7 字/token，英文约 4 字符/token
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * 按 token 预算截断文本（保留开头，末尾加省略标记）
+ * 用于控制单块上下文不超预算。
+ */
+export declare function truncateByTokens(text: string, maxTokens: number, marker?: string): string;
+/** 通用「只改表达不改情节」约束（润色/局部修订共用） */
+export declare const EXPRESSION_ONLY_RULE: string[];
+/** 章节上下文各阶段的 token 预算（粗略，用于控制注入量） */
+export declare const CONTEXT_BUDGET: {
+    /** 章节生成：道藏+角色+大纲+事实+伏笔 */
+    readonly writing: 12000;
+    /** AI 审稿：道藏+角色+事实+正文 */
+    readonly review: 10000;
+    /** 修订：原意见+相关事实+目标正文 */
+    readonly revise: 8000;
+    /** 润色：风格资产+原正文 */
+    readonly polish: 6000;
+    /** 分章规划：大纲+道藏+角色+近期事实 */
+    readonly plan: 15000;
+};
+export type ContextStage = keyof typeof CONTEXT_BUDGET;