@waterwx/dsh-novel-forge 1.4.1 → 1.5.0

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

@@ -18,6 +18,14 @@ export declare class NovelApi {
     }>;
     /** 反推大纲：从已写章节正文反向生成全书总纲（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>;
     /** 拆书分析：对已写章节做结构/人物/文风/卖点体检。 */

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 */
@@ -113,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[]>;
 /**
@@ -182,6 +182,22 @@ 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>;
 /**
  * 反向推大纲：从已写章节正文反推出全书总纲（分卷 + 章节要点 + 主线/人物弧线/伏笔清单）。
  * 两阶段：分批提取章节事件摘要 → 汇总生成大纲。不修改章节/设定，只返回大纲文本。

package/lib/types/protocol.d.ts

@@ -41,6 +41,14 @@ export declare const NOVEL_API: {
     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 扫描已生成章节，输出矛盾问题清单。 */
@@ -190,6 +198,139 @@ export interface BookImportTextPreviewResponse {
     /** 因内容过短被跳过的章节标题列表。 */
     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. */
@@ -674,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 {
@@ -805,6 +950,10 @@ export interface ProjectState {
     scenes?: SceneCard[];
     /** 视觉世界观规则（生图/生视频必须遵守，从道藏提炼，注入所有提示词）。 */
     visualRules?: string[];
+    /** 分镜工作台产出（骨架/分镜表，按章持久化，刷新/切换不丢）。 */
+    storyboards?: ChapterStoryboard[];
+    /** 漫剧方案列表（同一本书的多套视觉演绎：基底风格 + 可选滤镜）。 */
+    mangaPlans?: MangaPlan[];
     /** 人物志：角色当前状态聚合结果（从编年录刷新后存档，打开页面直接显示）。 */
     roleStatus?: RoleStatusCard[];
     /** 漫剧分镜结果缓存：章号 → 分镜（持久化，刷新不丢）。 */

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.1",
+  "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

@@ -80,6 +80,26 @@ export class NovelApi {
     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 })

package/src/client/panel/MangaWorkspace.tsx

@@ -0,0 +1,185 @@
+/**
+ * 漫剧工作台：方案管理（基底风格 + 可选滤镜）→ 分镜（骨架/分镜表，按方案风格生成）。
+ * 骨架为故事层（所有方案共享）；分镜表画面措辞随方案风格。
+ */
+import { useMemo, useState } from 'react'
+import type { NovelApi } from '../api.ts'
+import type { ChapterPlan, MangaPlan, ProjectState } from '../../protocol.ts'
+import { STYLE_LIBRARY, findStyle } from '../../style-library.ts'
+import { StoryboardTab } from './StoryboardTab.tsx'
+import css from './panel.module.css'
+
+export function MangaWorkspace({
+  api,
+  project,
+  chapters,
+  onProjectChanged,
+}: {
+  api: NovelApi
+  project: ProjectState | null
+  chapters: ChapterPlan[]
+  /** 方案变更已持久化后触发（刷新项目）。 */
+  onProjectChanged?: () => void | Promise<void>
+}) {
+  const plans = useMemo(() => project?.mangaPlans ?? [], [project?.mangaPlans])
+  const activePlan = plans.find(p => p.active) ?? null
+  const [showCreate, setShowCreate] = useState(false)
+  const [name, setName] = useState('')
+  const [styleId, setStyleId] = useState('')
+  const [filterId, setFilterId] = useState('')
+  const [busy, setBusy] = useState(false)
+  const [error, setError] = useState('')
+
+  // 基底候选：非 stackable 风格按 weight 降序（推荐池），+ 全部基底风格
+  const baseStyles = useMemo(() => STYLE_LIBRARY.filter(s => s.stackable !== true).sort((a, b) => (b.weight ?? 0) - (a.weight ?? 0)), [])
+  const filterStyles = useMemo(() => STYLE_LIBRARY.filter(s => s.stackable === true), [])
+
+  const mutate = async (req: import('../../protocol.ts').MangaPlansRequest): Promise<boolean> => {
+    setBusy(true)
+    setError('')
+    try {
+      await api.manhuaPlans(req)
+      return true
+    } catch (err) {
+      setError((err as Error).message)
+      return false
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  const createPlan = async (): Promise<void> => {
+    const n = name.trim()
+    if (n === '' || styleId === '') {
+      setError('请填写方案名并选择基底风格')
+      return
+    }
+    const ok = await mutate({ op: 'create', name: n, styleId, filterId: filterId !== '' ? filterId : undefined })
+    if (ok) {
+      setShowCreate(false)
+      setName('')
+      setStyleId('')
+      setFilterId('')
+      await refreshProject()
+    }
+  }
+
+  const refreshProject = async (): Promise<void> => {
+    await onProjectChanged?.()
+  }
+
+  if (project === null) {
+    return <div className={css.card}><span className={css.meta}>请先开书或选择一本书，再进入漫剧工作台。</span></div>
+  }
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 10 }}>
+      {/* ① 方案管理 */}
+      <div className={css.card}>
+        <div className={css.row} style={{ justifyContent: 'space-between', flexWrap: 'wrap' }}>
+          <span className={css.cardTitle}>🎬 漫剧方案</span>
+          <button type="button" className={`${css.button} ${css.buttonPrimary}`} disabled={busy} onClick={() => { setShowCreate(!showCreate) }}>
+            {showCreate ? '收起' : '＋ 新建方案'}
+          </button>
+        </div>
+        <span className={css.meta}>同一本书可建多套视觉演绎（基底风格 + 可选滤镜）；分镜画面措辞随激活方案。</span>
+
+        {showCreate && (
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 8, border: '1px solid var(--nf-info)', borderRadius: 12, padding: 10, marginTop: 8 }}>
+            <div className={css.field}>
+              <label className={css.fieldLabel}>方案名</label>
+              <input className={css.input} value={name} placeholder="例如：《保质期》3D 皮克斯版" onChange={e => { setName(e.target.value) }} />
+            </div>
+            <div className={css.field}>
+              <label className={css.fieldLabel}>基底风格（按推荐度排序）</label>
+              <div style={{ display: 'flex', flexWrap: 'wrap', gap: 6 }}>
+                {baseStyles.map(s => (
+                  <button
+                    key={s.id}
+                    type="button"
+                    className={`${css.button} ${css.buttonSmall} ${styleId === s.id ? css.buttonPrimary : ''}`}
+                    title={s.traits}
+                    onClick={() => { setStyleId(s.id) }}
+                  >
+                    {s.name}
+                  </button>
+                ))}
+              </div>
+            </div>
+            {filterStyles.length > 0 && (
+              <div className={css.field}>
+                <label className={css.fieldLabel}>叠加滤镜（可选）</label>
+                <div style={{ display: 'flex', flexWrap: 'wrap', gap: 6 }}>
+                  <button type="button" className={`${css.button} ${css.buttonSmall} ${filterId === '' ? css.buttonPrimary : ''}`} onClick={() => { setFilterId('') }}>无</button>
+                  {filterStyles.map(s => (
+                    <button
+                      key={s.id}
+                      type="button"
+                      className={`${css.button} ${css.buttonSmall} ${filterId === s.id ? css.buttonPrimary : ''}`}
+                      title={s.traits}
+                      onClick={() => { setFilterId(s.id) }}
+                    >
+                      {s.name}
+                    </button>
+                  ))}
+                </div>
+              </div>
+            )}
+            {error !== '' && <div className={css.importError}>{error}</div>}
+            <div className={css.row}>
+              <button type="button" className={`${css.button} ${css.buttonSmall} ${css.buttonPrimary}`} disabled={busy || name.trim() === '' || styleId === ''} onClick={() => { void createPlan() }}>
+                创建方案
+              </button>
+            </div>
+          </div>
+        )}
+
+        {plans.length === 0 ? (
+          <div className={css.meta} style={{ marginTop: 8 }}>尚无漫剧方案——新建一个方案，选择基底风格开始。</div>
+        ) : (
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 6, marginTop: 8 }}>
+            {plans.map(p => {
+              const style = findStyle(p.styleId)
+              const filter = p.filterId !== undefined ? findStyle(p.filterId) : undefined
+              return (
+                <div
+                  key={p.id}
+                  style={{
+                    display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap',
+                    border: `1px solid ${p.active ? 'var(--nf-accent)' : 'var(--nf-border)'}`, borderRadius: 10, padding: '8px 10px',
+                  }}
+                >
+                  <b>{p.name}</b>
+                  <span className={css.badge}>{style?.name ?? p.styleId}</span>
+                  {filter !== undefined && <span className={css.badge}>＋{filter.name}</span>}
+                  {p.active && <span className={`${css.badge} ${css.badgeDone}`}>激活中</span>}
+                  <div style={{ flex: 1 }} />
+                  {!p.active && (
+                    <button type="button" className={`${css.button} ${css.buttonSmall}`} disabled={busy} onClick={async () => { if (await mutate({ op: 'activate', id: p.id })) await refreshProject() }}>
+                      激活
+                    </button>
+                  )}
+                  <button type="button" className={`${css.button} ${css.buttonSmall}`} disabled={busy} onClick={async () => { if (await mutate({ op: 'remove', id: p.id })) await refreshProject() }}>
+                    删除
+                  </button>
+                </div>
+              )
+            })}
+          </div>
+        )}
+      </div>
+
+      {/* ② 分镜（按激活方案风格） */}
+      {plans.length === 0 ? null : (
+        <StoryboardTab
+          api={api}
+          project={project}
+          chapters={chapters}
+          onProjectChanged={onProjectChanged}
+          styleId={activePlan?.styleId}
+          filterId={activePlan?.filterId}
+        />
+      )}
+    </div>
+  )
+}

