@waterwx/dsh-novel-forge 1.2.1-alpha → 1.3.0-alpha

package/lib/types/protocol.d.ts

@@ -23,6 +23,18 @@ export declare const NOVEL_API: {
     readonly director: "/api/dsh-novel-forge/director";
     readonly directorTodos: "/api/dsh-novel-forge/director/todos";
     readonly llmLive: "/api/dsh-novel-forge/llm-live/stream";
+    /** 查看某次调用实际发送的 Prompt（按 sessionId）。 */
+    readonly llmPrompt: "/api/dsh-novel-forge/llm-live/prompt";
+    /** 清零本次运行的用量账本。 */
+    readonly usageReset: "/api/dsh-novel-forge/usage/reset";
+    /** 章节历史版本（快照）。 */
+    readonly snapshot: "/api/dsh-novel-forge/snapshot";
+    /** 张力曲线（GET 数据 / POST 设置）。 */
+    readonly tension: "/api/dsh-novel-forge/tension";
+    /** 提示词槽位（GET 列表 / POST 写入）。 */
+    readonly promptSlots: "/api/dsh-novel-forge/prompt-slots";
+    /** 故事时间线（GET 列表 / POST 操作）。 */
+    readonly timeline: "/api/dsh-novel-forge/timeline";
     readonly marketRadar: "/api/dsh-novel-forge/market-radar";
     readonly marketRadarScan: "/api/dsh-novel-forge/market-radar/scan";
     readonly marketRadarApply: "/api/dsh-novel-forge/market-radar/apply";
@@ -289,6 +301,10 @@ export interface ChapterPlan {
     review?: ReviewReport;
     /** 作者复盘：钩子兑现/结尾钩子/剧情线推进/连续性/节奏趋势（生成后自动）。 */
     authorReview?: AuthorReview;
+    /** 本章目标张力 0-100（规划或作者设定；用于张力曲线）。 */
+    tension?: number;
+    /** 本章实际张力 0-100（审稿时模型打分；缺省时回落到 review.tension）。 */
+    tensionActual?: number;
     /**
      * 待确认草稿：润色（去AI味）或整章重写的产物正文。生成时先存这里，
      * 用户看过对比后点「采纳」才覆盖正文文件；点「放弃」则丢弃。刷新页面不丢失。
@@ -366,6 +382,8 @@ export interface ReviewReport {
         word: string;
         count: number;
     }>;
+    /** 本章张力 0-100（审稿模型评分；用于张力曲线的"实际"值）。 */
+    tension?: number;
     /** When the review ran. */
     reviewedAt: string;
 }
@@ -560,6 +578,118 @@ export interface StoryBible {
     generatedAt?: string;
 }
 /** A planted/active/resolved foreshadowing thread. */
+/**
+ * 张力曲线形状预设：
+ * `escalation` 递进爬升 / `suspense` 悬疑加压 / `wave` 波浪呼吸 /
+ * `frontLoad` 前紧后稳 / `flat` 平稳推进 / `custom` 自定义。
+ */
+export type TensionCurvePreset = 'escalation' | 'suspense' | 'wave' | 'frontLoad' | 'flat' | 'custom';
+/** 张力曲线配置（随项目保存）。 */
+export interface TensionCurveConfig {
+    preset: TensionCurvePreset;
+    /** preset=custom 时的逐章采样（0-100；缺省按章节数取默认值）。 */
+    custom?: number[];
+}
+/** 张力曲线的一条问题（实际 vs 目标 / 曲线形状）。 */
+export interface TensionIssue {
+    severity: 'high' | 'medium' | 'low';
+    chapters: number[];
+    item: string;
+    suggestion: string;
+}
+/** 张力曲线数据点（面板绘图用）。 */
+export interface TensionCurvePoint {
+    no: number;
+    title: string;
+    /** 目标张力。 */
+    target?: number;
+    /** 实际张力（审稿打分）。 */
+    actual?: number;
+    /** 参考曲线在此处的取值。 */
+    reference?: number;
+}
+/** GET /tension 响应。 */
+export interface TensionResponse {
+    preset: TensionCurvePreset;
+    points: TensionCurvePoint[];
+    /** 规则核对发现的问题。 */
+    issues: TensionIssue[];
+}
+/** POST /tension 请求。 */
+export interface TensionRequest {
+    op: 'preset' | 'set' | 'clear';
+    preset?: TensionCurvePreset;
+    chapterNo?: number;
+    /** op=set 时的目标张力（0-100）。 */
+    tension?: number;
+}
+/** 允许作者编辑的提示词槽位 id（白名单）。 */
+export type PromptSlotId = 'styleExtra' | 'antiAiExtra' | 'dialogueExtra' | 'endingHookExtra';
+/** 一个提示词槽位的当前内容。 */
+export interface PromptSlotState {
+    id: PromptSlotId;
+    label: string;
+    hint: string;
+    placeholder: string;
+    maxChars: number;
+    value: string;
+}
+/** GET /prompt-slots 响应。 */
+export interface PromptSlotsResponse {
+    slots: PromptSlotState[];
+}
+/** POST /prompt-slots 请求：设置或清空一个槽位。 */
+export interface PromptSlotsRequest {
+    id: PromptSlotId;
+    /** 空串 = 清空该槽位（恢复默认）。 */
+    value: string;
+}
+/**
+ * 故事时间线事件：从章节正文抽取的「故事内时间点 + 地点 + 参与角色 + 事件」。
+ * 用途：后续章节的时间连续性与地点衔接（比编年录更强调"顺序"）。
+ */
+export interface TimelineEvent {
+    /** 稳定 id（时间线内唯一）。 */
+    id: string;
+    /** 所属章节号。 */
+    chapterNo: number;
+    /** 故事内时间点（如「第三日黄昏」「入宗三个月后」「同日夜」）。 */
+    time: string;
+    /** 相对顺序（同书内递增；无法判断时缺省）。用于检测时间倒流。 */
+    order?: number;
+    /** 地点。 */
+    place: string;
+    /** 参与角色（角色名）。 */
+    characters: string[];
+    /** 事件一句话。 */
+    event: string;
+    /** 来源：模型抽取 / 作者手改。 */
+    source: 'extracted' | 'manual';
+    createdAt: string;
+}
+/** 时间线矛盾（规则初筛 + AI 复核）。 */
+export interface TimelineIssue {
+    severity: 'high' | 'medium' | 'low';
+    /** 定位到的章节（可多个）。 */
+    chapters: number[];
+    /** 问题描述。 */
+    item: string;
+    /** 建议修法。 */
+    suggestion: string;
+}
+/** GET /timeline 响应。 */
+export interface TimelineResponse {
+    events: TimelineEvent[];
+    /** 规则初筛发现的问题（瞬时计算，不落盘）。 */
+    issues?: TimelineIssue[];
+}
+/** POST /timeline 请求：op=extract 抽单章 / check 全量检查 / update 手改 / remove 删除 / clear 清空。 */
+export interface TimelineRequest {
+    op: 'extract' | 'check' | 'update' | 'remove' | 'clear';
+    chapterNo?: number;
+    event?: TimelineEvent;
+    id?: string;
+}
 export interface Foreshadow {
     /** Stable id. */
     id: string;
@@ -957,6 +1087,12 @@ export interface ProjectState {
     roles?: RoleRecord[];
     /** 人物志：角色当前状态聚合结果（从编年录刷新后存档，打开页面直接显示）。 */
     roleStatus?: RoleStatusCard[];
+    /** 故事时间线（逐章抽取：时间点 / 地点 / 参与角色 / 事件）。 */
+    timeline?: TimelineEvent[];
+    /** 张力曲线配置（形状预设 + 自定义采样）。 */
+    tensionCurve?: TensionCurveConfig;
+    /** 作者自定义的提示词槽位（白名单见 prompt-slots.ts）。 */
+    promptSlots?: Partial<Record<PromptSlotId, string>>;
     /** 本书参数（写作/审稿/推理/模型快切；未设字段回退全局 config）。 */
     bookSettings?: BookSettings;
     /** ISO timestamps. */
@@ -1099,6 +1235,13 @@ export interface NovelConfig {
     reviewModel?: string;
     /** 全书质检(审计)用模型（缺省用 model）。 */
     auditModel?: string;
+    /**
+     * 备用模型：主模型调用失败（网络/限流/额度/服务不可用）时自动切换重试一次。
+     * 留空表示不切换。批量连写时能显著减少"整批中断"。
+     */
+    fallbackModel?: string;
+    /** 是否在出章后自动抽取故事时间线（失败不阻断出章）。默认开。 */
+    autoTimeline?: boolean;
     /** LLM reasoning effort: off = no thinking; low/high/max = thinking intensity. */
     reasoningEffort: 'off' | 'low' | 'high' | 'max';
     /** 分析类任务（提炼/拆书/反推大纲等）的推理档位；默认 low，不受上面写作档位影响。 */
@@ -1177,6 +1320,119 @@ export interface StageInfo {
     /** 为什么处于该阶段。 */
     reason: string;
 }
+/** 单次 LLM 调用的 token 用量（来自 dsh-llm 的 usage chunk）。 */
+export interface LlmTokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    /** 供应商给出的总用量（缺失时由输入+输出推导）。 */
+    totalTokens?: number;
+    /** 思考（reasoning）通道用量。 */
+    reasoningTokens?: number;
+    /** 命中缓存的输入用量。 */
+    cacheReadTokens?: number;
+}
+/** LLM 实况帧：宿主 → 浏览器的 SSE 事件（每次调用一组 session_* 事件）。 */
+export interface LlmLiveFrame {
+    type: 'session_started' | 'output_delta' | 'reasoning_delta' | 'phase_changed' | 'session_completed';
+    /** 宿主生成，形如 ll-<base36>-<n>。 */
+    sessionId: string;
+    /** 本次调用用途（如 正文生成/审稿/章节规划）。 */
+    label?: string;
+    /** 使用模型。 */
+    model?: string;
+    /** 事件时间（ISO）。 */
+    at: string;
+    /** session_started：交互上下文。 */
+    context?: {
+        taskId?: string;
+        interactionId: string;
+    };
+    /** output_delta / reasoning_delta：本次增量文本。 */
+    content?: string;
+    /** session 累计字符数。 */
+    totalChars?: number;
+    /** reasoning 累计字符数。 */
+    totalReasoningChars?: number;
+    /** phase_changed：新阶段。 */
+    phase?: 'requesting' | 'streaming' | 'completed' | 'failed';
+    /** phase_changed：阶段描述。 */
+    phaseMessage?: string;
+    /** session_completed：最终预览（截断）。 */
+    preview?: string;
+    /** session_completed：失败信息。 */
+    error?: string;
+    /** session_completed：本次用量（供应商未上报时缺省）。 */
+    usage?: LlmTokenUsage;
+    /** session_completed：本次调用耗时（毫秒）。 */
+    elapsedMs?: number;
+    /** session_completed：首字耗时（毫秒；未拿到文本时缺省）。 */
+    firstTokenMs?: number;
+    /** session_started：是否已记录可查看的 Prompt（面板据此显示「查看 Prompt」）。 */
+    hasPrompt?: boolean;
+    /** session_started：Prompt 字符数（system + user）。 */
+    promptChars?: number;
+}
+/** 按用途分组的用量。 */
+export interface LlmUsageBucket {
+    label: string;
+    calls: number;
+    failed: number;
+    inputTokens: number;
+    outputTokens: number;
+    reasoningTokens: number;
+    elapsedMs: number;
+}
+/** 本次运行（进程内，重启归零）的 LLM 用量汇总。 */
+export interface LlmUsageSummary {
+    calls: number;
+    failed: number;
+    inputTokens: number;
+    outputTokens: number;
+    reasoningTokens: number;
+    totalTokens: number;
+    elapsedMs: number;
+    /** 供应商未上报 usage 的调用次数（用于说明数据为何不完整）。 */
+    callsWithoutUsage: number;
+    byLabel: LlmUsageBucket[];
+}
+/** 一次调用的 Prompt 记录（供面板查看「实际发送了什么」）。 */
+export interface LlmPromptRecord {
+    sessionId: string;
+    label?: string;
+    model?: string;
+    at: string;
+    system?: string;
+    user?: string;
+    /** system + user 的字符数（记录被截断时仍给出原始长度）。 */
+    chars: number;
+    /** 记录本身是否被截断。 */
+    truncated?: boolean;
+}
+/** 章节历史版本（快照）：覆盖写入前自动留存，可回滚。 */
+export interface ChapterSnapshot {
+    id: string;
+    chapterNo: number;
+    /** 快照文件（相对书目录）。 */
+    file: string;
+    /** 留存原因（生成覆盖 / 采纳草稿 / 修订 / 手工）。 */
+    reason: string;
+    chars: number;
+    at: string;
+}
+/** GET /snapshot 响应。 */
+export interface SnapshotResponse {
+    snapshots: ChapterSnapshot[];
+    /** 快照占用字节数。 */
+    bytes: number;
+}
+/** POST /snapshot 请求：op=create 手工存档 / restore 回滚 / remove 删除 / prune 只留最近 N 个。 */
+export interface SnapshotRequest {
+    op: 'create' | 'restore' | 'remove' | 'prune';
+    chapterNo?: number;
+    id?: string;
+    /** prune：每章保留数量。 */
+    keep?: number;
+}
 export interface StatusResponse {
     config: NovelConfig;
     /** The persisted project, when one exists in the output dir. */
@@ -1187,6 +1443,8 @@ export interface StatusResponse {
     audit?: AuditStatus;
     /** 宿主按项目真实状态算出的创作阶段（面板角标 / 外部自动化共用）。 */
     stage?: StageInfo;
+    /** 本次运行（进程内）的 LLM 用量汇总：调用次数 / 输入·输出·思考 token / 耗时。 */
+    usage?: LlmUsageSummary;
     /**
      * 截断声明：本次响应中被裁掉的字段说明（如「编年录：共 320 条，仅返回最近 80 条」）。
      * 消费方不得把缺失字段当作"不存在"，需要完整数据时走专用接口。
@@ -1395,13 +1653,31 @@ export interface ChapterResponse {
     markdown: string;
 }
 /** POST /export request/response. */
+/**
+ * 导出范围：
+ * - `book`       整本正文（txt / md）
+ * - `settings`   项目设定（总纲 / 道藏 / 大世界 / 写作资产 / 卷首语）
+ * - `plan`       规划（卷计划 + 章节计划，含每章目标/要点/钩子/硬事实）
+ * - `characters` 角色（角色库 + 人物志当前状态）
+ * - `review`     质检记录（逐章审稿 + 作者复盘 + 伏笔/剧情线状态）
+ * - `project`    项目 JSON（完整状态，用于备份/迁移；仅 json 格式）
+ */
+export type ExportScope = 'book' | 'settings' | 'plan' | 'characters' | 'review' | 'project';
+/** 导出范围全集（宿主校验用；顺序即 UI 展示顺序）。 */
+export declare const EXPORT_SCOPE_VALUES: readonly ExportScope[];
+/** 导出范围的中文标签。 */
+export declare const EXPORT_SCOPE_LABELS: Record<ExportScope, string>;
 export interface ExportRequest {
-    format: 'txt' | 'md';
+    format: 'txt' | 'md' | 'json';
+    /** 缺省 `book`（兼容旧调用）。 */
+    scope?: ExportScope;
 }
 export interface ExportResponse {
     file: string;
     chars: number;
     chapters: number;
+    scope: ExportScope;
+    format: 'txt' | 'md' | 'json';
 }
 /** POST /config request: patch any subset of the runtime config. */
 export interface ConfigPatch {
@@ -1412,6 +1688,10 @@ export interface ConfigPatch {
     generateModel?: string;
     reviewModel?: string;
     auditModel?: string;
+    /** 备用模型（主模型失败时自动切换重试一次；空串 = 关闭）。 */
+    fallbackModel?: string;
+    /** 出章后自动抽取故事时间线（默认开）。 */
+    autoTimeline?: boolean;
     reasoningEffort?: 'off' | 'low' | 'high' | 'max';
     analysisReasoning?: 'off' | 'low' | 'high' | 'max';
     chapterChars?: number;
@@ -1554,7 +1834,7 @@ export interface AntiAiRule {
     /** 作用域（缺省 all）。 */
     scope?: Array<'writing' | 'review' | 'polish' | 'all'>;
 }
-/** 预置写法模板（来自 AI-Novel-Writing-Assistant 内置数据，一键绑定无需样本文本）。 */
+/** 预置叙事风格模板（一键绑定无需样本文本）。 */
 export interface StyleTemplateNarrativeRules {
     progressionMode?: string;
     sceneUnitPattern?: string[];
@@ -1622,7 +1902,7 @@ export interface StyleTemplate {
     /** 该模板默认绑定的反 AI 规则 key（内置规则名）。 */
     defaultAntiAiRuleKeys: string[];
 }
-/** 起始风格画像：无样本文本也能快速绑定一套写法（对齐上游 DEFAULT_STARTER_STYLE_PROFILES）。 */
+/** 起始风格画像：无样本文本也能快速绑定一套写法。 */
 export interface StarterStyleProfile {
     /** stable key（如 starter-power-up）。 */
     key: string;

package/lib/types/snapshots.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 章节历史版本（快照）：覆盖写入前自动留存正文，支持列表 / 回滚 / 清理。
+ *
+ * 为什么需要它：生成、按意见重写、去 AI 味润色、采纳草稿都会**覆盖** `第N章_*.md`，
+ * 一旦改差（尤其是自动修订把好稿改坏）就没有退路。这里在覆盖前把旧稿存到
+ * `<书目录>/snapshots/`，并维护一份 `snapshots/index.json` 索引。
+ *
+ * 纯 Node 文件操作，不依赖模型；路由层只做参数校验与响应。
+ */
+import type { ChapterPlan, ChapterSnapshot } from './protocol.ts';
+/** 快照目录名（书目录下）。 */
+export declare const SNAPSHOT_DIR = "snapshots";
+/** 每章默认保留的快照数（超出后按时间淘汰最旧的）。 */
+export declare const DEFAULT_SNAPSHOT_KEEP = 20;
+/** 快照目录绝对路径。 */
+export declare function snapshotDir(outputDir: string): string;
+/** 读取索引（缺失/损坏时返回空数组）。 */
+export declare function loadSnapshots(outputDir: string): ChapterSnapshot[];
+/** 快照占用字节数（索引 + 正文）。 */
+export declare function snapshotsBytes(outputDir: string): number;
+/**
+ * 为一个章节留存快照（覆盖写入前调用）。
+ *
+ * @param outputDir 书目录。
+ * @param chapter 章节（需要已存在正文文件）。
+ * @param reason 留存原因（生成覆盖 / 采纳草稿 / 修订 / 润色 / 手工）。
+ * @param keep 每章保留数量（超出淘汰最旧）。
+ * @returns 新建的快照；无正文文件时返回 undefined（不产生空快照）。
+ */
+export declare function createSnapshot(outputDir: string, chapter: ChapterPlan, reason: string, keep?: number): ChapterSnapshot | undefined;
+/**
+ * 回滚到某个快照：把快照内容写回章节正文文件。
+ *
+ * 回滚前会**先给当前正文留一份快照**（reason=回滚前自动留存），所以回滚本身也可撤销。
+ *
+ * @param outputDir 书目录。
+ * @param chapter 目标章节。
+ * @param snapshotId 快照 id。
+ * @returns 回滚后的字符数。
+ * @throws 快照不存在或章节无正文文件时抛错。
+ */
+export declare function restoreSnapshot(outputDir: string, chapter: ChapterPlan, snapshotId: string): number;
+/** 删除一个快照（连同文件）。 */
+export declare function removeSnapshot(outputDir: string, snapshotId: string): boolean;
+/** 按每章保留数量清理（连文件一起删）。 */
+export declare function pruneSnapshots(outputDir: string, keep?: number): number;

package/lib/types/stage-contract.d.ts

@@ -1,7 +1,7 @@
 /**
  * 阶段契约（Stage Contract）——宿主计算的「当前阶段 → 本轮允许的动作」。
  *
- * 设计来源（借鉴 dsh-ai-novel-writer 的「作者请求中的当前阶段决定唯一允许命令」）：
+ * 设计来源（「作者请求中的当前阶段决定唯一允许命令」这一约定）：
  * 允许的动作必须由宿主根据真实项目状态算出，而不是指望模型记住或自律。
  * 宿主计算结果同时用于三处：
  *   1) 注入助手系统提示词：模型知道自己在哪一步、下一步该做什么；

package/lib/types/tension.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 张力曲线：把「每章该有多紧」显式化，并在出章后核对实际走向。
+ *
+ * 为什么要有它：长篇最常见的两种崩法——**一直高能没有呼吸**（读者疲劳）与
+ * **长时间低位打转**（读者流失）；这两种都不是单章问题，而是"曲线"问题，
+ * 单章审稿看不见。这里提供：
+ *   1) 参考曲线（本项目自行设计，仅作形状参照）；
+ *   2) 把「本章目标张力」注入写作提示词；
+ *   3) 规则核对：实际 vs 目标偏差、连续同值、高潮后不回落、长期低位。
+ *
+ * 本模块只放纯逻辑（可离线单测）；模型交互与落盘在 engine/routes。
+ */
+import type { ChapterPlan, ProjectState, TensionCurvePreset, TensionIssue } from './protocol.ts';
+/** 单章张力的取值范围。 */
+export declare const TENSION_MIN = 0;
+export declare const TENSION_MAX = 100;
+/** 参考曲线的中文标签（面板展示）。 */
+export declare const TENSION_PRESET_LABELS: Record<TensionCurvePreset, string>;
+/** 全部可选预设（UI 下拉用）。 */
+export declare const TENSION_PRESETS: readonly TensionCurvePreset[];
+/** 把参考形状按章节数重采样（最近邻，保持形状不引入平滑失真）。 */
+export declare function referenceCurve(preset: TensionCurvePreset, chapterCount: number): number[];
+/** 读一章的目标张力（未设置时返回 undefined）。 */
+export declare function targetTension(chapter: ChapterPlan): number | undefined;
+/** 读一章的实际张力（审稿时模型打分，未设置时返回 undefined）。 */
+export declare function actualTension(chapter: ChapterPlan): number | undefined;
+/** 收敛到合法区间并取整。 */
+export declare function clampTension(value: number): number;
+/**
+ * 渲染注入写作提示词的「本章张力」块。
+ *
+ * @param project 项目状态。
+ * @param chapterNo 本章章号。
+ * @returns 提示词片段；没有张力信息时返回空串。
+ */
+export declare function renderTensionBlock(project: ProjectState, chapterNo: number): string;
+/**
+ * 规则核对张力曲线（不调模型）。
+ *
+ * 检查四类曲线级问题：
+ *   1) 实际与目标偏差过大（>25）；
+ *   2) 连续多章几乎同值（≥4 章落差 <6，平台期无起伏）；
+ *   3) 高点之后没有回落（连续 ≥3 章处在高位 ≥80）；
+ *   4) 长期低位（连续 ≥5 章 <40，容易拖沓）。
+ *
+ * @param project 项目状态。
+ * @returns 问题清单（可能为空）。
+ */
+export declare function detectTensionIssues(project: ProjectState): TensionIssue[];
+/**
+ * 组装面板需要的曲线数据（章节号 / 目标 / 实际 / 参考）。
+ *
+ * @param project 项目状态。
+ * @returns 逐章数据点与预设名。
+ */
+export declare function buildCurveData(project: ProjectState): {
+    preset: TensionCurvePreset;
+    points: Array<{
+        no: number;
+        title: string;
+        target?: number;
+        actual?: number;
+        reference?: number;
+    }>;
+};

package/lib/types/timeline.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 故事时间线：把「章节正文」压成可排序的时间事件，用于后续章节的时间连续性。
+ *
+ * 与编年录的分工：编年录记「事实」（人物状态/资源/关系），时间线记「顺序」
+ * （什么时候、在哪里、谁在场、发生了什么），专门用来抓时间倒流、地点瞬移与
+ * 跨越章节的时序矛盾。
+ *
+ * 本模块只放纯逻辑（可离线单测）：排序、注入渲染、规则初筛、事件归一化；
+ * 模型交互（抽取/复核）在 engine.ts，落盘与路由在 routes.ts。
+ */
+import type { ProjectState, TimelineEvent, TimelineIssue } from './protocol.ts';
+/** 注入后续章节的时间线锚点条数（超过则显式声明省略，遵循截断显式化规则）。 */
+export declare const TIMELINE_CONTEXT_LIMIT = 12;
+/** 归一化事件（清洗字符串、补 id/时间戳）。 */
+export declare function normalizeTimelineEvent(raw: Partial<TimelineEvent>, chapterNo: number, index: number, now?: string): TimelineEvent;
+/** 时间线排序：先章节、再 order（缺省排在该章末尾）、最后 createdAt。 */
+export declare function sortTimeline(events: readonly TimelineEvent[]): TimelineEvent[];
+/**
+ * 渲染注入到「写作/规划」提示词的时间线锚点块。
+ *
+ * @param project 项目状态。
+ * @param beforeChapter 只注入该章之前的锚点（含该章本身不注入，避免剧透）。
+ * @returns 提示词片段（无事件时返回空串）。带显式截断声明。
+ */
+export declare function renderTimelineBlock(project: ProjectState, beforeChapter: number): string;
+/**
+ * 规则初筛时间线矛盾（不调模型，瞬时计算）。
+ *
+ * 覆盖三类最容易犯又最容易用规则抓到的错：
+ *   1) 同一章内事件顺序号倒退；
+ *   2) 全书顺序号在章节推进后倒退（时间倒流）；
+ *   3) 相邻两章之间地点瞬移（同一角色在未交代移动的情况下跨地点）。
+ *
+ * @param project 项目状态。
+ * @returns 问题清单（可能为空）。
+ */
+export declare function detectTimelineIssues(project: ProjectState): TimelineIssue[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@waterwx/dsh-novel-forge",
   "description": "AI 编译纯文本小说工作台 for the dsh web GUI: import a novel outline (docx/text), plan volumes & chapters with LLM, generate chapter by chapter (3000-4000 chars each), auto AI review & book audit, and export the full book as Markdown/TXT into your chosen output folder.",
-  "version": "1.2.1-alpha",
+  "version": "1.3.0-alpha",
   "type": "module",
   "author": "waterwx",
   "repository": {
@@ -18,7 +18,7 @@
     "deepseek-harness",
     "小说工坊",
     "novel-forge",
-    "ai-novel-writing",
+    "novel-writing-workbench",
     "novel-writing",
     "写作助手",
     "小说创作",
@@ -113,6 +113,7 @@
     "watch": "tsdown --watch",
     "typecheck": "tsc --noEmit",
     "check:styles": "node scripts/check-theme-sizes.mjs",
+    "check:third-party": "node scripts/check-third-party.mjs",
     "release": "node scripts/release.mjs",
     "release:dry": "node scripts/release.mjs --dry-run",
     "test": "vitest run"

package/src/action-guard.ts

@@ -1,7 +1,7 @@
 /**
  * 动作失败分级（fail-stop 规则）——不依赖 LLM/宿主服务的纯逻辑模块，可离线单测。
  *
- * 规则来源（借鉴 dsh-ai-novel-writer）：
+ * 规则来源（借鉴同类 DSH 小说插件的规则设计）：
  *  - 参数/契约类失败**不得重复同一调用**，解释一次即停；
  *  - 瞬时故障允许有限重试，同样禁止无限重试。
  * 规则必须可测试，否则只是文档。