@waterwx/dsh-novel-forge 1.3.1 → 1.3.2-alpha

package/lib/types/action-guard.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 动作失败分级（fail-stop 规则）——不依赖 LLM/宿主服务的纯逻辑模块，可离线单测。
+ *
+ * 规则来源（借鉴同类 DSH 小说插件的规则设计）：
+ *  - 参数/契约类失败**不得重复同一调用**，解释一次即停；
+ *  - 瞬时故障允许有限重试，同样禁止无限重试。
+ * 规则必须可测试，否则只是文档。
+ */
+/**
+ * 动作失败分级：
+ * - `contract` 参数/契约类（参数缺失、片段未找到、章节不存在、非法取值…）：
+ *   同一调用只允许修正一次，禁止原样重复。
+ * - `transient` 瞬时故障（网络、模型中断、磁盘临时不可用…）：允许重试一次。
+ */
+export type ActionErrorKind = 'contract' | 'transient';
+/** 带分级的动作失败（executeAction 抛出，供 fail-stop 判定）。 */
+export declare class NovelActionError extends Error {
+    readonly kind: ActionErrorKind;
+    constructor(kind: ActionErrorKind, message: string);
+}
+/**
+ * 判定一次动作失败的类别。
+ *
+ * @param error 捕获到的异常。
+ * @returns `contract`（参数/契约，不重试原样调用）或 `transient`（瞬时，可重试一次）。
+ */
+export declare function classifyActionError(error: unknown): ActionErrorKind;
+/**
+ * 同一调用签名允许的总尝试次数（含首次）。
+ *
+ * @param kind 失败类别。
+ * @returns `contract` = 1（禁止原样重复），`transient` = 2（允许一次重试）。
+ */
+export declare function actionRetryLimit(kind: ActionErrorKind): number;
+/**
+ * 把动作参数规范化为稳定签名（键排序），用于识别「同一个调用」。
+ *
+ * @param args 动作参数。
+ * @returns 稳定字符串签名。
+ */
+export declare function safeArgsKey(args: Record<string, unknown> | undefined): string;
+/**
+ * 已失败调用记账：同一签名达到重试上限即 fail-stop。
+ */
+export declare class FailureLedger {
+    private readonly counts;
+    /**
+     * 记录一次失败并判断是否应当停止本轮。
+     *
+     * @param tool 工具名。
+     * @param args 该次调用参数。
+     * @param kind 失败类别。
+     * @returns `attempts` 本次是第几次失败；`stop` 是否达到上限（true = 立即停止，不再喂回模型）。
+     */
+    record(tool: string, args: Record<string, unknown> | undefined, kind: ActionErrorKind): {
+        attempts: number;
+        stop: boolean;
+    };
+    /** 已登记的失败签名数量（测试/诊断用）。 */
+    get size(): number;
+}

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

@@ -1,27 +1,34 @@
 /**
  * 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
+ * 内置种子数据（本项目自研表述；结构参考了同类工具的功能划分）：
+ * - 8 套预置叙事风格模板
+ * - 12 条带命中模式的反 AI 规则
+ * - 题材树 + 推进模式种子
  * 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';
-/** 预置写法模板（来自 AI-Novel-Writing-Assistant 内置 DEFAULT_STYLE_TEMPLATES）。 */
+import type { AntiAiRule, GenreNode, PlotBeatTemplate, ProgressionMode, ProjectAssets, StarterStyleProfile, StyleAsset, StyleTemplate } from './protocol.ts';
+/** 预置叙事风格模板（8 套，一键绑定无需样本文本）。 */
 export declare const BUILTIN_STYLE_TEMPLATES: StyleTemplate[];
-/** 内置全局反 AI 规则（来自 AI-Novel-Writing-Assistant 内置 DEFAULT_ANTI_AI_RULES）。 */
+/** 内置全局反 AI 规则（12 条，随插件发布；项目可叠加自定义规则）。 */
 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[];
