@waterwx/dsh-novel-forge 2.1.5 → 2.3.0

package/lib/types/assistant.d.ts

@@ -54,7 +54,7 @@ export declare function clearAssistantHistory(outputDir: string): void;
  */
 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<{
+export declare function runAssistantTurn(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, userMessage: string, signal?: AbortSignal): AsyncGenerator<{
     frame: 'delta';
     text: string;
 } | {

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

@@ -3,7 +3,7 @@
  * fetch, same origin; generation/rewrite/polish ride NDJSON streams read
  * incrementally.
  */
-import { type AssetsPatch, type AssetsResponse, type 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';
+import { type AssetsPatch, type AssetsResponse, type AddModelRequest, type AddModelResponse, type LlmModelsResponse, type LlmProvidersResponse, type LlmVendorsResponse, type RemoveProviderRequest, type RemoveProviderResponse, type BibleResponse, type ChapterResponse, type ChapterPlanPatchResponse, 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);
@@ -49,6 +49,8 @@ export declare class NovelApi {
     }): Promise<RevisionPlanResponse>;
     /** 保存手动编辑的正文（自动备份 .bak；带报告则沿用落盘，否则保存后自动审稿）。 */
     chapterSave(no: number, text: string, report?: ReviewReport): Promise<import('../protocol.ts').ChapterSaveResponse>;
+    /** 补写本章计划（目标 / 必达 / 保持 / 硬事实 / 结尾钩子 / 剧情推进）：只覆盖传入字段。 */
+    chapterPlan(no: number, patch: import('../protocol.ts').ChapterPlanPatchRequest['patch']): Promise<ChapterPlanPatchResponse>;
     patchConfig(patch: ConfigPatch): Promise<{
         config: NovelConfig;
         settingsWarning?: string;

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

@@ -2,13 +2,14 @@
  * 浏览器端「AI 创作实况」钩子：连接 /llm-live/stream (SSE)，按 LLM 调用分组会话。
  * 轻量实现，不持久化缓存（对齐上游 useLlmLiveFeed 的核心行为）。
  */
-import { type LlmLiveFrame, type LlmTokenUsage } from '../protocol.ts';
+import { type LlmLiveFrame, type LlmLivePhase, type LlmTokenUsage } from '../protocol.ts';
 export type { LlmLiveFrame };
 export interface LlmLiveSession {
     sessionId: string;
     label: string;
     model?: string;
-    phase: 'requesting' | 'streaming' | 'completed' | 'failed';
+    /** 阶段契约只有一份定义（protocol.ts），面板不再自行枚举。 */
+    phase: LlmLivePhase;
     phaseMessage: string;
     preview: string;
     totalChars: number;
@@ -25,6 +26,10 @@ export interface LlmLiveSession {
     /** Prompt 字符数（system + user）。 */
     promptChars?: number;
 }
+/** 是否仍在进行中：cancelled 属于已结束，不能显示为「生成中」。 */
+export declare function isActivePhase(phase: LlmLivePhase): boolean;
+/** SSE 帧 → 会话表（纯函数，导出供单测覆盖 cancelled 结案）。 */
+export declare function applyFrame(current: Record<string, LlmLiveSession>, frame: LlmLiveFrame): Record<string, LlmLiveSession>;
 export declare function useLlmLiveFeed(enabled?: boolean): {
     connected: boolean;
     sessions: LlmLiveSession[];

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

@@ -83,6 +83,7 @@ export declare const zh: {
     readonly 'plotlines.kindMystery': "悬念线";
     readonly 'plotlines.goal': "目标/终点";
     readonly 'plotlines.progress': "当前进度";
+    readonly 'plotlines.nextGoal': "下一目标";
     readonly 'plotlines.status': "状态";
     readonly 'plotlines.statusActive': "推进中";
     readonly 'plotlines.statusPaused': "暂停";

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

@@ -0,0 +1,23 @@
+export type InboxTone = 'high' | 'warn' | 'info';
+export interface InboxItem {
+    id: string;
+    /** 要做什么（动词开头的一句话）。 */
+    title: string;
+    /** 来源：AI 审稿 · 高优 / 时间线 / 张力 / 待审 … */
+    source: string;
+    /** 补充说明（原因、影响、原文摘录）。 */
+    detail?: string;
+    tone: InboxTone;
+    actionLabel: string;
+    onAction: () => void;
+}
+export declare function AuthorInbox({ items, total, shown, onOpenAll, empty }: {
+    items: InboxItem[];
+    /** 未截断的总条数（> items.length 时提示还有多少）。 */
+    total: number;
+    /** 列表区最大高度由外层控制时用的展示条数说明。 */
+    shown?: number;
+    onOpenAll?: () => void;
+    /** 空态文案。 */
+    empty: string;
+}): JSX.Element;

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

@@ -0,0 +1,16 @@
+/**
+ * 资料侧柜内容（2.1.7）：本书此刻的生成上下文。
+ *
+ * 从 demo 的资料侧柜取**内容组织**：四张「此刻事实 + 新鲜度」卡 ——
+ *   编年录最近锚点 / 人物志当前状态 / 剧情线最近推进 / 写作资产当前绑定。
+ * 与 demo 的差别：数据全部取自真实存档（timeline / roleStatus / plotlines /
+ * assets.styleAssets），缺数据时给**可执行的空态**而不是留空；
+ * 「剧情线进度 42%」这类没有数据源的百分比不编（改用「推进章节 · 第 N 章」）。
+ *
+ * 形态由调用方决定：宿主里是**面板内的右滑抽屉**（demo 的 fixed 全屏遮罩层
+ * 放进宿主会话列会盖住整个窗口）。
+ */
+import type { ProjectState } from '../../protocol.ts';
+export declare function CabinetSnapshot({ project }: {
+    project: ProjectState | null;
+}): JSX.Element;

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

@@ -0,0 +1,24 @@
+import type { NovelApi } from '../api.ts';
+import type { ChapterPlan, Plotline } from '../../protocol.ts';
+/** 把章节 beats 按结构标签渲染（本章目标 / 剧情要点 / 爽点 / 结尾钩子 等前缀加粗）。 */
+export declare function renderBeats(beats: string): JSX.Element;
+export interface ChapterPlanPanelProps {
+    chapter: ChapterPlan;
+    /** 全部剧情线：内部按 `chapters` 是否含本章来筛关联项。 */
+    plotlines: Plotline[];
+    api: NovelApi;
+    busy: boolean;
+    /** 保存成功后回传合并结果，由外层并入 project.chapters（工作台的唯一数据源）。 */
+    onSaved: (chapter: ChapterPlan) => void;
+    /** 截断声明汇入外层（不静默吞掉：作者写了 6 条只留 4 条时必须看见）。 */
+    onNotice: (message: string) => void;
+    /** 关联剧情线的动作入口：打开「长线管理」抽屉。 */
+    onLinkLines: () => void;
+}
+/**
+ * 左栏计划面板：六项固定分组 + 就地补写。
+ *
+ * 编辑态一次只开一个分组：`patch` 只覆盖传入字段，同时开两处会让两个
+ * 草稿互相看不见，保存时机也变得含混。
+ */
+export declare function ChapterPlanPanel({ chapter, plotlines, api, busy, onSaved, onNotice, onLinkLines }: ChapterPlanPanelProps): JSX.Element;

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

@@ -1,4 +1,6 @@
 export type ConfirmTone = 'danger' | 'warn' | 'info';
+/** 弹层共用键盘边界与焦点回归；只有最上层弹窗响应按键。 */
+export declare function useDialogFocus(open: boolean, onClose: () => void, canClose?: boolean): import("react").MutableRefObject<HTMLElement | null>;
 export interface ConfirmSpec {
     /** 弹窗标题：一句话说清要做什么。 */
     title: string;

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

@@ -0,0 +1,60 @@
+/**
+ * 总编台 hero（2.1.7 / 取自 prototype/NovelForge_总编台_Demo.html 的信息结构）。
+ *
+ * 为什么要有它：此前的首屏是「4 张指标卡 + 工序轨道」，作者看到的是**仪表盘**，
+ * 得自己拼出"现在最该干什么"。hero 把这件事收敛成一条视线：
+ *   在哪一章 → 该做什么 → 为什么现在做 → 做它的代价 → 边界（不会自动改写正文）。
+ *
+ * 与 demo 的差别（刻意保留）：demo 的大标题是一句文学化钩子（"旧钥已经发热…"），
+ * 那需要"生成一句钩子"的数据源；这里用宿主**真实**的推荐动作标题，永远为真。
+ * 虚线右侧的进度/节点也全部来自真实状态，不编造百分比。
+ */
+import type { ReactNode } from 'react';
+export interface HomeHeroAction {
+    /** 眉标：推荐下一步 / 需要你确认 / 阶段：等待中 … */
+    eyebrow: string;
+    /** 主标题（一件具体的事）。 */
+    title: string;
+    /** 为什么现在做。 */
+    reason: string;
+    /** 主 CTA 文案（动词开头）。 */
+    actionLabel: string;
+    onClick: () => void;
+}
+export interface HomeHeroProps {
+    /** 当前对象（如「第 8 章 · 雨夜之后」）。 */
+    kicker: string;
+    /** 印章里的短标记（章号 / 阶段序号）。 */
+    seal: string;
+    /** 印章下方说明。 */
+    sealNote: string;
+    stageLabel?: string;
+    action: HomeHeroAction;
+    /** 次要动作（如「查看批注」）。 */
+    secondary?: {
+        label: string;
+        onClick: () => void;
+    };
+    busy: boolean;
+    busyLabel: string;
+    /** meta 行：只放**能真算出来**的事实。 */
+    meta: Array<{
+        label: string;
+        value: string;
+        tone?: 'ok' | 'warn' | 'bad';
+    }>;
+    /** 本批次进度；无批次传 null。 */
+    batch: {
+        label: string;
+        percent: number;
+        caption: string;
+    } | null;
+    /** 章节节点：上一章 / 现在 / 下一步。 */
+    nodes: Array<{
+        label: string;
+        text: string;
+        tone: 'done' | 'now' | 'next';
+    }>;
+    children?: ReactNode;
+}
+export declare function HomeHero({ kicker, seal, sealNote, stageLabel, action, secondary, busy, busyLabel, meta, batch, nodes, children, }: HomeHeroProps): JSX.Element;

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

@@ -0,0 +1,24 @@
+/**
+ * 审稿问题卡片（2.1.6 / 方案 §7「审稿问题卡片化」）。
+ *
+ * 为什么单独成卡而不是继续用 `<ul><li>`：
+ *   1. 此前每条意见被压成一行带色文字 —— 「问题」和「建议」用同一个色号、同一种排版，
+ *      作者扫读时无法快速分辨"哪句是诊断、哪句是处方"。
+ *   2. 勾选框与文字在同一行内联，窄容器下换行会把勾选框甩到行尾，勾错是常事。
+ *   3. 卡片把三件事固定成三层：**严重度徽章 + 维度** / **问题** / **建议**，
+ *      颜色只承担严重度（图形版语义色 → 文字版 -ink，保证对比度）。
+ */
+import type { ReactNode } from 'react';
+import type { ReviewIssue } from '../../protocol.ts';
+/** 严重度的作者口径文案（与 Severity 类型一一对应）。 */
+export declare const SEV_LABEL: Record<string, string>;
+export declare function ReviewIssueCard({ issue, dimensionLabel, checked, onToggle, disabled }: {
+    issue: ReviewIssue;
+    /** 维度中文名（由调用方查表，避免把文案表搬进组件）。 */
+    dimensionLabel?: string;
+    checked: boolean;
+    onToggle: (next: boolean) => void;
+    disabled?: boolean;
+    /** 预留：卡片右上角的附加动作（如「单条重写」）。 */
+    actions?: ReactNode;
+}): JSX.Element;

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

@@ -1,5 +1,7 @@
 import type { NovelApi } from '../api.ts';
-export declare function RunPanel({ api, totalChapters }: {
+export declare function RunPanel({ api, totalChapters, onOpenChapter }: {
     api: NovelApi;
     totalChapters: number;
+    /** 打开某章的章节工作台（队列行的「打开工作台」与失败态的重试入口共用）。 */
+    onOpenChapter?: (no: number) => void;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,6 @@
+export declare function SkeletonLines({ label, lines }: {
+    /** 说清「在等什么」，如「正在读取写作资产…」。 */
+    label: string;
+    /** 占位行数。 */
+    lines?: number;
+}): JSX.Element;

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

@@ -5,6 +5,7 @@
  * （键位不匹配会在编译期报错），保持客户端 bundle 自包含、不引入运行时语言服务。
  * 需要多语言时再接入 DSH 的 locale 服务，届时只需替换本函数实现。
  */
+import type { KeyboardEvent } from 'react';
 import { type NovelKey } from '../locales.ts';
 /** Translate one key with optional {placeholder} substitution. */
 export declare function tt(key: NovelKey, params?: Record<string, string | number>): string;
@@ -18,3 +19,14 @@ export declare function kindLabel(kind: string): string;
 export declare function plotlineStatusLabel(status: string): string;
 /** 剧情线状态颜色。 */
 export declare function plotlineStatusColor(status: string): string;
+/**
+ * 上下键在同类条目之间移动焦点（设计方案 §12「上下键移动章节列表 / 审稿问题」）。
+ *
+ * 只管焦点移动，不接管 Enter / 空格：条目保持原生 button 与 checkbox，
+ * 「空格勾选问题」「Enter 打开章节」继续由浏览器负责，不另造一套键盘语义。
+ * 焦点不在列表条目上时直接放行，方向键仍然用来滚动页面。
+ *
+ * @param event 列表容器上收到的 keydown。
+ * @param itemSelector 条目选择器，如 `.${css.wbIndexRow}` 或 `input[type="checkbox"]`。
+ */
+export declare function moveFocusByArrow(event: KeyboardEvent<HTMLElement>, itemSelector: string): void;

package/lib/types/engine.d.ts

@@ -4,13 +4,10 @@
  * auto-review + rewrite, polish (de-AI-ify), narrative summaries, foreshadow
  * tracking, project persistence, and whole-book export. Pure Node (no
  * web-server dependencies), so routes stay thin and logic is testable.
+ *
+ * 系统提示词全部住在 src/prompts/（按域拆分 + catalog 注册表），本文件只做
+ * 组装与调用——提示词文案的修改去对应域文件，不要在这里新起一段。
  */
-/**
- * 内容合规红线（平台硬性要求）：所有书籍、所有章节无条件生效，
- * 优先级高于单书大纲/道藏中的任何设定与作者自定义红线。
- * 注入点：章节生成系统提示 + 审稿系统提示（命中即 high）。
- */
-export declare const COMPLIANCE_REDLINES: ReadonlyArray<string>;
 import type { Context } from '@deepseek-ai/cordis';
 import { type StyleFingerprint } from './style-fingerprint.ts';
 import { fullTextBudget } from './model-capability.ts';
@@ -26,13 +23,25 @@ export declare function inferBookName(outline: string): string;
 export declare function loadProject(outputDir: string): ProjectState | undefined;
 /** Persist the project state next to the chapters. */
 export declare function saveProject(outputDir: string, project: ProjectState): void;
+/** `mergeVolatileFromDisk` 会覆盖的易变字段的全集（也是 `keep` 的合法取值域）。 */
+declare const VOLATILE_FIELDS: readonly ["bible", "roles", "plotlines", "roleStatus", "blurb", "coverPath", "facts", "assets", "world", "volumes"];
+/** 易变字段名。用于 {@link mergeVolatileFromDisk} 的 `keep`：声明「本次我改过它，别覆盖」。 */
+export type VolatileField = (typeof VOLATILE_FIELDS)[number];
 /**
  * 并发保护：长任务（章节计划生成/正文生成）在内存中持有旧快照，
  * 期间其他请求可能修改了「易变字段」（道藏/角色库/剧情线/人物志存档/简介/封面）。
  * 保存前用磁盘最新版本合并这些字段，避免旧快照覆盖新修改（曾导致角色卡丢失）。
- * 注意：调用方若自己修改了这些字段，不要使用本函数。
+ *
+ * ⚠️ `keep` 不是可选的礼貌参数，而是本函数唯一的正确用法保证：
+ * 调用方只要自己写过这些字段中的任何一个（哪怕只是 `project.plotlines[0].chapters.push(no)`），
+ * **必须**把它列进 `keep`，否则本函数会用磁盘旧值把本轮成果整块覆盖掉。
+ * 历史上正是漏了 `facts` / `plotlines`，导致作者复盘回灌的事实与剧情线关联被静默丢弃。
+ *
+ * @param outputDir - 项目目录。
+ * @param project - 待保存的内存项目（原地修改）。
+ * @param keep - 本次调用方已自行修改过的易变字段，这些字段不从磁盘覆盖。
  */
-export declare function mergeVolatileFromDisk(outputDir: string, project: ProjectState): void;
+export declare function mergeVolatileFromDisk(outputDir: string, project: ProjectState, keep?: readonly VolatileField[]): void;
 /** 对一段文本做违禁词硬匹配，返回命中（词/类别/次数）。 */
 export declare function checkSensitiveText(text: string): Array<{
     word: string;
@@ -45,6 +54,15 @@ export declare function listChapterFiles(outputDir: string): string[];
 export declare function syncProjectWithDisk(project: ProjectState, outputDir: string): void;
 /** Read a chapter's markdown body from disk (undefined when missing). */
 export declare function readChapterFile(outputDir: string, chapter: ChapterPlan): string | undefined;
+/**
+ * 章节正文的**写盘时间**（文件 mtime，ISO）—— 面板「今日产出 / 日环比」的唯一本地事实来源。
+ *
+ * 为什么不把它写进 novel-project.json：它是**派生数据**。落盘后一旦文件被外部替换、
+ * 从备份回拷、或手工改名，存档里的时间戳就开始撒谎；mtime 永远跟着真实文件走。
+ * 代价是每次 /status 要对每个有正文的章 stat 一次 —— 本地磁盘上是微秒级，
+ * 相对它换来的"今天的产出是真的"，这个代价可以接受。
+ */
+export declare function chapterWrittenAt(outputDir: string, chapter: ChapterPlan): string | undefined;
 /** Create a fresh project from an outline. */
 export declare function createProject(outline: string, outlinePath?: string): ProjectState;
 /**
@@ -200,7 +218,7 @@ export declare function designPlotlinePlan(ctx: Context, config: NovelConfig, pr
  * untouched (local revision). Without `target`, the whole chapter is
  * rewritten. Yields delta text; persists when done.
  */
-export declare function rewriteChapterStream(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number, instructions: string, target?: string): AsyncGenerator<{
+export declare function rewriteChapterStream(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number, instructions: string, target?: string, signal?: AbortSignal): AsyncGenerator<{
     frame: 'start';
 } | {
     frame: 'delta';
@@ -212,7 +230,7 @@ export declare function rewriteChapterStream(ctx: Context, config: NovelConfig,
 }, void, unknown>;
 /** Stream a chapter polish (de-AI-ify). Draft-mode: the polished body lands
  *  in `chapter.pendingDraft` and is only applied on draft/apply. */
-export declare function polishChapterStream(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): AsyncGenerator<{
+export declare function polishChapterStream(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number, signal?: AbortSignal): AsyncGenerator<{
     frame: 'start';
 } | {
     frame: 'delta';
@@ -225,7 +243,7 @@ export declare function polishChapterStream(ctx: Context, config: NovelConfig, p
 /** 统计中文字符数（汉字），与「每章字数」红线口径一致（不含标点/换行）。 */
 export declare function countHanzi(text: string): number;
 /** Generate one chapter (streaming). Yields progress frames; persists when done. */
-export declare function generateChapterStream(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): AsyncGenerator<{
+export declare function generateChapterStream(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number, signal?: AbortSignal): AsyncGenerator<{
     frame: 'start';
 } | {
     frame: 'delta';
@@ -242,7 +260,7 @@ export declare function summarizeChapter(ctx: Context, config: NovelConfig, proj
  * 反向推大纲：从已写章节正文反推出全书总纲（分卷 + 章节要点 + 主线/人物弧线/伏笔清单）。
  * 两阶段：分批提取章节事件摘要 → 汇总生成大纲。不修改章节/设定，只返回大纲文本。
  */
-export declare function reverseOutlineFromChapters(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, onProgress?: (done: number, total: number, phase: string) => void): Promise<string>;
+export declare function reverseOutlineFromChapters(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, onProgress?: (done: number, total: number, phase: string) => void, signal?: AbortSignal): Promise<string>;
 /**
  * 改编模式 P0：全文分析 → 原文设定卡片 / 可改范围矩阵。
  * 拆章统计 + 取样正文，让 LLM 一次输出结构化 JSON：
@@ -278,6 +296,7 @@ export declare function rewriteAdaptationBook(ctx: Context, config: NovelConfig,
         no: number;
         title: string;
     }) => void;
+    signal?: AbortSignal;
 }): Promise<{
     adaptedText: string;
     rewritten: Array<{
@@ -375,8 +394,6 @@ export interface ImpactItem {
  * 定位一次改动波及的所有位置。助手在修改后主动调用，做连锁维护。
  */
 export declare function analyzeImpact(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, change: string): Promise<ImpactItem[]>;
-/** 把大世界结构化数据渲染成提示词块（境界体系按顺序强约束）。 */
-export declare function renderWorld(world: WorldState | undefined): string;
 /** 提炼大世界：从大纲 + 道藏生成结构化境界体系/区域/势力。 */
 export declare function extractWorld(ctx: Context, config: NovelConfig, project: ProjectState): Promise<WorldState>;
 /**

package/lib/types/llm-live.d.ts

@@ -8,7 +8,7 @@
  *   3) **首字耗时**：调用方在拿到第一个文本增量时打点，用于观察模型响应速度。
  */
 import type { BlockAssembler, TokenUsage } from '@deepseek-ai/dsh-llm';
-import type { LlmLiveFrame, LlmPromptRecord, LlmTokenUsage, LlmUsageSummary } from './protocol.ts';
+import type { LlmLiveFinalPhase, LlmLiveFrame, LlmPromptRecord, LlmTokenUsage, LlmUsageSummary } from './protocol.ts';
 export type { LlmLiveFrame };
 type Listener = (frame: LlmLiveFrame) => void;
 export declare function nextSessionId(): string;
@@ -65,6 +65,6 @@ export declare function markFirstToken(handle: LiveCallHandle): void;
 export declare function endLiveCall(handle: LiveCallHandle, assembler: BlockAssembler, extra?: {
     chars?: number;
     preview?: string;
-    phase?: 'completed' | 'failed';
+    phase?: LlmLiveFinalPhase;
     error?: string;
 }): void;

package/lib/types/llm-retry.d.ts

@@ -15,6 +15,17 @@
  * @returns 可重试时为 true。
  */
 export declare function isRetryableLlmError(error: unknown): boolean;
+/**
+ * 判断一次失败是「取消」（作者关页面 / 主动中断）还是模型故障。
+ *
+ * 取消有两种现场：适配器给出 `aborted` 收尾块，或抛出 `AbortError` / 本插件自己的
+ * 断开错误。它必须和真实失败分开记账——否则面板「本次运行失败 N 次」会把作者的正常
+ * 中断统计成模型不稳定，进而误导备用模型档位判断（与规则 1「用户取消不重试」同一口径）。
+ *
+ * @param input 收尾块 kind（字符串）或捕获到的异常。
+ * @returns 属于取消时为 true。
+ */
+export declare function isCancellation(input: unknown): boolean;
 /**
  * 判断是否应当切换到备用模型。
  *

package/lib/types/prompt-cache.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 提示词分层组装。
+ *
+ * 同一本书的连续多次调用（逐章正文、审稿、润色、修订…）里，输入的大部分是重复的，
+ * 但各块的变化频率差着量级：
+ *
+ *   - **固定层（fixed）**：合规红线、写作硬性要求——永远不变，写死在代码里；
+ *   - **本书层（book）**：道藏、世界、大纲、资产、提示词槽位——只随作者编辑变，
+ *     一次章节生产循环里不变；
+ *   - **本章层（chapter）**：活跃伏笔、剧情线、时间线锚点、张力、章节骨架——
+ *     随创作进度逐章变。
+ *
+ * 厂商的输入缓存按**前缀**命中：只有排在前面的内容逐字节相同，后面的重复输入才有
+ * 机会整段命中。所以组装顺序必须是「固定 → 本书 → 本章」，把次次都变的挤到末尾。
+ * 反过来，若静态规则夹在书级内容中段，作者每改一次道藏，它后面的全部内容都跟着
+ * 作废、重新计费——分层就是把「不变的内容」尽量往前固定住。
+ *
+ * 三条纪律由本模块强制，不靠调用方自觉：
+ *   1. 三层顺序写死（LAYER_ORDER），调用方只标层、不决定顺序；
+ *   2. 同层内稳定排序，保持调用方的书写顺序；
+ *   3. 空白块直接丢弃——「无伏笔」时留一段空分隔，会让前后两次调用的前缀在这里分叉。
+ *
+ * 实话实说：分层只是给缓存命中**创造条件**。厂商是否命中、命中多少，以每次调用
+ * 实际上报的用量为准（见 llm-live 的缓存统计），本模块不做任何承诺，也不做
+ * 模型预热之类的玄学操作。
+ */
+/** 提示词分层：越靠前的内容越稳定。 */
+export type PromptLayer = 'fixed' | 'book' | 'chapter';
+/** 一个待组装进系统提示词的文本块。 */
+export interface PromptBlock {
+    /** 该块的变化频率归属哪一层。 */
+    layer: PromptLayer;
+    /** 块文本（内部可含多行）。 */
+    text: string;
+}
+/**
+ * 按「固定 → 本书 → 本章」组装系统提示词。
+ *
+ * 同层内保持书写顺序（稳定排序）；空白块丢弃，不在结果里留空段。
+ * @param blocks 调用方按书写顺序给出的块（层标可以乱，组装后一定分层有序）。
+ * @param separator 块间分隔符（默认换行）。
+ */
+export declare function assemblePromptBlocks(blocks: readonly PromptBlock[], separator?: string): string;

package/lib/types/prompts/adapt.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 改编域：原文设定卡片分析、改编方案生成、按映射表重写章节。
+ *
+ * 改编是「结构性改写」而非换词：分析出的可改矩阵 → 用户勾选 → 映射表 +
+ * 保留/改变规则 → 逐章重写。提示词同域放一处，改口径时三份一起看。
+ *
+ * 本文件同时是提示词注册表的域模块之一（见 catalog.ts）。
+ */
+import type { PromptEntry } from './catalog.ts';
+/** 改编 P0 分析：system 侧只声明角色（指令主体在 user 侧，位置效应更不易被长上下文稀释）。 */
+export declare function adaptationAnalyzeSystemPrompt(): string;
+/** 改编 P0 分析：user 侧指令（原文设定卡片 + 可改范围矩阵）。 */
+export declare function adaptationAnalyzeUser(sampleBodies: string[]): string;
+/** 改编方案：system 侧角色声明（指令主体在 user 侧）。 */
+export declare function adaptationProposeSystemPrompt(): string;
+/** 改编方案：user 侧指令 + 用户勾选的改动与已分析的可改矩阵。 */
+export declare function adaptationProposeUser(selLines: string, dimLines: string): string;
+/** 改编重写：按映射表与规则把一章正文结构性重写（不只是换词）。 */
+export declare function adaptationRewriteSystemPrompt(): string;
+/** 本域提示词登记（注册表消费）。 */
+export declare const entries: PromptEntry[];

package/lib/types/prompts/audit.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 一致性质检域：全书分批质检、改动影响分析。
+ *
+ * 两者都是「拿道藏 + 事实库 + 正文节选找矛盾」的同族任务，差别在触发方式：
+ * 质检是定期全本扫，影响分析是作者改一处后主动扫波及面。
+ *
+ * 本文件同时是提示词注册表的域模块之一（见 catalog.ts）。
+ */
+import type { PromptEntry } from './catalog.ts';
+/** 单批质检：设定 + 事实库 + 该批章节节选 → 矛盾清单。 */
+export declare function auditBatchSystemPrompt(): string;
+/** 影响分析：一处改动 → 全书波及位置清单（设定/大纲/正文/事实库/简介）。 */
+export declare function impactAnalysisSystemPrompt(): string;
+/** 本域提示词登记（注册表消费）。 */
+export declare const entries: PromptEntry[];

package/lib/types/prompts/bible.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 道藏域：从大纲提炼结构化设定（题材/世界规则/角色卡/红线/风格）。
+ *
+ * 本文件同时是提示词注册表的域模块之一（见 catalog.ts）。
+ */
+import type { PromptEntry } from './catalog.ts';
+/** System prompt for story-bible extraction. */
+export declare function bibleSystemPrompt(): string;
+/** 本域提示词登记（注册表消费）。 */
+export declare const entries: PromptEntry[];

package/lib/types/prompts/catalog.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 提示词注册表（轻量版）。
+ *
+ * ## 它解决什么问题
+ *
+ * 提示词散落在 engine.ts 里时，有三件事会慢慢腐烂：
+ *   1. **看不见总量**：没人说得清这个插件到底有多少份系统提示、各是干什么的；
+ *   2. **改一处忘三处**：合规红线有四份注入点，「反 AI 套话口径」在润色和局部
+ *      修订里各写一份，改一边漏一边，两个提示词悄悄漂移；
+ *   3. **新人不敢动**：想改审稿维度，先得在 5000 行里 grep 出所有相关文案。
+ *
+ * 注册表把「有哪些提示词、各自负责什么」变成一份可检索、可测试的清单。
+ * 域模块（`./*.ts`，catalog 自身除外）各自导出 `entries` 登记表，此处汇总。
+ *
+ * ## 纪律（由 tests/prompt-registry.test.ts 强制执行）
+ *
+ *   1. **目录完整**：src/prompts/ 下每个域文件都必须被本文件 import——
+ *      新建了域文件却忘了登记，测试直接红；
+ *   2. **双向完整**：登记表里的每条 id 必须以所在域的文件名开头（`域.名称`），
+ *      域名与文件域一一对应，没有挂靠的孤条；
+ *   3. **id 唯一**：全库不允许重复 id；
+ *   4. **短描述**：description 是给人看的索引，不是第二份提示词——必须非空、
+ *      不超长，且不得原文照抄提示词首句（那是重复维护两份）。
+ *
+ * 遥测（哪次调用用了哪条提示词）与导出器暂不做：那需要改调用点传 id，
+ * 等真有度量需求再接，避免为假想的功能付出复杂度。
+ */
+/** 一条提示词登记。 */
+export interface PromptEntry {
+    /** 稳定标识：`域.名称`，全库唯一（域名与 src/prompts/ 下的文件名对应）。 */
+    id: string;
+    /** 中文短描述：给人看的索引，不进提示词本身。 */
+    description: string;
+}
+/** 全库提示词清单（按域名字典序）。 */
+export declare const PROMPT_CATALOG: readonly PromptEntry[];
+/** 查一条提示词的中文描述；未登记返回 undefined。 */
+export declare function describePrompt(id: string): string | undefined;
+/** 全库清单（供测试与将来的导出器使用）。 */
+export declare function listPromptEntries(): readonly PromptEntry[];

package/lib/types/prompts/characters.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 角色域：角色库提炼（含补漏后缀）、角色当前状态聚合。
+ *
+ * 本文件同时是提示词注册表的域模块之一（见 catalog.ts）。
+ */
+import type { PromptEntry } from './catalog.ts';
+/** AI 从全书提炼角色库：大纲 + 道藏 + 编年录 + 章节摘要 → 结构化角色清单。 */
+export declare function extractRolesSystemPrompt(): string;
+/**
+ * 角色补漏后缀（拼在 extractRolesSystemPrompt 之后）。
+ *
+ * 第一轮偶发漏掉「身份型/功能性角色」（站长/律师/警察等反复出现者），
+ * 用这一轮专项补捞；没有遗漏就输出 []。
+ */
+export declare function roleCatchUpSuffix(names: string): string;
+/** 角色当前状态聚合：角色名单 + 已确立事实库 → 每角色一句话状态。 */
+export declare function roleStatusSystemPrompt(): string;
+/** 本域提示词登记（注册表消费）。 */
+export declare const entries: PromptEntry[];

package/lib/types/prompts/common.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 提示词共享件：内容合规红线。
+ *
+ * 所有书籍、所有章节无条件生效，优先级高于单书大纲/道藏中的任何设定与作者
+ * 自定义红线。原来住在 engine.ts 里，随二期拆分成域模块后迁到此处——
+ * 各域模块（writing/review/polish…）都注入它，放共享件里避免循环导入。
+ */
+/** 内容合规红线（平台硬性要求）。注入点：章节生成 + 审稿 + 润色 + 局部修订系统提示（命中即 high）。 */
+export declare const COMPLIANCE_REDLINES: ReadonlyArray<string>;

package/lib/types/prompts/digest.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 拆书与摘要域：源片段笔记、分节分析、单章摘要、书分析。
+ *
+ * 本文件同时是提示词注册表的域模块之一（见 catalog.ts）。
+ */
+import type { PromptEntry } from './catalog.ts';
+/** 拆书阶段一：单章正文 → 结构化笔记（供后续章节级分析复用）。 */
+export declare function breakdownNoteSystemPrompt(): string;
+/** 拆书分节配置项。 */
+export interface BreakdownSection {
+    key: string;
+    title: string;
+    focus: string;
+    system: string;
+}
+/**
+ * 拆书阶段二：分节分析配置。
+ *
+ * @param preset - quick（总览/剧情/人物/文风）| standard（+ 商业化卖点）。
+ */
+export declare function breakdownSections(preset: 'quick' | 'standard'): BreakdownSection[];
+/** 单章摘要（叙事记忆）：供后续章节写作时保持连贯性。 */
+export declare function chapterSummarySystemPrompt(): string;
+/** 书分析/拆书：输入一本书/章节文本 → 卖点/结构/可借鉴点/风险。 */
+export declare function bookAnalysisSystemPrompt(): string;
+/** 本域提示词登记（注册表消费）。 */
+export declare const entries: PromptEntry[];