@waterwx/dsh-novel-forge 2.0.1-alpha → 2.1.0-alpha

package/lib/types/src/assets.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Writing assets — 题材基底库 / 推进模式库 / 反 AI 规则 / 写法引擎.
+ *
+ * Ported from AI-Novel-Writing-Assistant (Apache-2.0) built-in seed data:
+ * - 8 preset style templates (DEFAULT_STYLE_TEMPLATES)
+ * - 12 anti-AI rules with concrete detect patterns (DEFAULT_ANTI_AI_RULES)
+ * - genre tree + progression mode seeds
+ * Assets persist with the project (novel-project.json) and are injected into
+ * generation / planning / review prompts, and available to the AI assistant.
+ */
+import type { AntiAiRule, GenreNode, PlotBeatTemplate, ProgressionMode, ProjectAssets, StyleAsset, StyleTemplate } from './protocol.ts';
+/** 预置写法模板（来自 AI-Novel-Writing-Assistant 内置 DEFAULT_STYLE_TEMPLATES）。 */
+export declare const BUILTIN_STYLE_TEMPLATES: StyleTemplate[];
+/** 内置全局反 AI 规则（来自 AI-Novel-Writing-Assistant 内置 DEFAULT_ANTI_AI_RULES）。 */
+export declare const BUILTIN_ANTI_AI_RULES: AntiAiRule[];
+/** 内置题材基底库（常用网文题材树，跨书复用）。 */
+export declare const BUILTIN_GENRE_LIBRARY: GenreNode[];
+/** 内置常用推进模式。 */
+export declare const BUILTIN_PROGRESSION_MODES: ProgressionMode[];
+/** 剧情桥段库：可复用情节套路（作者阅读经验沉淀，非某本书的剧情线）。 */
+export declare const BUILTIN_PLOT_BEATS: PlotBeatTemplate[];
+/** 默认（空）项目写作资产。 */
+export declare function emptyProjectAssets(): ProjectAssets;
+/** 合并项目资产与内置库：返回「生效的反 AI 规则」（内置全局 + 项目自定义）。 */
+export declare function effectiveAntiAiRules(assets: ProjectAssets | undefined): AntiAiRule[];
+/** 把生效规则渲染成提示词块（禁止/鼓励分列，压缩省 token）。 */
+export declare function renderAntiAiRules(assets: ProjectAssets | undefined): string;
+/** 渲染题材与推进模式提示词块。 */
+export declare function renderGenreAndProgression(assets: ProjectAssets | undefined): string;
+/** 渲染写法资产提示词块（规则去重，省 token）。 */
+export declare function renderStyleAssets(assets: ProjectAssets | undefined): string;
+/** 渲染全部写作资产提示词（供生成/规划/审稿注入）。 */
+export declare function renderAllAssets(assets: ProjectAssets | undefined): string;
+/** 预置写法模板 → 可直接绑定的 StyleAsset。 */
+export declare function styleTemplateToAsset(template: StyleTemplate): StyleAsset;
+/** 写法引擎：从样本文本提取风格资产的系统提示词。 */
+export declare function styleEngineSystemPrompt(): string;

package/lib/types/src/assistant.d.ts

@@ -0,0 +1,45 @@
+/**
+ * AI assistant engine — a conversational editor over the novel project.
+ *
+ * The user talks to the assistant about plot, characters, settings; the
+ * assistant can reply in prose AND emit action directives that the host
+ * executes (rewrite a paragraph, edit the bible, regenerate a chapter,
+ * export the book, ...). Conversation history persists next to the project
+ * as NDJSON, so a reload keeps the thread.
+ *
+ * Action protocol: the model emits a line of the form
+ *   <dsh-action name="toolName">{jsonArgs}</dsh-action>
+ * anywhere in its reply. The host strips it, executes the tool, appends the
+ * result as a tool-role message, and continues the loop (bounded rounds).
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { AssistantMessage, NovelConfig, ProjectState } from './protocol.ts';
+import { chapterFileName } from './engine.ts';
+/** History file name inside the output dir. */
+export declare const ASSISTANT_HISTORY_FILE = "novel-assistant.jsonl";
+/** Load the persisted conversation (empty when none). */
+export declare function loadAssistantHistory(outputDir: string): AssistantMessage[];
+/** 清空助手对话记录（删除历史文件）。 */
+export declare function clearAssistantHistory(outputDir: string): void;
+/** Execute one action directive. Returns a text result (or throws). */
+/**
+ * Execute one action directive as an async generator: yields live progress
+ * text (chapter text being generated/rewritten), then yields the final result
+ * string. Throws on failure.
+ */
+export declare function executeAction(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, name: string, args: Record<string, unknown>): AsyncGenerator<string, string, unknown>;
+/** Run one user turn. Yields stream frames; persists history. */
+export declare function runAssistantTurn(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, userMessage: string): AsyncGenerator<{
+    frame: 'delta';
+    text: string;
+} | {
+    frame: 'tool';
+    name: string;
+    status: 'start' | 'done' | 'error';
+    detail?: string;
+} | {
+    frame: 'toolDelta';
+    name: string;
+    text: string;
+}, void, unknown>;
+export { chapterFileName };

