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

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

@@ -8,7 +8,7 @@
  * 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, ProgressionMode, ProjectAssets, StyleAsset, StyleTemplate } from './protocol.ts';
+import type { AntiAiRule, GenreNode, PlotBeatTemplate, ProgressionMode, ProjectAssets, StarterStyleProfile, 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）。 */
@@ -17,19 +17,34 @@ 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[];
-/** 把生效规则渲染成提示词块。 */
+/** 安定 key：内置规则全局基线（globalBaselineEnabled）在新书/旧书一律生效。 */
+export declare function ensureGlobalBaseline(assets: ProjectAssets | undefined): ProjectAssets;
+/** 内置库种子化 upsert（对齐上游 SystemResourceBootstrapService 精神）。
+ *  missing_only 仅补齐缺失的全局基线规则；sync_existing 还会按 key 刷新已内置规则的结构化字段。 */
+export declare function ensureBuiltinAssets(assets: ProjectAssets | undefined, mode?: 'missing_only' | 'sync_existing'): ProjectAssets;
+/** 把生效规则渲染成提示词块（禁止/风险/鼓励三档分列，压缩省 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;
-/** 写法引擎：从样本文本提取风格资产的系统提示词。 */
+/** 起始风格画像库：无样本文本也能快速绑定一套写法（对齐上游 DEFAULT_STARTER_STYLE_PROFILES）。 */
+export declare const BUILTIN_STARTER_STYLE_PROFILES: StarterStyleProfile[];
+/** 起始风格画像 → 可直接绑定的 StyleAsset（绑定对应模板，名称用画像名）。 */
+export declare function starterProfileToAsset(profile: StarterStyleProfile): StyleAsset | null;
+/** 根据指纹风险推荐仿写预设：low→imitate / medium→balanced / high→transfer。 */
+export declare function recommendStylePreset(fingerprintRisk?: 'low' | 'medium' | 'high'): 'imitate' | 'balanced' | 'transfer';
+/** 写法引擎：从样本文本提取风格资产的系统提示词（含 preset / 指纹 / 净化管线）。 */
 export declare function styleEngineSystemPrompt(): string;
+/** 写作公式提取系统提示词（分层：basic 骨架 / standard 完整 / deep 逐句细化）。 */
+export declare function styleFormulaSystemPrompt(depth: 'basic' | 'standard' | 'deep'): string;

package/lib/types/assistant.d.ts

@@ -19,6 +19,8 @@ import { chapterFileName } from './engine.ts';
 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
@@ -39,5 +41,9 @@ export declare function runAssistantTurn(ctx: Context, config: NovelConfig, proj
     frame: 'toolDelta';
     name: string;
     text: string;
+} | {
+    frame: 'toolResult';
+    name: string;
+    text: string;
 }, void, unknown>;
 export { chapterFileName };

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/bookshelf.d.ts

@@ -26,12 +26,22 @@ export declare function renameBook(id: string, bookName: string): boolean;
  * @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;
-/** 默认输出目录推断：桌面/书名。 */
+/**
+ * 书目录重指向：把 outputDir 等于 from 的书条目全部改为 to（目录迁移联动）。
+ * @returns 重指向的条目数。
+ */
+export declare function repointBookDirs(from: string, to: string): number;
+/** 默认输出目录推断：~/.dsh/novels/书名。 */
 export declare function defaultOutputDirFor(bookName: string): string;
 export {};

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

@@ -3,11 +3,12 @@
  * 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 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);
 }
