@waterwx/dsh-novel-forge 1.1.2 → 1.1.3

package/src/engine.ts

@@ -69,6 +69,7 @@ export function loadProject(outputDir: string): ProjectState | undefined {
     if (!Array.isArray(raw.assets.auxiliaryProgressions)) raw.assets.auxiliaryProgressions = []
     if (!Array.isArray(raw.assets.styleAssets)) raw.assets.styleAssets = []
     if (!Array.isArray(raw.facts)) raw.facts = []
+    if (!Array.isArray(raw.plotlines)) raw.plotlines = []
     return raw
   } catch {
     return undefined
@@ -81,6 +82,78 @@ export function saveProject(outputDir: string, project: ProjectState): void {
   writeFileSync(join(outputDir, PROJECT_FILE), JSON.stringify(project, null, 2), 'utf8')
 }
 
+// ------------------------------------------------------------ sensitive words
+
+/**
+ * 内置违禁词库（网文平台常见审查类别）。只做硬匹配提示，不代替人工判断。
+ * 词语刻意保持常见写法；作者可自行判断是否修改。
+ */
+const SENSITIVE_WORDS: ReadonlyArray<{ word: string; category: string }> = [
+  // 政治敏感
+  { word: '共匪', category: '政治' }, { word: '独裁', category: '政治' },
+  { word: '法轮', category: '政治' }, { word: '六四', category: '政治' },
+  { word: '天安门事件', category: '政治' }, { word: '翻墙', category: '政治' },
+  { word: '政治敏感', category: '政治' },
+  // 色情擦边
+  { word: '乳沟', category: '擦边' }, { word: '酥胸', category: '擦边' },
+  { word: '淫荡', category: '擦边' }, { word: '做爱', category: '擦边' },
+  { word: '上床', category: '擦边' }, { word: '裸体', category: '擦边' },
+  { word: '一丝不挂', category: '擦边' }, { word: '胴体', category: '擦边' },
+  { word: '春药', category: '擦边' }, { word: '催情', category: '擦边' },
+  { word: '迷奸', category: '擦边' }, { word: '强暴', category: '擦边' },
+  { word: '轮奸', category: '擦边' }, { word: '援交', category: '擦边' },
+  { word: '嫖娼', category: '擦边' }, { word: '卖淫', category: '擦边' },
+  { word: '色情', category: '擦边' }, { word: '情色', category: '擦边' },
+  { word: '撸管', category: '擦边' }, { word: '自慰', category: '擦边' },
+  { word: '口交', category: '擦边' }, { word: '打炮', category: '擦边' },
+  { word: '约炮', category: '擦边' }, { word: '一夜情', category: '擦边' },
+  // 暴力血腥
+  { word: '碎尸', category: '暴力' }, { word: '分尸', category: '暴力' },
+  { word: '凌迟', category: '暴力' }, { word: '剥皮', category: '暴力' },
+  { word: '开膛', category: '暴力' }, { word: '剖腹', category: '暴力' },
+  { word: '挖心', category: '暴力' }, { word: '虐杀', category: '暴力' },
+  { word: '凌辱', category: '暴力' }, { word: '血腥', category: '暴力' },
+  { word: '大屠杀', category: '暴力' }, { word: '灭门', category: '暴力' },
+  { word: '满门抄斩', category: '暴力' }, { word: '腰斩', category: '暴力' },
+  { word: '活埋', category: '暴力' }, { word: '点天灯', category: '暴力' },
+  // 辱骂攻击
+  { word: '傻逼', category: '辱骂' }, { word: '傻B', category: '辱骂' },
+  { word: '草泥马', category: '辱骂' }, { word: '妈的', category: '辱骂' },
+  { word: '尼玛', category: '辱骂' }, { word: '去死', category: '辱骂' },
+  { word: '废物', category: '辱骂' }, { word: '垃圾', category: '辱骂' },
+  { word: '人渣', category: '辱骂' }, { word: '贱人', category: '辱骂' },
+  { word: '婊子', category: '辱骂' }, { word: '狗日的', category: '辱骂' },
+  // 广告引流
+  { word: '加微信', category: '广告' }, { word: '加QQ', category: '广告' },
+  { word: '微信公众号', category: '广告' }, { word: '淘宝', category: '广告' },
+  { word: '拼多多', category: '广告' }, { word: '刷单', category: '广告' },
+  { word: '充值返利', category: '广告' }, { word: '扫码领', category: '广告' },
+  { word: '加群领', category: '广告' }, { word: 'vx', category: '广告' },
+  { word: '扣扣', category: '广告' },
+  // 其他违禁
+  { word: '赌博', category: '其他' }, { word: '赌场', category: '其他' },
+  { word: '毒品', category: '其他' }, { word: '冰毒', category: '其他' },
+  { word: '摇头丸', category: '其他' }, { word: '自杀方法', category: '其他' },
+  { word: '邪教', category: '其他' }, { word: '传销', category: '其他' },
+  { word: '军火', category: '其他' }, { word: '枪支', category: '其他' },
+  { word: '管制刀具', category: '其他' },
+]
+
+/** 对一段文本做违禁词硬匹配，返回命中（词/类别/次数）。 */
+export function checkSensitiveText(text: string): Array<{ word: string; category: string; count: number }> {
+  const hits: Array<{ word: string; category: string; count: number }> = []
+  for (const entry of SENSITIVE_WORDS) {
+    let count = 0
+    let idx = text.indexOf(entry.word)
+    while (idx !== -1) {
+      count++
+      idx = text.indexOf(entry.word, idx + entry.word.length)
+    }
+    if (count > 0) hits.push({ word: entry.word, category: entry.category, count })
+  }
+  return hits
+}
+
 /** List generated chapter files in the output dir (sorted). */
 export function listChapterFiles(outputDir: string): string[] {
   if (!existsSync(outputDir)) return []
@@ -337,6 +410,7 @@ export async function extractBible(ctx: Context, config: NovelConfig, outline: s
           traits: strArray(entry.traits),
           goals: typeof entry.goals === 'string' ? entry.goals : '',
           relations: typeof entry.relations === 'string' ? entry.relations : '',
+          knowledge: strArray(entry.knowledge),
         }))
         .filter(card => card.name !== '')
     : []