-/** 把生效规则渲染成提示词块（压缩：avoid/fix 截断，省 token）。 */
+/** 安定 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;
@@ -31,5 +38,13 @@ export declare function renderStyleAssets(assets: ProjectAssets | undefined): st
 export declare function renderAllAssets(assets: ProjectAssets | undefined): string;
 /** 预置写法模板 → 可直接绑定的 StyleAsset。 */
 export declare function styleTemplateToAsset(template: StyleTemplate): StyleAsset;
-/** 写法引擎：从样本文本提取风格资产的系统提示词。 */
+/** 起始风格画像库：无样本文本也能快速绑定一套写法（4 档起步写法）。 */
+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

@@ -15,8 +15,33 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { AssistantMessage, NovelConfig, ProjectState } from './protocol.ts';
 import { chapterFileName } from './engine.ts';
+import { type BookStage } from './stage-contract.ts';
 /** History file name inside the output dir. */
 export declare const ASSISTANT_HISTORY_FILE = "novel-assistant.jsonl";
+/**
+ * 按阶段渲染动作说明书。
+ *
+ * - `strict=false`（作者点明了要做什么）：全量说明书照给，只靠动作可见性段提示
+ *   哪些属于阶段外——作者有权指定任意动作。
+ * - `strict=true`（作者只说「继续/下一步」）：阶段外的写操作说明书直接**从提示词里移除**，
+ *   和执行层的阶段白名单完全一致，模型不再有机会去试错撞守卫。
+ *
+ * @param docs 动作说明书行。
+ * @param stage 阶段契约。
+ * @param strict 是否为「阶段即唯一命令」模式。
+ * @returns 裁剪后的说明书行。
+ */
+export declare function renderToolDocs(docs: readonly string[], stage: BookStage, strict: boolean): string[];
+/**
+ * 渲染「动作可见性」：把写操作分成「本阶段可用」与「阶段外（仅作者点名时执行）」，
+ * 让模型不必靠试错去发现哪些动作会被拒绝。
+ *
+ * @param stage 阶段契约。
+ * @returns 多行文本。
+ */
+export declare function renderActionVisibility(stage: BookStage): string;
+export { classifyActionError, actionRetryLimit, safeArgsKey, NovelActionError, FailureLedger } from './action-guard.ts';
+export type { ActionErrorKind } from './action-guard.ts';
 /** Load the persisted conversation (empty when none). */
 export declare function loadAssistantHistory(outputDir: string): AssistantMessage[];
 /** 清空助手对话记录（删除历史文件）。 */
@@ -41,5 +66,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 RevisionPlanResponse, 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,8 @@ 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>;
     /** 拆书分析：对已写章节做结构/人物/文风/卖点体检。 */
@@ -30,18 +33,32 @@ export declare class NovelApi {
         summary: string;
     }>;
     foreshadow(req: ForeshadowRequest): Promise<ForeshadowResponse>;
-    exportBook(format: 'txt' | 'md'): Promise<ExportResponse>;
+    exportBook(format: 'txt' | 'md' | 'json', scope?: import('../protocol.ts').ExportScope): Promise<ExportResponse>;
     chapter(no: number): Promise<ChapterResponse>;
     /** 审查手动编辑的正文（不落盘）。previousReport 传入时走「验证模式」（核对原意见解决 + 只挑新增 high）。 */
     chapterCheck(no: number, text: string, previousReport?: ReviewReport): Promise<{
         report: ReviewReport;
     }>;
+    /**
+     * 修订指令合并：把本章的审稿意见（勾选项）+ 时间线矛盾 + 张力偏差合成**一份**指令。
+     * 面板所有「按意见修订 / 一键按建议修订」入口都先走这里，保证同一章只改一轮。
+     */
+    revisionPlan(no: number, reviewIssues?: ReviewReport['issues'], opts?: {
+        includeTimeline?: boolean;
+        includeTension?: boolean;
+    }): Promise<RevisionPlanResponse>;
     /** 保存手动编辑的正文（自动备份 .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>;
     /** 新建书并激活（开书向导：可携带大纲文本，创建即建项目）。 */
