@waterwx/dsh-novel-forge 2.5.0 → 2.5.1

package/lib/types/assets.d.ts

@@ -2,8 +2,8 @@
  * Writing assets — 题材基底库 / 推进模式库 / 反 AI 规则 / 写法引擎.
  *
  * 内置种子数据（本项目自研表述；结构参考了同类工具的功能划分）：
- * - 8 套预置叙事风格模板
- * - 12 条带命中模式的反 AI 规则
+ * - 预置叙事风格模板（数量以 {@link BUILTIN_STYLE_TEMPLATES} 数组为准）
+ * - 带命中模式的反 AI 规则（数量以 ANTI_AI_RULES 数组为准）
  * - 题材树 + 推进模式种子
  * Assets persist with the project (novel-project.json) and are injected into
  * generation / planning / review prompts, and available to the AI assistant.

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

@@ -34,7 +34,6 @@ export declare const zh: {
     readonly 'plan.pending': "待生成";
     readonly 'plan.generating': "生成中";
     readonly 'plan.written': "待审稿";
-    readonly 'plan.reviewing': "审稿中";
     readonly 'plan.approved': "已通过";
     readonly 'plan.rejected': "待修订";
     readonly 'plan.error': "失败";

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

@@ -0,0 +1,69 @@
+import type { ReactElement } from 'react';
+import type { NovelApi } from '../api.ts';
+import type { ChapterPlan, ChapterSnapshot, Plotline, ReviewReport } from '../../protocol.ts';
+/** 审稿维度中文名（工作台与主面板共用）。 */
+export declare const REVIEW_DIM_ZH: Record<string, string>;
+export declare function statusBadge(chapter: ChapterPlan): {
+    cls: string;
+    label: string;
+};
+/** One review issue line (severity-colored, theme-aware). */
+export declare function severityColor(severity: string): string;
+/** 把章节 beats 按结构标签渲染的实现见 ChapterPlanPanel.renderBeats（左栏与计划抽屉共用）。 */
+/** The diff list of a draft-vs-original comparison (scrollable). */
+export declare function DiffList({ original, draft, fontSize }: {
+    original: string;
+    draft: string;
+    fontSize?: number;
+}): ReactElement;
+/** 章节工作台右侧页签：对比（草稿 diff）/ 审稿（AI 审稿报告）/ 复盘（作者复盘）。 */
+export type ChapterSideTab = 'diff' | 'review' | 'author' | 'versions';
+/** 章节工作台（独立全页）需要的全部输入；所有数据来自真实 project.chapters。 */
+interface ChapterWorkbenchProps {
+    chapter: ChapterPlan;
+    bookKey: string;
+    /** 已加载的正文 markdown；'' 表示未加载 / 尚未生成。 */
+    text: string;
+    /** 润色 / 修订草稿；存在时「对比」页可做逐段 diff。 */
+    draft?: string;
+    fontSize: number;
+    busy: boolean;
+    busyAny: boolean;
+    onBack: () => void;
+    onWrite: () => void;
+    onReview: () => void;
+    onApprove: () => void;
+    onEdit: () => void;
+    /** 按作者勾选的审稿意见修订（不传则内部自动挑 high）。 */
+    onRevisePicked: (issues: ReviewReport['issues']) => void;
+    onReset: () => void;
+    onRegenerate: () => void;
+    onBackfillAuthor: () => void;
+    /** 右栏当前页签（受控：修订完成后由外层自动切到「对比」）。 */
+    tab: ChapterSideTab;
+    onTabChange: (tab: ChapterSideTab) => void;
+    /** 草稿审查报告（验证模式产物，针对草稿本身）；null = 还没审查过。 */
+    draftReport: ReviewReport | null;
+    onApplyDraft: () => void;
+    onDiscardDraft: () => void;
+    onCheckDraft: () => void;
+    /** 本章历史版本（快照）与回滚/存档动作。 */
+    snapshots: ChapterSnapshot[];
+    onRestoreSnapshot: (id: string) => void;
+    onCreateSnapshot: () => void;
+    /** 左栏「本章计划」：剧情线用于关联项，api + onPlanSaved 提供就地补写通道。 */
+    plotlines: Plotline[];
+    api: NovelApi;
+    onPlanSaved: (chapter: ChapterPlan) => void;
+    /** 截断声明汇入外层进度台。 */
+    onNotice: (message: string) => void;
+    onLinkLines: () => void;
+    /** 失败态的出路之一：打开「AI 进度」浮窗看这一章的运行详情（Prompt / 耗时 / 原始错误）。 */
+    onOpenRunLog: () => void;
+}
+/**
+ * 章节工作台：**独立全页**（不塞进抽屉或主从布局，内容太重）。
+ * 三栏并发 —— 左：本章计划（六项固定分组，见 ChapterPlanPanel）；中：正文；右：对比 / 审稿 / 复盘 / 历史。
+ */
+export declare function ChapterWorkbench({ chapter, bookKey, text, draft, fontSize, busy, busyAny, onBack, onWrite, onReview, onApprove, onEdit, onRevisePicked, onReset, onRegenerate, onBackfillAuthor, tab, onTabChange, draftReport, onApplyDraft, onDiscardDraft, onCheckDraft, snapshots, onRestoreSnapshot, onCreateSnapshot, plotlines, api, onPlanSaved, onNotice, onLinkLines, onOpenRunLog, }: ChapterWorkbenchProps): ReactElement;
+export {};

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

@@ -14,5 +14,4 @@ export interface NovelPanelProps {
     /** The API client every tab operates through. */
     api: NovelApi;
 }
-/** The novel-forge panel. */
 export declare function NovelPanel({ controller, api }: NovelPanelProps): import("react").JSX.Element;

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

@@ -0,0 +1,51 @@
+/**
+ * 润色 / 修订工作区（全页受控组件）。
+ *
+ * 从 NovelPanel.tsx 抽出（2026-10 重构第二步）：它是一整页编辑器，原先直接嵌在
+ * 5600 行主组件的 return 里，任何一处改动都要翻过上百行 JSX。这里只做**受控渲染**：
+ * 状态与请求逻辑仍留在面板（它要驱动全局 busy / 进度台 / 刷新），视图只负责把
+ * props 接上——纯搬家，不搬行为。
+ */
+import type { Dispatch, MutableRefObject, SetStateAction } from 'react';
+import type { ReactElement } from 'react';
+import type { ReviewReport } from '../../protocol.ts';
+/** 工作区状态（面板持有）。 */
+export interface WorkspaceState {
+    no: number;
+    title: string;
+    original: string;
+    instruction: string;
+    draft: string | null;
+    /** 打开工作区时的正文基线（用于判断"有未保存修改"）。 */
+    baseline: string;
+    /** 已采纳草稿（原地结论态）：显示已采纳横幅 + 自动审稿结果，返回时才关闭工作区。 */
+    applied?: boolean;
+}
+/** 工作区视图的全部输入；状态与副作用都由面板提供。 */
+export interface WorkspaceViewProps {
+    workspace: WorkspaceState;
+    onWorkspaceChange: (next: WorkspaceState) => void;
+    onClose: () => void;
+    onGotoChapter: (no: number) => void;
+    backTo: string;
+    editorFontSize: number;
+    onEditorFontSizeChange: (n: number) => void;
+    editorRef: MutableRefObject<HTMLTextAreaElement | null>;
+    selected: string;
+    onCaptureSelection: () => void;
+    checkReport: ReviewReport | null;
+    checked: number[];
+    onCheckedChange: Dispatch<SetStateAction<number[]>>;
+    showDiff: boolean;
+    onShowDiffChange: (next: boolean) => void;
+    resultMode: boolean;
+    busy: boolean;
+    onReviseByReport: () => void;
+    onRewrite: (whole: boolean) => void;
+    onPolish: () => void;
+    onSave: () => void;
+    onCheck: () => void;
+    onDiscardDraft: (no: number) => void;
+}
+/** 工作区全页：左栏原文（可选中局部目标）+ 右栏指令 / 预览 / 应用。 */
+export declare function WorkspaceView({ workspace, onWorkspaceChange, onClose, onGotoChapter, backTo, editorFontSize, onEditorFontSizeChange, editorRef, selected, onCaptureSelection, checkReport, checked, onCheckedChange, showDiff, onShowDiffChange, resultMode, busy, onReviseByReport, onRewrite, onPolish, onSave, onCheck, onDiscardDraft, }: WorkspaceViewProps): ReactElement;

package/lib/types/client/panel/home-model.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 总编台（首页）的纯计算层。
+ *
+ * 从 NovelPanel.tsx 抽出（2026-10 重构）：这些数字原先散在 6000+ 行组件的
+ * useMemo 里，既没法单测，也让「同一件事在面板里说两遍」难以发现。抽成纯函数后：
+ *   - 输入只有 project / chapters，输出是确定的结构；
+ *   - 面板只负责渲染，数字口径集中在这里改；
+ *   - `tests/home-model.test.ts` 直接覆盖边界（空书、全过审、生成中）。
+ */
+import type { ChapterPlan, ProjectState } from '../../protocol.ts';
+/** 总编台用的章节统计（一次遍历算完，避免面板里重复过滤）。 */
+export interface ChapterStats {
+    /** 有正文的章数（approved / written / rejected）。 */
+    done: number;
+    /** 待处理章数（pending / error）。 */
+    pending: number;
+    /** 已过审章数。 */
+    approved: number;
+    /** 待审章数（written / rejected）。 */
+    reviewPending: number;
+    /** 全书已写字数（汉字口径，来自 chapter.chars）。 */
+    totalChars: number;
+    /** 正在生成的章（同刻至多一章；undefined = 没有）。 */
+    writingNow: ChapterPlan | undefined;
+    /** 逐章字数序列（Sparkline 用；顺序 = 章节数组顺序）。 */
+    charSeries: Array<{
+        no: number;
+        chars: number;
+        approved: boolean;
+    }>;
+}
+/**
+ * 单次遍历统计全书章节。
+ * @param chapters 全书章节计划（顺序无关，按数组顺序输出 charSeries）。
+ */
+export declare function computeChapterStats(chapters: ChapterPlan[]): ChapterStats;
+/** 创作旅程的一个阶段。 */
+export interface JourneyStage {
+    id: string;
+    label: string;
+    done: boolean;
+}
+/**
+ * 创作旅程 6 阶段（大纲 → 设定 → 卷计划 → 章节计划 → 正文 → 审稿）。
+ *
+ * 「完成」的判定只看项目真实数据，不参考 UI 当前所在页；否则作者在
+ * 「总纲」页多停留一会儿，旅程条就会自己变。
+ *
+ * @param project 当前书（undefined = 没有书）。
+ * @param chapters 章节计划。
+ * @param approvedCount 已过审章数（来自 {@link computeChapterStats}）。
+ */
+export declare function computeJourneyStages(project: ProjectState | undefined, chapters: ChapterPlan[], approvedCount: number): JourneyStage[];

package/lib/types/engine.d.ts

@@ -502,11 +502,18 @@ export declare function extractTimelineForChapter(ctx: Context, config: NovelCon
  * @returns 模型给出的问题清单（与规则初筛结果合并由调用方决定）。
  */
 export declare function reviewTimeline(ctx: Context, config: NovelConfig, project: ProjectState): Promise<TimelineIssue[]>;
-/** Export the whole book as one txt/md file. */
+/**
+ * Export the whole book as one txt/md file.
+ *
+ * 只收真实存在且非空的章节文件：`chapter.file` 有值不等于文件没被手删/清空，
+ * 旧实现会把它们当空串拼进去，导出件看起来完整、实际缺章。跳过的章号随
+ * `skipped` 一起返回，由面板如实提示。
+ */
 export declare function exportBook(outputDir: string, project: ProjectState, format: 'txt' | 'md'): {
     file: string;
     chars: number;
     chapters: number;
+    skipped?: number[];
 };
 /**
  * 按范围导出：整本正文 / 设定 / 规划 / 角色 / 质检记录 / 项目 JSON。
@@ -521,4 +528,5 @@ export declare function exportScope(outputDir: string, project: ProjectState, sc
     file: string;
     chars: number;
     chapters: number;
+    skipped?: number[];
 };

package/lib/types/index.d.ts

@@ -8,7 +8,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from 'schemastery';
-import type { NovelConfig } from './protocol.ts';
+import type { NovelConfig, SavedModel } from './protocol.ts';
 /** Stable cordis plugin name. */
 export declare const name = "novel-forge";
 /** Services required before the novel-forge surfaces can mount. */
@@ -47,6 +47,8 @@ export interface Config {
     auditModel?: string;
     /** 备用模型：主模型失败时自动切换重试一次（留空 = 不切换）。 */
     fallbackModel?: string;
+    /** 备用模型的输出 token 上限（仅在设了 fallbackModel 时有意义；0/空 = 沿用主模型预算）。 */
+    fallbackMaxTokens?: number;
     /** 出章后自动抽取故事时间线（默认开）。 */
     autoTimeline?: boolean;
     /** LLM reasoning effort (off/low/high/max). */
@@ -73,6 +75,8 @@ export interface Config {
     themeOpacity?: number;
     /** 是否启用改编模式（默认关闭）。 */
     enableAdaptMode?: boolean;
+    /** 手动添加的模型库（「我的模型」条目；只存插件内）。 */
+    savedModels?: SavedModel[];
 }
 /**
  * Plugin config schema.

package/lib/types/protocol.d.ts

@@ -265,7 +265,7 @@ export interface BookImportTextPreviewResponse {
     skipped: string[];
 }
 /** Chapter lifecycle states (the writing pipeline's state machine). */
-export type ChapterStatus = 'pending' | 'generating' | 'written' | 'reviewing' | 'approved' | 'rejected' | 'error';
+export type ChapterStatus = 'pending' | 'generating' | 'written' | 'approved' | 'rejected' | 'error';
 /** One chapter in the plan. */
 export interface ChapterPlan {
     /** 1-based chapter number (stable identity; files are named from it). */
@@ -1868,6 +1868,8 @@ export interface ExportResponse {
     file: string;
     chars: number;
     chapters: number;
+    /** 全本导出时因文件缺失/为空被跳过的章号；无跳过项时缺省。 */
+    skipped?: number[];
     scope: ExportScope;
     format: 'txt' | 'md' | 'json';
 }
@@ -1882,6 +1884,8 @@ export interface ConfigPatch {
     auditModel?: string;
     /** 备用模型（主模型失败时自动切换重试一次；空串 = 关闭）。 */
     fallbackModel?: string;
+    /** 备用模型的输出 token 上限（0/空 = 沿用主模型预算）。 */
+    fallbackMaxTokens?: number;
     /** 出章后自动抽取故事时间线（默认开）。 */
     autoTimeline?: boolean;
     reasoningEffort?: 'off' | 'low' | 'high' | 'max';

package/package.json

@@ -1,12 +1,12 @@
 {
   "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": "2.5.0",
+  "version": "2.5.1",
   "type": "module",
   "author": "waterwx",
   "repository": {
     "type": "git",
-    "url": "https://github.com/watersxya/dsh-novel-forge.git"
+    "url": "git+https://github.com/watersxya/dsh-novel-forge.git"
   },
   "homepage": "https://github.com/watersxya/dsh-novel-forge",
   "bugs": {