@waterwx/dsh-novel-forge 0.1.0 → 1.0.0-alpha

package/lib/types/review-policy.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 审稿规则注册表
+ *
+ * 生成用 compact 模式（核心规则），审稿用 full 模式（全部规则），
+ * 消除 reviewSystemPrompt 内嵌规则与 renderAllAssets() 两套打架的问题。
+ */
+/** 通用写作资产规则（兼容 ProjectAssets 中的各类规则） */
+export interface WritingRule {
+    name: string;
+    description: string;
+    type?: string;
+    enabled?: boolean;
+}
+export interface ReviewRule {
+    id: string;
+    /** 规则维度 */
+    dimension: 'character' | 'setting' | 'redline' | 'writing' | 'pacing' | 'logic' | 'anti-ai' | 'presentation' | 'compliance';
+    /** 严重度 */
+    severity: 'high' | 'medium' | 'low';
+    /** 规则类型：forbidden=禁止类（命中即问题），encourage=鼓励类（不命中不算错） */
+    type: 'forbidden' | 'encourage';
+    /** 规则描述 */
+    description: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 作用域 */
+    scope: Array<'writing' | 'review' | 'polish' | 'all'>;
+}
+/** 内置审稿维度（结构化评分用） */
+export declare const REVIEW_DIMENSIONS: readonly [{
+    readonly id: "character";
+    readonly name: "人设一致性";
+    readonly weight: 0.2;
+}, {
+    readonly id: "setting";
+    readonly name: "设定一致性";
+    readonly weight: 0.15;
+}, {
+    readonly id: "redline";
+    readonly name: "红线检查";
+    readonly weight: 0.15;
+}, {
+    readonly id: "writing";
+    readonly name: "文笔质量";
+    readonly weight: 0.15;
+}, {
+    readonly id: "pacing";
+    readonly name: "节奏与爽点";
+    readonly weight: 0.1;
+}, {
+    readonly id: "logic";
+    readonly name: "逻辑漏洞";
+    readonly weight: 0.1;
+}, {
+    readonly id: "anti-ai";
+    readonly name: "反 AI 规则";
+    readonly weight: 0.05;
+}, {
+    readonly id: "presentation";
+    readonly name: "呈现方式";
+    readonly weight: 0.05;
+}, {
+    readonly id: "compliance";
+    readonly name: "内容合规";
+    readonly weight: 0.05;
+}];
+export type ReviewDimensionId = typeof REVIEW_DIMENSIONS[number]['id'];
+/** 维度结构化评分 */
+export interface DimensionScore {
+    dimension: ReviewDimensionId;
+    score: number;
+    note: string;
+}
+/**
+ * 渲染审稿规则（compact 或 full 模式）
+ *
+ * compact: 只渲染禁止类 + high 严重度（用于生成时的约束）
+ * full: 渲染全部启用规则（用于审稿时的检查清单）
+ */
+export declare function renderReviewRules(assets: WritingRule[] | undefined, mode?: 'compact' | 'full'): string;
+/**
+ * 从审稿 issues 中按维度统计
+ * 用于结构化评分和 UI 展示。
+ */
+export declare function groupIssuesByDimension(issues: Array<{
+    severity: string;
+    item: string;
+    dimension?: string;
+}>): Record<string, Array<{
+    severity: string;
+    item: string;
+}>>;
+/**
+ * 计算维度加权总分
+ * 用于审稿报告的结构化评分。
+ */
+export declare function calculateWeightedScore(dimensions: DimensionScore[]): number;

package/lib/types/run.d.ts

@@ -0,0 +1,32 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { NovelConfig, RunState } from './protocol.ts';
+export declare class ProductionRunner {
+    private deps;
+    private state;
+    private working;
+    private pauseRequested;
+    private stopRequested;
+    /** 生产单绑定目录（start 时快照；所有读写固定用它，防止运行中切书导致写错目录）。 */
+    private bookDir;
+    constructor(deps: {
+        ctx: Context;
+        getConfig: () => NovelConfig;
+    });
+    /** 当前生产单状态（内存优先；web 重启后从磁盘恢复）。 */
+    status(): RunState | null;
+    private persist;
+    private log;
+    /** 启动/续跑生产单：startNo..endNo 区间，endNo 超出计划时先自动补计划。 */
+    start(startNo: number, endNo: number, runDir?: string): Promise<RunState>;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    /** 主循环：从 currentNo 扫描到 endNo，逐章处理；支持暂停/停止。 */
+    private loop;
+    private processChapter;
+    /** 完整质量门：生成 → 摘要+事实 → 伏笔标记 → 审稿 → 作者复盘。 */
+    private produce;
+    /** 被拒分级处理：无 high 豁免；有 high 按意见修订（最多 2 轮）+ 验证模式；仍不过 → 待人工。 */
+    private handleRejected;
+    private applyDraft;
+}

