@waterwx/dsh-novel-forge 1.1.8 → 1.2.0-alpha

package/lib/types/review-policy.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 审稿规则注册表
+ *
+ * 生成用 compact 模式（核心规则），审稿用 full 模式（全部规则），
+ * 消除 reviewSystemPrompt 内嵌规则与 renderAllAssets() 两套打架的问题。
+ */
+/** 通用写作资产规则（兼容 ProjectAssets 中的各类规则） */
+export interface WritingRule {
+    name: string;
+    description: string;
+    type?: string;
+    enabled?: boolean;
+}
+export interface ReviewRule {
+    id: string;
+    /** 规则维度 */
+    dimension: 'character' | 'setting' | 'redline' | 'writing' | 'pacing' | 'logic' | 'anti-ai' | 'presentation' | 'compliance';
+    /** 严重度 */
+    severity: 'high' | 'medium' | 'low';
+    /** 规则类型：forbidden=禁止类（命中即问题），encourage=鼓励类（不命中不算错） */
+    type: 'forbidden' | 'encourage';
+    /** 规则描述 */
+    description: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 作用域 */
+    scope: Array<'writing' | 'review' | 'polish' | 'all'>;
+}
+/** 内置审稿维度（结构化评分用） */
+export declare const REVIEW_DIMENSIONS: readonly [{
+    readonly id: "character";
+    readonly name: "人设一致性";
+    readonly weight: 0.2;
+}, {
+    readonly id: "setting";
+    readonly name: "设定一致性";
+    readonly weight: 0.15;
+}, {
+    readonly id: "redline";
+    readonly name: "红线检查";
+    readonly weight: 0.15;
+}, {
+    readonly id: "writing";
+    readonly name: "文笔质量";
+    readonly weight: 0.15;
+}, {
+    readonly id: "pacing";
+    readonly name: "节奏与爽点";
+    readonly weight: 0.1;
+}, {
+    readonly id: "logic";
+    readonly name: "逻辑漏洞";
+    readonly weight: 0.1;
+}, {
+    readonly id: "anti-ai";
+    readonly name: "反 AI 规则";
+    readonly weight: 0.05;
+}, {
+    readonly id: "presentation";
+    readonly name: "呈现方式";
+    readonly weight: 0.05;
+}, {
+    readonly id: "compliance";
+    readonly name: "内容合规";
+    readonly weight: 0.05;
+}];
+export type ReviewDimensionId = typeof REVIEW_DIMENSIONS[number]['id'];
+/** 维度结构化评分 */
+export interface DimensionScore {
+    dimension: ReviewDimensionId;
+    score: number;
+    note: string;
+}
+/**
+ * 渲染审稿规则（compact 或 full 模式）
+ *
+ * compact: 只渲染禁止类 + high 严重度（用于生成时的约束）
+ * full: 渲染全部启用规则（用于审稿时的检查清单）
+ */
+export declare function renderReviewRules(assets: WritingRule[] | undefined, mode?: 'compact' | 'full'): string;
+/**
+ * 从审稿 issues 中按维度统计
+ * 用于结构化评分和 UI 展示。
+ */
+export declare function groupIssuesByDimension(issues: Array<{
+    severity: string;
+    item: string;
+    dimension?: string;
+}>): Record<string, Array<{
+    severity: string;
+    item: string;
+}>>;
+/**
+ * 计算维度加权总分
+ * 用于审稿报告的结构化评分。
+ */
+export declare function calculateWeightedScore(dimensions: DimensionScore[]): number;

package/lib/types/routes.d.ts