package/src/client/panel/NovelPanel.tsx

@@ -17,6 +17,9 @@ import { RunPanel } from './RunPanel.tsx'
 import { CreateBookView } from './CreateBookView.tsx'
 import { ImportModal } from './ImportModal.tsx'
 import { WorldTab } from './WorldTab.tsx'
+import { StoryboardTab } from './StoryboardTab.tsx'
+import { MangaWorkspace } from './MangaWorkspace.tsx'
+import { StyleGallery } from './StyleGallery.tsx'
 import { AuditIssueRow, PlotlineCard, PlotlineHealthPanel, PlotlinePlanPanel, PlotlineSuggestionPanel, RoleCandidateRow, RoleCard, StatCell, TodoRow } from './views.tsx'
 import { extractDocxTextFromBuffer } from '../docx.ts'
 import type {
@@ -43,7 +46,7 @@ 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'
+  | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle' | 'run' | 'manhua' | 'styleLib'
   | 'book' | 'assets'
 
 /** Panel shell props. */
@@ -88,6 +91,8 @@ const NAV_GROUPS: ReadonlyArray<{ id: string; label: string; items: ReadonlyArra
       { id: 'breakdown', label: '拆书分析', icon: '🔍' },
       { id: 'roleImage', label: '角色形象', icon: '🖼️' },
       { id: 'scenes', label: '场景库', icon: '🏞️' },
+      { id: 'styleLib', label: '风格库', icon: '🎨' },
+      { id: 'manhua', label: '漫剧', icon: '🎬' },
       { id: 'run', label: '生产单', icon: '🏭' },
     ],
   },
