@waterwx/dsh-novel-forge 1.7.3 → 1.9.0

package/lib/types/protocol.d.ts

@@ -55,6 +55,18 @@ export declare const NOVEL_API: {
     readonly storyboardPrompts: "/api/dsh-novel-forge/storyboard/prompts";
     /** 生图接口连通性测试（设置页每个模型条目用）。 */
     readonly imageTest: "/api/dsh-novel-forge/image-test";
+    /** LLM 模型连通性测试：真实最小调用，验证 Key / 端点 / 模型可用。 */
+    readonly llmTest: "/api/dsh-novel-forge/llm-test";
+    /** 添加模型：厂商直填 key 或自定义路由，写进 DSH 凭据与 llm-pi-ai 路由。 */
+    readonly addModel: "/api/dsh-novel-forge/llm-add";
+    /** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+    readonly llmVendors: "/api/dsh-novel-forge/llm-vendors";
+    /** 查询某个 provider 当前可用的模型（添加成功后可即时刷新）。 */
+    readonly llmModels: "/api/dsh-novel-forge/llm-models";
+    /** 已注册的提供方路由列表（提供方管理）。 */
+    readonly llmProviders: "/api/dsh-novel-forge/llm-providers";
+    /** 移除一个提供方。 */
+    readonly llmRemove: "/api/dsh-novel-forge/llm-remove";
     /** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
     readonly reset: "/api/dsh-novel-forge/reset";
     /** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
@@ -104,6 +116,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 {
@@ -977,6 +1007,21 @@ export interface ImageTestResponse {
     /** 模型 id 是否出现在接口的模型列表（探测成功时才有）。 */
     modelFound?: boolean;
 }
