@waterwx/dsh-novel-forge 1.6.0 → 1.7.2

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

@@ -98,7 +98,10 @@ export declare class NovelApi {
         no: number;
     }>;
     /** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+    imageTest(req: import('../protocol.ts').ImageTestRequest): Promise<import('../protocol.ts').ImageTestResponse>;
     roles(req: import('../protocol.ts').RolesRequest): Promise<import('../protocol.ts').RolesResponse>;
+    /** 漫剧角色库：从分镜提名 / 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
+    mangaRoles(req: import('../protocol.ts').MangaRolesRequest): Promise<import('../protocol.ts').MangaRolesResponse>;
     /** 场景库：AI 提炼 / 采纳 / 更新 / 删除 / 图集。 */
     scenes(req: import('../protocol.ts').ScenesRequest): Promise<import('../protocol.ts').ScenesResponse>;
     /** 视觉世界观规则：提炼 / 保存。 */

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

@@ -153,7 +153,6 @@ export declare const zh: {
     readonly 'settings.reasoning.max': "max · 最高思考（质检/推演）";
     readonly 'settings.theme': "主题";
     readonly 'settings.themeLiquid': "iOS 液态玻璃（绿）";
-    readonly 'settings.themeClassic': "经典毛玻璃（蓝）";
     readonly 'settings.themeNeumorph': "新拟物（双阴影）";
     readonly 'settings.themeHint': "存于浏览器本地，即时生效";
     readonly 'settings.chapterChars': "每章目标字数";

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

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

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

@@ -0,0 +1,18 @@
+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, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    refresh: () => void | Promise<void>;
+    styleId?: string;
+    filterId?: string;
+    /** 是否启用生图（豆包等出定妆图）。 */
+    imageApiEnabled?: boolean;
+    /** 生图模型库（出定妆图时可选择用哪条）。 */
+    imageModels?: ImageModelConfig[];
+    /** 步骤页聚焦：import=展开并滚动到导入区；cards=滚动到已建漫剧卡列表。 */
+    focus?: 'import' | 'cards';
+    /** 是否显示「已建漫剧卡」列表（第⑤步导入页可隐藏，只留导入区）。 */
+    showCards?: boolean;
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): import("react").JSX.Element;

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

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

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

@@ -1,13 +1,15 @@
 import type { NovelApi } from '../api.ts';
