@waterwx/dsh-novel-forge 1.4.0 → 1.5.0

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

@@ -16,6 +16,16 @@ export declare class NovelApi {
         ok: boolean;
         bookName: string;
     }>;
+    /** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流）。 */
+    outlineReverse(onFrame: (frame: JobFrame) => void): Promise<void>;
+    /** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
+    storyboardTable(chapterNo: number, skeleton: import('../protocol.ts').StoryboardSkeleton, styleId?: string, filterId?: string): Promise<import('../protocol.ts').StoryboardTableResponse>;
+    /** 漫剧方案管理：create / remove / activate。 */
+    manhuaPlans(req: import('../protocol.ts').MangaPlansRequest): Promise<import('../protocol.ts').MangaPlansResponse>;
+    /** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
+    storyboardPrompts(chapterNo: number, table: import('../protocol.ts').StoryboardTable, styleId?: string, filterId?: string): Promise<import('../protocol.ts').StoryboardPromptsResponse>;
+    /** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
+    storyboardSkeleton(chapterNo: number): Promise<import('../protocol.ts').StoryboardSkeletonResponse>;
     /** 开书想法 → AI 大纲：生成 count 个方案（换批时传 exclude 避开已暂留方向）。 */
     outlineSuggest(idea: string, count?: number, exclude?: string[]): Promise<import('../protocol.ts').OutlineSuggestResponse>;
     /** 拆书分析：对已写章节做结构/人物/文风/卖点体检。 */
