@waterwx/dsh-novel-forge 1.1.2 → 1.1.4

package/src/protocol.ts

@@ -54,6 +54,12 @@ export const NOVEL_API = {
   world: '/api/dsh-novel-forge/world',
   /** 封面：GET 读取（dataUrl）/ POST 上传或移除。 */
   cover: '/api/dsh-novel-forge/blurb/cover',
+  /** 剧情线管理：增删改 + 关联章节。 */
+  plotlines: '/api/dsh-novel-forge/plotlines',
+  /** 作者复盘补跑：对已写章节补齐 authorReview（全书流式 / 单章 JSON）。 */
+  reviewBackfill: '/api/dsh-novel-forge/review/backfill',
+  /** 敏感词检查：全书已写章节或指定文本。 */
+  sensitiveCheck: '/api/dsh-novel-forge/sensitive-check',
   config: '/api/dsh-novel-forge/config',
   openFolder: '/api/dsh-novel-forge/open-folder',
 } as const
@@ -137,6 +143,8 @@ export interface ChapterPlan {
   summary?: string
   /** Latest review report (present once reviewed). */
   review?: ReviewReport
+  /** 作者复盘：钩子兑现/结尾钩子/剧情线推进/连续性/节奏趋势（生成后自动）。 */
+  authorReview?: AuthorReview
   /**
    * 待确认草稿：润色（去AI味）或整章重写的产物正文。生成时先存这里，
    * 用户看过对比后点「采纳」才覆盖正文文件；点「放弃」则丢弃。刷新页面不丢失。
@@ -144,6 +152,26 @@ export interface ChapterPlan {
   pendingDraft?: string
 }
 
+/** 作者复盘：叙事结构层面的逐章检查（钩子/推进/连续性/趋势）。 */
+export interface AuthorReview {
+  /** 上一章结尾钩子是否在本章兑现。 */
+  hookHonored: boolean
+  /** 钩子兑现说明（未兑现时给出建议）。 */
+  hookNote: string
+  /** 本章结尾钩子强度 0-10。 */
+  endingHook: number
+  /** 剧情线推进情况（推进了哪条线/或未推进）。 */
+  plotlineProgress: string
+  /** 结构化：本章推进的剧情线名称列表（与项目剧情线 name 精确匹配，复盘后自动关联章节）。 */
+  advancedLines?: string[]
+  /** 连续性检查（人物位置/时间/伤势/资源是否与上章衔接）。 */
+  continuity: string
+  /** 近期节奏趋势提示（拖沓/爽点密度等）。 */
+  trend: string
+  /** 复盘时间。 */
+  reviewedAt: string
+}
+
 /** One review finding. */
 export interface ReviewIssue {
   /** Severity: high = must fix, medium = should fix, low = suggestion. */
@@ -192,6 +220,8 @@ export interface CharacterCard {
   goals: string
   /** Key relations to other characters. */
   relations: string
+  /** 知情度：该角色已经知道的事实/秘密（未列出的信息该角色不知道）。 */
+  knowledge?: string[]
 }
 
 /** The structured story bible (worldbuilding extracted from the outline). */
@@ -254,6 +284,102 @@ export interface AuditResponse {
   auditedAt: string
 }
 
+/** 一条剧情线（主线/支线/人物线/悬念线）。 */
+export interface Plotline {
+  /** 稳定 id。 */
+  id: string
+  /** 线名。 */
+  name: string
+  /** 类型：主线 / 支线 / 人物线 / 悬念线。 */
+  kind: 'main' | 'branch' | 'character' | 'mystery'
+  /** 目标/终点（这条线最终要完成什么）。 */
+  goal: string
+  /** 当前进度说明（最近推进到哪）。 */
+  progress: string
+  /** 生命周期状态。 */
+  status: 'active' | 'paused' | 'resolved' | 'abandoned'
+  /** 关联章节号（推进/落地的章节）。 */
+  chapters: number[]
+  /** 创建时间。 */
+  createdAt: string
+}
+
+/** POST /plotlines 请求：剧情线增删改 + 关联章节 + AI 辅助。 */
+export interface PlotlinesRequest {
+  op: 'add' | 'update' | 'remove' | 'link' | 'suggest' | 'refresh' | 'health' | 'plan'
+  /** add / update 时传入的完整剧情线。 */
+  line?: Plotline
+  /** remove / link / refresh 时的目标线 id。 */
+  id?: string
+  /** link 时关联的章节号。 */
+  chapterNo?: number
+}
+
+/** 剧情线健康检查报告。 */
+export interface PlotlineHealthReport {
+  /** 是否需要新线（需要 / 暂不需要 / 再写 X 章后需要）。 */
+  verdict: string
+  /** 建议添加新线的时机说明。 */
+  timing: string
+  /** 依据（基于数据的理由，每条一句）。 */
+  reasons: string[]
+  /** 各线健康度。 */
+  lines: Array<{
+    name: string
+    /** ok=健康 / warning=预警 / stale=搁置过久。 */
+    health: 'ok' | 'warning' | 'stale'
+    note: string
+  }>
+}
+
+/** AI 剧情方案：下一阶段目标 + 建议新线。 */
+export interface PlotlinePlan {
+  /** 下一阶段（未来 5-10 章）剧情方向。 */
+  direction: string
+  /** 建议的新线（可逐条采纳）。 */
+  suggestions: Plotline[]
+}
+
+/** POST /plotlines 响应。 */
+export interface PlotlinesResponse {
+  plotlines: Plotline[]
+  /** op=suggest 时的 AI 建议候选线。 */
+  suggestions?: Plotline[]
+  /** op=health 时的健康检查报告。 */
+  health?: PlotlineHealthReport
+  /** op=plan 时的剧情方案。 */
+  plan?: PlotlinePlan
+}
+
+/** 一条敏感词命中。 */
+export interface SensitiveHit {
+  /** 命中章节号（文本检测时为 0）。 */
+  chapterNo: number
+  /** 命中的违禁词。 */
+  word: string
+  /** 类别：政治 / 擦边 / 暴力 / 辱骂 / 广告 / 其他。 */
+  category: string
+  /** 出现次数。 */
+  count: number
+}
+
+/** POST /sensitive-check 请求：检测指定章节/任意文本/全书。 */
+export interface SensitiveCheckRequest {
+  /** 检测该章正文。 */
+  chapterNo?: number
+  /** 检测任意文本（优先于 chapterNo）。 */
+  text?: string
+  /** 扫描全部已写章节。 */
+  all?: boolean
+}
+
+/** POST /sensitive-check 响应。 */
+export interface SensitiveCheckResponse {
+  hits: SensitiveHit[]
+  /** 参与扫描的章节数。 */
+  scannedChapters: number
+}
+
 /** 角色卡：角色当前状态（从事实库聚合）。 */
 export interface RoleStatusCard {
   name: string
@@ -272,6 +398,8 @@ export interface BiblePatchRequest {
   worldRules?: string[]
   redLines?: string[]
   style?: string[]
+  /** 角色卡整体替换（人物志编辑知情度等）。 */
+  characters?: CharacterCard[]
 }
 
 /** POST /blurb 请求：AI 生成/补全或手动保存小说简介。 */
@@ -384,6 +512,8 @@ export interface ProjectState {
   coverPath?: string
   /** 大世界结构化数据（境界体系/区域/势力）。 */
   world?: WorldState
+  /** 剧情线（主线/支线/人物线/悬念线）。 */
+  plotlines?: Plotline[]
   /** ISO timestamps. */
   createdAt: string
   updatedAt: string
@@ -407,6 +537,8 @@ export interface NovelConfig {
   reviewPassScore: number
   /** Whether generation auto-runs review after writing. */
   autoReview: boolean
+  /** Whether generation auto-runs the author review (hook/continuity/trend) after writing. */
+  autoAuthorReview: boolean
 }
 
 /** GET /status response. */
@@ -482,6 +614,8 @@ export type JobFrame =
   | { type: 'progress'; chars: number }
   | { type: 'done'; no: number; file: string; chars: number; title: string }
   | { type: 'review'; no: number; report: ReviewReport }
+  | { type: 'author-review'; no: number; review: AuthorReview }
+  | { type: 'author-backfill-done'; count: number }
   | { type: 'rewritten'; no: number; file: string; chars: number }
   /** 润色/重写完成，产物作为待确认草稿（尚未覆盖正文）。 */
   | { type: 'drafted'; no: number; chars: number; draft: string }
@@ -562,6 +696,7 @@ export interface ConfigPatch {
   maxTokens?: number
   reviewPassScore?: number
   autoReview?: boolean
+  autoAuthorReview?: boolean
 }
 
 // ------------------------------------------------------------ assistant

package/src/routes.ts

@@ -22,6 +22,7 @@ import {
   type AssistantHistoryResponse,
   type AssistantRequest,
   type AuditResponse,
+  type AuthorReview,
   type BiblePatchRequest,
   type BibleRequest,
   type BlurbRequest,
@@ -48,6 +49,8 @@ import {
   type LoadOutlineRequest,
   type LoadOutlineResponse,
   type NovelConfig,
+  type PlotlinesRequest,
+  type PlotlinesResponse,
   type PlanRequest,
   type PlanResponse,
   type PolishRequest,
@@ -55,7 +58,11 @@ import {
   type ReviewReport,
   type ReviewRequest,
   type RewriteRequest,
+  type SensitiveCheckRequest,
+  type SensitiveCheckResponse,
+  type SensitiveHit,
   type StatusResponse,
+  type StoryBible,
   type StyleEngineRequest,
   type SummaryRequest,
   type VolumesRequest,
@@ -68,6 +75,8 @@ import { BUILTIN_ANTI_AI_RULES, BUILTIN_GENRE_LIBRARY, BUILTIN_PROGRESSION_MODES
 import {
   chapterFileName,
   auditBook,
+  authorReviewChapter,
+  autoLinkPlotlines,
   backfillFacts,
   createProject,
   exportBook,
@@ -83,11 +92,16 @@ import {
   polishChapterStream,
   readChapterFile,
   refreshCharacters,
+  refreshPlotlineProgress,
   reviewChapter,
   reviewChapterText,
   rewriteChapterStream,
   saveProject,
+  analyzePlotlineHealth,
+  designPlotlinePlan,
+  checkSensitiveText,
   suggestForeshadows,
+  suggestPlotlines,
   summarizeAndExtractFacts,
   summarizeChapter,
   syncProjectWithDisk,
@@ -438,6 +452,31 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
           chapter.status = 'approved'
           saveProject(config.outputDir, project)
         }
+        // 作者复盘：叙事结构检查（钩子兑现/结尾钩子/推进/连续性/趋势；不改变章节状态）。
+        if (config.autoAuthorReview ?? true) {
+          try {
+            const currentBody = readChapterFile(config.outputDir, chapter)
+            let prevTail = ''
+            if (no > 1) {
+              const prev = project.chapters.find(c => c.no === no - 1)
+              if (prev !== undefined) {
+                prevTail = (readChapterFile(config.outputDir, prev) ?? '').replace(/^#.*$/m, '').trim().slice(-600)
+              }
+            }
+            if (currentBody !== undefined) {
+              const review = await authorReviewChapter(ctx, config, project, no, currentBody, prevTail)
+              chapter.authorReview = review
+              // 复盘标记推进的剧情线 → 自动关联本章。
+              if (review.advancedLines !== undefined) {
+                autoLinkPlotlines(project, no, review.advancedLines)
+              }
+              saveProject(config.outputDir, project)
+              send({ type: 'author-review', no, review })
+            }
+          } catch (error) {
+            console.warn('[dsh-novel-forge] author review failed:', (error as Error).message)
+          }
+        }
         res.end()
       } catch (error) {
         chapter.status = 'error'
@@ -1180,6 +1219,22 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
       if (Array.isArray(body?.worldRules)) project.bible.worldRules = body.worldRules.filter(r => r.trim() !== '')
       if (Array.isArray(body?.redLines)) project.bible.redLines = body.redLines.filter(r => r.trim() !== '')
       if (Array.isArray(body?.style)) project.bible.style = body.style.filter(r => r.trim() !== '')
+      if (Array.isArray(body?.characters)) {
+        project.bible.characters = body.characters
+          .filter(c => c !== undefined && c !== null && typeof c.name === 'string' && c.name.trim() !== '')
+          .map(c => ({
+            name: c.name.trim(),
+            role: (['protagonist', 'supporting', 'antagonist', 'other'] as const).includes(c.role as never)
+              ? c.role as StoryBible['characters'][number]['role']
+              : 'other',
+            traits: Array.isArray(c.traits) ? c.traits.filter((t): t is string => typeof t === 'string' && t.trim() !== '') : [],
+            goals: typeof c.goals === 'string' ? c.goals : '',
+            relations: typeof c.relations === 'string' ? c.relations : '',
+            knowledge: Array.isArray(c.knowledge)
+              ? c.knowledge.filter((k): k is string => typeof k === 'string' && k.trim() !== '')
+              : undefined,
+          }))
+      }
       project.updatedAt = new Date().toISOString()
       saveProject(config.outputDir, project)
       writeJson(res, 200, { bible: project.bible })
@@ -1359,6 +1414,243 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     },
   }
 
+  // ------------------------------------------------------------- plotlines
+  /** 剧情线管理：增删改 + 关联章节（主线/支线/人物线/悬念线）。 */
+  const plotlinesRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.plotlines,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const project = requireProject(res)
+      if (project === undefined) return
+      const body = await readJsonBody<PlotlinesRequest>(req)
+      if (project.plotlines === undefined) project.plotlines = []
+      const op = body?.op
+      if (op === 'add' && body?.line !== undefined) {
+        const line = body.line
+        project.plotlines.push({
+          id: line.id !== '' ? line.id : `pl-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+          name: line.name.slice(0, 40),
+          kind: line.kind,
+          goal: line.goal.slice(0, 300),
+          progress: line.progress.slice(0, 300),
+          status: line.status,
+          chapters: Array.isArray(line.chapters) ? line.chapters.filter((n): n is number => typeof n === 'number') : [],
+          createdAt: line.createdAt !== '' ? line.createdAt : new Date().toISOString(),
+        })
+      } else if (op === 'update' && body?.line !== undefined && body.line.id !== '') {
+        const idx = project.plotlines.findIndex(l => l.id === body.line!.id)
+        if (idx !== -1) {
+          const line = body.line
+          project.plotlines[idx] = {
+            ...project.plotlines[idx]!,
+            name: line.name.slice(0, 40),
+            kind: line.kind,
+            goal: line.goal.slice(0, 300),
+            progress: line.progress.slice(0, 300),
+            status: line.status,
+          }
+        }
+      } else if (op === 'remove' && body?.id !== undefined) {
+        project.plotlines = project.plotlines.filter(l => l.id !== body.id)
+      } else if (op === 'link' && body?.id !== undefined && typeof body.chapterNo === 'number' && body.chapterNo > 0) {
+        const line = project.plotlines.find(l => l.id === body.id)
+        if (line !== undefined && !line.chapters.includes(body.chapterNo)) {
+          line.chapters.push(body.chapterNo)
+          if (line.status === 'active' && line.progress === '') {
+            line.progress = `推进至第 ${body.chapterNo} 章`
+          }
+        }
+      } else if (op === 'suggest') {
+        try {
+          const suggestions = await suggestPlotlines(ctx, config, project)
+          writeJson(res, 200, { plotlines: project.plotlines, suggestions } satisfies PlotlinesResponse)
+          return
+        } catch (error) {
+          writeJson(res, 500, { error: `AI 建议失败：${(error as Error).message}` })
+          return
+        }
+      } else if (op === 'refresh' && body?.id !== undefined) {
+        const line = project.plotlines.find(l => l.id === body.id)
+        if (line === undefined) {
+          writeJson(res, 404, { error: '剧情线不存在' })
+          return
+        }
+        try {
+          const progress = await refreshPlotlineProgress(ctx, config, project, line)
+          line.progress = progress
+          project.updatedAt = new Date().toISOString()
+          saveProject(config.outputDir, project)
+          writeJson(res, 200, { plotlines: project.plotlines } satisfies PlotlinesResponse)
+          return
+        } catch (error) {
+          writeJson(res, 500, { error: `刷新进度失败：${(error as Error).message}` })
+          return
+        }
+      } else if (op === 'health') {
+        try {
+          const health = await analyzePlotlineHealth(ctx, config, project)
+          writeJson(res, 200, { plotlines: project.plotlines, health } satisfies PlotlinesResponse)
+          return
+        } catch (error) {
+          writeJson(res, 500, { error: `健康检查失败：${(error as Error).message}` })
+          return
+        }
+      } else if (op === 'plan') {
+        try {
+          const health = await analyzePlotlineHealth(ctx, config, project)
+          const plan = await designPlotlinePlan(ctx, config, project, health)
+          writeJson(res, 200, { plotlines: project.plotlines, health, plan } satisfies PlotlinesResponse)
+          return
+        } catch (error) {
+          writeJson(res, 500, { error: `剧情方案生成失败：${(error as Error).message}` })
+          return
+        }
+      }
+      project.updatedAt = new Date().toISOString()
+      saveProject(config.outputDir, project)
+      const response: PlotlinesResponse = { plotlines: project.plotlines }
+      writeJson(res, 200, response)
+    },
+  }
+
+  // --------------------------------------------------------- sensitive
+  /** 敏感词检查：指定章节 / 任意文本 / 全书已写章节。 */
+  const sensitiveRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.sensitiveCheck,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const project = requireProject(res)
+      if (project === undefined) return
+      const body = await readJsonBody<SensitiveCheckRequest>(req)
+      const hits: SensitiveHit[] = []
+      let scanned = 0
+      if (body?.text !== undefined) {
+        for (const hit of checkSensitiveText(body.text)) {
+          hits.push({ chapterNo: 0, word: hit.word, category: hit.category, count: hit.count })
+        }
+      } else if (typeof body?.chapterNo === 'number') {
+        const chapter = project.chapters.find(c => c.no === body.chapterNo)
+        if (chapter !== undefined) {
+          const text = readChapterFile(config.outputDir, chapter)
+          if (text !== undefined) {
+            scanned = 1
+            for (const hit of checkSensitiveText(text)) {
+              hits.push({ chapterNo: chapter.no, word: hit.word, category: hit.category, count: hit.count })
+            }
+          }
+        }
+      } else if (body?.all === true) {
+        for (const chapter of project.chapters) {
+          if (chapter.status === 'pending' || chapter.status === 'generating') continue
+          const text = readChapterFile(config.outputDir, chapter)
+          if (text === undefined) continue
+          scanned++
+          for (const hit of checkSensitiveText(text)) {
+            hits.push({ chapterNo: chapter.no, word: hit.word, category: hit.category, count: hit.count })
+          }
+        }
+      } else {
+        writeJson(res, 400, { error: '请提供 chapterNo / text / all 之一' })
+        return
+      }
+      const response: SensitiveCheckResponse = { hits, scannedChapters: scanned }
+      writeJson(res, 200, response)
+    },
+  }
+
+  // ------------------------------------------------------ author review backfill
+  /** 作者复盘补跑：对已写章节补齐 authorReview（body.chapterNo=单章 JSON，缺省=全书 NDJSON 流）。 */
+  const reviewBackfillRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.reviewBackfill,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const project = requireProject(res)
+      if (project === undefined) return
+      const body = await readJsonBody<{ chapterNo?: number }>(req)
+
+      /** 对一章执行作者复盘（读取已落盘正文，不改变章节状态/正文）。 */
+      const runOne = async (chapter: ChapterPlan): Promise<AuthorReview> => {
+        const currentBody = readChapterFile(config.outputDir, chapter)
+        if (currentBody === undefined) throw new Error(`章节 ${chapter.no} 的正文文件不存在`)
+        let prevTail = ''
+        if (chapter.no > 1) {
+          const prev = project.chapters.find(c => c.no === chapter.no - 1)
+          if (prev !== undefined) {
+            prevTail = (readChapterFile(config.outputDir, prev) ?? '').replace(/^#.*$/m, '').trim().slice(-600)
+          }
+        }
+        return authorReviewChapter(ctx, config, project, chapter.no, currentBody, prevTail)
+      }
+
+      // 单章：JSON 响应。
+      if (typeof body?.chapterNo === 'number' && body.chapterNo > 0) {
+        const chapter = project.chapters.find(c => c.no === body.chapterNo)
+        if (chapter === undefined) {
+          writeJson(res, 404, { error: `章节 ${body.chapterNo} 不在计划中` })
+          return
+        }
+        if (chapter.status === 'pending') {
+          writeJson(res, 400, { error: '该章尚未生成正文，无法复盘' })
+          return
+        }
+        try {
+          const review = await runOne(chapter)
+          chapter.authorReview = review
+          if (review.advancedLines !== undefined) {
+            autoLinkPlotlines(project, chapter.no, review.advancedLines)
+          }
+          project.updatedAt = new Date().toISOString()
+          saveProject(config.outputDir, project)
+          writeJson(res, 200, { no: chapter.no, review } satisfies { no: number; review: AuthorReview })
+          return
+        } catch (error) {
+          writeJson(res, 500, { error: (error as Error).message })
+          return
+        }
+      }
+
+      // 全书：NDJSON 流式补跑缺失复盘的已写章节。
+      const missing = project.chapters.filter(c => c.status !== 'pending' && c.status !== 'generating' && c.authorReview === undefined)
+      if (missing.length === 0) {
+        writeJson(res, 200, { count: 0 })
+        return
+      }
+      res.writeHead(200, {
+        'content-type': 'application/x-ndjson; charset=utf-8',
+        'cache-control': 'no-cache',
+        'referrer-policy': 'no-referrer',
+      })
+      const send = (frame: JobFrame): void => {
+        res.write(JSON.stringify(frame) + '\n')
+      }
+      let done = 0
+      for (const chapter of missing) {
+        try {
+          const review = await runOne(chapter)
+          chapter.authorReview = review
+          if (review.advancedLines !== undefined) {
+            autoLinkPlotlines(project, chapter.no, review.advancedLines)
+          }
+          done++
+          saveProject(config.outputDir, project)
+          send({ type: 'author-review', no: chapter.no, review })
+        } catch (error) {
+          console.warn(`[dsh-novel-forge] author backfill ch.${chapter.no} failed:`, (error as Error).message)
+        }
+      }
+      project.updatedAt = new Date().toISOString()
+      saveProject(config.outputDir, project)
+      send({ type: 'author-backfill-done', count: done })
+      res.end()
+    },
+  }
+
   // --------------------------------------------------------------- config
   const configRoute: WebRoute = {
     kind: 'exact',
@@ -1433,6 +1725,9 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     coverRoute,
     worldRoute,
     renameRoute,
+    plotlinesRoute,
+    sensitiveRoute,
+    reviewBackfillRoute,
     configRoute,
     openFolderRoute,
   ]