@waterwx/dsh-novel-forge 1.7.2 → 1.8.0

package/lib/types/author-assets.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 作者资产库/总数据（跨书）— 按作者维度聚合的可复用资产。
+ * 与书架同惯例持久化到 ~/.dsh/dsh-novel-forge-author-assets.json。
+ * 提供读取/持久化/新增或更新/删除，以及「导入默认」：把书架书的写作资产/角色 +
+ * 内置全局库（题材/反AI规则/风格模板/推进模式）批量沉淀成资产条目（默认库）。
+ */
+import type { AuthorAssetLibrary, AuthorStyleAsset } from './protocol.ts';
+/** 作者资产库配置文件路径。 */
+export declare function authorAssetsFile(): string;
+/** 读取作者资产库（不存在/损坏则返回空库，不抛错）。 */
+export declare function loadAuthorAssets(): AuthorAssetLibrary;
+/** 持久化作者资产库。 */
+export declare function saveAuthorAssets(library: AuthorAssetLibrary): void;
+/** 新建一条资产（自动生成 id 与时间戳）。 */
+export declare function createAuthorAsset(input: Omit<AuthorStyleAsset, 'id' | 'createdAt' | 'updatedAt'>): AuthorStyleAsset;
+/** 按 id 更新一条资产；不存在则追加。 */
+export declare function upsertAuthorAsset(input: AuthorStyleAsset): AuthorAssetLibrary;
+/** 删除一条资产；返回更新后的资产库。 */
+export declare function removeAuthorAsset(id: string): AuthorAssetLibrary;
+/**
+ * 导入默认：把书架所有书的写作资产/角色 + 内置全局库批量沉淀到作者资产库。
+ * 按 `kind:name` 去重（已存在则跳过），不覆盖用户已有条目。
+ * @returns 更新后的资产库。
+ */
+export declare function importDefaultAuthorAssets(): AuthorAssetLibrary;

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

@@ -184,4 +184,22 @@ export declare class NovelApi {
     assistantClear(): Promise<{
         ok: boolean;
     }>;
+    /** 作者资产库/总数据：读取跨书可复用资产。 */
+    authorAssets(): Promise<import('../protocol.ts').AuthorAssetsResponse>;
+    /** 作者资产库：新增/更新一条资产（upsert by id）。 */
+    authorAssetsUpsert(asset: import('../protocol.ts').AuthorStyleAsset): Promise<import('../protocol.ts').AuthorAssetsResponse>;
+    /** 作者资产库：删除一条资产。 */
+    authorAssetsRemove(id: string): Promise<import('../protocol.ts').AuthorAssetsResponse>;
+    /** 作者资产库：导入默认（书架书的写作资产/角色 + 内置全局库）批量沉淀。 */
+    authorAssetsImportDefault(): Promise<import('../protocol.ts').AuthorAssetsResponse>;
+    /** 改编模式 P0：上传全文 → 原文设定卡片 / 可改范围矩阵。 */
+    adaptAnalyze(text: string, filePath?: string): Promise<import('../protocol.ts').AdaptAnalyzeResponse>;
+    /** 改编模式 P1：确认要改的维度 → 生成映射表/改编规则/联动影响清单。 */
+    adaptPropose(req: import('../protocol.ts').AdaptProposeRequest): Promise<import('../protocol.ts').AdaptProposeResponse>;
+    /** 改编模式 P2：执行术语替换（全局替换 + 命中统计 + 改编文本预览）。 */
+    adaptExecute(req: import('../protocol.ts').AdaptExecuteRequest): Promise<import('../protocol.ts').AdaptExecuteResponse>;
+    /** 主题自定义背景：上传图片，服务端存盘并返回可访问 URL。 */
+    themeBackgroundUpload(dataUrl: string): Promise<{
+        url: string;
+    }>;
 }

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