@@ -118,8 +128,12 @@ export declare class NovelApi {
     bookRemove(id: string): Promise<import('../protocol.ts').BookshelfSnapshot>;
     /** 导入已有项目目录（Mode A）：校验 novel-project.json，登记/激活书架。 */
     bookImportDir(outputDir: string): Promise<import('../protocol.ts').BookImportDirResponse>;
-    /** 导入 txt/md 全本（Mode B）：拆章建项目并登记书架。 */
+    /** 导入 txt/md 全本（Mode B）：服务器本地文件路径模式。 */
     bookImportText(filePath: string, outputDir?: string): Promise<import('../protocol.ts').BookImportTextResponse>;
+    /** 拆章预览（浏览器上传全文，不落盘）：返回识别到的章节与跳过清单。 */
+    bookImportTextPreview(text: string, fileName?: string): Promise<import('../protocol.ts').BookImportTextPreviewResponse>;
+    /** 导入 txt/md 全本（Mode B）：浏览器上传全文内容模式。 */
+    bookImportTextContent(text: string, fileName: string, outputDir?: string): Promise<import('../protocol.ts').BookImportTextResponse>;
     /** 生产单：启动批量生产（区间或新增 N 章；计划不足自动补）。 */
     runStart(req: import('../protocol.ts').RunStartRequest): Promise<import('../protocol.ts').RunState>;
     /** 生产单控制：pause / resume / stop。 */

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

@@ -143,12 +143,14 @@ export declare const zh: {
     readonly 'settings.model': "模型";
     readonly 'settings.modelCustom': "自定义…";
     readonly 'settings.modelCustomPlaceholder': "输入任意模型 id";
-    readonly 'settings.reasoningEffort': "思考强度 (reasoningEffort)";
+    readonly 'settings.reasoningEffort': "写作类任务思考强度 (reasoningEffort)";
+    readonly 'settings.reasoningHint': "章节生成/润色/重写/审稿等写作任务使用；关掉更省更快。";
+    readonly 'settings.analysisReasoning': "分析类任务思考强度（提炼/拆书/反推大纲）";
+    readonly 'settings.analysisReasoningHint': "角色/场景/道藏提炼、拆书、反推大纲等一次性分析任务默认 low，保证质量，不受上面写作档位影响。";
     readonly 'settings.reasoning.off': "off · 关闭思考（推荐日常写文）";
     readonly 'settings.reasoning.low': "low · 低思考";
     readonly 'settings.reasoning.high': "high · 高思考";
     readonly 'settings.reasoning.max': "max · 最高思考（质检/推演）";
-    readonly 'settings.reasoningHint': "off 最快最省；high/max 更慢更贵但推理更强";
     readonly 'settings.theme': "主题";
     readonly 'settings.themeLiquid': "iOS 液态玻璃（绿）";
     readonly 'settings.themeClassic': "经典毛玻璃（蓝）";

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

@@ -0,0 +1,9 @@
+import type { NovelApi } from '../api.ts';
+import type { ChapterPlan, ProjectState } from '../../protocol.ts';
+export declare function MangaWorkspace({ api, project, chapters, onProjectChanged, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    chapters: ChapterPlan[];
+    /** 方案变更已持久化后触发（刷新项目）。 */
+    onProjectChanged?: () => void | Promise<void>;
+}): import("react").JSX.Element;

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

@@ -1,7 +1,7 @@
 import type { NovelApi } from '../api.ts';
 import type { PanelController } from './controller.ts';
 /** The panel's tab identifiers. */
-export type NovelTab = 'workflow' | 'overview' | 'blurb' | 'plan' | 'bible' | 'world' | 'foreshadow' | 'assistant' | 'settings' | 'characters' | 'roles' | 'facts' | 'plotlines' | 'reviews' | 'progress' | 'breakdown' | 'roleImage' | 'scenes' | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle' | 'run' | 'book' | 'assets';
+export type NovelTab = 'workflow' | 'overview' | 'blurb' | 'plan' | 'bible' | 'world' | 'foreshadow' | 'assistant' | 'settings' | 'characters' | 'roles' | 'facts' | 'plotlines' | 'reviews' | 'progress' | 'breakdown' | 'roleImage' | 'scenes' | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle' | 'run' | 'manhua' | 'styleLib' | 'book' | 'assets';
 /** Panel shell props. */
 export interface NovelPanelProps {
     /** The panel state owner (open/close/toggle). */

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

@@ -0,0 +1,13 @@
+import type { NovelApi } from '../api.ts';
+import type { ChapterPlan, ProjectState } from '../../protocol.ts';
+export declare function StoryboardTab({ api, project, chapters, onProjectChanged, styleId, filterId, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    chapters: ChapterPlan[];
+    /** 生成成功且已持久化后触发（刷新项目，切章/重进可恢复）。 */
+    onProjectChanged?: () => void | Promise<void>;
+    /** 漫剧基底风格 id（画面措辞随风格）。 */
+    styleId?: string;
+    /** 可选滤镜风格 id。 */
+    filterId?: string;
+}): import("react").JSX.Element;

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

@@ -0,0 +1 @@
+export declare function StyleGallery(): import("react").JSX.Element;

package/lib/types/engine.d.ts

@@ -12,7 +12,7 @@
  */
 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, SceneCard, StoryBible, Volume, WorldState } from './protocol.ts';
+import type { AuditIssue, AuthorReview, BreakdownResponse, ChapterPlan, Foreshadow, NovelConfig, OutlineCandidate, Plotline, PlotlineHealthReport, PlotlinePlan, ProjectState, ReviewReport, RoleRecord, RoleStatusCard, SceneCard, StoryBible, StoryboardSkeleton, StoryboardTable, StoryboardPrompt, Volume, WorldState } 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 */
@@ -71,7 +71,28 @@ export declare function refreshPlotlineProgress(ctx: Context, config: NovelConfi
 export declare function extractRoles(ctx: Context, config: NovelConfig, project: ProjectState): Promise<RoleRecord[]>;
 /** ✨ AI 从全书提炼场景库：正文/编年录 → 高频重要场景的结构化视觉锚点。 */
 export declare function extractScenes(ctx: Context, config: NovelConfig, project: ProjectState): Promise<SceneCard[]>;
-/** 从 txt/md 全本拆分章节并建立项目：正文落盘为章节文件，status=written（待审稿）。 */
+/** 从 txt/md 全本文本拆章（纯逻辑，不落盘）：识别章节头、剥离重复标题、去重、排序并统一重新编号。 */
+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;
@@ -92,12 +113,12 @@ export interface RoleVisualPrompt {
  * 为单个角色提炼「动漫形象描述词」：扫描该角色出场的已写章节正文，
  * 截取含外貌描写的段落，交给 LLM 提炼中文描述 + 英文绘图标签。
  */
-export declare function extractRoleVisual(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, roleName: string): Promise<RoleVisualPrompt>;
+export declare function extractRoleVisual(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, roleName: string, styleId?: string, filterId?: string): Promise<RoleVisualPrompt>;
 /**
  * 角色四类生图提示词精修包（promptKit）：以锚点 + 表情清单 + 视觉规则为输入，
  * LLM 产出 立绘/四视图/表情×N/细节 四套 zh+en 提示词（比前端拼装更精炼）。
  */
-export declare function generateRolePromptKit(ctx: Context, config: NovelConfig, project: ProjectState, roleName: string): Promise<RoleRecord['promptKit']>;
+export declare function generateRolePromptKit(ctx: Context, config: NovelConfig, project: ProjectState, roleName: string, styleId?: string, filterId?: string): Promise<RoleRecord['promptKit']>;
 /** ✨ 从道藏/红线提炼「视觉世界观规则」：生图/生视频必须遵守的设定纠偏（如"商品=人，禁止常规超市商品"）。 */
 export declare function extractVisualRules(ctx: Context, config: NovelConfig, project: ProjectState): Promise<string[]>;
 /**
@@ -161,6 +182,27 @@ 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>;
+/**
+ * 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。
+ * 每镜头一段：风格词块（基底+滤镜）+ 画面内容（角色动作/服装标志物）+ 机位运镜 + 光效。
+ * 提示词聚焦画面与镜头（视频模型无音频，台词/音效不注入）。
+ */
+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>;
+/**
+ * 反向推大纲：从已写章节正文反推出全书总纲（分卷 + 章节要点 + 主线/人物弧线/伏笔清单）。
+ * 两阶段：分批提取章节事件摘要 → 汇总生成大纲。不修改章节/设定，只返回大纲文本。
+ */
+export declare function reverseOutlineFromChapters(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, onProgress?: (done: number, total: number, phase: string) => void): Promise<string>;
 /**
  * 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
  * 批量生成时整体开销约省 25%）。

package/lib/types/index.d.ts

@@ -35,6 +35,8 @@ export interface Config {
     model?: string;
     /** 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. */

package/lib/types/protocol.d.ts

@@ -39,6 +39,16 @@ export declare const NOVEL_API: {
     readonly bookshelfImportDir: "/api/dsh-novel-forge/bookshelf/import-dir";
     /** 导入 txt/md 全本：拆章建项目并登记书架。 */
     readonly bookshelfImportText: "/api/dsh-novel-forge/bookshelf/import-text";
+    /** 导入 txt/md 全本：拆章预览（不落盘）。 */
+    readonly bookshelfImportTextPreview: "/api/dsh-novel-forge/bookshelf/import-text/preview";
+    /** 漫剧方案管理：create/remove/activate。 */
+    readonly manhuaPlans: "/api/dsh-novel-forge/manhua/plans";
+    /** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
+    readonly storyboardSkeleton: "/api/dsh-novel-forge/storyboard/skeleton";
+    /** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
+    readonly storyboardTable: "/api/dsh-novel-forge/storyboard/table";
+    /** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
+    readonly storyboardPrompts: "/api/dsh-novel-forge/storyboard/prompts";
     /** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
     readonly reset: "/api/dsh-novel-forge/reset";
     /** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
@@ -73,6 +83,8 @@ export declare const NOVEL_API: {
     readonly sensitiveCheck: "/api/dsh-novel-forge/sensitive-check";
     /** 开书想法 → AI 补全大纲：输入一句话想法，生成 2-3 个可选大纲方案。 */
     readonly outlineSuggest: "/api/dsh-novel-forge/outline/suggest";
+    /** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流）。 */
+    readonly outlineReverse: "/api/dsh-novel-forge/outline/reverse";
     /** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检（两阶段：源笔记→分节分析）。 */
     readonly breakdown: "/api/dsh-novel-forge/breakdown";
     /** 漫剧分镜生成：章节 → 角色锚点 + 分镜表（可适配豆包/Seedance/SD）。 */
@@ -143,10 +155,17 @@ export interface BookImportDirResponse {
     /** true = 目录已在书架中（本次为重新激活）。 */
     existed: boolean;
 }
-/** POST /bookshelf/import-text 请求：导入 txt/md 全本。 */
+/** POST /bookshelf/import-text 请求：导入 txt/md 全本。两种模式二选一：
+ *  - filePath：服务器本地文件路径；
+ *  - text + fileName：浏览器上传的全文内容（fileName 用于推断书名）。
+ */
 export interface BookImportTextRequest {
-    /** 源文件绝对路径（txt 或 md）。 */
-    filePath: string;
+    /** 模式一：源文件绝对路径（txt 或 md）。 */
+    filePath?: string;
+    /** 模式二：浏览器上传的全文内容。 */
+    text?: string;
+    /** 模式二：原文件名（txt/md），用于推断书名与显示。 */
+    fileName?: string;
     /** 输出目录；缺省为 ~/.dsh/novels/书名。 */
     outputDir?: string;
 }
@@ -160,6 +179,158 @@ export interface BookImportTextResponse {
     /** 登记后的书架条目。 */
     book: BookEntry;
 }
+/** POST /bookshelf/import-text/preview 请求：上传全文做拆章预览（不落盘）。 */
+export interface BookImportTextPreviewRequest {
+    text: string;
+    /** 原文件名（txt/md），用于推断书名。 */
+    fileName?: string;
+}
+/** POST /bookshelf/import-text/preview 响应。 */
+export interface BookImportTextPreviewResponse {
+    /** 预计书名（fileName 去扩展名）。 */
+    bookName: string;
+    /** 识别出的章节（已按正文长度过滤过短章节）。 */
+    chapters: Array<{
+        no: number;
+        title: string;
+        chars: number;
+    }>;
+    /** 因内容过短被跳过的章节标题列表。 */
+    skipped: string[];
+}
+/** 分镜·编剧级：剧情骨架中的一节拍。 */
+export interface StoryboardBeat {
+    /** 节拍 id（如 b1、b2）。 */
+    id: string;
+    /** 事件一句话（发生了什么）。 */
+    event: string;
+    /** 情绪走向（如 压抑→隐忍→惊惧）。 */
+    emotion: string;
+    /** 叙事功能：铺垫/冲突/转折/高潮/收束/伏笔/人物塑造。 */
+    function: string;
+    /** 因果：承接上一节拍的原因（可选）。 */
+    cause?: string;
+}
+/** 分镜·编剧级：单章剧情骨架。 */
+export interface StoryboardSkeleton {
+    chapterNo: number;
+    /** 本章弧线一句话（起承转合）。 */
+    arc: string;
+    /** 剧情节拍链（时间顺序，因果连贯）。 */
+    beats: StoryboardBeat[];
+}
+/** 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;
+    /** 景别：远景/全景/中景/近景/特写。 */
+    shot: string;
+    /** 机位与运镜（如 低机位仰拍 + 缓慢推近）。 */
+    camera: string;
+    /** 时长（秒，1-12）。 */
+    duration: number;
+    /** 画面内容：角色动作 + 表情 + 服装/标志物。 */
+    visual: string;
+    /** 台词/旁白（无则空字符串）。 */
+    line: string;
+    /** 音效（无则空字符串）。 */
+    sound: string;
+    /** 光效（如 雨夜顶光 + 手机屏幕冷光）。 */
+    light: string;
+    /** 承接上一镜头结尾状态（位置/动作/情绪/服装）。 */
+    prevState: string;
+    /** 本镜头结束状态。 */
+    nextState: string;
+}
+/** 分镜·导演级：单章分镜表。 */
+export interface StoryboardTable {
+    chapterNo: number;
+    shots: StoryboardShot[];
+}
+/** 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;
+}
+/** 分镜持久化：单章的分镜产出（骨架 + 分镜表 + 视频提示词，可分别存在）。 */
+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;
+    /** 是否激活（分镜/角色图生成时使用）。 */
+    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;
+    /** remove/activate：方案 id。 */
+    id?: string;
+}
+/** POST /manhua/plans 响应。 */
+export interface MangaPlansResponse {
+    plans: MangaPlan[];
+}
 /** Chapter lifecycle states (the writing pipeline's state machine). */
 export type ChapterStatus = 'pending' | 'generating' | 'written' | 'reviewing' | 'approved' | 'rejected' | 'error';
 /** One chapter in the plan. */
@@ -644,6 +815,10 @@ export interface RolesRequest {
     label?: string;
     /** op='imageGenerate' 时的漫画风格预设 id（用于统一角色图与漫画页风格）。 */
     style?: string;
+    /** op='visual' / op='promptKit' 时的漫剧基底风格 id（角色图按方案风格重出）。 */
+    styleId?: string;
+    /** op='visual' / op='promptKit' 时的可选滤镜风格 id。 */
+    filterId?: string;
 }
 /** POST /roles 响应。 */
 export interface RolesResponse {
@@ -775,6 +950,10 @@ export interface ProjectState {
     scenes?: SceneCard[];
     /** 视觉世界观规则（生图/生视频必须遵守，从道藏提炼，注入所有提示词）。 */
     visualRules?: string[];
+    /** 分镜工作台产出（骨架/分镜表，按章持久化，刷新/切换不丢）。 */
+    storyboards?: ChapterStoryboard[];
+    /** 漫剧方案列表（同一本书的多套视觉演绎：基底风格 + 可选滤镜）。 */
+    mangaPlans?: MangaPlan[];
     /** 人物志：角色当前状态聚合结果（从编年录刷新后存档，打开页面直接显示）。 */
     roleStatus?: RoleStatusCard[];
     /** 漫剧分镜结果缓存：章号 → 分镜（持久化，刷新不丢）。 */
@@ -796,6 +975,8 @@ export interface NovelConfig {
     model: string;
     /** LLM reasoning effort: off = no thinking; low/high/max = thinking intensity. */
     reasoningEffort: 'off' | 'low' | 'high' | 'max';
+    /** 分析类任务（提炼/拆书/反推大纲等）的推理档位；默认 low，不受上面写作档位影响。 */
+    analysisReasoning: 'off' | 'low' | 'high' | 'max';
     /** Target characters per chapter. */
     chapterChars: number;
     /** Max output tokens per chapter call. */
@@ -961,6 +1142,15 @@ export type JobFrame = {
     no: number;
     chars: number;
     draft: string;
+} | {
+    type: 'outline-progress';
+    done: number;
+    total: number;
+    phase: string;
+} | {
+    type: 'outline-done';
+    outline: string;
+    chars: number;
 } | {
     type: 'error';
     no: number;
@@ -1032,6 +1222,7 @@ export interface ConfigPatch {
     provider?: string;
     model?: string;
     reasoningEffort?: 'off' | 'low' | 'high' | 'max';
+    analysisReasoning?: 'off' | 'low' | 'high' | 'max';
     chapterChars?: number;
     maxTokens?: number;
     reviewPassScore?: number;

package/lib/types/style-library.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 风格库（内置模板）：漫剧方案的视觉基底 + 可叠加滤镜。
+ * 字段来自通用风格模板（豆包整理），keywords 即风格前缀词块，生成时直接套用。
+ */
+export type StyleCategory = '3d' | 'game' | '2d' | 'film' | 'craft';
+export interface ArtStyle {
+    id: string;
+    /** 风格名（用户可见）。 */
+    name: string;
+    category: StyleCategory;
+    /** 特点一句话（卡片展示）。 */
+    traits: string;
+    /** 风格关键词/前缀（生成角色图/视频提示词时套用）。 */
+    keywords: string;
+    /** 是否可作为滤镜叠加在基底风格之上（影视实验类；缺省 false）。 */
+    stackable?: boolean;
+    /** 默认推荐排序权重（0-1，推荐池排序参考）。 */
+    weight?: number;
+}
+export declare const STYLE_CATEGORIES: ReadonlyArray<{
+    id: StyleCategory;
+    label: string;
+    icon: string;
+    desc: string;
+}>;
+/** 内置风格模板（18 个）。 */
+export declare const STYLE_LIBRARY: ArtStyle[];
+/** 按分类取风格。 */
+export declare function stylesByCategory(category: StyleCategory): ArtStyle[];
+/** 取单个风格（未找到返回 undefined）。 */
+export declare function findStyle(id: string): ArtStyle | undefined;
+/** 按基底 + 滤镜拼接风格关键词（角色图/分镜/视频提示词共用；缺省回退 3D 动漫）。 */
+export declare function styleKeywords(styleId?: string, filterId?: string): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@waterwx/dsh-novel-forge",
   "description": "AI 编译小说工作台 for the dsh web GUI: import a novel outline (docx/text), plan chapters with LLM, generate chapter by chapter (3000-4000 chars each), and save every chapter as Markdown into your chosen output folder.",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -81,6 +81,7 @@
     "lib/**/*.d.ts",
     "lib/**/*.d.ts.map",
     "src",
+    "assets/styles",
     "scripts/patch-schemastery.mjs",
     "cordis.patch.yml",
     "README.md"

package/src/client/api.ts

@@ -75,6 +75,31 @@ export class NovelApi {
     return postJson<{ ok: boolean; bookName: string }>(NOVEL_API.saveOutline, { text })
   }
 
+  /** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流）。 */
+  async outlineReverse(onFrame: (frame: JobFrame) => void): Promise<void> {
+    await this.streamJob(NOVEL_API.outlineReverse, {}, onFrame)
+  }
+
+  /** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
+  async storyboardTable(chapterNo: number, skeleton: import('../protocol.ts').StoryboardSkeleton, styleId?: string, filterId?: string): Promise<import('../protocol.ts').StoryboardTableResponse> {
+    return postJson<import('../protocol.ts').StoryboardTableResponse>(NOVEL_API.storyboardTable, { chapterNo, skeleton, styleId, filterId })
+  }
+
+  /** 漫剧方案管理：create / remove / activate。 */
+  async manhuaPlans(req: import('../protocol.ts').MangaPlansRequest): Promise<import('../protocol.ts').MangaPlansResponse> {
+    return postJson<import('../protocol.ts').MangaPlansResponse>(NOVEL_API.manhuaPlans, req)
+  }
+
+  /** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
+  async storyboardPrompts(chapterNo: number, table: import('../protocol.ts').StoryboardTable, styleId?: string, filterId?: string): Promise<import('../protocol.ts').StoryboardPromptsResponse> {
+    return postJson<import('../protocol.ts').StoryboardPromptsResponse>(NOVEL_API.storyboardPrompts, { chapterNo, table, styleId, filterId })
+  }
+
+  /** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
+  async storyboardSkeleton(chapterNo: number): Promise<import('../protocol.ts').StoryboardSkeletonResponse> {
+    return postJson<import('../protocol.ts').StoryboardSkeletonResponse>(NOVEL_API.storyboardSkeleton, { chapterNo })
+  }
+
   /** 开书想法 → AI 大纲：生成 count 个方案（换批时传 exclude 避开已暂留方向）。 */
   async outlineSuggest(idea: string, count?: number, exclude?: string[]): Promise<import('../protocol.ts').OutlineSuggestResponse> {
     return postJson<import('../protocol.ts').OutlineSuggestResponse>(NOVEL_API.outlineSuggest, { idea, count, exclude })
@@ -259,11 +284,21 @@ export class NovelApi {
     return postJson<import('../protocol.ts').BookImportDirResponse>(NOVEL_API.bookshelfImportDir, { outputDir })
   }
 
-  /** 导入 txt/md 全本（Mode B）：拆章建项目并登记书架。 */
+  /** 导入 txt/md 全本（Mode B）：服务器本地文件路径模式。 */
   async bookImportText(filePath: string, outputDir?: string): Promise<import('../protocol.ts').BookImportTextResponse> {
     return postJson<import('../protocol.ts').BookImportTextResponse>(NOVEL_API.bookshelfImportText, { filePath, outputDir })
   }
 
+  /** 拆章预览（浏览器上传全文，不落盘）：返回识别到的章节与跳过清单。 */
+  async bookImportTextPreview(text: string, fileName?: string): Promise<import('../protocol.ts').BookImportTextPreviewResponse> {
+    return postJson<import('../protocol.ts').BookImportTextPreviewResponse>(NOVEL_API.bookshelfImportTextPreview, { text, fileName })
+  }
+
+  /** 导入 txt/md 全本（Mode B）：浏览器上传全文内容模式。 */
+  async bookImportTextContent(text: string, fileName: string, outputDir?: string): Promise<import('../protocol.ts').BookImportTextResponse> {
+    return postJson<import('../protocol.ts').BookImportTextResponse>(NOVEL_API.bookshelfImportText, { text, fileName, outputDir })
+  }
+
   /** 生产单：启动批量生产（区间或新增 N 章；计划不足自动补）。 */
   async runStart(req: import('../protocol.ts').RunStartRequest): Promise<import('../protocol.ts').RunState> {
     return postJson<import('../protocol.ts').RunState>(NOVEL_API.runStart, req)

package/src/client/locales.ts

@@ -144,12 +144,14 @@ export const zh = {
   'settings.model': '模型',
   'settings.modelCustom': '自定义…',
   'settings.modelCustomPlaceholder': '输入任意模型 id',
-  'settings.reasoningEffort': '思考强度 (reasoningEffort)',
+  'settings.reasoningEffort': '写作类任务思考强度 (reasoningEffort)',
+  'settings.reasoningHint': '章节生成/润色/重写/审稿等写作任务使用；关掉更省更快。',
+  'settings.analysisReasoning': '分析类任务思考强度（提炼/拆书/反推大纲）',
+  'settings.analysisReasoningHint': '角色/场景/道藏提炼、拆书、反推大纲等一次性分析任务默认 low，保证质量，不受上面写作档位影响。',
   'settings.reasoning.off': 'off · 关闭思考（推荐日常写文）',
   'settings.reasoning.low': 'low · 低思考',
   'settings.reasoning.high': 'high · 高思考',
   'settings.reasoning.max': 'max · 最高思考（质检/推演）',
-  'settings.reasoningHint': 'off 最快最省；high/max 更慢更贵但推理更强',
   'settings.theme': '主题',
   'settings.themeLiquid': 'iOS 液态玻璃（绿）',
   'settings.themeClassic': '经典毛玻璃（蓝）',
@@ -295,7 +297,9 @@ export const en: Record<string, string> = {
   'settings.model': 'Model',
   'settings.modelCustom': 'Custom…',
   'settings.modelCustomPlaceholder': 'Type any model id',
-  'settings.reasoningEffort': 'Reasoning effort',
+  'settings.reasoningEffort': 'Writing-task reasoning effort',
+  'settings.analysisReasoning': 'Analysis-task reasoning (extract / breakdown / reverse outline)',
+  'settings.analysisReasoningHint': 'One-off analysis tasks (roles/scenes/bible extract, breakdown, reverse outline) default to low; not affected by the writing-level switch.',
   'settings.reasoning.off': 'off · no thinking (recommended)',
   'settings.reasoning.low': 'low',
   'settings.reasoning.high': 'high',