@waterwx/dsh-novel-forge 1.7.3 → 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

@@ -104,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 {
@@ -1175,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 {
@@ -1412,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[];
 }
@@ -1573,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/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.3",
+  "version": "1.8.0",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"

package/src/author-assets.ts

@@ -0,0 +1,166 @@
+/**
+ * 作者资产库/总数据（跨书）— 按作者维度聚合的可复用资产。
+ * 与书架同惯例持久化到 ~/.dsh/dsh-novel-forge-author-assets.json。
+ * 提供读取/持久化/新增或更新/删除，以及「导入默认」：把书架书的写作资产/角色 + 
+ * 内置全局库（题材/反AI规则/风格模板/推进模式）批量沉淀成资产条目（默认库）。
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { randomBytes } from 'node:crypto'
+import type { AuthorAssetLibrary, AuthorStyleAsset, GenreNode, AntiAiRule, StyleTemplate, ProgressionMode } from './protocol.ts'
+import { BUILTIN_ANTI_AI_RULES, BUILTIN_GENRE_LIBRARY, BUILTIN_PROGRESSION_MODES, BUILTIN_STYLE_TEMPLATES } from './assets.ts'
+import { loadBookshelf } from './bookshelf.ts'
+import { loadProject } from './engine.ts'
+
+/** 作者资产库配置文件路径。 */
+export function authorAssetsFile(): string {
+  return join(homedir(), '.dsh', 'dsh-novel-forge-author-assets.json')
+}
+
+/** 默认空资产库。 */
+function defaultLibrary(): AuthorAssetLibrary {
+  return { version: 1, items: [] }
+}
+
+/** 读取作者资产库（不存在/损坏则返回空库，不抛错）。 */
+export function loadAuthorAssets(): AuthorAssetLibrary {
+  const file = authorAssetsFile()
+  if (!existsSync(file)) return defaultLibrary()
+  try {
+    let raw = readFileSync(file, 'utf8')
+    if (raw.charCodeAt(0) === 0xFEFF) raw = raw.slice(1)
+    const parsed = JSON.parse(raw) as Partial<AuthorAssetLibrary>
+    if (!Array.isArray(parsed.items)) return defaultLibrary()
+    return { version: 1, items: parsed.items }
+  } catch {
+    return defaultLibrary()
+  }
+}
+
+/** 持久化作者资产库。 */
+export function saveAuthorAssets(library: AuthorAssetLibrary): void {
+  const file = authorAssetsFile()
+  mkdirSync(join(homedir(), '.dsh'), { recursive: true })
+  writeFileSync(file, JSON.stringify(library, null, 2), 'utf8')
+}
+
+/** 新建一条资产（自动生成 id 与时间戳）。 */
+export function createAuthorAsset(input: Omit<AuthorStyleAsset, 'id' | 'createdAt' | 'updatedAt'>): AuthorStyleAsset {
+  const now = new Date().toISOString()
+  const asset: AuthorStyleAsset = {
+    ...input,
+    id: 'aa-' + Date.now().toString(36) + '-' + randomBytes(3).toString('hex'),
+    sourceBooks: input.sourceBooks ?? [],
+    tags: input.tags ?? [],
+    createdAt: now,
+    updatedAt: now,
+  }
+  const library = loadAuthorAssets()
+  library.items.push(asset)
+  saveAuthorAssets(library)
+  return asset
+}
+
+/** 按 id 更新一条资产；不存在则追加。 */
+export function upsertAuthorAsset(input: AuthorStyleAsset): AuthorAssetLibrary {
+  const library = loadAuthorAssets()
+  const idx = library.items.findIndex(a => a.id === input.id)
+  const now = new Date().toISOString()
+  if (idx >= 0) {
+    const prev = library.items[idx]
+    if (prev !== undefined) {
+      library.items[idx] = {
+        ...prev,
+        ...input,
+        id: prev.id,
+        createdAt: prev.createdAt,
+        updatedAt: now,
+      }
+    }
+  } else {
+    library.items.push({ ...input, createdAt: input.createdAt !== '' ? input.createdAt : now, updatedAt: now })
+  }
+  saveAuthorAssets(library)
+  return library
+}
+
+/** 删除一条资产；返回更新后的资产库。 */
+export function removeAuthorAsset(id: string): AuthorAssetLibrary {
+  const library = loadAuthorAssets()
+  library.items = library.items.filter(a => a.id !== id)
+  saveAuthorAssets(library)
+  return library
+}
+
+/**
+ * 导入默认：把书架所有书的写作资产/角色 + 内置全局库批量沉淀到作者资产库。
+ * 按 `kind:name` 去重（已存在则跳过），不覆盖用户已有条目。
+ * @returns 更新后的资产库。
+ */
+export function importDefaultAuthorAssets(): AuthorAssetLibrary {
+  const library = loadAuthorAssets()
+  const seen = new Set(library.items.map(a => a.kind + ':' + a.name))
+  const now = new Date().toISOString()
+  const push = (kind: AuthorStyleAsset['kind'], name: string, summary: string, content: string, tags: string[], sourceBooks: string[], structured?: Record<string, unknown>): void => {
+    const key = kind + ':' + name.trim()
+    if (name.trim() === '' || seen.has(key)) return
+    seen.add(key)
+    library.items.push({
+      id: 'aa-' + Date.now().toString(36) + '-' + randomBytes(3).toString('hex'),
+      kind, name: name.trim(), summary: summary.trim(), content: content.trim(),
+      sourceBooks, tags, structured, createdAt: now, updatedAt: now,
+    });
+  };
+
+  // 1) 内置全局库
+  for (const g of flattenGenres(BUILTIN_GENRE_LIBRARY)) {
+    push('genre', g.name, g.description, g.description, ['内置', '题材'], [], { description: g.description, children: (g.children ?? []).map(c => c.name) });
+  }
+  for (const r of BUILTIN_ANTI_AI_RULES) {
+    push('antiAi', r.name, r.avoid, '避免：' + r.avoid + '\n修正：' + r.fix, ['内置', '反AI'], [], { avoid: r.avoid, fix: r.fix, detectPatterns: r.detectPatterns });
+  }
+  for (const t of BUILTIN_STYLE_TEMPLATES) {
+    push('style', t.name, t.description, 
+      '分类：' + t.category + '\n适用：' + t.applicableGenres.join('、') + '\n叙述：' + t.proseRules.join('；') + '\n台词：' + t.dialogueRules.join('；') + '\n语言：' + t.languageRules.join('；') + '\n节奏：' + t.rhythmRules.join('；'),
+      ['内置', '风格模板'], [], { category: t.category, applicableGenres: t.applicableGenres });
+  }
+  for (const p of BUILTIN_PROGRESSION_MODES) {
+    push('progression', p.name, p.driver, '驱动：' + p.driver + '\n期待：' + p.readerExpectation + '\n兑现：' + p.payoffs.join('；') + '\n风险：' + p.risks.join('；'), ['内置', '推进'], [], { driver: p.driver, primary: p.primary });
+  }
+
+  // 2) 书架里的书：写作资产 + 角色模板
+  const shelf = loadBookshelf()
+  for (const book of shelf.books) {
+    const project = loadProject(book.outputDir)
+    if (project === undefined) continue
+    const src = [project.bookName]
+    const assets = project.assets
+    if (assets !== undefined) {
+      if (assets.genre !== undefined) push('genre', assets.genre.name, assets.genre.description, assets.genre.description, ['书', '题材'], src, { description: assets.genre.description });
+      if (assets.primaryProgression !== undefined) push('progression', assets.primaryProgression.name, assets.primaryProgression.driver, '驱动：' + assets.primaryProgression.driver + '\n期待：' + assets.primaryProgression.readerExpectation, src, [], { driver: assets.primaryProgression.driver, primary: true });
+      for (const p of assets.auxiliaryProgressions ?? []) push('progression', p.name, p.driver, '驱动：' + p.driver + '\n期待：' + p.readerExpectation, src, [], { driver: p.driver, primary: false });
+      for (const r of assets.antiAiRules ?? []) push('antiAi', r.name, r.avoid, '避免：' + r.avoid + '\n修正：' + r.fix, src, [], { avoid: r.avoid, fix: r.fix, detectPatterns: r.detectPatterns });
+      for (const s of assets.styleAssets ?? []) push('style', s.name, s.proseRules.join('；'), 
+        '叙述：' + s.proseRules.join('；') + '\n台词：' + s.dialogueRules.join('；') + '\n描写：' + s.descriptionRules.join('；') + '\n边界：' + s.boundaries.join('；'), src, [], { sourceText: s.sourceText });
+    }
+    for (const role of project.roles ?? []) {
+      const persona = ('身份：' + role.identity + '\n性格：' + role.traits.join('、') + '\n目标：' + role.goals + '\n关系：' + role.relations.join('、') + '\n成长线：' + (role.arc.length > 0 ? role.arc.join(' > ') : '—') + '\n知情度：' + role.knowledge.join('、')).trim();
+      push('roleTemplate', role.name, role.identity, persona, src, [], { roleLabel: role.roleLabel, traits: role.traits, relations: role.relations, arc: role.arc, knowledge: role.knowledge });
+    }
+  }
+
+  saveAuthorAssets(library)
+  return library
+}
+
+/** 拍平题材库（含子题材，父级名称并入 tag）。 */
+function flattenGenres(nodes: GenreNode[], parentName?: string): GenreNode[] {
+  const out: GenreNode[] = []
+  for (const n of nodes) {
+    out.push({ ...n, name: parentName !== undefined ? parentName + '/' + n.name : n.name });
+    if (n.children.length > 0) out.push(...flattenGenres(n.children, parentName !== undefined ? parentName + '/' + n.name : n.name));
+  }
+  return out
+}

package/src/client/api.ts

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