@@ -18,6 +18,10 @@ export interface NovelRoutesDeps {
     getConfig: () => NovelConfig;
     /** Persist a config patch through the settings seam. */
     patchConfig: (patch: ConfigPatch) => Promise<NovelConfig>;
+    /** Raw settings config（未与激活书合并）——目录迁移判断默认目录是否需同步用。 */
+    rawConfig?: () => {
+        outputDir?: string;
+    };
 }
 /**
  * Build every /api/dsh-novel-forge route.

package/lib/types/run.d.ts

@@ -0,0 +1,34 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { NovelConfig, RunState } from './protocol.ts';
+export declare class ProductionRunner {
+    private deps;
+    private state;
+    private working;
+    private pauseRequested;
+    private stopRequested;
+    /** 生产单绑定目录（start 时快照；所有读写固定用它，防止运行中切书导致写错目录）。 */
+    private bookDir;
+    constructor(deps: {
+        ctx: Context;
+        getConfig: () => NovelConfig;
+    });
+    /** 当前生产单状态（内存优先；web 重启后从磁盘恢复）。 */
+    status(): RunState | null;
+    private persist;
+    private log;
+    /** 启动/续跑生产单：startNo..endNo 区间，endNo 超出计划时先自动补计划。 */
+    start(startNo: number, endNo: number, runDir?: string): Promise<RunState>;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    /** 是否有生产单正在执行（目录迁移等磁盘级操作前须为 false）。 */
+    isWorking(): boolean;
+    /** 主循环：从 currentNo 扫描到 endNo，逐章处理；支持暂停/停止。 */
+    private loop;
+    private processChapter;
+    /** 完整质量门：生成 → 摘要+事实 → 伏笔标记 → 审稿 → 作者复盘。 */
+    private produce;
+    /** 被拒分级处理：无 high 豁免；有 high 按意见修订（最多 2 轮）+ 验证模式；仍不过 → 待人工。 */
+    private handleRejected;
+    private applyDraft;
+}

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

@@ -0,0 +1,60 @@
+/**
+ * 阶段契约（Stage Contract）——宿主计算的「当前阶段 → 本轮允许的动作」。
+ *
+ * 设计来源（借鉴 dsh-ai-novel-writer 的「作者请求中的当前阶段决定唯一允许命令」）：
+ * 允许的动作必须由宿主根据真实项目状态算出，而不是指望模型记住或自律。
+ * 宿主计算结果同时用于三处：
+ *   1) 注入助手系统提示词：模型知道自己在哪一步、下一步该做什么；
+ *   2) 通用续写指令（「继续 / 下一步」）下的写操作白名单强约束（阶段即唯一命令）；
+ *   3) 拒绝写操作时给出可执行的、阶段相关的理由，而不是一句「不允许」。
+ *
+ * 注意：作者显式点名的写操作永远优先于阶段白名单（作者终审权）；
+ * 阶段强约束只在作者没有指定具体对象（通用续写）时生效。
+ */
+import type { ChapterPlan, ProjectState, StageInfo } from './protocol.ts';
+/** 创作阶段标识（线上形状见 protocol.ts 的 StageInfo）。 */
+export type BookStageId = StageInfo['id'];
+/** 一个阶段契约。 */
+export type BookStage = StageInfo;
+/**
+ * 作者这一轮是否只说了「继续/下一步」这类没有具体对象的指令。
+ *
+ * @param message 本轮用户消息。
+ * @returns 是通用续写指令时为 true。
+ */
+export declare function isGenericContinue(message: string): boolean;
+/**
+ * 根据项目真实状态计算当前创作阶段。
+ *
+ * @param project 当前项目（未加载时为 undefined）。
+ * @returns 阶段契约（推荐动作 + 写操作白名单 + 判定理由）。
+ */
+export declare function computeBookStage(project: ProjectState | undefined): BookStage;
+/**
+ * 判断某写操作是否在当前阶段的允许白名单内。
+ *
+ * @param stage 阶段契约。
+ * @param tool 助手工具名。
+ * @returns 允许时为 true。
+ */
+export declare function stageAllows(stage: BookStage, tool: string): boolean;
+/**
+ * 按阶段把一组动作分成「本阶段可用」与「阶段外」。
+ *
+ * @param stage 阶段契约。
+ * @param tools 动作名列表（通常是写操作登记表）。
+ * @returns 两个保持输入顺序的子集。
+ */
+export declare function splitByStage(stage: BookStage, tools: readonly string[]): {
+    available: string[];
+    outside: string[];
+};
+/**
+ * 渲染阶段契约为可注入提示词的一段文字。
+ *
+ * @param stage 阶段契约。
+ * @returns 多行文本。
+ */
+export declare function renderStageContract(stage: BookStage): string;
+/** 汇总章节状态计数（供面板/提示词展示，避免各处重复统计）。 */
+export declare function summarizeChapters(chapters: ChapterPlan[]): Record<string, number>;

package/package.json