@@ -53,6 +70,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[];
@@ -62,7 +167,7 @@ export declare class NovelApi {
         ok: boolean;
         filled: number;
     }>;
-    /** 设定圣经局部修补。 */
+    /** 道藏局部修补。 */
     biblePatch(patch: import('../protocol.ts').BiblePatchRequest): Promise<{
         bible: import('../protocol.ts').StoryBible;
     }>;
@@ -87,13 +192,20 @@ export declare class NovelApi {
         ok: boolean;
         no: number;
     }>;
-    /** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+    /** 对选中的提供商/模型发一次最小真实调用，验证连通性。 */
+    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>;
-    /** 场景库：AI 提炼 / 采纳 / 更新 / 删除 / 图集。 */
-    scenes(req: import('../protocol.ts').ScenesRequest): Promise<import('../protocol.ts').ScenesResponse>;
-    /** 视觉世界观规则：提炼 / 保存。 */
-    visualRules(req: import('../protocol.ts').VisualRulesRequest): Promise<import('../protocol.ts').VisualRulesResponse>;
-    /** 小说简介：AI 生成/补全（partial 留空 = 全量），或手动保存。 */
+    /** 小说简介：生成/补全（partial 留空 = 全量），或手动保存。 */
     blurb(action: 'generate' | 'save', text?: string, partial?: string): Promise<{
         blurb: string;
     }>;