@@ -1174,7 +1179,8 @@ export function NovelPanel({ controller, api }: NovelPanelProps) {
     setBusyLabel(`生成「${name}」形象锚点…`)
     setError('')
     try {
-      await api.roles({ op: 'visual', name })
+      const activePlan = (project?.mangaPlans ?? []).find(pl => pl.active)
+      await api.roles({ op: 'visual', name, styleId: activePlan?.styleId, filterId: activePlan?.filterId })
       await refresh(false)
       pushProgress(`已生成「${name}」形象锚点`, 'done')
     } catch (err) {
@@ -4384,6 +4390,14 @@ export function NovelPanel({ controller, api }: NovelPanelProps) {
           <RunPanel api={api} totalChapters={chapters.length} />
         )}
 
+        {activeTab === 'styleLib' && (
+          <StyleGallery />
+        )}
+
+        {activeTab === 'manhua' && (
+          <MangaWorkspace api={api} project={project} chapters={chapters} onProjectChanged={() => refresh(false)} />
+        )}
+
         {activeTab === 'breakdown' && (
           <div className={css.card}>
             <div className={css.row} style={{ justifyContent: 'space-between', flexWrap: 'wrap' }}>
@@ -4693,7 +4707,8 @@ export function NovelPanel({ controller, api }: NovelPanelProps) {
                                       setBusyLabel(`精修「${detailRole.name}」提示词…`)
                                       setError('')
                                       try {
-                                        await api.roles({ op: 'promptKit', name: detailRole.name })
+                                        const activePlan = (project?.mangaPlans ?? []).find(pl => pl.active)
+                                        await api.roles({ op: 'promptKit', name: detailRole.name, styleId: activePlan?.styleId, filterId: activePlan?.filterId })
                                         await refresh(false)
                                         pushProgress(`已生成「${detailRole.name}」四类精修提示词`, 'done')
                                       } catch (err) {