@@ -1,8 +1,32 @@
 {
   "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.1.8",
+  "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.0-alpha",
   "type": "module",
+  "author": "waterwx",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/watersxya/dsh-novel-forge.git"
+  },
+  "homepage": "https://github.com/watersxya/dsh-novel-forge",
+  "bugs": {
+    "url": "https://github.com/watersxya/dsh-novel-forge/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "小说工坊",
+    "novel-forge",
+    "ai-novel-writing",
+    "novel-writing",
+    "写作助手",
+    "小说创作",
+    "网文写作",
+    "章节生成",
+    "AI审稿",
+    "story-writing"
+  ],
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
   },
@@ -26,7 +50,6 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-ui-settings"
       ],
@@ -35,36 +58,35 @@
   },
   "dependencies": {
     "fflate": "^0.8.2",
+    "lucide-react": "^1.33.0",
     "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",
+    "@deepseek-ai/dsh-client-connection": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-host-webserver": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-skill": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-tools": "0.1.2-alpha.3",
     "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",
+    "@deepseek-ai/dsh-client-connection": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-host-webserver": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-skill": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-tools": "0.1.2-alpha.3",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "^18.3.5",
@@ -77,19 +99,22 @@
   },
   "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",
+    "check:styles": "node scripts/check-theme-sizes.mjs",
+    "release": "node scripts/release.mjs",
+    "release:dry": "node scripts/release.mjs --dry-run",
     "test": "vitest run"
   }
 }

package/scripts/patch-schemastery.mjs