@@ -0,0 +1,4 @@
+import type { NovelApi } from '../api.ts';
+export declare function AdaptModeView({ api }: {
+    api: NovelApi;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,4 @@
+import type { NovelApi } from '../api.ts';
+export declare function AuthorAssetsView({ api }: {
+    api: NovelApi;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,20 @@
+import type { NovelApi } from '../api.ts';
+import type { BookshelfSnapshot } from '../../protocol.ts';
+export declare function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenSettings, onTheme, onBackground, onOpacity, adaptEnabled }: {
+    api: NovelApi;
+    shelf: BookshelfSnapshot;
+    onOpenBook: (id: string) => void;
+    onReadBook: (id: string) => void;
+    onAddBook: () => void;
+    onImportBook: () => void;
+    /** 兼容旧入口：首页设置现为独立设置页，此回调保留但不再使用。 */
+    onOpenSettings?: () => void;
+    /** 主题/模式/密度变化回调（供面板根容器实时生效）。 */
+    onTheme?: (theme: 'liquid' | 'neumorph' | 'macos' | 'clay', mode: 'system' | 'light' | 'dark', density: 'comfort' | 'compact' | 'spacious') => void;
+    /** 自定义背景变化回调。 */
+    onBackground?: (bg: string | undefined, blur: number) => void;
+    /** 玻璃透明度变化回调。 */
+    onOpacity?: (n: number) => void;
+    /** 是否启用改编模式（默认 false=隐藏入口）。 */
+    adaptEnabled?: boolean;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,5 @@
+import type { BookshelfSnapshot } from '../../protocol.ts';
+export declare function ProgressHomeView({ shelf, onOpenBook }: {
+    shelf: BookshelfSnapshot;
+    onOpenBook: (id: string) => void;
+}): import("react").JSX.Element;

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * 客户端文件文本智能解码：兼容 UTF-8 BOM / UTF-16 / UTF-8 / GB18030(GBK)。
+ * 浏览器 File.text() 固定按 UTF-8 解码，GBK 中文网文 txt 会乱码，这里兜底。
+ */
+/**
+ * 读取一个 File 的文本，按编码探测兜底解码。
+ * @returns 解码后的文本。
+ */
+export declare function readFileTextSmart(file: File): Promise<string>;

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, MangaRoleCandidate, Volume, WorldState } from './protocol.ts';
+import type { AdaptationDimension, AdaptAnalyzeResponse, AdaptationMapping, AdaptProposeResponse, 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 */
@@ -217,6 +217,29 @@ export declare function generateStoryboardSkeleton(ctx: Context, config: NovelCo
  * 两阶段：分批提取章节事件摘要 → 汇总生成大纲。不修改章节/设定，只返回大纲文本。
  */
 export declare function reverseOutlineFromChapters(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, onProgress?: (done: number, total: number, phase: string) => void): Promise<string>;
+/**
+ * 改编模式 P0：全文分析 → 原文设定卡片 / 可改范围矩阵。
+ * 拆章统计 + 取样正文，让 LLM 一次输出结构化 JSON：
+ * { bookName, outline, dimensions: [{key,title,mutability,current,evidence,candidates,impact,risk}] }。
+ */
+export declare function analyzeAdaptation(ctx: Context, config: NovelConfig, text: string): Promise<AdaptAnalyzeResponse>;
+/** 改编方案：由用户勾选的维度与新值，生成 LLM 映射表/规则/影响清单。 */
+export declare function proposeAdaptation(ctx: Context, config: NovelConfig, text: string, selections: Array<{
+    key: string;
+    title: string;
+    current: string;
+    target: string;
+    mutability: string;
+}>, dimensions?: AdaptationDimension[]): Promise<AdaptProposeResponse>;
+/** 剧本术语替换执行：按映射表做精确替换并统计命中。 */
+export declare function applyAdaptationReplacements(text: string, mappings: AdaptationMapping[]): {
+    adaptedText: string;
+    hits: Array<{
+        source: string;
+        target: string;
+        count: number;
+    }>;
+};
 /**
  * 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
  * 批量生成时整体开销约省 25%）。

package/lib/types/index.d.ts

@@ -57,6 +57,14 @@ export interface Config {
     imageApiModel?: string;
     /** 是否启用豆包生图（旧字段，兼容迁移用）。 */
     imageApiEnabled?: boolean;
+    /** 自定义背景图（URL / dataURL / 服务端路径引用）。 */
+    themeBackground?: string;
+    /** 自定义背景遮罩/模糊强度 0-80。 */
+    themeBackgroundBlur?: number;
+    /** 玻璃透明度 0-100（100=当前原样）。 */
+    themeOpacity?: number;
+    /** 是否启用改编模式（默认关闭）。 */
+    enableAdaptMode?: boolean;
 }
 export declare const Config: z<Config>;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */

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";
@@ -102,6 +104,24 @@ export declare const NOVEL_API: {
     readonly runStatus: "/api/dsh-novel-forge/run/status";
     readonly config: "/api/dsh-novel-forge/config";
     readonly openFolder: "/api/dsh-novel-forge/open-folder";
+    /** 作者资产库/总数据：读取个人跨书资产（笔法/红线/套路/角色模板/世界观模板）。 */
+    readonly authorAssets: "/api/dsh-novel-forge/author-assets";
+    /** 作者资产库：新增/更新一条资产（upsert by id）。 */
+    readonly authorAssetsUpsert: "/api/dsh-novel-forge/author-assets/upsert";
+    /** 作者资产库：删除一条资产。 */
+    readonly authorAssetsRemove: "/api/dsh-novel-forge/author-assets/remove";
+    /** 作者资产库：导入默认（书架书的写作资产/角色 + 内置全局库）批量沉淀。 */
+    readonly authorAssetsImportDefault: "/api/dsh-novel-forge/author-assets/import-default";
+    /** 改编模式：上传全文 → 分析 → 原文设定卡片/可改范围矩阵。 */
+    readonly adaptAnalyze: "/api/dsh-novel-forge/adapt/analyze";
+    /** 改编模式：确认要改的维度 → 生成映射表/改编规则/联动影响清单。 */
+    readonly adaptPropose: "/api/dsh-novel-forge/adapt/propose";
+    /** 改编模式：执行术语替换（全局替换 + 命中统计 + 改编文本预览）。 */
+    readonly adaptExecute: "/api/dsh-novel-forge/adapt/execute";
+    /** 主题自定义背景：上传图片（POST，存盘并返回服务端 URL）。 */
+    readonly themeBackgroundUpload: "/api/dsh-novel-forge/theme/background";
+    /** 主题自定义背景：读取已上传文件（GET prefix，/theme/background/<name>）。 */
+    readonly themeBackgroundGet: "/api/dsh-novel-forge/theme/background";
 };
 /** 书架：一本书的条目。 */
 export interface BookEntry {
@@ -208,10 +228,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;
 }
@@ -239,10 +259,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;
     /** 画面内容：角色动作 + 表情 + 服装/标志物。 */
@@ -251,8 +273,8 @@ export interface StoryboardShot {
     line: string;
     /** 音效（无则空字符串）。 */
     sound: string;
-    /** 光效（如 雨夜顶光 + 手机屏幕冷光）。 */
-    light: string;
+    /** 光效（枚举 id 数组，来自 shot-language 词库）。 */
+    light: LightingId[];
     /** 承接上一镜头结尾状态（位置/动作/情绪/服装）。 */
     prevState: string;
     /** 本镜头结束状态。 */
@@ -1171,6 +1193,14 @@ export interface NovelConfig {
     imageApiModel?: string;
     /** 是否启用生图（= 存在启用条目）。 */
     imageApiEnabled?: boolean;
+    /** 自定义背景图（URL 或 dataURL 或服务端路径引用；空 = 使用主题默认背景）。 */
+    themeBackground?: string;
+    /** 自定义背景遮罩/模糊强度 0-80（0 = 不遮罩）。 */
+    themeBackgroundBlur?: number;
+    /** 玻璃透明度 0-100（100=当前原样，越小越透，新拟态/黏土可见背景图）。 */
+    themeOpacity?: number;
+    /** 是否启用改编模式（默认关闭；发布后开启）。 */
+    enableAdaptMode?: boolean;
 }
 /** GET /status response. */
 export interface StatusResponse {
@@ -1408,6 +1438,13 @@ export interface ConfigPatch {
     imageApiKey?: string;
     imageApiModel?: string;
     imageApiEnabled?: boolean;
+    /** 自定义背景图（URL / dataURL / 服务端路径引用）。 */
+    themeBackground?: string;
+    /** 自定义背景遮罩/模糊强度 0-80。 */
+    themeBackgroundBlur?: number;
+    /** 玻璃透明度 0-100（100=当前原样）。 */
+    themeOpacity?: number;
+    enableAdaptMode?: boolean;
     /** 生图模型库（完整替换保存）。 */
     imageModels?: ImageModelConfig[];
 }
@@ -1569,3 +1606,162 @@ export interface StyleEngineRequest {
     /** 资产名（可选，默认「风格资产 N」）。 */
     name?: string;
 }
+/** 作者资产库中一条可跨书复用的资产（笔法/红线/套路/角色模板/世界观模板等）。 */
+export interface AuthorStyleAsset {
+    /** 稳定 id（本地唯一）。 */
+    id: string;
+    /** 资产名（如「短句快节奏爽文风」「林越式痞坏角色」）。 */
+    name: string;
+    /** 资产类型。 */
+    kind: 'style' | 'antiAi' | 'progression' | 'genre' | 'roleTemplate' | 'worldTemplate' | 'custom';
+    /** 一句话摘要。 */
+    summary: string;
+    /** 资产正文内容（按 kind 约定解读的文本/JSON 描述）。 */
+    content: string;
+    /** 结构化载荷（角色模板/世界观模板等可结构化字段；缺省为 null）。 */
+    structured?: Record<string, unknown>;
+    /** 来源书名（哪本书提炼/收藏而来）。 */
+    sourceBooks: string[];
+    /** 标签。 */
+    tags: string[];
+    /** 来源样本文本（可选）。 */
+    sourceText?: string;
+    /** 创建时间。 */
+    createdAt: string;
+    /** 更新时间。 */
+    updatedAt: string;
+}
+/** 作者资产库（跨书总数据）：按作者维度聚合的可复用资产。 */
+export interface AuthorAssetLibrary {
+    /** 货架版本，便于未来迁移。 */
+    version: 1;
+    items: AuthorStyleAsset[];
+}
+/** GET /author-assets 响应。 */
+export interface AuthorAssetsResponse {
+    assets: AuthorAssetLibrary;
+}
+/** POST /author-assets/upsert 请求：新增或按 id 更新一条资产。 */
+export interface AuthorAssetUpsertRequest {
+    asset: AuthorStyleAsset;
+}
+/** POST /author-assets/remove 请求：删除一条资产。 */
+export interface AuthorAssetRemoveRequest {
+    id: string;
+}
+/** 改编可改范围的单个维度（矩阵的一行）。 */
+export interface AdaptationDimension {
+    /** 维度 key（如 realm/name/goldenFinger…）。 */
+    key: string;
+    /** 维度名（如「大世界」「修为体系」「主角名」「金手指」）。 */
+    title: string;
+    /** 可改度：保留 / 可改影响大 / 可改影响小 / 可自由改 / 仅视觉包装。 */
+    mutability: 'locked' | 'big' | 'small' | 'free' | 'visual';
+    /** 原文当前值（从正文提炼，附证据）。 */
+    current: string;
+    /** 该值在正文中的出现证据（章节/频次，可空）。 */
+    evidence?: string;
+    /** AI 建议的候选新值（可空）。 */
+    candidates?: string[];
+    /** 联动影响说明（改了会影响哪些章节/角色/伏笔/术语）。 */
+    impact: string;
+    /** 风险评级。 */
+    risk: 'high' | 'medium' | 'low';
+}
+/** POST /adapt/analyze 请求：上传全文做改编分析。 */
+export interface AdaptAnalyzeRequest {
+    /** 全文文本（优先）。 */
+    text: string;
+    /** 或服务器端全文文件路径。 */
+    filePath?: string;
+}
+/** POST /adapt/analyze 响应。 */
+export interface AdaptAnalyzeResponse {
+    /** 识别书名（文件名推断或正文首行）。 */
+    bookName: string;
+    /** 拆出的章节数。 */
+    chapters: number;
+    /** 反推的初始大纲（可空）。 */
+    outline?: string;
+    /** 可改范围矩阵。 */
+    dimensions: AdaptationDimension[];
+    /** 分析消耗说明。 */
+    note?: string;
+}
+/** 一条改编映射（原值 → 新值）。 */
+export interface AdaptationMapping {
+    /** 原值（如「林尘」「练气」「青云宗」）。 */
+    source: string;
+    /** 新值（如「楚风」「凝元」「天渊阁」）。 */
+    target: string;
+    /** 适用范围。 */
+    scope: 'name' | 'realm' | 'faction' | 'term' | 'other';
+    /** 说明（可空）。 */
+    note?: string;
+}
+/** 改编规则：哪些必须保留、哪些允许改、一致性约束。 */
+export interface AdaptationRules {
+    /** 必须保留的要素（骨架/人物动机/伏笔逻辑/爽点结构…）。 */
+    preserve: string[];
+    /** 允许改变的要素。 */
+    change: string[];
+    /** 改编红线/一致性要求。 */
+    constraints: string[];
+}
+/** 一组改编方案（映射表 + 规则 + 联动影响清单）。 */
+export interface AdaptationProposal {
+    /** 映射表（原→新）。 */
+    mappings: AdaptationMapping[];
+    /** 改编规则。 */
+    rules: AdaptationRules;
+    /** 联动影响清单。 */
+    impacts: Array<{
+        item: string;
+        detail: string;
+        risk: 'high' | 'medium' | 'low';
+        chapters?: number[];
+    }>;
+}
+/** POST /adapt/propose 请求：由用户勾选的维度 + 新值生成改编方案。 */
+export interface AdaptProposeRequest {
+    /** 原文全文（复用，便于 LLM 核对联动影响）。 */
+    text: string;
+    /** 用户确认要改的维度（含原值与新值）。 */
+    selections: Array<{
+        key: string;
+        title: string;
+        current: string;
+        target: string;
+        mutability: string;
+    }>;
+    /** 若已分析过，可携带完整矩阵作为上下文。 */
+    dimensions?: AdaptationDimension[];
+}
+/** POST /adapt/propose 响应。 */
+export interface AdaptProposeResponse {
+    proposal: AdaptationProposal;
+}
+/** POST /adapt/execute 请求：执行改编（首版为术语替换）。 */
+export interface AdaptExecuteRequest {
+    /** 原文全文。 */
+    text: string;
+    /** 改编映射表。 */
+    mappings: AdaptationMapping[];
+    /** 改编规则（可选，后续逐章改写使用；替换模式暂不依赖）。 */
+    rules?: AdaptationRules;
+    /** 执行模式：首版仅 replace（术语替换）。 */
+    mode?: 'replace' | 'rewrite';
+}
+/** POST /adapt/execute 响应。 */
+export interface AdaptExecuteResponse {
+    /** 改编后的全文。 */
+    adaptedText: string;
+    /** 执行的映射数。 */
+    mappings: number;
+    /** 命中统计：每条映射的替换次数。 */
+    hits: Array<{
+        source: string;
+        target: string;
+        count: number;
+    }>;
+}

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.2",
+  "version": "1.8.0",
   "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"
@@ -95,6 +95,8 @@
     "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 瞬时错误）。