@waterwx/dsh-novel-forge 1.3.3 → 1.4.1

package/lib/types/bookshelf.d.ts

@@ -26,6 +26,11 @@ 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;
 /** 移除一本书。 */

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

@@ -16,6 +16,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>;
     /** 拆书分析：对已写章节做结构/人物/文风/卖点体检。 */
@@ -116,6 +118,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。 */

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

@@ -143,12 +143,14 @@ export declare const zh: {
     readonly 'settings.model': "模型";
     readonly 'settings.modelCustom': "自定义…";
     readonly 'settings.modelCustomPlaceholder': "输入任意模型 id";
-    readonly 'settings.reasoningEffort': "思考强度 (reasoningEffort)";
+    readonly 'settings.reasoningEffort': "写作类任务思考强度 (reasoningEffort)";
+    readonly 'settings.reasoningHint': "章节生成/润色/重写/审稿等写作任务使用；关掉更省更快。";
+    readonly 'settings.analysisReasoning': "分析类任务思考强度（提炼/拆书/反推大纲）";
+    readonly 'settings.analysisReasoningHint': "角色/场景/道藏提炼、拆书、反推大纲等一次性分析任务默认 low，保证质量，不受上面写作档位影响。";
     readonly 'settings.reasoning.off': "off · 关闭思考（推荐日常写文）";
     readonly 'settings.reasoning.low': "low · 低思考";
     readonly 'settings.reasoning.high': "high · 高思考";
     readonly 'settings.reasoning.max': "max · 最高思考（质检/推演）";
-    readonly 'settings.reasoningHint': "off 最快最省；high/max 更慢更贵但推理更强";
     readonly 'settings.theme': "主题";
     readonly 'settings.themeLiquid': "iOS 液态玻璃（绿）";
     readonly 'settings.themeClassic': "经典毛玻璃（蓝）";

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

@@ -0,0 +1,7 @@
+import type { NovelApi } from '../api.ts';
+export declare function ImportModal({ api, onClose, onImported, }: {
+    api: NovelApi;
+    onClose: () => void;
+    /** 导入成功并已激活该书后回调（刷新书架）。 */
+    onImported: () => void | Promise<void>;
+}): import("react").JSX.Element;

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

@@ -1,7 +1,7 @@
 import type { NovelApi } from '../api.ts';
 import type { BookshelfSnapshot } from '../../protocol.ts';
 /** 书架首页。 */
-export declare function ShelfView({ api, shelf, onOpenBook, onReadBook, onAddBook, }: {
+export declare function ShelfView({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, }: {
     api: NovelApi;
     shelf: BookshelfSnapshot;
     /** 点击书卡：激活该书并进入工作台。 */
@@ -10,4 +10,6 @@ export declare function ShelfView({ api, shelf, onOpenBook, onReadBook, onAddBoo
     onReadBook: (id: string) => void;
     /** 点击＋：进入开书向导页。 */
     onAddBook: () => void;
+    /** 点击「导入」：打开导入弹窗（已有项目目录 / txt/md 全本）。 */
+    onImportBook: () => void;
 }): import("react").JSX.Element;

package/lib/types/engine.d.ts

@@ -71,6 +71,33 @@ export declare function refreshPlotlineProgress(ctx: Context, config: NovelConfi
 export declare function extractRoles(ctx: Context, config: NovelConfig, project: ProjectState): Promise<RoleRecord[]>;
 /** ✨ AI 从全书提炼场景库：正文/编年录 → 高频重要场景的结构化视觉锚点。 */
 export declare function extractScenes(ctx: Context, config: NovelConfig, project: ProjectState): Promise<SceneCard[]>;
+/** 从 txt/md 全本文本拆章（纯逻辑，不落盘）：识别章节头、剥离重复标题、去重、排序并统一重新编号。 */
+export declare function splitBookText(raw: string): Array<{
+    no: number;
+    title: string;
+    body: string;
+}>;
+/** 拆章预览（不落盘）：章节编号/标题/字数 + 跳过清单。 */
+export declare function previewBookText(raw: string): {
+    chapters: Array<{
+        no: number;
+        title: string;
+        chars: number;
+    }>;
+    skipped: string[];
+};
+/** 从全本文本导入（浏览器上传 / 服务器文件共用）：建项目、写章节文件、保存。 */
+export declare function importBookTextFromText(raw: string, outputDir: string, bookName: string): {
+    bookName: string;
+    chapters: number;
+    skipped: string[];
+};
+/** 从 txt/md 全本文件导入：编码自适应读取后拆章建项目，status=written（待审稿）。 */
+export declare function importBookText(filePath: string, outputDir: string): {
+    bookName: string;
+    chapters: number;
+    skipped: string[];
+};
 /** 动漫形象描述词（中文描述 + 英文 booru 标签 + 关键外貌标签）。 */
 export interface RoleVisualPrompt {
     zh: string;
@@ -155,6 +182,11 @@ export declare function generateChapterStream(ctx: Context, config: NovelConfig,
 }, void, unknown>;
 /** Generate a chapter summary (narrative memory). */
 export declare function summarizeChapter(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<string>;
+/**
+ * 反向推大纲：从已写章节正文反推出全书总纲（分卷 + 章节要点 + 主线/人物弧线/伏笔清单）。
+ * 两阶段：分批提取章节事件摘要 → 汇总生成大纲。不修改章节/设定，只返回大纲文本。
+ */
+export declare function reverseOutlineFromChapters(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, onProgress?: (done: number, total: number, phase: string) => void): Promise<string>;
 /**
  * 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
  * 批量生成时整体开销约省 25%）。

package/lib/types/index.d.ts

@@ -35,6 +35,8 @@ export interface Config {
     model?: string;
     /** LLM reasoning effort (off/low/high/max). */
     reasoningEffort?: 'off' | 'low' | 'high' | 'max';
+    /** 分析类任务（提炼/拆书/反推大纲等）的推理档位；默认 low。 */
+    analysisReasoning?: 'off' | 'low' | 'high' | 'max';
     /** Target characters per chapter. */
     chapterChars?: number;
     /** Max output tokens per chapter call. */

package/lib/types/protocol.d.ts

@@ -35,6 +35,12 @@ export declare const NOVEL_API: {
     /** 清空助手对话记录。 */
     readonly assistantClear: "/api/dsh-novel-forge/assistant/clear";
     readonly bookshelf: "/api/dsh-novel-forge/bookshelf";
+    /** 导入已有项目目录（含 novel-project.json）到书架。 */
+    readonly bookshelfImportDir: "/api/dsh-novel-forge/bookshelf/import-dir";
+    /** 导入 txt/md 全本：拆章建项目并登记书架。 */
+    readonly bookshelfImportText: "/api/dsh-novel-forge/bookshelf/import-text";
+    /** 导入 txt/md 全本：拆章预览（不落盘）。 */
+    readonly bookshelfImportTextPreview: "/api/dsh-novel-forge/bookshelf/import-text/preview";
     /** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
     readonly reset: "/api/dsh-novel-forge/reset";
     /** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
@@ -69,6 +75,8 @@ export declare const NOVEL_API: {
     readonly sensitiveCheck: "/api/dsh-novel-forge/sensitive-check";
     /** 开书想法 → AI 补全大纲：输入一句话想法，生成 2-3 个可选大纲方案。 */
     readonly outlineSuggest: "/api/dsh-novel-forge/outline/suggest";
+    /** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流）。 */
+    readonly outlineReverse: "/api/dsh-novel-forge/outline/reverse";
     /** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检（两阶段：源笔记→分节分析）。 */
     readonly breakdown: "/api/dsh-novel-forge/breakdown";
     /** 漫剧分镜生成：章节 → 角色锚点 + 分镜表（可适配豆包/Seedance/SD）。 */
@@ -128,6 +136,60 @@ export interface BookActivateRequest {
 export interface BookRemoveRequest {
     id: string;
 }
+/** POST /bookshelf/import-dir 请求：导入已有项目目录。 */
+export interface BookImportDirRequest {
+    /** 项目目录（须含 novel-project.json）。 */
+    outputDir: string;
+}
+/** POST /bookshelf/import-dir 响应。 */
+export interface BookImportDirResponse {
+    book: BookEntry;
+    /** true = 目录已在书架中（本次为重新激活）。 */
+    existed: boolean;
+}
+/** POST /bookshelf/import-text 请求：导入 txt/md 全本。两种模式二选一：
+ *  - filePath：服务器本地文件路径；
+ *  - text + fileName：浏览器上传的全文内容（fileName 用于推断书名）。
+ */
+export interface BookImportTextRequest {
+    /** 模式一：源文件绝对路径（txt 或 md）。 */
+    filePath?: string;
+    /** 模式二：浏览器上传的全文内容。 */
+    text?: string;
+    /** 模式二：原文件名（txt/md），用于推断书名与显示。 */
+    fileName?: string;
+    /** 输出目录；缺省为 ~/.dsh/novels/书名。 */
+    outputDir?: string;
+}
+/** POST /bookshelf/import-text 响应。 */
+export interface BookImportTextResponse {
+    bookName: string;
+    /** 成功拆出的章节数。 */
+    chapters: number;
+    /** 因内容过短被跳过的章节标题列表。 */
+    skipped: string[];
+    /** 登记后的书架条目。 */
+    book: BookEntry;
+}
+/** POST /bookshelf/import-text/preview 请求：上传全文做拆章预览（不落盘）。 */
+export interface BookImportTextPreviewRequest {
+    text: string;
+    /** 原文件名（txt/md），用于推断书名。 */
+    fileName?: string;
+}
+/** POST /bookshelf/import-text/preview 响应。 */
+export interface BookImportTextPreviewResponse {
+    /** 预计书名（fileName 去扩展名）。 */
+    bookName: string;
+    /** 识别出的章节（已按正文长度过滤过短章节）。 */
+    chapters: Array<{
+        no: number;
+        title: string;
+        chars: number;
+    }>;
+    /** 因内容过短被跳过的章节标题列表。 */
+    skipped: string[];
+}
 /** Chapter lifecycle states (the writing pipeline's state machine). */
 export type ChapterStatus = 'pending' | 'generating' | 'written' | 'reviewing' | 'approved' | 'rejected' | 'error';
 /** One chapter in the plan. */
@@ -764,6 +826,8 @@ export interface NovelConfig {
     model: string;
     /** LLM reasoning effort: off = no thinking; low/high/max = thinking intensity. */
     reasoningEffort: 'off' | 'low' | 'high' | 'max';
+    /** 分析类任务（提炼/拆书/反推大纲等）的推理档位；默认 low，不受上面写作档位影响。 */
+    analysisReasoning: 'off' | 'low' | 'high' | 'max';
     /** Target characters per chapter. */
     chapterChars: number;
     /** Max output tokens per chapter call. */
@@ -929,6 +993,15 @@ export type JobFrame = {
     no: number;
     chars: number;
     draft: string;
+} | {
+    type: 'outline-progress';
+    done: number;
+    total: number;
+    phase: string;
+} | {
+    type: 'outline-done';
+    outline: string;
+    chars: number;
 } | {
     type: 'error';
     no: number;
@@ -1000,6 +1073,7 @@ export interface ConfigPatch {
     provider?: string;
     model?: string;
     reasoningEffort?: 'off' | 'low' | 'high' | 'max';
+    analysisReasoning?: 'off' | 'low' | 'high' | 'max';
     chapterChars?: number;
     maxTokens?: number;
     reviewPassScore?: number;

package/package.json

@@ -1,97 +1,97 @@
-{
-  "name": "@waterwx/dsh-novel-forge",
-  "description": "AI 编译小说工作台 for the dsh web GUI: import a novel outline (docx/text), plan chapters with LLM, generate chapter by chapter (3000-4000 chars each), and save every chapter as Markdown into your chosen output folder.",
-  "version": "1.3.3",
-  "type": "module",
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0"
-  },
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./client": {
-      "types": "./lib/types/client/index.d.ts",
-      "default": "./lib/client.js"
-    },
-    "./src/*": "./src/*",
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-ui-settings"
-      ],
-      "platform": "web"
-    }
-  },
-  "dependencies": {
-    "fflate": "^0.8.2",
-    "schemastery": "^3.18.0"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-skill": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-skill": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5",
-    "@types/node": "^22.20.0",
-    "@types/react": "~18.3.1",
-    "@types/react-dom": "^18.3.5",
-    "lightningcss": "1.32.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "tsdown": "0.22.2",
-    "typescript": "~5.7.2",
-    "vitest": "^3.0.0"
-  },
-  "files": [
-    "lib/**/*.js",
-    "lib/**/*.js.map",
-    "lib/**/*.d.ts",
-    "lib/**/*.d.ts.map",
-    "src",
-    "scripts/patch-schemastery.mjs",
-    "cordis.patch.yml",
-    "README.md"
-  ],
-  "license": "Apache-2.0",
-  "scripts": {
-    "postinstall": "node scripts/patch-schemastery.mjs",
-    "build": "tsc -p tsconfig.build.json && tsdown",
-    "bundle": "tsdown",
-    "watch": "tsdown --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
-  }
-}
+{
+  "name": "@waterwx/dsh-novel-forge",
+  "description": "AI 编译小说工作台 for the dsh web GUI: import a novel outline (docx/text), plan chapters with LLM, generate chapter by chapter (3000-4000 chars each), and save every chapter as Markdown into your chosen output folder.",
+  "version": "1.4.1",
+  "type": "module",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "dependencies": {
+    "fflate": "^0.8.2",
+    "schemastery": "^3.18.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-skill": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-skill": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5",
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "^18.3.5",
+    "lightningcss": "1.32.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsdown": "0.22.2",
+    "typescript": "~5.7.2",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.js.map",
+    "lib/**/*.d.ts",
+    "lib/**/*.d.ts.map",
+    "src",
+    "scripts/patch-schemastery.mjs",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "license": "Apache-2.0",
+  "scripts": {
+    "postinstall": "node scripts/patch-schemastery.mjs",
+    "build": "tsc -p tsconfig.build.json && tsdown",
+    "bundle": "tsdown",
+    "watch": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}

package/src/bookshelf.ts

@@ -114,6 +114,22 @@ export function seedBookshelfFromOutputDir(outputDir: string): boolean {
   return true
 }
 
+/** 导入已有项目目录到书架：校验 novel-project.json，已存在则直接激活。 */
+export function importDir(outputDir: string): { book: BookEntry; existed: boolean } {
+  const project = loadProject(outputDir)
+  if (project === undefined) throw new Error(`目录中未找到有效的 novel-project.json：${outputDir}`)
+  const store = loadBookshelf()
+  const existed = store.books.find(b => b.outputDir === outputDir)
+  if (existed !== undefined) {
+    store.activeBookId = existed.id
+    saveBookshelf(store)
+    return { book: existed, existed: true }
+  }
+  const bookName = project.bookName !== '' ? project.bookName : (outputDir.split(/[\\/]/).pop() ?? '未命名小说')
+  const book = createBook(bookName, outputDir)
+  return { book, existed: false }
+}
+
 /** 激活一本书。 */
 export function activateBook(id: string): BookEntry | undefined {
   const store = loadBookshelf()