package/lib/types/src/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/src/bookshelf.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 书架（Bookshelf）— 多书管理：一本书记录一个独立输出目录。
+ * 状态持久化到 ~/.dsh/dsh-novel-forge-bookshelf.json（跟随 dsh 配置惯例）。
+ */
+import type { BookEntry, BookshelfSnapshot } from './protocol.ts';
+/** 书架配置文件路径。 */
+export declare function bookshelfFile(): string;
+interface BookshelfStore {
+    books: BookEntry[];
+    activeBookId: string | null;
+}
+/** 读取书架（无则返回空）。 */
+export declare function loadBookshelf(): BookshelfStore;
+/** 当前激活的书。 */
+export declare function activeBook(store: BookshelfStore): BookEntry | undefined;
+/** 书架快照（含每本书的进度摘要）。 */
+export declare function bookshelfSnapshot(store: BookshelfStore): BookshelfSnapshot;
+/** 新建一本书（自动成为当前书）。 */
+export declare function createBook(bookName: string, outputDir: string): BookEntry;
+/** 更新某本书的书名（开书向导导入大纲后书名以大纲首行为准）。 */
+export declare function renameBook(id: string, bookName: string): boolean;
+/**
+ * 播种：书架为空时，把指定输出目录下已有的项目自动登记为第一本书。
+ * 兼容升级场景 —— 旧版插件直接在输出目录写项目，从未登记书架。
+ * @param outputDir - 候选输出目录（通常为 settings 的默认输出目录）。
+ * @returns 是否发生了播种。
+ */
+export declare function seedBookshelfFromOutputDir(outputDir: string): boolean;
+/** 导入已有项目目录到书架：校验 novel-project.json，已存在则直接激活。 */
+export declare function importDir(outputDir: string): {
+    book: BookEntry;
+    existed: boolean;
+};
+/** 激活一本书。 */
+export declare function activateBook(id: string): BookEntry | undefined;
+/** 移除一本书。 */
+export declare function removeBook(id: string): boolean;
+/** 当前书输出目录（无书架则 undefined，回退 settings）。 */
+export declare function activeBookOutputDir(): string | undefined;
+/** 默认输出目录推断：~/.dsh/novels/书名。 */
+export declare function defaultOutputDirFor(bookName: string): string;
+export {};

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