+/** POST /llm-test 请求：对选中的提供商/模型发一次最小真实调用。 */
+export interface LlmTestRequest {
+    provider: string;
+    model: string;
+}
+/** POST /llm-test 响应。 */
+export interface LlmTestResponse {
+    ok: boolean;
+    /** 连通延迟（毫秒）。 */
+    ms?: number;
+    /** 失败原因（已映射为人话）。 */
+    message?: string;
+    /** 稳定错误码（LlmError code），便于排查。 */
+    code?: string;
+}
 /** POST /roles 响应。 */
 export interface RolesResponse {
     roles: RoleRecord[];
@@ -1140,6 +1185,122 @@ export interface ImageModelConfig {
     enabled: boolean;
 }
 /** Runtime config surface exposed to the panel (subset of plugin Config). */
+/** 手动添加的模型库条目（只存插件内，不改 DSH 全局）。 */
+export interface SavedModel {
+    /** 唯一 id（前端生成的短 id）。 */
+    id: string;
+    /** 展示名（可为空，回退到 model）。 */
+    name: string;
+    /** DSH 提供商路由（如 zai-coding-cn）。 */
+    provider: string;
+    /** 模型 id（如 glm-5.3-flash）。 */
+    model: string;
+}
+/** DSH 模型添加：厂商预设（选择厂商，直接填 API Key）。 */
+export interface LlmVendor {
+    id: string;
+    name: string;
+    /** 该厂商对应的 provider 路由。 */
+    route: string;
+    /** DSH 凭据引用名（写入 .credentials.yaml 的 refs）。 */
+    apiKeyEnv: string;
+    /** 默认模型 id。 */
+    defaultModel: string;
+    /** 建议可选模型 id 列表（下拉 data-list 用）。 */
+    models: string[];
+    /** 内置适配器（如 deepseek-official），无需注册 pi-ai 路由。 */
+    builtin?: boolean;
+}
+/** 预置的常见厂商（id=provider 路由；添加模型下拉兜底用，其余厂商由运行时目录动态补充）。 */
+export declare const LLM_VENDORS: LlmVendor[];
+/** 运行时厂商目录的一项（添加到模型下拉；由 DSH 的 pi-ai 可配置提供方动态生成）。 */
+export interface LlmVendorOption {
+    /** provider 路由 id（也是厂商下拉的值）。 */
+    id: string;
+    /** 展示名。 */
+    name: string;
+    /** 建议模型 id（可为空，用户手填）。 */
+    models: string[];
+    /** 已知 DSH 凭据引用名；为空时 host 生成 `PI_AI_<ID>_API_KEY`。 */
+    apiKeyEnv?: string;
+    /** 内置适配器（只写凭据，不注册 pi-ai 路由）。 */
+    builtin?: boolean;
+}
+/** GET /llm-vendors 响应。 */
+export interface LlmVendorsResponse {
+    vendors: LlmVendorOption[];
+}
+/** /llm-models 里的一条模型。 */
+export interface LlmModelOption {
+    id: string;
+    name: string;
+}
+/** GET /llm-models?provider=x 响应。 */
+export interface LlmModelsResponse {
+    models: LlmModelOption[];
+}
+/** GET /llm-providers 响应：当前已注册的提供方路由。 */
+export interface LlmProvidersResponse {
+    providers: {
+        id: string;
+        name: string;
+    }[];
+}
+/** POST /llm-remove 请求：移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+export interface RemoveProviderRequest {
+    provider: string;
+    /** 该提供方对应的 DSH 凭据引用名（用于 unset）。 */
+    apiKeyEnv?: string;
+}
+/** POST /llm-remove 响应。 */
+export interface RemoveProviderResponse {
+    ok: boolean;
+    message?: string;
+}
+/** GET /llm-providers 响应：当前已注册的提供方路由。 */
+export interface LlmProvidersResponse {
+    providers: {
+        id: string;
+        name: string;
+    }[];
+}
+/** POST /llm-remove 请求：移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+export interface RemoveProviderRequest {
+    provider: string;
+    /** 该提供方对应的 DSH 凭据引用名（用于 unset）。 */
+    apiKeyEnv?: string;
+}
+/** POST /llm-remove 响应。 */
+export interface RemoveProviderResponse {
+    ok: boolean;
+    message?: string;
+}
+/** POST /llm-add 请求：添加一个模型（厂商直填 key，或自定义路由）。 */
+export interface AddModelRequest {
+    mode: 'vendor' | 'custom';
+    /** 厂商模式用：provider 路由 id（来自 /llm-vendors）。 */
+    vendor?: string;
+    /** 厂商已知的 DSH 凭据引用名（可选；为空时 host 生成）。 */
+    apiKeyEnv?: string;
+    /** 自定义模式用：provider 路由 id。 */
+    provider?: string;
+    /** 模型 id。 */
+    model: string;
+    /** API Key。 */
+    apiKey: string;
+    /** 展示名（可选）。 */
+    name?: string;
+    /** 自定义模式用：OpenAI 兼容 base URL。 */
+    baseURL?: string;
+}
+/** POST /llm-add 响应。 */
+export interface AddModelResponse {
+    ok: boolean;
+    saved: SavedModel;
+    provider: string;
+    message?: string;
+}
+/** 手动添加的模型库条目（只存插件内，不改 DSH 全局）。 */
 export interface NovelConfig {
     /** Absolute path of the default docx outline to load. */
     outlinePath: string;
@@ -1175,6 +1336,16 @@ export interface NovelConfig {
     imageApiModel?: string;
     /** 是否启用生图（= 存在启用条目）。 */
     imageApiEnabled?: boolean;
+    /** 自定义背景图（URL 或 dataURL 或服务端路径引用；空 = 使用主题默认背景）。 */
+    themeBackground?: string;
+    /** 自定义背景遮罩/模糊强度 0-80（0 = 不遮罩）。 */
+    themeBackgroundBlur?: number;
+    /** 玻璃透明度 0-100（100=当前原样，越小越透，新拟态/黏土可见背景图）。 */
+    themeOpacity?: number;
+    /** 是否启用改编模式（默认关闭；发布后开启）。 */
+    enableAdaptMode?: boolean;
+    /** 手动添加的模型库（「我的模型」条目；只存插件内）。 */
+    savedModels?: SavedModel[];
 }
 /** GET /status response. */
 export interface StatusResponse {
@@ -1412,8 +1583,17 @@ 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[];
+    /** 手动添加的模型库（完整替换保存）。 */
+    savedModels?: SavedModel[];
 }
 /** One assistant conversation message (persisted per project). */
 export interface AssistantMessage {
@@ -1573,3 +1753,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.9.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

@@ -8,6 +8,13 @@ import {
   NOVEL_API,
   type AssetsPatch,
   type AssetsResponse,
+  type AddModelRequest,
+  type AddModelResponse,
+  type LlmModelsResponse,
+  type LlmProvidersResponse,
+  type LlmVendorsResponse,
+  type RemoveProviderRequest,
+  type RemoveProviderResponse,
   type BibleResponse,
   type ChapterResponse,
   type ConfigPatch,
@@ -16,6 +23,7 @@ import {
   type ForeshadowResponse,
   type JobFrame,
   type LoadOutlineResponse,
+  type LlmTestResponse,
   type NovelConfig,
   type PlanResponse,
   type ReviewReport,
@@ -232,6 +240,39 @@ export class NovelApi {
     return postJson<import('../protocol.ts').ImageTestResponse>(NOVEL_API.imageTest, req)
   }
 
+  /** 对选中的提供商/模型发一次最小真实调用，验证连通性。 */
+  async llmTest(provider: string, model: string): Promise<LlmTestResponse> {
+    return postJson<LlmTestResponse>(NOVEL_API.llmTest, { provider, model })
+  }
+
+  /** 添加模型：厂商直填 key，或自定义 OpenAI 兼容路由（写 DSH 凭据 + 注册路由）。 */
+  async addModel(req: AddModelRequest): Promise<AddModelResponse> {
+    return postJson<AddModelResponse>(NOVEL_API.addModel, req)
+  }
+
+  /** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+  async llmVendors(): Promise<LlmVendorsResponse> {
+    const response = await fetch(NOVEL_API.llmVendors)
+    return readJson<LlmVendorsResponse>(response)
+  }
+
+  /** 查询某个 provider 当前可用的模型（添加成功后可即时刷新）。 */
+  async llmModels(provider: string): Promise<LlmModelsResponse> {
+    const response = await fetch(NOVEL_API.llmModels + '?provider=' + encodeURIComponent(provider))
+    return readJson<LlmModelsResponse>(response)
+  }
+
+  /** 已注册的提供方路由列表（提供方管理卡片）。 */
+  async llmProviders(): Promise<LlmProvidersResponse> {
+    const response = await fetch(NOVEL_API.llmProviders)
+    return readJson<LlmProvidersResponse>(response)
+  }
+
+  /** 移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+  async removeProvider(req: RemoveProviderRequest): Promise<RemoveProviderResponse> {
+    return postJson<RemoveProviderResponse>(NOVEL_API.llmRemove, req)
+  }
+
   async roles(req: import('../protocol.ts').RolesRequest): Promise<import('../protocol.ts').RolesResponse> {
     return postJson<import('../protocol.ts').RolesResponse>(NOVEL_API.roles, req)
   }
@@ -461,4 +502,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 })
+  }
 }