package/lib/types/shot-language.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 镜头语言词库（分镜规范化基准）。
+ * 分镜表的 shot/camera/composition/light 字段统一从这里取值（英文 id），
+ * 生成提示词时用 zh 中文词块；适配英文平台时用 en。
+ * 目的：让"景别/运镜/构图/光效"有标准词表，避免 LLM 自由发挥导致漂移。
+ */
+/** 景别。 */
+export type ShotSizeId = 'extreme_wide' | 'wide' | 'full' | 'medium' | 'medium_close' | 'close' | 'extreme_close' | 'big_extreme_close';
+/** 运镜/机位。 */
+export type CameraMoveId = 'static' | 'dolly_in' | 'dolly_out' | 'pan_left' | 'pan_right' | 'track_left' | 'track_right' | 'follow' | 'pedestal_up' | 'pedestal_down' | 'orbit' | 'handheld' | 'low_angle' | 'high_angle' | 'over_shoulder';
+/** 构图。 */
+export type CompositionId = 'rule_of_thirds' | 'center' | 'leading_line' | 'foreground' | 'low' | 'overhead' | 'symmetry';
+/** 光效。 */
+export type LightingId = 'front' | 'side' | 'back' | 'top' | 'rembrandt' | 'neon' | 'hard' | 'soft' | 'mood' | 'contrast';
+export interface ShotLangEntry<T extends string> {
+    id: T;
+    /** 中文（提示词/展示用）。 */
+    zh: string;
+    /** 英文（英文平台适配用）。 */
+    en: string;
+    /** 一句话说明（下拉/卡片）。 */
+    hint: string;
+}
+export declare const SHOT_SIZES: readonly ShotLangEntry<ShotSizeId>[];
+export declare const CAMERA_MOVES: readonly ShotLangEntry<CameraMoveId>[];
+export declare const COMPOSITIONS: readonly ShotLangEntry<CompositionId>[];
+export declare const LIGHTINGS: readonly ShotLangEntry<LightingId>[];
+export interface ShotLanguage {
+    shot?: ShotSizeId;
+    camera: CameraMoveId[];
+    composition?: CompositionId;
+    light: LightingId[];
+}
+/** 从中文文本归一化到景别（处理旧数据/LLM 口语）。未知回退 medium。 */
+export declare function normalizeShotSize(text: string | undefined): ShotSizeId;
+/** 从中文文本归一化到运镜列表。 */
+export declare function normalizeCameras(text: string | undefined): CameraMoveId[];
+/** 从中文文本归一化到构图（可选）。 */
+export declare function normalizeComposition(text: string | undefined): CompositionId | undefined;
+/** 从中文文本归一化到光效列表。 */
+export declare function normalizeLightings(text: string | undefined): LightingId[];
+/** 取词条中文（ZHs 合并句子）。 */
+export declare function sizeZh(id: ShotSizeId | undefined): string;
+export declare function cameraZh(ids: CameraMoveId[] | undefined): string;
+export declare function compoZh(id: CompositionId | undefined): string;
+export declare function lightZh(ids: LightingId[] | undefined): string;

package/lib/types/src/ai-scan.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 本地 AI 味扫描器（不调 LLM，确定性检测）
+ *
+ * 用途：生成/润色后自动扫描，结果作为「事实锚点」注入审稿提示词，
+ * 让 LLM 做判断而非机械统计。也可用于 UI 展示 AI 味指标。
+ */
+export interface AiScanResult {
+    /** 总评分 0-100，越高越像 AI 写的 */
+    aiScore: number;
+    /** 命中的套话及次数 */
+    clicheHits: Array<{
+        word: string;
+        count: number;
+    }>;
+    /** 段落长度方差（过高=段落过于整齐） */
+    paragraphLengthVariance: number;
+    /** 连续解释性叙事段数（≥3 视为问题） */
+    consecutiveExpositoryParagraphs: number;
+    /** 句式重复率（相同开头句式占比） */
+    sentenceRepetitionRate: number;
+    /** 过长段落数（>300字） */
+    longParagraphCount: number;
+    /** 过短段落数（<20字） */
+    shortParagraphCount: number;
+    /** 对话占比（0-1） */
+    dialogueRatio: number;
+    /** 问题摘要，可直接注入审稿提示词 */
+    summary: string;
+}
+export declare function scanAiFlavor(text: string): AiScanResult;
+/** 扫描前后对比（润色时用） */
+export declare function compareAiScan(before: AiScanResult, after: AiScanResult): {
+    improved: boolean;
+    deltaScore: number;
+    details: string[];
+};

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;