@@ -0,0 +1,234 @@
+/**
+ * Browser-side API client for the /api/dsh-novel-forge route family. Plain
+ * fetch, same origin; generation/rewrite/polish ride NDJSON streams read
+ * incrementally.
+ */
+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 AdaptExecuteRequest, type AdaptRewriteFrame, type AdaptMaterializeSaveRequest, type AdaptMaterializeSaveResponse, type PluginUpdateResponse, 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);
+}
+/** The browser half's only data entry point. */
+export declare class NovelApi {
+    status(): Promise<StatusResponse>;
+    loadOutline(path?: string, text?: string): Promise<LoadOutlineResponse>;
+    saveOutline(text: string): Promise<{
+        ok: boolean;
+        bookName: string;
+    }>;
+    /** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流）。 */
+    outlineReverse(onFrame: (frame: JobFrame) => void): Promise<void>;
+    /** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
+    storyboardTable(chapterNo: number, skeleton: import('../protocol.ts').StoryboardSkeleton, styleId?: string, filterId?: string): Promise<import('../protocol.ts').StoryboardTableResponse>;
+    /** 漫剧方案管理：create / remove / activate。 */
+    manhuaPlans(req: import('../protocol.ts').MangaPlansRequest): Promise<import('../protocol.ts').MangaPlansResponse>;
+    /** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
+    storyboardPrompts(chapterNo: number, table: import('../protocol.ts').StoryboardTable, styleId?: string, filterId?: string): Promise<import('../protocol.ts').StoryboardPromptsResponse>;
+    /** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
+    storyboardSkeleton(chapterNo: number): Promise<import('../protocol.ts').StoryboardSkeletonResponse>;
+    /** 开书想法 → AI 大纲：生成 count 个方案（换批时传 exclude 避开已暂留方向）。 */
+    outlineSuggest(idea: string, count?: number, exclude?: string[]): Promise<import('../protocol.ts').OutlineSuggestResponse>;
+    /** 拆书分析：对已写章节做结构/人物/文风/卖点体检。 */
+    breakdown(scope?: string, preset?: 'quick' | 'standard', budgetTokens?: number): Promise<import('../protocol.ts').BreakdownResponse>;
+    plan(outline?: string, chapterCount?: number, volume?: number): Promise<PlanResponse>;
+    volumes(outline?: string): Promise<VolumesResponse>;
+    bible(outline?: string): Promise<BibleResponse>;
+    review(chapterNo: number): Promise<{
+        report: ReviewReport;
+    }>;
+    summarize(chapterNo: number): Promise<{
+        summary: string;
+    }>;
+    foreshadow(req: ForeshadowRequest): Promise<ForeshadowResponse>;
+    exportBook(format: 'txt' | 'md'): Promise<ExportResponse>;
+    chapter(no: number): Promise<ChapterResponse>;
+    /** 审查手动编辑的正文（不落盘）。previousReport 传入时走「验证模式」（核对原意见解决 + 只挑新增 high）。 */
+    chapterCheck(no: number, text: string, previousReport?: ReviewReport): Promise<{
+        report: ReviewReport;
+    }>;
+    /** 保存手动编辑的正文（自动备份 .bak；带报告则沿用落盘，否则保存后自动审稿）。 */
+    chapterSave(no: number, text: string, report?: ReviewReport): Promise<import('../protocol.ts').ChapterSaveResponse>;
+    patchConfig(patch: ConfigPatch): Promise<{
+        config: NovelConfig;
+    }>;
+    openFolder(): Promise<void>;
+    /** 插件自更新：在 DSH profile 目录拉取最新 npm 版（需重启 DSH 生效）。 */
+    pluginUpdate(): Promise<PluginUpdateResponse>;
+    /** 书架快照。 */
+    bookshelf(): Promise<import('../protocol.ts').BookshelfSnapshot>;
+    /** 新建书并激活（开书向导：可携带大纲文本，创建即建项目）。 */
+    bookCreate(bookName: string, outputDir?: string, outline?: string): Promise<import('../protocol.ts').BookshelfSnapshot>;
+    /** 重置项目（清空进度；可携带新大纲）。 */
+    reset(outline?: string): Promise<{
+        ok: boolean;
+        bookName: string;
+    }>;
+    /** 全书一致性质检。 */
+    audit(): Promise<import('../protocol.ts').AuditResponse>;
+    /** 角色卡刷新（基于事实库聚合）。 */
+    charactersRefresh(): Promise<{
+        cards: import('../protocol.ts').RoleStatusCard[];
+    }>;
+    /** 事实库回填：对历史已生成章节批量抽取事实。 */
+    factsBackfill(): Promise<{
+        ok: boolean;
+        filled: number;
+    }>;
+    /** 道藏局部修补。 */
+    biblePatch(patch: import('../protocol.ts').BiblePatchRequest): Promise<{
+        bible: import('../protocol.ts').StoryBible;
+    }>;
+    /** 剧情线管理：增删改 + 关联章节。 */
+    plotlines(req: import('../protocol.ts').PlotlinesRequest): Promise<import('../protocol.ts').PlotlinesResponse>;
+    /** 敏感词检查：指定章节 / 任意文本 / 全书。 */
+    sensitiveCheck(req: import('../protocol.ts').SensitiveCheckRequest): Promise<import('../protocol.ts').SensitiveCheckResponse>;
+    /** 作者复盘补跑：单章（JSON）。 */
+    reviewBackfillChapter(no: number): Promise<{
+        no: number;
+        review: import('../protocol.ts').AuthorReview;
+    }>;
+    /** 作者复盘补跑：全书缺失章节（NDJSON 流）。 */
+    reviewBackfillAll(onFrame: (frame: JobFrame) => void): Promise<void>;
+    /** 章节复位：generating 卡死 → pending。 */
+    chapterReset(no: number): Promise<{
+        ok: boolean;
+        no: number;
+    }>;
+    /** 章节直接通过（作者行使最终决定权）。 */
+    chapterApprove(no: number): Promise<{
+        ok: boolean;
+        no: number;
+    }>;
+    /** 角色库：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>;
+    /** 导出「即梦素材包」落盘到资产库 manga-assets/素材包/。 */
+    exportPackage(chapterNo: number, title: string, markdown: string): Promise<{
+        ok: boolean;
+        file: string;
+    }>;
+    /** 场景库：AI 提炼 / 采纳 / 更新 / 删除 / 图集。 */
+    scenes(req: import('../protocol.ts').ScenesRequest): Promise<import('../protocol.ts').ScenesResponse>;
+    /** 视觉世界观规则：提炼 / 保存。 */
+    visualRules(req: import('../protocol.ts').VisualRulesRequest): Promise<import('../protocol.ts').VisualRulesResponse>;
+    /** 道具库：从已写章节提炼常驻道具 / 保存清单。 */
+    mangaProps(req: import('../protocol.ts').MangaPropsRequest): Promise<import('../protocol.ts').MangaPropsResponse>;
+    /** 小说简介：AI 生成/补全（partial 留空 = 全量），或手动保存。 */
+    blurb(action: 'generate' | 'save', text?: string, partial?: string): Promise<{
+        blurb: string;
+    }>;
+    /** 封面：读取（dataUrl；dir 指定某本书的输出目录，省略为当前书）。 */
+    coverGet(dir?: string): Promise<import('../protocol.ts').CoverResponse>;
+    /** 封面：上传（base64 data URL）或移除。 */
+    coverPost(action: 'upload' | 'remove', dataUrl?: string): Promise<{
+        ok: boolean;
+        coverPath?: string | null;
+    }>;
+    /** 重命名当前书（同步项目与书架条目）。 */
+    rename(bookName: string): Promise<{
+        bookName: string;
+    }>;
+    /** 大世界：AI 提炼（generate）或手动保存（save）。 */
+    world(action: 'generate' | 'save', world?: import('../protocol.ts').WorldState): Promise<{
+        world: import('../protocol.ts').WorldState;
+    }>;
+    /** 切换当前书。 */
+    bookActivate(id: string): Promise<import('../protocol.ts').BookshelfSnapshot>;
+    /** 移除书架条目。 */
+    bookRemove(id: string): Promise<import('../protocol.ts').BookshelfSnapshot>;
+    /** 导入已有项目目录（Mode A）：校验 novel-project.json，登记/激活书架。 */
+    bookImportDir(outputDir: string): Promise<import('../protocol.ts').BookImportDirResponse>;
+    /** 导入 txt/md 全本（Mode B）：服务器本地文件路径模式。 */
+    bookImportText(filePath: string, outputDir?: string): Promise<import('../protocol.ts').BookImportTextResponse>;
+    /** 拆章预览（浏览器上传全文，不落盘）：返回识别到的章节与跳过清单。 */
+    bookImportTextPreview(text: string, fileName?: string): Promise<import('../protocol.ts').BookImportTextPreviewResponse>;
+    /** 导入 txt/md 全本（Mode B）：浏览器上传全文内容模式。 */
+    bookImportTextContent(text: string, fileName: string, outputDir?: string): Promise<import('../protocol.ts').BookImportTextResponse>;
+    /** 生产单：启动批量生产（区间或新增 N 章；计划不足自动补）。 */
+    runStart(req: import('../protocol.ts').RunStartRequest): Promise<import('../protocol.ts').RunState>;
+    /** 生产单控制：pause / resume / stop。 */
+    runControl(action: 'pause' | 'resume' | 'stop'): Promise<import('../protocol.ts').RunState | null>;
+    /** 生产单状态（无生产单返回 null）。 */
+    runStatus(): Promise<import('../protocol.ts').RunState | null>;
+    /** Get project writing assets + built-in libraries. */
+    assets(): Promise<AssetsResponse>;
+    /** Patch project writing assets. */
+    patchAssets(patch: AssetsPatch): Promise<AssetsResponse>;
+    /** Extract a style asset from sample text. */
+    styleEngine(req: StyleEngineRequest): Promise<{
+        styleAsset: StyleAsset;
+    }>;
+    /**
+     * Consume an NDJSON job stream (generate / rewrite / polish).
+     * @param path - the route to POST to.
+     * @param payload - the JSON body.
+     * @param onFrame - receives every frame as it lands.
+     */
+    private streamJob;
+    /** Generate one chapter. */
+    generate(chapterNo: number, skipReview: boolean, onFrame: (frame: JobFrame) => void): Promise<void>;
+    /** Rewrite one chapter (whole-chapter, or local when `target` is given). */
+    rewrite(chapterNo: number, instructions: string, target: string, onFrame: (frame: JobFrame) => void): Promise<void>;
+    /** Polish (de-AI-ify) one chapter. */
+    polish(chapterNo: number, onFrame: (frame: JobFrame) => void): Promise<void>;
+    /** 采纳待确认草稿（润色/重写产物），覆盖正文文件。返回采纳后的新正文（markdown）。
+     *  可携带审查报告（沿用结论定状态：通过 → approved）。 */
+    draftApply(chapterNo: number, report?: import('../protocol.ts').ReviewReport): Promise<{
+        ok: boolean;
+        chars: number;
+        file: string;
+        markdown: string;
+    }>;
+    /** 放弃待确认草稿，保留原稿。 */
+    draftDiscard(chapterNo: number): Promise<{
+        ok: boolean;
+    }>;
+    /** Run one assistant turn (NDJSON stream). */
+    assistant(message: string, onFrame: (frame: import('../protocol.ts').AssistantFrame) => void): Promise<void>;
+    /** Load the persisted assistant conversation. */
+    assistantHistory(): Promise<import('../protocol.ts').AssistantMessage[]>;
+    /** 清空助手对话记录。 */
+    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>;
+    /** 改编模式 P3：保存改编全文为新书（原书保留，登记书架）。 */
+    adaptSave(req: import('../protocol.ts').AdaptSaveRequest): Promise<import('../protocol.ts').AdaptSaveResponse>;
+    /** 改编模式 P4：从源全文 + 编辑后方案提炼新书资料并保存为「待写新书」。 */
+    adaptMaterialize(req: import('../protocol.ts').AdaptMaterializeRequest): Promise<import('../protocol.ts').AdaptMaterializeResponse>;
+    /** 改编模式：保存预览/微调后的新书资料为新书（原书保留，登记书架）。 */
+    adaptMaterializeSave(req: AdaptMaterializeSaveRequest): Promise<AdaptMaterializeSaveResponse>;
+    /** 改编模式：rewrite 逐章重写（NDJSON 流式进度，支持分段 startNo/endNo）。 */
+    adaptRewriteStream(req: AdaptExecuteRequest, onFrame: (frame: AdaptRewriteFrame) => void): Promise<void>;
+    /** 主题自定义背景：上传图片，服务端存盘并返回可访问 URL。 */
+    themeBackgroundUpload(dataUrl: string): Promise<{
+        url: string;
+    }>;
+}

