@waterwx/dsh-novel-forge 1.7.0 → 1.7.3

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

@@ -100,6 +100,8 @@ export declare class NovelApi {
     /** 角色库：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

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

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[]>;
 /**
@@ -143,7 +147,10 @@ export declare function testImageEndpoint(baseURL: string, apiKey: string, model
     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/protocol.d.ts

@@ -4,6 +4,8 @@
  * state file format, and the NDJSON generation stream frames all live here so
  * both halves spell exactly one vocabulary.
  */
+import type { ShotSizeId, CameraMoveId, CompositionId, LightingId } from './shot-language.ts';
+import type { StoryFunctionId, EmotionId } from './story-beat-language.ts';
 /** The /api/dsh-novel-forge route family (same-origin, loopback-fenced). */
 export declare const NOVEL_API: {
     readonly status: "/api/dsh-novel-forge/status";
@@ -43,6 +45,8 @@ 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";
     /** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
@@ -206,10 +210,10 @@ export interface StoryboardBeat {
     id: string;
     /** 事件一句话（发生了什么）。 */
     event: string;
-    /** 情绪走向（如 压抑→隐忍→惊惧）。 */
-    emotion: string;
-    /** 叙事功能：铺垫/冲突/转折/高潮/收束/伏笔/人物塑造。 */
-    function: string;
+    /** 情绪走向（情绪词 id 数组，来自 story-beat-language 词库，链式）。 */
+    emotion: EmotionId[];
+    /** 叙事功能（枚举 id，来自 story-beat-language 词库）。 */
+    function: StoryFunctionId;
     /** 因果：承接上一节拍的原因（可选）。 */
     cause?: string;
 }
@@ -220,6 +224,8 @@ export interface StoryboardSkeleton {
     arc: string;
     /** 剧情节拍链（时间顺序，因果连贯）。 */
     beats: StoryboardBeat[];
+    /** 本章全部出镜角色（正文中的确切称谓，去重；漫剧角色库提名地基）。 */
+    characters?: string[];
 }
 /** POST /storyboard/skeleton 请求：生成单章剧情骨架。 */
 export interface StoryboardSkeletonRequest {
@@ -235,10 +241,12 @@ export interface StoryboardShot {
     id: string;
     /** 挂载的节拍 id（骨架中的 b1…）。 */
     beatId: string;
-    /** 景别：远景/全景/中景/近景/特写。 */
-    shot: string;
-    /** 机位与运镜（如 低机位仰拍 + 缓慢推近）。 */
-    camera: string;
+    /** 景别（枚举 id，来自 shot-language 词库）。 */
+    shot: ShotSizeId;
+    /** 机位与运镜（枚举 id 数组，来自 shot-language 词库）。 */
+    camera: CameraMoveId[];
+    /** 构图（可选，枚举 id）。 */
+    composition?: CompositionId;
     /** 时长（秒，1-12）。 */
     duration: number;
     /** 画面内容：角色动作 + 表情 + 服装/标志物。 */
@@ -247,12 +255,16 @@ export interface StoryboardShot {
     line: string;
     /** 音效（无则空字符串）。 */
     sound: string;
-    /** 光效（如 雨夜顶光 + 手机屏幕冷光）。 */
-    light: string;
+    /** 光效（枚举 id 数组，来自 shot-language 词库）。 */
+    light: LightingId[];
     /** 承接上一镜头结尾状态（位置/动作/情绪/服装）。 */
     prevState: string;
     /** 本镜头结束状态。 */
     nextState: string;
+    /** 本镜头出镜角色（引用小说库规范名/漫剧卡名，1-4 个；漫剧角色库提名地基）。 */
+    characters?: string[];
+    /** 本镜头已绑定漫剧卡的 id（定妆图引用，供出图/生视频时按卡取参考图）。 */
+    mangaRoleIds?: string[];
 }
 /** 分镜·导演级：单章分镜表。 */
 export interface StoryboardTable {
@@ -260,6 +272,10 @@ export interface StoryboardTable {
     shots: StoryboardShot[];
     /** 生成时注入的场景卡名称（前端标注消费关系）。 */
     usedScenes?: string[];
+    /** 本章全部出镜角色（各镜头 characters 去重汇总；骨架有则兜底）。 */
+    characters?: string[];
+    /** 本章已绑定漫剧卡的 id（去重汇总，定妆图引用）。 */
+    mangaRoleIds?: string[];
 }
 /** POST /storyboard/table 请求：骨架 → 分镜表。 */
 export interface StoryboardTableRequest {
@@ -281,6 +297,8 @@ export interface StoryboardPrompt {
     shotId: string;
     /** 即梦/视频模型可粘贴的中文提示词（画面+运镜+光效+风格词块）。 */
     text: string;
+    /** 本镜头绑定的漫剧卡 id（定妆图引用：出图/生视频时按卡取 imageUrl/立绘）。 */
+    mangaRoleIds?: string[];
 }
 /** 分镜持久化：单章的分镜产出（骨架 + 分镜表 + 视频提示词，可分别存在）。 */
 export interface ChapterStoryboard {
@@ -335,6 +353,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. */
@@ -979,6 +1103,10 @@ export interface ProjectState {
     plotlines?: Plotline[];
     /** 角色库（作者维护 + AI 提炼的主表）。 */
     roles?: RoleRecord[];
+    /** 漫剧角色库（制作角色投影：从分镜提名导入，独立于小说角色库）。 */
+    mangaRoles?: MangaRoleCard[];
+    /** 短剧精简模式：漫剧角色库按 5-8 上镜角色 / 功能标签 / 关系闭环 / 人设极致化约束。 */
+    shortDramaMode?: boolean;
     /** 场景库（作者维护 + AI 提炼的主表）。 */
     scenes?: SceneCard[];
     /** 视觉世界观规则（生图/生视频必须遵守，从道藏提炼，注入所有提示词）。 */

package/lib/types/shot-language.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 镜头语言词库（分镜规范化基准）。
+ * 分镜表的 shot/camera/composition/light 字段统一从这里取值（英文 id），
+ * 生成提示词时用 zh 中文词块；适配英文平台时用 en。
+ * 目的：让"景别/运镜/构图/光效"有标准词表，避免 LLM 自由发挥导致漂移。
+ */
+/** 景别。 */
+export type ShotSizeId = 'extreme_wide' | 'wide' | 'full' | 'medium' | 'medium_close' | 'close' | 'extreme_close' | 'big_extreme_close';
+/** 运镜/机位。 */
+export type CameraMoveId = 'static' | 'dolly_in' | 'dolly_out' | 'pan_left' | 'pan_right' | 'track_left' | 'track_right' | 'follow' | 'pedestal_up' | 'pedestal_down' | 'orbit' | 'handheld' | 'low_angle' | 'high_angle' | 'over_shoulder';
+/** 构图。 */
+export type CompositionId = 'rule_of_thirds' | 'center' | 'leading_line' | 'foreground' | 'low' | 'overhead' | 'symmetry';
+/** 光效。 */
+export type LightingId = 'front' | 'side' | 'back' | 'top' | 'rembrandt' | 'neon' | 'hard' | 'soft' | 'mood' | 'contrast';
+export interface ShotLangEntry<T extends string> {
+    id: T;
+    /** 中文（提示词/展示用）。 */
+    zh: string;
+    /** 英文（英文平台适配用）。 */
+    en: string;
+    /** 一句话说明（下拉/卡片）。 */
+    hint: string;
+}
+export declare const SHOT_SIZES: readonly ShotLangEntry<ShotSizeId>[];
+export declare const CAMERA_MOVES: readonly ShotLangEntry<CameraMoveId>[];
+export declare const COMPOSITIONS: readonly ShotLangEntry<CompositionId>[];
+export declare const LIGHTINGS: readonly ShotLangEntry<LightingId>[];
+export interface ShotLanguage {
+    shot?: ShotSizeId;
+    camera: CameraMoveId[];
+    composition?: CompositionId;
+    light: LightingId[];
+}
+/** 从中文文本归一化到景别（处理旧数据/LLM 口语）。未知回退 medium。 */
+export declare function normalizeShotSize(text: string | undefined): ShotSizeId;
+/** 从中文文本归一化到运镜列表。 */
+export declare function normalizeCameras(text: string | undefined): CameraMoveId[];
+/** 从中文文本归一化到构图（可选）。 */
+export declare function normalizeComposition(text: string | undefined): CompositionId | undefined;
+/** 从中文文本归一化到光效列表。 */
+export declare function normalizeLightings(text: string | undefined): LightingId[];
+/** 取词条中文（ZHs 合并句子）。 */
+export declare function sizeZh(id: ShotSizeId | undefined): string;
+export declare function cameraZh(ids: CameraMoveId[] | undefined): string;
+export declare function compoZh(id: CompositionId | undefined): string;
+export declare function lightZh(ids: LightingId[] | undefined): string;

package/lib/types/story-beat-language.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 编剧词库（剧情骨架规范化基准）。
+ * 骨架的 function（叙事功能）与 emotion（情绪走向）统一从这里取值（英文 id），
+ * 生成提示词/展示时用 zh 中文。
+ * 目的：让"叙事功能/情绪"有标准词表，避免 LLM 自由发挥导致情绪链漂移。
+ */
+/** 叙事功能（对应节拍在剧情中的作用）。 */
+export type StoryFunctionId = 'exposition' | 'conflict' | 'turn' | 'climax' | 'resolve' | 'foreshadow' | 'character';
+/** 情绪词（低→高能量的情绪阶，角色在节拍中的主要情绪点）。 */
+export type EmotionId = 'calm' | 'indifferent' | 'expectant' | 'curious' | 'alert' | 'suppressed' | 'enduring' | 'worried' | 'irritable' | 'uneasy' | 'terrified' | 'angry' | 'collapsing' | 'resolute' | 'grieved' | 'relieved' | 'bittersweet' | 'triumphant' | 'reborn' | 'numb';
+export interface BeatLangEntry<T extends string> {
+    id: T;
+    /** 中文（展示用）。 */
+    zh: string;
+    /** 英文（英文平台适配用）。 */
+    en: string;
+    /** 一句话说明。 */
+    hint: string;
+}
+/** 叙事功能词表。 */
+export declare const STORY_FUNCTIONS: readonly BeatLangEntry<StoryFunctionId>[];
+/** 情绪词表（按能量/阶段排序）。 */
+export declare const EMOTIONS: readonly BeatLangEntry<EmotionId>[];
+export interface StoryBeatLanguage {
+    function: StoryFunctionId;
+    emotion: EmotionId[];
+}
+/** 从中文归一化叙事功能（未知回退 exposition）。 */
+export declare function normalizeStoryFunction(text: string | undefined): StoryFunctionId;
+/** 从中文文本归一化情绪词列表（可含→箭头链）。 */
+export declare function normalizeEmotions(text: string | undefined): EmotionId[];
+/** 叙事功能中文。 */
+export declare function functionZh(id: StoryFunctionId | undefined): string;
+/** 情绪中文（箭头连接）。 */
+export declare function emotionZh(ids: EmotionId[] | undefined): 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.7.0",
+  "version": "1.7.3",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -80,9 +80,9 @@
     "lib/**/*.js",
     "lib/**/*.js.map",
     "lib/**/*.d.ts",
-    "lib/**/*.d.ts.map",
     "src",
     "assets/styles",
+    "skills",
     "scripts/patch-schemastery.mjs",
     "cordis.patch.yml",
     "README.md"
@@ -94,6 +94,9 @@
     "bundle": "tsdown",
     "watch": "tsdown --watch",
     "typecheck": "tsc --noEmit",
+    "check:styles": "node scripts/check-theme-sizes.mjs",
+    "release": "node scripts/release.mjs",
+    "release:dry": "node scripts/release.mjs --dry-run",
     "test": "vitest run"
   }
 }

package/skills/chapter-batch/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: novel-forge-chapter-batch
+description: 批量生成小说章节并值守处理审稿未过的章节。当用户说「生成 N 章」「连写」「批量生成」「继续写章节」「值守处理未过章节」时使用。依赖 dsh-novel-forge 插件（http://127.0.0.1:3080/api/dsh-novel-forge/*）。
+---
+
+# 小说章节批量生产与值守处理
+
+把「批量生成章节 + 审稿未过处理」固化为可复现流程。所有操作通过 dsh-novel-forge 的 HTTP API 执行。
+
+## 0. 值守纪律（最高优先级，违反即空转）
+
+1. **启动后台任务后立即停下，不轮询、不连续 wait、不做无意义动作**——后台任务（批量生成/处理）由运行时在完成时自动通知。
+2. 只有收到「任务完成」通知或用户新消息时，才继续下一步（读结果 → 处理未过 → 汇报）。
+3. 等待期间可以做「与当前任务无关」的其他有用工作（如用户提出的其他问题、代码改进），但不得为等任务而空转。
+4. 任务因 web 重启中断时：等用户确认或检测到 3080 恢复后，复位卡死章节（generating/error → reset）再续跑，并向用户说明中断原因。
+
+## 1. 前置检查（每次必做）
+
+1. 确认服务在跑：`GET /api/dsh-novel-forge/status` 返回 200，读 `project.chapters` 数量与书名。
+2. 确认目标章节状态：列出 `pending`（待生成）章节号区间，避免重复生成已 approved/rejected 的章。
+3. **串行执行，禁止并行写 project.json**——多个脚本同时调 API 会造成状态互相覆盖（实测教训：第 166 章曾被并发回滚成 rejected）。
+
+## 2. 批量生成
+
+对目标章节区间（如 181-205）逐章串行调用：
+
+```
+POST /api/dsh-novel-forge/generate
+{ "chapterNo": N, "skipReview": false }
+```
+
+- `skipReview: false` 走完整质量门（生成 → 摘要+编年录 → AI 审稿 → 作者复盘）。
+- 响应为 NDJSON 流；找 `{"type":"review","report":{...}}` 帧取 `score`/`passed`。
+- 每章 2-5 分钟；失败自动重试 1 次（间隔 3 秒）。
+- 预估总时长并告知用户（25 章 ≈ 45-75 分钟），放后台跑，期间可并行做别的（只读操作不受影响）。
+- 推荐用 Node 脚本（fetch + 逐章循环），避免 PowerShell 的引号/UTF-8 转义坑；脚本用完删除。
+
+## 2. 未过章节处理（分级策略）
+
+生成完成后汇总：通过 / 未过（rejected）/ 失败（error）。对未过章按此分级：
+
+### A. 无 high（全是 medium/low 主观项）→ 豁免通过
+```
+POST /api/dsh-novel-forge/chapter/approve  { "chapterNo": N }
+```
+主观项（套话/节奏/比喻/心理描写）不值得逐章磨，直接通过。
+
+### B. 有 high 且问题明确（逻辑/设定/时间线/用词）→ 按意见修订 + 验证模式
+1. 取 review 的 high（无 high 取前 3 条 medium），拼指令：
+   `按审稿意见修订（优先处理）：\n[severity] item → suggestion`
+2. `POST /rewrite` `{ chapterNo, instructions }` → 产出 pendingDraft
+3. **验证模式**：`POST /chapter/check` `{ chapterNo, text: draft, previousReport: review }`——携带上一轮报告，LLM 只核对原意见是否解决 + 只挑新增 high，不全新找茬
+4. 判定：`passed || issues 全非 high` → 可接受
+5. 可接受 → `POST /draft/apply` `{ chapterNo, report: { score: max(score,70), passed: true, issues: [], ... } }` 落盘为 approved
+6. 不可接受 → 看剩余 high 是否明确可修 → 第二轮修订（指令更精确，如「把第 141 章的养伤时间线统一为七天」）→ 再验证
+7. **每章最多修订 2 轮**，仍不过 → 保留草稿，标记「待人工」，不硬来
+
+### C. 有 high 但结构性（修订改不好，如逻辑矛盾被坐实）→ 重新生成
+- `POST /draft/discard` 清草稿 → `POST /generate` 整章重写
+- 重新生成后若只剩主观项 → 走 A 豁免
+
+### D. error 状态（无审稿、chars 丢失）→ 重置重生成
+- `POST /chapter/reset`  `{ chapterNo }` → `POST /generate`
+
+### 特殊注意
+- **approved 但 review 有 high**：已通过状态保留，不折腾（high 可能已被正文处理或审稿误标）。
+- **修订指令越精确越有效**：具体数字/行为（如「茶梗尺寸统一为半截指节」）一次就过；泛泛的「修正矛盾」容易改不到位。
+
+## 3. 收尾
+
+1. 最终验证：`GET /status` 读目标区间全部 approved。
+2. 可选：对涉及剧情的章节刷新剧情线进度（`POST /plotlines` `{ op:'refresh', id }`）——注意刷新函数只读最近 8 章摘要，早期章节的线可能刷不准，必要时手动 update progress + link 章节。
+3. 向用户汇报：通过/未过/失败数量 + 每章处理方式 + 遗留待人工项。
+
+## 4. 已知陷阱（血泪教训）
+
+- **并发写 project.json 会互相覆盖**——多个生成/处理任务必须串行。
+- **rewrite 的草稿可能不落盘**（偶发 500 或时序）——应用前检查 `pendingDraft` 是否存在，不存在则重跑 rewrite。
+- **PowerShell 调 API 的引号/中文转义是坑**——统一用 Node 脚本。
+- **status 接口会做数据快照**——以磁盘 novel-project.json 为准复核关键状态。
+- **验证模式 500 偶发**——重试一次即可（LLM 瞬时错误）。

package/src/client/api.ts

@@ -236,6 +236,11 @@ export class NovelApi {
     return postJson<import('../protocol.ts').RolesResponse>(NOVEL_API.roles, req)
   }
 
+  /** 漫剧角色库：从分镜提名 / 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
+  async mangaRoles(req: import('../protocol.ts').MangaRolesRequest): Promise<import('../protocol.ts').MangaRolesResponse> {
+    return postJson<import('../protocol.ts').MangaRolesResponse>(NOVEL_API.mangaRoles, req)
+  }
+
   /** 场景库：AI 提炼 / 采纳 / 更新 / 删除 / 图集。 */
   async scenes(req: import('../protocol.ts').ScenesRequest): Promise<import('../protocol.ts').ScenesResponse> {
     return postJson<import('../protocol.ts').ScenesResponse>(NOVEL_API.scenes, req)

package/src/client/locales.ts

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