@@ -443,6 +517,9 @@ function writeSystemPrompt(project: ProjectState): string {
       for (const card of bible.characters) {
         const roleName = { protagonist: '主角', supporting: '配角', antagonist: '反派', other: '其他' }[card.role]
         sections.push(`- ${card.name}（${roleName}）：${card.traits.join('、')}${card.goals !== '' ? `；目标：${card.goals}` : ''}${card.relations !== '' ? `；关系：${card.relations}` : ''}`)
+        if (Array.isArray(card.knowledge) && card.knowledge.length > 0) {
+          sections.push(`  已知信息（该角色知道的：${card.knowledge.join('；')}；未列出的信息该角色一律不知道，不得写其知晓或提及）`)
+        }
       }
     }
     if (bible.redLines.length > 0) sections.push('写作红线（违反即失败）：\n' + bible.redLines.map(r => `- ${r}`).join('\n'))
@@ -466,6 +543,14 @@ function writeSystemPrompt(project: ProjectState): string {
       sections.push(`- [${f.status === 'planted' ? '已埋设' : '推进中'}] ${f.description}${f.targetChapter !== undefined ? `（预计 ${f.targetChapter} 章回收）` : ''}`)
     }
   }
+  const lines = (project.plotlines ?? []).filter(l => l.status === 'active' || l.status === 'paused')
+  if (lines.length > 0) {
+    const kindName = { main: '主线', branch: '支线', character: '人物线', mystery: '悬念线' }
+    sections.push('==================== 剧情线（本章应推进至少一条活跃线） ====================')
+    for (const l of lines) {
+      sections.push(`- [${kindName[l.kind]}${l.status === 'paused' ? '·暂停中' : ''}] ${l.name}：${l.goal}${l.progress !== '' ? `（当前进度：${l.progress}）` : ''}`)
+    }
+  }
   sections.push('')
   sections.push('写作硬性要求：')
   sections.push('1. 每章 3000-4000 字（按中文字符计），只输出章节正文，不要输出标题、章回名、作者的话或任何 Markdown 标记。')