package/lib/types/src/client/docx.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Browser-side docx outline extraction: a .docx is a zip whose
+ * word/document.xml holds the body text in <w:t> runs inside <w:p> paragraphs.
+ * Uses fflate (inlined into the client bundle) so the user can pick or drag a
+ * docx without any server upload.
+ *
+ * Import from 'fflate/browser' (not 'fflate'): the default entry resolves to
+ * the Node build (esm/index.mjs), which calls module.createRequire() for the
+ * optional worker_threads path — inlining that into the browser bundle leaves
+ * a bare require("module") the client-modules table cannot answer.
+ */
+/** Extract plain text from a docx buffer: one line per <w:p> paragraph. */
+export declare function extractDocxTextFromBuffer(buffer: ArrayBuffer | Uint8Array): string;
+/** Read a File as ArrayBuffer. */
+export declare function readFileAsArrayBuffer(file: File): Promise<ArrayBuffer>;

package/lib/types/src/client/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Browser-half entry for the dsh-novel-forge plugin — runs inside the dsh web
+ * GUI. Registers the sidebar entry row and the workbench panel. DOM mounting
+ * problems are logged, never thrown — the web shell fails the whole boot when
+ * a plugin apply throws.
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/** Required services (fiber inject waiting). */
+export declare const inject: string[];
+/**
+ * Mount the novel-forge workbench.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;

package/lib/types/src/client/locales.d.ts

@@ -0,0 +1,212 @@
+/**
+ * dsh-novel-forge — locale dictionaries (zh / en).
+ */
+/** zh dictionary. */
+export declare const zh: {
+    readonly 'entry.label': "小说工坊";
+    readonly 'entry.tooltip': "AI 编译小说工作台：总纲 → 道藏 → 卷计划 → 章节计划 → 逐章生成+审稿";
+    readonly 'panel.title': "小说工坊";
+    readonly 'common.close': "关闭";
+    readonly 'common.loading': "加载中…";
+    readonly 'common.save': "保存";
+    readonly 'common.error': "错误";
+    readonly 'common.success': "成功";
+    readonly 'common.generating': "生成中…";
+    readonly 'common.chars': "字";
+    readonly 'tab.workflow': "工作台";
+    readonly 'tab.overview': "总纲";
+    readonly 'tab.plan': "章节";
+    readonly 'tab.bible': "道藏";
+    readonly 'tab.foreshadow': "暗线";
+    readonly 'tab.assistant': "AI 助手";
+    readonly 'tab.settings': "设置";
+    readonly 'workflow.title': "创作工作台";
+    readonly 'workflow.step1': "① 加载总纲";
+    readonly 'workflow.step2': "② 提炼道藏";
+    readonly 'workflow.step3': "③ 规划卷";
+    readonly 'workflow.step4': "④ 生成章节计划";
+    readonly 'workflow.step5': "⑤ 逐章写作 + AI 审稿";
+    readonly 'workflow.step6': "⑥ 润色 / 导出";
+    readonly 'workflow.loadOutline': "读取总纲";
+    readonly 'workflow.genBible': "提炼道藏";
+    readonly 'workflow.genVolumes': "生成卷计划";
+    readonly 'workflow.genPlan': "生成章节计划";
+    readonly 'workflow.done': "已完成";
+    readonly 'workflow.todo': "待办";
+    readonly 'workflow.bibleDone': "道藏已生成（{n} 条规则 / {c} 个人物 / {r} 条红线）";
+    readonly 'workflow.volumesDone': "卷计划已生成（{n} 卷）";
+    readonly 'workflow.planDone': "章节计划已生成（{n} 章）";
+    readonly 'workflow.progress': "进度：总纲 ✓ · 道藏 {bible} · 卷 {volumes} · 计划 {plan} · 已完成 {done}/{total} 章";
+    readonly 'overview.loadDocx': "从 docx 读取总纲";
+    readonly 'overview.loadDocxDefault': "读取默认总纲";
+    readonly 'overview.loadingOutline': "正在解析 docx…";
+    readonly 'overview.outlineHint': "总纲文本（可编辑）";
+    readonly 'overview.outlineChars': "总纲字数";
+    readonly 'overview.saveOutline': "保存总纲";
+    readonly 'overview.saved': "总纲已保存";
+    readonly 'overview.bookName': "书名";
+    readonly 'overview.loadCustom': "指定 docx 路径";
+    readonly 'overview.loadCustomHint': "绝对路径，留空使用默认";
+    readonly 'plan.generate': "生成章节计划";
+    readonly 'plan.generateHint': "章节数量";
+    readonly 'plan.count': "章";
+    readonly 'plan.empty': "暂无章节计划，请先生成";
+    readonly 'plan.chapter': "章";
+    readonly 'plan.pending': "待生成";
+    readonly 'plan.generating': "生成中";
+    readonly 'plan.written': "待审稿";
+    readonly 'plan.reviewing': "审稿中";
+    readonly 'plan.approved': "已通过";
+    readonly 'plan.rejected': "待修订";
+    readonly 'plan.error': "失败";
+    readonly 'plan.write': "生成本章";
+    readonly 'plan.rewrite': "修订";
+    readonly 'plan.review': "审稿";
+    readonly 'plan.polish': "去AI味";
+    readonly 'plan.writeAll': "批量生成全部";
+    readonly 'plan.writeAllPending': "批量生成剩余";
+    readonly 'plan.generated': "已生成";
+    readonly 'plan.progress': "进度";
+    readonly 'plan.beats': "剧情要点";
+    readonly 'plan.reviewReport': "审稿报告";
+    readonly 'plan.reviewScore': "评分";
+    readonly 'plan.reviewVerdict': "总评";
+    readonly 'plan.reviewIssues': "问题清单";
+    readonly 'plan.reviewPass': "通过";
+    readonly 'plan.reviewFail': "未通过";
+    readonly 'plan.approve': "手动通过";
+    readonly 'plan.summary': "章节摘要";
+    readonly 'plan.volumes': "卷";
+    readonly 'plan.noVolume': "未分卷";
+    readonly 'bible.title': "道藏";
+    readonly 'bible.gen': "AI 提炼道藏";
+    readonly 'bible.genre': "题材基调";
+    readonly 'bible.worldRules': "世界规则";
+    readonly 'bible.characters': "人物志";
+    readonly 'bible.redLines': "写作红线";
+    readonly 'bible.style': "风格要求";
+    readonly 'bible.none': "尚未生成道藏。生成后写作会严格遵守人设与金手指规则，审稿也会按红线检查。";
+    readonly 'foreshadow.title': "暗线管理";
+    readonly 'foreshadow.suggest': "AI 建议暗线";
+    readonly 'foreshadow.none': "暂无暗线";
+    readonly 'foreshadow.status': "状态";
+    readonly 'foreshadow.planned': "计划中";
+    readonly 'foreshadow.planted': "已埋设";
+    readonly 'foreshadow.progressing': "推进中";
+    readonly 'foreshadow.resolved': "已回收";
+    readonly 'foreshadow.abandoned': "已放弃";
+    readonly 'foreshadow.target': "预计回收";
+    readonly 'foreshadow.plantedAt': "埋设于";
+    readonly 'foreshadow.setPlanted': "标记已埋设";
+    readonly 'foreshadow.setResolved': "标记已回收";
+    readonly 'tab.facts': "编年录";
+    readonly 'tab.plotlines': "剧情线";
+    readonly 'plotlines.hint': "主线/支线/人物线/悬念线的推进管理：章节生成时会注入未完结的线，要求每章至少推进一条；关联章节记录推进节点。";
+    readonly 'plotlines.empty': "还没有剧情线——长篇小说建议先建主线与几条支线。";
+    readonly 'plotlines.new': "＋ 新建剧情线";
+    readonly 'plotlines.name': "线名";
+    readonly 'plotlines.kind': "类型";
+    readonly 'plotlines.kindMain': "主线";
+    readonly 'plotlines.kindBranch': "支线";
+    readonly 'plotlines.kindCharacter': "人物线";
+    readonly 'plotlines.kindMystery': "悬念线";
+    readonly 'plotlines.goal': "目标/终点";
+    readonly 'plotlines.progress': "当前进度";
+    readonly 'plotlines.status': "状态";
+    readonly 'plotlines.statusActive': "推进中";
+    readonly 'plotlines.statusPaused': "暂停";
+    readonly 'plotlines.statusResolved': "已完结";
+    readonly 'plotlines.statusAbandoned': "已废弃";
+    readonly 'plotlines.save': "保存";
+    readonly 'plotlines.cancel': "取消";
+    readonly 'plotlines.edit': "编辑";
+    readonly 'plotlines.remove': "删除";
+    readonly 'plotlines.linkChapter': "关联本章";
+    readonly 'plotlines.chapters': "已关联";
+    readonly 'plotlines.workflowTitle': "剧情线进度";
+    readonly 'plotlines.workflowEmpty': "未建剧情线（去「剧情线」页创建）";
+    readonly 'sensitive.title': "敏感词检查";
+    readonly 'sensitive.scanAll': "🔞 全书敏感词检查";
+    readonly 'sensitive.hint': "内置违禁词库硬匹配（政治/擦边/暴力/辱骂/广告/其他），发布前建议检查；只做提示，是否修改由你判断。";
+    readonly 'sensitive.clean': "✅ 未命中任何违禁词（扫描 {n} 章）";
+    readonly 'sensitive.hits': "命中 {n} 处（{chapters} 章受影响）";
+    readonly 'sensitive.goFix': "去修订";
+    readonly 'sensitive.fixPrefill': "请删除或替换正文中的违禁表达「{word}」（类别：{category}），用含蓄/间接的写法替代。";
+    readonly 'facts.title': "编年录 / 时间线（{n} 条）";
+    readonly 'facts.hint': "每章生成后自动抽取「已确立事实」（人物状态/境界资源/关系变化/伏笔落地），最近 20 条注入后续章节生成，保证长期一致。";
+    readonly 'facts.backfill': "回填历史章节事实";
+    readonly 'facts.backfilled': "已从历史章节回填 {n} 条事实";
+    readonly 'settings.title': "设置";
+    readonly 'settings.outlinePath': "默认大纲路径";
+    readonly 'settings.outputDir': "输出目录";
+    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': "分析类任务思考强度（提炼/拆书/反推大纲）";
+    readonly 'settings.analysisReasoningHint': "角色/场景/道藏提炼、拆书、反推大纲等一次性分析任务默认 low，保证质量，不受上面写作档位影响。";
+    readonly 'settings.reasoning.off': "off · 关闭思考（推荐日常写文）";
+    readonly 'settings.reasoning.low': "low · 低思考";
+    readonly 'settings.reasoning.high': "high · 高思考";
+    readonly 'settings.reasoning.max': "max · 最高思考（质检/推演）";
+    readonly 'settings.theme': "主题";
+    readonly 'settings.themeLiquid': "iOS 液态玻璃（绿）";
+    readonly 'settings.themeNeumorph': "新拟物（双阴影）";
+    readonly 'settings.themeHint': "存于浏览器本地，即时生效";
+    readonly 'settings.chapterChars': "每章目标字数";
+    readonly 'settings.maxTokens': "单章最大输出 tokens";
+    readonly 'settings.reviewPassScore': "审稿通过分数（0-100）";
+    readonly 'settings.editorFontSize': "编辑器字号（仅编辑页显示）";
+    readonly 'settings.editorFontSizeHint': "存于浏览器本地，不影响其他设备";
+    readonly 'settings.autoReview': "生成后自动审稿";
+    readonly 'settings.autoAuthorReview': "生成后自动作者复盘";
+    readonly 'settings.autoAuthorReviewHint': "复盘钩子兑现/结尾钩子/剧情线推进/连续性/节奏趋势，每章约 2000 token";
+    readonly 'settings.autoReviewAfterRevise': "修订后自动审查";
+    readonly 'settings.autoReviewAfterReviseHint': "按意见修订/润色产出草稿后自动附带一次 AI 审查，直接显示新稿评分与剩余问题（每章约 2-3k token，可关）";
+    readonly 'settings.save': "保存设置";
+    readonly 'settings.saved': "设置已保存";
+    readonly 'settings.openFolder': "打开输出文件夹";
+    readonly 'settings.export': "导出";
+    readonly 'settings.exportTxt': "导出 TXT";
+    readonly 'settings.exportMd': "导出 Markdown";
+    readonly 'settings.exported': "已导出：{file}（{chars} 字，{chapters} 章）";
+    readonly 'progress.generating': "正在生成第 {no} 章《{title}》…";
+    readonly 'progress.done': "第 {no} 章完成（{chars} 字）→ {file}";
+    readonly 'progress.reviewed': "第 {no} 章审稿：{score} 分 — {verdict}";
+    readonly 'progress.error': "第 {no} 章失败：{message}";
+    readonly 'progress.rewriting': "正在修订第 {no} 章…";
+    readonly 'progress.polishing': "正在润色第 {no} 章…";
+    readonly 'progress.empty': "生成/审稿进度将显示在这里";
+    readonly 'assistant.hint': "和 AI 编辑讨论剧情、人设、暗线；达成一致后可让它直接修改总纲、道藏、章节内容。";
+    readonly 'assistant.placeholder': "例如：我想让第 2 章结尾加一个悬念——墟境里传来爷爷的声音…";
+    readonly 'assistant.send': "发送";
+    readonly 'assistant.toolStart': "⚙ 执行操作：{name}…";
+    readonly 'assistant.toolDone': "✓ {name} 完成：{detail}";
+    readonly 'assistant.toolError': "✗ {name} 失败：{detail}";
+    readonly 'assistant.empty': "还没有对话。和 AI 编辑聊聊剧情吧。";
+    readonly 'status.projectNone': "输出目录中还没有项目。请先加载大纲。";
+    readonly 'status.files': "已生成文件";
+    readonly 'api.error': "请求失败";
+};
+/** en dictionary (fallback). */
+export declare const en: Record<string, string>;
+/** Keys type for the zh dictionary. */
+export type NovelKey = keyof typeof zh;