@@ -0,0 +1,47 @@
+// Durable local fix: schemastery@3.18.x from npm has no "exports" field, which
+// breaks tsx/Node ESM resolution when dsh loads novel-forge's lib/index.js.
+// pnpm re-installs can overwrite the manual node_modules patch, so this script
+// re-applies it on every `pnpm install` (postinstall).
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = join(fileURLToPath(new URL('..', import.meta.url)))
+const pnpmDir = join(root, 'node_modules', '.pnpm')
+
+if (!existsSync(pnpmDir)) {
+  console.warn('[dsh-novel-forge] no node_modules/.pnpm found; skip schemastery patch')
+  process.exit(0)
+}
+
+const candidates = readdirSync(pnpmDir)
+  .filter((name) => name.startsWith('schemastery@'))
+  .map((name) => join(pnpmDir, name, 'node_modules', 'schemastery', 'package.json'))
+  .filter((file) => existsSync(file))
+
+if (candidates.length === 0) {
+  console.warn('[dsh-novel-forge] schemastery package not found; skip patch')
+  process.exit(0)
+}
+
+let patched = 0
+for (const file of candidates) {
+  const pkg = JSON.parse(readFileSync(file, 'utf8'))
+  if (pkg.exports) {
+    console.log(`[dsh-novel-forge] schemastery exports already present: ${file}`)
+    continue
+  }
+  pkg.exports = {
+    '.': {
+      types: './lib/index.d.ts',
+      import: './lib/index.mjs',
+      require: './lib/index.cjs',
+    },
+    './package.json': './package.json',
+  }
+  writeFileSync(file, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8')
+  console.log(`[dsh-novel-forge] patched schemastery exports: ${file}`)
+  patched++
+}
+
+if (patched === 0) console.log('[dsh-novel-forge] schemastery patch: nothing to do')

package/src/action-guard.ts

@@ -0,0 +1,127 @@
+/**
+ * 动作失败分级（fail-stop 规则）——不依赖 LLM/宿主服务的纯逻辑模块，可离线单测。
+ *
+ * 规则来源（借鉴 dsh-ai-novel-writer）：
+ *  - 参数/契约类失败**不得重复同一调用**，解释一次即停；
+ *  - 瞬时故障允许有限重试，同样禁止无限重试。
+ * 规则必须可测试，否则只是文档。
+ */
+
+/**
+ * 动作失败分级：
+ * - `contract` 参数/契约类（参数缺失、片段未找到、章节不存在、非法取值…）：
+ *   同一调用只允许修正一次，禁止原样重复。
+ * - `transient` 瞬时故障（网络、模型中断、磁盘临时不可用…）：允许重试一次。
+ */
+export type ActionErrorKind = 'contract' | 'transient'
+
+/** 带分级的动作失败（executeAction 抛出，供 fail-stop 判定）。 */
+export class NovelActionError extends Error {
+  readonly kind: ActionErrorKind
+  constructor(kind: ActionErrorKind, message: string) {
+    super(message)
+    this.name = 'NovelActionError'
+    this.kind = kind
+  }
+}
+
+/** 瞬时故障特征（先判，避免被下面的契约词误伤）。 */
+const TRANSIENT_PATTERNS: readonly RegExp[] = [
+  /助手调用失败/,
+  /生成失败|请求失败|调用失败/,
+  /network|fetch failed|ECONNRESET|ECONNREFUSED|ETIMEDOUT|EPIPE|EAI_AGAIN|socket hang up|aborted|terminated/i,
+  /超时|timeout/i,
+  /频繁|限流|rate\s*limit|too many requests|\b429\b/i,
+  /ENOSPC|EACCES|EBUSY|EPERM|EMFILE/,
+]
+
+/**
+ * 参数/契约类失败特征（兜底识别）。
+ *
+ * 宿主自己的前置条件失败已在抛出点标成 {@link NovelActionError}（引擎与助手动作层），
+ * 这里的正则只兜住漏标的历史消息与第三方错误。
+ */
+const CONTRACT_PATTERNS: readonly RegExp[] = [
+  /动作参数不是合法 JSON/,
+  /未知工具/,
+  /需要/,
+  /不存在/,
+  /尚未生成/,
+  /未找到/,
+  /不在计划中/,
+  /正文文件不存在/,
+  /还没有已写章节/,
+  /没有可分析的已写章节/,
+  /非法/,
+  /无效/,
+  /必须是/,
+  /无法识别/,
+  /请先/,
+]
+
+/**
+ * 判定一次动作失败的类别。
+ *
+ * @param error 捕获到的异常。
+ * @returns `contract`（参数/契约，不重试原样调用）或 `transient`（瞬时，可重试一次）。
+ */
+export function classifyActionError(error: unknown): ActionErrorKind {
+  if (error instanceof NovelActionError) return error.kind
+  const message = error instanceof Error ? error.message : String(error)
+  if (TRANSIENT_PATTERNS.some(re => re.test(message))) return 'transient'
+  if (CONTRACT_PATTERNS.some(re => re.test(message))) return 'contract'
+  // 未知错误默认按瞬时处理：允许一次重试，但同一调用签名仍有次数上限（见 fail-stop）。
+  return 'transient'
+}
+
+/**
+ * 同一调用签名允许的总尝试次数（含首次）。
+ *
+ * @param kind 失败类别。
+ * @returns `contract` = 1（禁止原样重复），`transient` = 2（允许一次重试）。
+ */
+export function actionRetryLimit(kind: ActionErrorKind): number {
+  return kind === 'contract' ? 1 : 2
+}
+
+/**
+ * 把动作参数规范化为稳定签名（键排序），用于识别「同一个调用」。
+ *
+ * @param args 动作参数。
+ * @returns 稳定字符串签名。
+ */
+export function safeArgsKey(args: Record<string, unknown> | undefined): string {
+  if (args === undefined) return ''
+  try {
+    return JSON.stringify(Object.keys(args).sort().map(key => [key, args[key]]))
+  } catch {
+    return String(args)
+  }
+}
+
+/**
+ * 已失败调用记账：同一签名达到重试上限即 fail-stop。
+ */
+export class FailureLedger {
+  private readonly counts = new Map<string, number>()
+
+  /**
+   * 记录一次失败并判断是否应当停止本轮。
+   *
+   * @param tool 工具名。
+   * @param args 该次调用参数。
+   * @param kind 失败类别。
+   * @returns `attempts` 本次是第几次失败；`stop` 是否达到上限（true = 立即停止，不再喂回模型）。
+   */
+  record(tool: string, args: Record<string, unknown> | undefined, kind: ActionErrorKind): { attempts: number; stop: boolean } {
+    const signature = `${tool}:${safeArgsKey(args)}`
+    const attempts = (this.counts.get(signature) ?? 0) + 1
+    this.counts.set(signature, attempts)
+    return { attempts, stop: attempts >= actionRetryLimit(kind) }
+  }
+
+  /** 已登记的失败签名数量（测试/诊断用）。 */
+  get size(): number {
+    return this.counts.size
+  }
+}