@@ -606,6 +691,9 @@ function reviewSystemPrompt(project: ProjectState): string {
       sections.push('角色卡：')
       for (const card of bible.characters) {
         sections.push(`- ${card.name}（${card.role}）：${card.traits.join('、')}`)
+        if (Array.isArray(card.knowledge) && card.knowledge.length > 0) {
+          sections.push(`  该角色知道：${card.knowledge.join('；')}（未列出的信息该角色不知道）`)
+        }
       }
     }
     if (bible.redLines.length > 0) sections.push('红线：\n' + bible.redLines.map(r => `- ${r}`).join('\n'))

package/src/protocol.ts

@@ -54,6 +54,10 @@ 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',
+  /** 敏感词检查：全书已写章节或指定文本。 */
+  sensitiveCheck: '/api/dsh-novel-forge/sensitive-check',
   config: '/api/dsh-novel-forge/config',
   openFolder: '/api/dsh-novel-forge/open-folder',
 } as const
@@ -192,6 +196,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 +260,71 @@ 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 请求：剧情线增删改 + 关联章节。 */
+export interface PlotlinesRequest {
+  op: 'add' | 'update' | 'remove' | 'link'
+  /** add / update 时传入的完整剧情线。 */
+  line?: Plotline
+  /** remove / link 时的目标线 id。 */
+  id?: string
+  /** link 时关联的章节号。 */
+  chapterNo?: number
+}
+
+/** POST /plotlines 响应。 */
+export interface PlotlinesResponse {
+  plotlines: Plotline[]
+}
+
+/** 一条敏感词命中。 */
+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 +343,8 @@ export interface BiblePatchRequest {
   worldRules?: string[]
   redLines?: string[]
   style?: string[]
+  /** 角色卡整体替换（人物志编辑知情度等）。 */
+  characters?: CharacterCard[]
 }
 
 /** POST /blurb 请求：AI 生成/补全或手动保存小说简介。 */
@@ -384,6 +457,8 @@ export interface ProjectState {
   coverPath?: string
   /** 大世界结构化数据（境界体系/区域/势力）。 */
   world?: WorldState
+  /** 剧情线（主线/支线/人物线/悬念线）。 */
+  plotlines?: Plotline[]
   /** ISO timestamps. */
   createdAt: string
   updatedAt: string

package/src/routes.ts

@@ -48,6 +48,8 @@ import {
   type LoadOutlineRequest,
   type LoadOutlineResponse,
   type NovelConfig,
+  type PlotlinesRequest,
+  type PlotlinesResponse,
   type PlanRequest,
   type PlanResponse,
   type PolishRequest,
@@ -55,7 +57,11 @@ import {
   type ReviewReport,
   type ReviewRequest,
   type RewriteRequest,
+  type SensitiveCheckRequest,
+  type SensitiveCheckResponse,
+  type SensitiveHit,
   type StatusResponse,
+  type StoryBible,
   type StyleEngineRequest,
   type SummaryRequest,
   type VolumesRequest,
@@ -87,6 +93,7 @@ import {
   reviewChapterText,
   rewriteChapterStream,
   saveProject,
+  checkSensitiveText,
   suggestForeshadows,
   summarizeAndExtractFacts,
   summarizeChapter,
@@ -1180,6 +1187,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 +1382,109 @@ 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} 章`
+          }
+        }
+      }
+      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)
+    },
+  }
+
   // --------------------------------------------------------------- config
   const configRoute: WebRoute = {
     kind: 'exact',
@@ -1433,6 +1559,8 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     coverRoute,
     worldRoute,
     renameRoute,
+    plotlinesRoute,
+    sensitiveRoute,
     configRoute,
     openFolderRoute,
   ]