@@ -108,7 +220,7 @@ export declare class NovelApi {
     rename(bookName: string): Promise<{
         bookName: string;
     }>;
-    /** 大世界：AI 提炼（generate）或手动保存（save）。 */
+    /** 大世界：提炼（generate）或手动保存（save）。 */
     world(action: 'generate' | 'save', world?: import('../protocol.ts').WorldState): Promise<{
         world: import('../protocol.ts').WorldState;
     }>;
@@ -116,6 +228,14 @@ export declare class NovelApi {
     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。 */
@@ -157,10 +277,66 @@ export declare class NovelApi {
     }>;
     /** Run one assistant turn (NDJSON stream). */
     assistant(message: string, onFrame: (frame: import('../protocol.ts').AssistantFrame) => void): Promise<void>;
+    /** 张力曲线：数据 + 规则核对。 */
+    tension(): Promise<import('../protocol.ts').TensionResponse>;
+    /** 设置张力曲线预设。 */
+    tensionPreset(preset: import('../protocol.ts').TensionCurvePreset): Promise<void>;
+    /** 设置/清除某一章的目标张力。 */
+    tensionSet(chapterNo: number, tension?: number): Promise<void>;
+    /** 提示词槽位：列表。 */
+    promptSlots(): Promise<import('../protocol.ts').PromptSlotsResponse>;
+    /** 写入一个提示词槽位（空串 = 清空）。 */
+    promptSlotSet(id: import('../protocol.ts').PromptSlotId, value: string): Promise<void>;
+    /** 故事时间线：列表（含规则初筛问题）。 */
+    timeline(): Promise<import('../protocol.ts').TimelineResponse>;
+    /** 抽取某一章的时间线事件。 */
+    timelineExtract(chapterNo: number): Promise<{
+        events: import('../protocol.ts').TimelineEvent[];
+    }>;
+    /** 检查时间线矛盾（规则初筛 + AI 复核）。 */
+    timelineCheck(): Promise<import('../protocol.ts').TimelineResponse>;
+    /** 手工修正一条时间线事件。 */
+    timelineUpdate(event: import('../protocol.ts').TimelineEvent): Promise<void>;
+    /** 删除一条时间线事件。 */
+    timelineRemove(id: string): Promise<void>;
+    /** 章节历史版本列表。 */
+    snapshots(): Promise<import('../protocol.ts').SnapshotResponse>;
+    /** 回滚到某个历史版本。 */
+    snapshotRestore(id: string): Promise<void>;
+    /** 给某章手工存档。 */
+    snapshotCreate(chapterNo: number): Promise<void>;
+    /** 删除一个历史版本。 */
+    snapshotRemove(id: string): 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/chip-prefs.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 右上角「小说工坊生成状态」芯片的显示偏好（纯客户端、localStorage）。
+ *
+ * 为什么是 localStorage 而不是插件配置：这是纯界面 chrome，与显示模式 / 界面密度 /
+ * 编辑器字号 / 芯片自身的位置记忆同类；哪个浏览器想清屏就哪个浏览器清，不需要跨端同步。
+ * 将来若要跨端，把键名沿用成 config 字段 `showRunChip` 即可平滑升级。
+ *
+ * 三态：
+ *   off    关闭（同时停止 4 秒轮询，不白跑）
+ *   active 只在生产单**运行中或已暂停**时显示（不想错过生成，也不想留残影）
+ *   always 只要该目录有生产单状态就显示（默认，保持历史行为）
+ */
+import type { RunState } from '../protocol.ts';
+export type RunChipMode = 'off' | 'active' | 'always';
+/** localStorage 键（与芯片位置记忆同一命名空间）。 */
+export declare const RUN_CHIP_MODE_KEY = "dsh-novel-forge.runChip.mode";
+/** 同页变更通知用的自定义事件名（跨标签页走原生 storage 事件）。 */
+export declare const RUN_CHIP_MODE_EVENT = "dsh-novel-forge:runchip-mode";
+/** 默认值与历史行为一致：有生产单状态就显示。 */
+export declare const DEFAULT_RUN_CHIP_MODE: RunChipMode;
+/** 设置页下拉用的三态选项（顺序即用户看到的顺序）。 */
+export declare const RUN_CHIP_MODE_OPTIONS: ReadonlyArray<{
+    value: RunChipMode;
+    label: string;
+}>;
+/** 读取偏好（缺失 / 非法 / 存储不可用 → 默认值）。 */
+export declare function readRunChipMode(): RunChipMode;
+/** 写入偏好并通知所有监听者；存储不可用时仍通知（本次会话内生效）。 */
+export declare function writeRunChipMode(mode: RunChipMode): void;
+/** 订阅偏好变化（同页 + 跨标签页 storage）；返回退订函数。 */
+export declare function subscribeRunChipMode(listener: (mode: RunChipMode) => void): () => void;
+/**
+ * 给定偏好与当前生产单状态，判断芯片是否应可见。
+ * null（没有生产单状态）永远不显示——这是渲染层与测试共用的唯一判据。
+ */
+export declare function isRunChipVisible(mode: RunChipMode, state: RunState | null | undefined): boolean;

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,31 @@
+/**
+ * 浏览器端「AI 创作实况」钩子：连接 /llm-live/stream (SSE)，按 LLM 调用分组会话。
+ * 轻量实现，不持久化缓存（对齐上游 useLlmLiveFeed 的核心行为）。
+ */
+import { type LlmLiveFrame, type LlmTokenUsage } from '../protocol.ts';
+export type { LlmLiveFrame };
+export interface LlmLiveSession {
+    sessionId: string;
+    label: string;
+    model?: string;
+    phase: 'requesting' | 'streaming' | 'completed' | 'failed';
+    phaseMessage: string;
+    preview: string;
+    totalChars: number;
+    startedAt: string;
+    updatedAt: string;
+    /** 本次调用的 token 用量（供应商未上报时缺省）。 */
+    usage?: LlmTokenUsage;
+    /** 本次调用耗时（毫秒）。 */
+    elapsedMs?: number;
+    /** 首字耗时（毫秒）。 */
+    firstTokenMs?: number;
+    /** 是否保存了可查看的 Prompt。 */
+    hasPrompt?: boolean;
+    /** Prompt 字符数（system + user）。 */
+    promptChars?: number;
+}
+export declare function useLlmLiveFeed(enabled?: boolean): {
+    connected: boolean;
+    sessions: LlmLiveSession[];
+};