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

@@ -3,7 +3,7 @@
  * fetch, same origin; generation/rewrite/polish ride NDJSON streams read
  * incrementally.
  */
-import { type AssetsPatch, type AssetsResponse, type BibleResponse, type ChapterResponse, type ConfigPatch, type ExportResponse, type ForeshadowRequest, type ForeshadowResponse, type JobFrame, type LoadOutlineResponse, type NovelConfig, type PlanResponse, type ReviewReport, type StatusResponse, type StyleEngineRequest, type StyleAsset, type VolumesResponse } from '../protocol.ts';
+import { type AssetsPatch, type AssetsResponse, type AddModelRequest, type AddModelResponse, type LlmModelsResponse, type LlmProvidersResponse, type LlmVendorsResponse, type RemoveProviderRequest, type RemoveProviderResponse, type BibleResponse, type ChapterResponse, type ConfigPatch, type ExportResponse, type ForeshadowRequest, type ForeshadowResponse, type JobFrame, type LoadOutlineResponse, type LlmTestResponse, type NovelConfig, type PlanResponse, type ReviewReport, type StatusResponse, type StyleEngineRequest, type StyleAsset, type VolumesResponse } from '../protocol.ts';
 /** Error carrying the route's JSON error message. */
 export declare class NovelApiError extends Error {
     constructor(message: string);
@@ -99,6 +99,18 @@ export declare class NovelApi {
     }>;
     /** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
     imageTest(req: import('../protocol.ts').ImageTestRequest): Promise<import('../protocol.ts').ImageTestResponse>;
+    /** 对选中的提供商/模型发一次最小真实调用，验证连通性。 */
+    llmTest(provider: string, model: string): Promise<LlmTestResponse>;
+    /** 添加模型：厂商直填 key，或自定义 OpenAI 兼容路由（写 DSH 凭据 + 注册路由）。 */
+    addModel(req: AddModelRequest): Promise<AddModelResponse>;
+    /** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+    llmVendors(): Promise<LlmVendorsResponse>;
+    /** 查询某个 provider 当前可用的模型（添加成功后可即时刷新）。 */
+    llmModels(provider: string): Promise<LlmModelsResponse>;
+    /** 已注册的提供方路由列表（提供方管理卡片）。 */
+    llmProviders(): Promise<LlmProvidersResponse>;
+    /** 移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+    removeProvider(req: RemoveProviderRequest): Promise<RemoveProviderResponse>;
     roles(req: import('../protocol.ts').RolesRequest): Promise<import('../protocol.ts').RolesResponse>;
     /** 漫剧角色库：从分镜提名 / 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
     mangaRoles(req: import('../protocol.ts').MangaRolesRequest): Promise<import('../protocol.ts').MangaRolesResponse>;
@@ -184,4 +196,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/locales.d.ts

@@ -142,7 +142,23 @@ export declare const zh: {
     readonly 'settings.provider': "模型提供商";
     readonly 'settings.model': "模型";
     readonly 'settings.modelCustom': "自定义…";
+    readonly 'settings.customProvider': "自定义提供商…";
+    readonly 'settings.edit': "编辑";
+    readonly 'settings.delete': "删除";
     readonly 'settings.modelCustomPlaceholder': "输入任意模型 id";
+    readonly 'settings.savedModels': "我的模型";
+    readonly 'settings.modelCards': "模型卡片（内置 + 已添加）";
+    readonly 'settings.savedModelName': "名称";
+    readonly 'settings.addModel': "添加模型";
+    readonly 'settings.catalogRefresh': "刷新厂商";
+    readonly 'settings.refreshModels': "刷新模型";
+    readonly 'settings.savedModelsHint': "手动添加常用模型（provider + 模型 id），点击即可切换当前模型；厂商模式会写入 DSH 凭据并注册路由。";
+    readonly 'settings.testConnection': "测试连通";
+    readonly 'settings.testRunning': "测试中";
+    readonly 'settings.testOk': "连通";
+    readonly 'settings.testFail': "失败";
+    readonly 'settings.testHint': "真实发送一次最小调用（约几十 token），验证 Key / 端点 / 模型可用。";
+    readonly 'settings.reasoningSection': "推理强度";
     readonly 'settings.reasoningEffort': "写作类任务思考强度 (reasoningEffort)";
     readonly 'settings.reasoningHint': "章节生成/润色/重写/审稿等写作任务使用；关掉更省更快。";
     readonly 'settings.analysisReasoning': "分析类任务思考强度（提炼/拆书/反推大纲）";

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,30 @@
+import type { NovelApi } from '../api.ts';
+import type { BookshelfSnapshot } from '../../protocol.ts';
+import { type ProgressLine } from './ProgressConsole.tsx';
+export declare function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenSettings, onTheme, onBackground, onOpacity, adaptEnabled, progress, busy, busyLabel, liveBar, onClearProgress }: {
+    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;
+    /** AI 进度实时状态（与书内共享同一份）。 */
+    progress?: ProgressLine[];
+    busy?: boolean;
+    busyLabel?: string;
+    liveBar?: {
+        text: string;
+        ratio?: number;
+    } | null;
+    onClearProgress?: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,14 @@
+import type { NovelApi } from '../api.ts';
+import type { SavedModel } from '../../protocol.ts';
+/** 目录不可用时回退的内置预设（历史行为）。 */
+export declare const FALLBACK_MODEL_PRESETS: readonly ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-chat", "deepseek-reasoner"];
+export interface ModelManagerProps {
+    api: NovelApi;
+    provider: string;
+    model: string;
+    savedModels: SavedModel[];
+    onProvider: (provider: string) => void;
+    onModel: (model: string) => void;
+    onSavedModels: (models: SavedModel[]) => void;
+}
+export declare function ModelManager({ api, provider, model, onProvider, onModel }: ModelManagerProps): JSX.Element;

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

@@ -0,0 +1,11 @@
+import type { NovelApi } from '../api.ts';
+/** 目录不可用时回退的内置预设（历史行为）。 */
+export declare const FALLBACK_MODEL_PRESETS: readonly ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-chat", "deepseek-reasoner"];
+export interface ModelPickerProps {
+    api: NovelApi;
+    provider: string;
+    model: string;
+    onProvider: (provider: string) => void;
+    onModel: (model: string) => void;
+}
+export declare function ModelPicker({ api, provider, model, onProvider, onModel }: ModelPickerProps): JSX.Element;

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

@@ -0,0 +1,17 @@
+export interface ProgressLine {
+    id: number;
+    text: string;
+    kind: 'info' | 'done' | 'error';
+    live?: boolean;
+    ratio?: number;
+}
+export declare function ProgressConsole({ progress, busy, busyLabel, liveBar, onClear }: {
+    progress: ProgressLine[];
+    busy: boolean;
+    busyLabel: string;
+    liveBar: {
+        text: string;
+        ratio?: number;
+    } | null;
+    onClear: () => void;
+}): 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/ReasoningSection.d.ts

@@ -0,0 +1,10 @@
+import type { NovelConfig } from '../../protocol.ts';
+export interface ReasoningSectionProps {
+    reasoningEffort: NovelConfig['reasoningEffort'];
+    analysisReasoning: NovelConfig['analysisReasoning'];
+    onChange: (patch: {
+        reasoningEffort?: NovelConfig['reasoningEffort'];
+        analysisReasoning?: NovelConfig['analysisReasoning'];
+    }) => void;
+}
+export declare function ReasoningSection({ reasoningEffort, analysisReasoning, onChange }: ReasoningSectionProps): 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';
+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, AddModelRequest, AddModelResponse, LlmModelsResponse, LlmVendorsResponse, LlmProvidersResponse, RemoveProviderRequest, RemoveProviderResponse, LlmTestResponse, 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 */
@@ -147,6 +147,21 @@ export declare function testImageEndpoint(baseURL: string, apiKey: string, model
     message?: string;
     modelFound?: boolean;
 }>;
+/** 对选中的提供商/模型发一次最小真实调用（maxTokens=16），验证 Key / 端点 / 模型可用。 */
+export declare function testLlmModel(ctx: Context, provider: string, model: string): Promise<LlmTestResponse>;
+/** 运行时厂商目录：DSH pi-ai 可配置提供方 + 内置适配器，作为「添加模型」下拉。 */
+export declare function listLlmVendors(ctx: Context): Promise<LlmVendorsResponse>;
+/** 查询某个 provider 当前可用模型（添加成功后可即时刷新下拉）。 */
+export declare function listLlmModels(ctx: Context, provider: string): Promise<LlmModelsResponse>;
+/** 当前已注册的提供方路由列表（提供方管理卡片）。 */
+export declare function listLlmProviders(ctx: Context): Promise<LlmProvidersResponse>;
+/** 移除一个提供方：unset 凭据 ref + 移除 llm-pi-ai providers 路由。 */
+export declare function removeLlmProvider(ctx: Context, req: RemoveProviderRequest): Promise<RemoveProviderResponse>;
+/**
+ * 添加模型（DSH 同款体验）：厂商直填 API Key，或自定义 OpenAI 兼容路由。
+ * 写入 DSH 凭据 refs，并（必要时）注册/更新 llm-pi-ai provider 路由。
+ */
+export declare function registerLlmModel(ctx: Context, req: AddModelRequest): Promise<AddModelResponse>;
 /** 小说角色库：生成角色定妆图并写回角色卡（imageUrl）。 */
 export declare function generateRoleReferenceImage(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, name: string, style?: string, modelId?: string): Promise<string>;
 /** 漫剧角色卡：生成定妆图并写回漫剧卡（imageUrl）。 */
@@ -217,6 +232,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. */