+export declare function setCurrentBook(id: string | null): void;
 /** The browser half's only data entry point. */
 export declare class NovelApi {
     status(): Promise<StatusResponse>;
@@ -16,6 +17,12 @@ export declare class NovelApi {
         ok: boolean;
         bookName: string;
     }>;
+    /** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流）。 */
+    outlineReverse(onFrame: (frame: JobFrame) => void): Promise<void>;
+    /** 开书想法 → 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>;
@@ -28,10 +35,22 @@ export declare class NovelApi {
     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;
     }>;
+    /** 输出目录迁移：dryRun=true 仅预览目录内容；确认时传 to 搬迁。 */
+    moveOutputDir(to?: string, dryRun?: boolean): Promise<import('../protocol.ts').MoveOutputDirResponse>;
+    /** 本书参数：不带 patch 读取；带 patch 合并保存（字段传 null = 回退全局）。 */
+    bookSettings(patch?: Record<string, unknown>): Promise<import('../protocol.ts').BookSettingsResponse>;
     openFolder(): Promise<void>;
+    /** 插件自更新：在 DSH profile 目录拉取最新 npm 版（需重启 DSH 生效）。 */
+    pluginUpdate(): Promise<PluginUpdateResponse>;
     /** 书架快照。 */
     bookshelf(): Promise<import('../protocol.ts').BookshelfSnapshot>;
     /** 新建书并激活（开书向导：可携带大纲文本，创建即建项目）。 */
@@ -43,6 +62,94 @@ export declare class NovelApi {
     }>;
     /** 全书一致性质检。 */
     audit(): Promise<import('../protocol.ts').AuditResponse>;
+    /** 热门题材雷达：信号 + 生产底座。 */
+    marketRadar(req: import('../protocol.ts').MarketRadarRequest): Promise<{
+        result: import('../protocol.ts').MarketRadarResult;
+    }>;
+    /** 真实榜单扫榜：抓取公开榜单，返回分组候选。 */
+    marketRadarScan(req: {
+        platforms?: string[];
+    }): Promise<{
+        result: {
+            scannedAt: string;
+            groups: any[];
+        };
+    }>;
+    /** 把雷达生产底座里的新资产同步进全局资源库（跨书复用；已有名字跳过）。 */
+    marketRadarSync(req: {
+        foundation: import('../protocol.ts').ProductionFoundation;
+    }): Promise<{
+        ok: boolean;
+        synced: {
+            genre: boolean;
+            primaryMode: boolean;
+            secondaryMode: boolean;
+        };
+    }>;
+    /** 书内知识库：读取。 */
+    knowledgeList(): Promise<{
+        docs: import('../protocol.ts').KnowledgeDoc[];
+    }>;
+    /** 书内知识库：新增。 */
+    knowledgeAdd(doc: {
+        title: string;
+        content: string;
+    }): Promise<{
+        docs: import('../protocol.ts').KnowledgeDoc[];
+    }>;
+    /** 书内知识库：删除。 */
+    knowledgeRemove(id: string): Promise<{
+        docs: import('../protocol.ts').KnowledgeDoc[];
+    }>;
+    /** 书分析/拆书。 */
+    bookAnalysis(text: string): Promise<{
+        result: import('../protocol.ts').BookAnalysisResult;
+    }>;
+    /** 创意灵感。 */
+    ideaInspiration(idea: string, count?: number): Promise<{
+        result: import('../protocol.ts').IdeaInspirationResult;
+    }>;
+    /** 雷达→灵感：基于市场信号/生产底座/创意简报生成开书灵感。 */
+    marketIdeaInspiration(req: {
+        signals?: import('../protocol.ts').MarketRadarSignal[];
+        foundation?: import('../protocol.ts').ProductionFoundation;
+        brief?: import('../protocol.ts').MarketCreativeBrief;
+        count?: number;
+    }): Promise<{
+        result: import('../protocol.ts').IdeaInspirationResult;
+    }>;
+    /** 自动编辑编排建议：基于全书上下文。 */
+    director(focus?: string): Promise<{
+        result: import('../protocol.ts').DirectorAdvice;
+    }>;
+    /** 自动编辑「采纳」出的书内待办：读取。 */
+    directorTodosList(): Promise<{
+        todos: import('../protocol.ts').DirectorTodo[];
+    }>;
+    /** 待办：新增（来源 risk/fix）。 */
+    directorTodosAdd(text: string, source: 'risk' | 'fix'): Promise<{
+        todos: import('../protocol.ts').DirectorTodo[];
+    }>;
+    /** 待办：勾选/取消。 */
+    directorTodosToggle(id: string): Promise<{
+        todos: import('../protocol.ts').DirectorTodo[];
+    }>;
+    /** 待办：删除。 */
+    directorTodosRemove(id: string): Promise<{
+        todos: import('../protocol.ts').DirectorTodo[];
+    }>;
+    /** 用选中的市场信号 + 影响模式生成开书创意简报。 */
+    marketRadarBrief(req: import('../protocol.ts').MarketRadarBriefRequest): Promise<{
+        creativeBrief: import('../protocol.ts').MarketCreativeBrief;
+    }>;
+    /** 把雷达生产底座一键应用到某本书（写入项目资产/开书定盘）。 */
+    marketRadarApply(req: {
+        bookId?: string;
+        foundation: import('../protocol.ts').ProductionFoundation;
+    }): Promise<{
+        ok: boolean;
+        bookName: string;
+    }>;
     /** 角色卡刷新（基于事实库聚合）。 */
     charactersRefresh(): Promise<{
         cards: import('../protocol.ts').RoleStatusCard[];
@@ -52,14 +159,81 @@ export declare class NovelApi {
         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;
+    }>;
+    /** 对选中的提供商/模型发一次最小真实调用，验证连通性。 */
+    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>;
+    /** 小说简介：生成/补全（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;
+    }>;
+    /** 大世界：提炼（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. */
@@ -81,11 +255,13 @@ export declare class NovelApi {
     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>;
-    /** 采纳待确认草稿（润色/重写产物），覆盖正文文件。 */
-    draftApply(chapterNo: number): Promise<{
+    /** 采纳待确认草稿（润色/重写产物），覆盖正文文件。返回采纳后的新正文（markdown）。
+     *  可携带审查报告（沿用结论定状态：通过 → approved）。 */
+    draftApply(chapterNo: number, report?: import('../protocol.ts').ReviewReport): Promise<{
         ok: boolean;
         chars: number;
         file: string;
+        markdown: string;
     }>;
     /** 放弃待确认草稿，保留原稿。 */
     draftDiscard(chapterNo: number): Promise<{
@@ -95,4 +271,34 @@ export declare class NovelApi {
     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/client/docx.d.ts

@@ -8,6 +8,8 @@
  * 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.
+ *
+ * XML 解析共享核心在 ../docx-core.ts（与服务端同源）。
  */
 /** Extract plain text from a docx buffer: one line per <w:p> paragraph. */
 export declare function extractDocxTextFromBuffer(buffer: ArrayBuffer | Uint8Array): string;

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

@@ -4,7 +4,7 @@
  * problems are logged, never thrown — the web shell fails the whole boot when
  * a plugin apply throws.
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
 /** Required services (fiber inject waiting). */
 export declare const inject: string[];
 /**

package/lib/types/client/llmLive.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 浏览器端「AI 创作实况」钩子：连接 /llm-live/stream (SSE)，按 LLM 调用分组会话。
+ * 轻量实现，不持久化缓存（对齐上游 useLlmLiveFeed 的核心行为）。
+ */
+export interface LlmLiveFrame {
+    type: 'session_started' | 'output_delta' | 'reasoning_delta' | 'phase_changed' | 'session_completed';
+    sessionId: string;
+    label?: string;
+    model?: string;
+    at: string;
+    content?: string;
+    totalChars?: number;
+    totalReasoningChars?: number;
+    phase?: 'requesting' | 'streaming' | 'completed' | 'failed';
+    phaseMessage?: string;
+    preview?: string;
+    error?: string;
+}
+export interface LlmLiveSession {
+    sessionId: string;
+    label: string;
+    model?: string;
+    phase: 'requesting' | 'streaming' | 'completed' | 'failed';
+    phaseMessage: string;
+    preview: string;
+    totalChars: number;
+    startedAt: string;
+    updatedAt: string;
+}
+export declare function useLlmLiveFeed(enabled?: boolean): {
+    connected: boolean;
+    sessions: LlmLiveSession[];
+};