-import type { ProjectState } from '../../protocol.ts';
-export declare function RoleVisualPanel({ api, project, refresh, styleId, filterId, imageApiEnabled, onGotoRoles, onProgress, }: {
+import type { ImageModelConfig, ProjectState } from '../../protocol.ts';
+export declare function RoleVisualPanel({ api, project, refresh, styleId, filterId, imageApiEnabled, imageModels, onGotoRoles, onProgress, }: {
     api: NovelApi;
     project: ProjectState | null;
     refresh: () => void | Promise<void>;
     styleId?: string;
     filterId?: string;
     imageApiEnabled?: boolean;
+    /** 生图模型库（AI 生图时可选择用哪条）。 */
+    imageModels?: ImageModelConfig[];
     onGotoRoles?: () => void;
-    /** 上报到「工作进度」控制台（角色形象页 / 漫剧工作台共用）。 */
+    /** 上报到「AI进度」控制台（角色形象页 / 漫剧工作台共用）。 */
     onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
 }): import("react").JSX.Element;

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

@@ -9,6 +9,6 @@ export declare function SceneLibrary({ api, project, refresh, styleId, filterId,
     styleId?: string;
     /** 可选滤镜风格 id。 */
     filterId?: string;
-    /** 上报到「工作进度」控制台。 */
+    /** 上报到「AI进度」控制台。 */
     onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
 }): import("react").JSX.Element;

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

@@ -1,6 +1,6 @@
 import type { NovelApi } from '../api.ts';
 import type { ChapterPlan, ProjectState } from '../../protocol.ts';
-export declare function StoryboardTab({ api, project, chapters, onProjectChanged, styleId, filterId, onProgress, }: {
+export declare function StoryboardTab({ api, project, chapters, onProjectChanged, styleId, filterId, mode, onGoStep, onProgress, }: {
     api: NovelApi;
     project: ProjectState | null;
     chapters: ChapterPlan[];
@@ -10,6 +10,10 @@ export declare function StoryboardTab({ api, project, chapters, onProjectChanged
     styleId?: string;
     /** 可选滤镜风格 id。 */
     filterId?: string;
-    /** 上报到「工作进度」控制台（分镜三步生成）。 */
+    /** 页面模式：auto=按本章实际进度显示；skeleton/table/prompts=固定显示该步骤（前置不足显示提示，不降级）。 */
+    mode?: 'auto' | 'skeleton' | 'table' | 'prompts';
+    /** 「下一步」按钮回调（1=骨架→2=分镜表→3=提示词），供外层切步骤页。 */
+    onGoStep?: (n: 1 | 2 | 3) => void;
+    /** 上报到「AI进度」控制台（分镜三步生成）。 */
     onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
 }): 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, StoryboardSkeleton, StoryboardTable, StoryboardPrompt, 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, MangaRoleCandidate, 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 */
@@ -109,16 +109,20 @@ export interface RoleVisualPrompt {
     /** 四类精修提示词（立绘/四视图/表情/细节，一次提炼直接产出）。 */
     promptKit?: RoleRecord['promptKit'];
 }
-/**
- * 为单个角色提炼「动漫形象描述词」：扫描该角色出场的已写章节正文，
- * 截取含外貌描写的段落，交给 LLM 提炼中文描述 + 英文绘图标签。
- */
+/** 小说角色库：提炼单个角色的形象锚点并写回角色卡。 */
 export declare function extractRoleVisual(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, roleName: string, styleId?: string, filterId?: string): Promise<RoleVisualPrompt>;
+/** 漫剧角色卡：提炼形象锚点并写回漫剧卡（status → anchored）。 */
+export declare function extractMangaRoleVisual(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, cardId: string, styleId?: string, filterId?: string): Promise<RoleVisualPrompt>;
+/** 小说角色库：角色四类生图提示词精修包（写回角色卡）。 */
+export declare function generateRolePromptKit(ctx: Context, config: NovelConfig, project: ProjectState, roleName: string, styleId?: string, filterId?: string): Promise<RoleRecord['promptKit']>;
+/** 漫剧角色卡：四类生图提示词精修包（写回漫剧卡，status → anchored）。 */
+export declare function generateMangaRolePromptKit(ctx: Context, config: NovelConfig, project: ProjectState, cardId: string, styleId?: string, filterId?: string): Promise<RoleRecord['promptKit']>;
 /**
- * 角色四类生图提示词精修包（promptKit）：以锚点 + 表情清单 + 视觉规则为输入，
- * LLM 产出 立绘/四视图/表情×N/细节 四套 zh+en 提示词（比前端拼装更精炼）。
+ * 漫剧角色库·提名（两段式）：从某章分镜的 characters 提名候选角色名 →
+ * 规则过滤（精确名 + 身份/简称匹配，短名单 ≤5）→ LLM 确认（是/否 + 选哪个，不做开放检索）→
+ * 返回带漫剧卡建议的候选（未匹配时给出「回小说库补提炼 / 漫剧直接创建」判定）。
  */
-export declare function generateRolePromptKit(ctx: Context, config: NovelConfig, project: ProjectState, roleName: string, styleId?: string, filterId?: string): Promise<RoleRecord['promptKit']>;
+export declare function nominateMangaRoles(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<MangaRoleCandidate[]>;
 /** ✨ 从道藏/红线提炼「视觉世界观规则」：生图/生视频必须遵守的设定纠偏（如"商品=人，禁止常规超市商品"）。 */
 export declare function extractVisualRules(ctx: Context, config: NovelConfig, project: ProjectState): Promise<string[]>;
 /**
@@ -136,7 +140,17 @@ 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>;
-export declare function generateRoleReferenceImage(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, name: string, style?: string): Promise<string>;
+/** 生图接口连通性测试（设置页模型条目用）：GET {baseURL}/models，计时返回延迟。 */
+export declare function testImageEndpoint(baseURL: string, apiKey: string, model?: string): Promise<{
+    ok: boolean;
+    ms: number;
+    message?: string;
+    modelFound?: boolean;
+}>;
+/** 小说角色库：生成角色定妆图并写回角色卡（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>;
 /** 🩺 剧情健康检查：基于已写章节数/各线状态/编年录，判断是否需要新线及添加时机。 */
 export declare function analyzePlotlineHealth(ctx: Context, config: NovelConfig, project: ProjectState): Promise<PlotlineHealthReport>;
 /** ✨ AI 剧情方案：基于健康检查结果设计下一阶段方向与建议新线。 */

package/lib/types/index.d.ts

@@ -8,7 +8,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from 'schemastery';
-import type { NovelConfig } from './protocol.ts';
+import type { ImageModelConfig, NovelConfig } from './protocol.ts';
 /** Stable cordis plugin name. */
 export declare const name = "novel-forge";
 /** Services required before the novel-forge surfaces can mount. */
@@ -49,11 +49,13 @@ export interface Config {
     autoAuthorReview?: boolean;
     /** 修订/润色产出草稿后自动附带一次 AI 审查（默认开，可在设置页关闭省 token）。 */
     autoReviewAfterRevise?: boolean;
-    /** 豆包/Seedream 生图 API Key。 */
+    /** 生图模型库（多套并存，启用一条生效）。 */
+    imageModels?: ImageModelConfig[];
+    /** 豆包/Seedream 生图 API Key（旧字段，兼容迁移用）。 */
     imageApiKey?: string;
-    /** 豆包/Seedream 生图模型 ID。 */
+    /** 豆包/Seedream 生图模型 ID（旧字段，兼容迁移用）。 */
     imageApiModel?: string;
-    /** 是否启用豆包生图（默认关）。 */
+    /** 是否启用豆包生图（旧字段，兼容迁移用）。 */
     imageApiEnabled?: boolean;
 }
 export declare const Config: z<Config>;

package/lib/types/protocol.d.ts

@@ -43,12 +43,16 @@ export declare const NOVEL_API: {
     readonly bookshelfImportTextPreview: "/api/dsh-novel-forge/bookshelf/import-text/preview";
     /** 漫剧方案管理：create/remove/activate。 */
     readonly manhuaPlans: "/api/dsh-novel-forge/manhua/plans";
+    /** 漫剧角色库：从分镜提名（规则+LLM两段式）/ 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
+    readonly mangaRoles: "/api/dsh-novel-forge/manga/roles";
     /** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
     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 imageTest: "/api/dsh-novel-forge/image-test";
     /** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
     readonly reset: "/api/dsh-novel-forge/reset";
     /** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
@@ -218,6 +222,8 @@ export interface StoryboardSkeleton {
     arc: string;
     /** 剧情节拍链（时间顺序，因果连贯）。 */
     beats: StoryboardBeat[];
+    /** 本章全部出镜角色（正文中的确切称谓，去重；漫剧角色库提名地基）。 */
+    characters?: string[];
 }
 /** POST /storyboard/skeleton 请求：生成单章剧情骨架。 */
 export interface StoryboardSkeletonRequest {
@@ -251,6 +257,10 @@ export interface StoryboardShot {
     prevState: string;
     /** 本镜头结束状态。 */
     nextState: string;
+    /** 本镜头出镜角色（引用小说库规范名/漫剧卡名，1-4 个；漫剧角色库提名地基）。 */
+    characters?: string[];
+    /** 本镜头已绑定漫剧卡的 id（定妆图引用，供出图/生视频时按卡取参考图）。 */
+    mangaRoleIds?: string[];
 }
 /** 分镜·导演级：单章分镜表。 */
 export interface StoryboardTable {
@@ -258,6 +268,10 @@ export interface StoryboardTable {
     shots: StoryboardShot[];
     /** 生成时注入的场景卡名称（前端标注消费关系）。 */
     usedScenes?: string[];
+    /** 本章全部出镜角色（各镜头 characters 去重汇总；骨架有则兜底）。 */
+    characters?: string[];
+    /** 本章已绑定漫剧卡的 id（去重汇总，定妆图引用）。 */
+    mangaRoleIds?: string[];
 }
 /** POST /storyboard/table 请求：骨架 → 分镜表。 */
 export interface StoryboardTableRequest {
@@ -279,6 +293,8 @@ export interface StoryboardPrompt {
     shotId: string;
     /** 即梦/视频模型可粘贴的中文提示词（画面+运镜+光效+风格词块）。 */
     text: string;
+    /** 本镜头绑定的漫剧卡 id（定妆图引用：出图/生视频时按卡取 imageUrl/立绘）。 */
+    mangaRoleIds?: string[];
 }
 /** 分镜持久化：单章的分镜产出（骨架 + 分镜表 + 视频提示词，可分别存在）。 */
 export interface ChapterStoryboard {
@@ -333,6 +349,112 @@ export interface MangaPlansRequest {
 export interface MangaPlansResponse {
     plans: MangaPlan[];
 }
+/** 漫剧角色卡：制作角色（要建模/出图/锁一致性的「上镜角色」），与小说角色库弱关联。 */
+export interface MangaRoleCard {
+    /** 稳定 id。 */
+    id: string;
+    /** 来源小说角色名（只读追溯，非强外键；禁止反向写回小说库）。 */
+    sourceRoleName?: string;
+    /** 漫剧用名（可短剧化改名）。 */
+    name: string;
+    /** 身份一句话。 */
+    identity: string;
+    /** 核心功能：主角/导师/感情线/反派/搭档/线人/功能性。 */
+    coreFunction: 'protagonist' | 'mentor' | 'love_interest' | 'antagonist' | 'sidekick' | 'informant' | 'functional';
+    /** 与主角的关系。 */
+    protagonistRelation: 'enemy' | 'friend' | 'mentor' | 'lover' | 'exploit' | 'neutral';
+    /** 口头禅/说话方式（配音一致性）。 */
+    speechStyle: string;
+    /** ≤3 个极致性格标签。 */
+    traits: string[];
+    /** 1-2 个辨识度外貌点。 */
+    appearance: string;
+    /** 3-5 个关键剧情节点。 */
+    keyScenes: string[];
+    /** 上场集数（分镜提名导入时记录）。 */
+    appearsInEpisodes: number[];
+    /** 待匹配 → 待确认 → 已导入 → 已定妆 → 已归档。 */
+    status: 'pending_match' | 'pending_confirm' | 'imported' | 'anchored' | 'archived';
+    /** 形象资产（沿用小说角色库同款结构）。 */
+    imagePrompt?: RoleRecord['imagePrompt'];
+    /** 情绪表情清单（锚点提炼时产出）。 */
+    expressions?: string[];
+    /** 四类精修生图提示词（立绘/四视图/表情/细节）。 */
+    promptKit?: RoleRecord['promptKit'];
+    /** 角色参考图。 */
+    imageUrl?: string;
+    /** 图集（图像锚点）。 */
+    gallery?: RoleImage[];
+    /** 生成锚点/精修时的方案风格 id（旧风格检测用）。 */
+    promptStyleId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** 分镜提名 → 小说角色库匹配的一条候选。 */
+export interface MangaRoleCandidate {
+    /** 分镜里的原始称谓（正文确切用法）。 */
+    rawName: string;
+    /** matched=命中小说角色；ambiguous=多个候选待定；not_in_library=小说库没有；already_imported=已建漫剧卡（跳过）。 */
+    verdict: 'matched' | 'ambiguous' | 'not_in_library' | 'already_imported';
+    /** 规则阶段候选短名单（≤5，精确名优先 + 身份/简称匹配）。 */
+    matches: Array<{
+        roleName: string;
+        reason: string;
+    }>;
+    /** LLM/规则确认的命中角色名（ambiguous 时可能为空）。 */
+    matchedRoleName?: string;
+    /** not_in_library 时给出建议：backfill=正文有该称谓但小说库漏提炼（回小说库补）；manga_new=漫剧新增角色（直接建卡）。 */
+    novelHint?: 'backfill' | 'manga_new';
+    /** 采纳时预填的漫剧卡建议。 */
+    suggested: {
+        name: string;
+        identity: string;
+        coreFunction: MangaRoleCard['coreFunction'];
+        protagonistRelation: MangaRoleCard['protagonistRelation'];
+        speechStyle: string;
+        traits: string[];
+        appearance: string;
+        keyScenes: string[];
+    };
+}
+/** POST /manga/roles 请求：漫剧角色库操作。 */
+export interface MangaRolesRequest {
+    op: 'nominate' | 'adopt' | 'update' | 'remove' | 'visual' | 'promptKit' | 'image' | 'removeImage' | 'imageGenerate' | 'mode';
+    /** op='mode'：短剧精简模式开关。 */
+    shortDramaMode?: boolean;
+    /** op='nominate'：从哪章分镜提名角色。 */
+    chapterNo?: number;
+    /** op='adopt' / op='update'：漫剧角色卡。 */
+    card?: MangaRoleCard;
+    /** op='remove' / 'visual' / 'promptKit' / 'image' / 'removeImage' / 'imageGenerate'：漫剧卡 id。 */
+    id?: string;
+    /** op='visual' / 'promptKit'：漫剧方案基底风格 id。 */
+    styleId?: string;
+    /** 可选滤镜风格 id。 */
+    filterId?: string;
+    /** op='image'：定妆图 dataURL。 */
+    dataUrl?: string;
+    /** op='image'：图集用途标签（立绘/四视图/表情-x/场景/细节）；缺省视为角色参考图（imageUrl）。 */
+    label?: string;
+    /** op='imageGenerate'：漫画风格预设 id（可选）。 */
+    style?: string;
+    /** op='imageGenerate'：生图模型库条目 id（缺省用启用条目）。 */
+    modelId?: string;
+}
+/** POST /manga/roles 响应。 */
+export interface MangaRolesResponse {
+    cards: MangaRoleCard[];
+    /** op='nominate' 时的 AI 提名候选。 */
+    candidates?: MangaRoleCandidate[];
+    /** op='visual' 时的形象锚点（已写入漫剧卡）。 */
+    visual?: RoleRecord['imagePrompt'];
+    /** op='promptKit' 时的四类精修提示词包（已写入漫剧卡）。 */
+    promptKit?: RoleRecord['promptKit'];
+    /** op='image' / 'imageGenerate' 时的定妆图 dataURL（已写入漫剧卡）。 */
+    imageUrl?: string;
+    /** op='mode' 时的短剧精简模式状态。 */
+    shortDramaMode?: boolean;
+}
 /** Chapter lifecycle states (the writing pipeline's state machine). */
 export type ChapterStatus = 'pending' | 'generating' | 'written' | 'reviewing' | 'approved' | 'rejected' | 'error';
 /** One chapter in the plan. */
@@ -825,11 +947,32 @@ export interface RolesRequest {
     label?: string;
     /** op='imageGenerate' 时的漫画风格预设 id（用于统一角色图与漫画页风格）。 */
     style?: string;
+    /** op='imageGenerate' 时指定生图模型库条目 id（缺省用启用条目）。 */
+    modelId?: string;
     /** op='visual' / op='promptKit' 时的漫剧基底风格 id（角色图按方案风格重出）。 */
     styleId?: string;
     /** op='visual' / op='promptKit' 时的可选滤镜风格 id。 */
     filterId?: string;
 }
+/** POST /image-test 请求：测一个生图接口的连通性与延迟（不落盘）。 */
+export interface ImageTestRequest {
+    /** OpenAI 兼容生图接口地址。 */
+    baseURL: string;
+    /** API Key。 */
+    apiKey: string;
+    /** 模型 id（顺带校验是否在接口模型列表里，可选）。 */
+    model?: string;
+}
+/** POST /image-test 响应。 */
+export interface ImageTestResponse {
+    ok: boolean;
+    /** 连通延迟（毫秒）。 */
+    ms?: number;
+    /** 失败原因。 */
+    message?: string;
+    /** 模型 id 是否出现在接口的模型列表（探测成功时才有）。 */
+    modelFound?: boolean;
+}
 /** POST /roles 响应。 */
 export interface RolesResponse {
     roles: RoleRecord[];
@@ -956,6 +1099,10 @@ export interface ProjectState {
     plotlines?: Plotline[];
     /** 角色库（作者维护 + AI 提炼的主表）。 */
     roles?: RoleRecord[];
+    /** 漫剧角色库（制作角色投影：从分镜提名导入，独立于小说角色库）。 */
+    mangaRoles?: MangaRoleCard[];
+    /** 短剧精简模式：漫剧角色库按 5-8 上镜角色 / 功能标签 / 关系闭环 / 人设极致化约束。 */
+    shortDramaMode?: boolean;
     /** 场景库（作者维护 + AI 提炼的主表）。 */
     scenes?: SceneCard[];
     /** 视觉世界观规则（生图/生视频必须遵守，从道藏提炼，注入所有提示词）。 */
@@ -973,6 +1120,21 @@ export interface ProjectState {
     createdAt: string;
     updatedAt: string;
 }
+/** 生图模型配置（模型库条目，可多套并存，启用一条生效）。 */
+export interface ImageModelConfig {
+    /** 条目 id（本地唯一）。 */
+    id: string;
+    /** 展示名（如「豆包 Seedream」「即梦」）。 */
+    name: string;
+    /** OpenAI 兼容生图接口地址（如 https://ark.cn-beijing.volces.com/api/v3）。 */
+    baseURL: string;
+    /** API Key。 */
+    apiKey: string;
+    /** 生图模型 id（如 doubao-seedream-5-0-pro-260628）。 */
+    model: string;
+    /** 是否启用（同时只启用一条）。 */
+    enabled: boolean;
+}
 /** Runtime config surface exposed to the panel (subset of plugin Config). */
 export interface NovelConfig {
     /** Absolute path of the default docx outline to load. */
@@ -999,11 +1161,15 @@ export interface NovelConfig {
     autoAuthorReview: boolean;
     /** 修订/润色产出草稿后是否自动附带一次 AI 审查（工作区显示新稿评分与剩余问题）。 */
     autoReviewAfterRevise: boolean;
-    /** 豆包/Seedream 生图 API Key（保存在服务端配置，不暴露给前端明文回显）。 */
+    /** 生图模型库（多套并存，启用一条生效；旧 imageApiKey/imageApiModel 自动迁移为一条）。 */
+    imageModels?: ImageModelConfig[];
+    /** 运行时生效的生图接口地址（= 启用条目，兼容旧代码读取）。 */
+    imageBaseUrl?: string;
+    /** 运行时生效的生图 API Key（= 启用条目，兼容旧代码读取）。 */
     imageApiKey?: string;
-    /** 豆包/Seedream 生图模型 ID（如 doubao-seedream-5-0-pro-260628）。 */
+    /** 运行时生效的生图模型 id（= 启用条目，兼容旧代码读取）。 */
     imageApiModel?: string;
-    /** 是否启用豆包生图（默认关，避免误调用付费 API）。 */
+    /** 是否启用生图（= 存在启用条目）。 */
     imageApiEnabled?: boolean;
 }
 /** GET /status response. */
@@ -1242,6 +1408,8 @@ export interface ConfigPatch {
     imageApiKey?: string;
     imageApiModel?: string;
     imageApiEnabled?: boolean;
+    /** 生图模型库（完整替换保存）。 */
+    imageModels?: ImageModelConfig[];
 }
 /** One assistant conversation message (persisted per project). */
 export interface AssistantMessage {