@waterwx/dsh-novel-forge 1.7.2 → 1.7.3

package/src/protocol.ts

@@ -4,6 +4,16 @@
  * state file format, and the NDJSON generation stream frames all live here so
  * both halves spell exactly one vocabulary.
  */
+import type {
+  ShotSizeId,
+  CameraMoveId,
+  CompositionId,
+  LightingId,
+} from './shot-language.ts'
+import type {
+  StoryFunctionId,
+  EmotionId,
+} from './story-beat-language.ts'
 
 /** The /api/dsh-novel-forge route family (same-origin, loopback-fenced). */
 export const NOVEL_API = {
@@ -212,10 +222,10 @@ export interface StoryboardBeat {
   id: string
   /** 事件一句话（发生了什么）。 */
   event: string
-  /** 情绪走向（如 压抑→隐忍→惊惧）。 */
-  emotion: string
-  /** 叙事功能：铺垫/冲突/转折/高潮/收束/伏笔/人物塑造。 */
-  function: string
+  /** 情绪走向（情绪词 id 数组，来自 story-beat-language 词库，链式）。 */
+  emotion: EmotionId[]
+  /** 叙事功能（枚举 id，来自 story-beat-language 词库）。 */
+  function: StoryFunctionId
   /** 因果：承接上一节拍的原因（可选）。 */
   cause?: string
 }
@@ -247,10 +257,12 @@ export interface StoryboardShot {
   id: string
   /** 挂载的节拍 id（骨架中的 b1…）。 */
   beatId: string
-  /** 景别：远景/全景/中景/近景/特写。 */
-  shot: string
-  /** 机位与运镜（如 低机位仰拍 + 缓慢推近）。 */
-  camera: string
+  /** 景别（枚举 id，来自 shot-language 词库）。 */
+  shot: ShotSizeId
+  /** 机位与运镜（枚举 id 数组，来自 shot-language 词库）。 */
+  camera: CameraMoveId[]
+  /** 构图（可选，枚举 id）。 */
+  composition?: CompositionId
   /** 时长（秒，1-12）。 */
   duration: number
   /** 画面内容：角色动作 + 表情 + 服装/标志物。 */
@@ -259,8 +271,8 @@ export interface StoryboardShot {
   line: string
   /** 音效（无则空字符串）。 */
   sound: string
-  /** 光效（如 雨夜顶光 + 手机屏幕冷光）。 */
-  light: string
+  /** 光效（枚举 id 数组，来自 shot-language 词库）。 */
+  light: LightingId[]
   /** 承接上一镜头结尾状态（位置/动作/情绪/服装）。 */
   prevState: string
   /** 本镜头结束状态。 */

package/src/routes.ts

@@ -9,7 +9,7 @@
  */
 
 import type { IncomingMessage, ServerResponse } from 'node:http'
-import { exec } from 'node:child_process'
+import { spawn } from 'node:child_process'
 import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { join, basename, extname } from 'node:path'
 import { homedir } from 'node:os'
@@ -2296,12 +2296,18 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
       if (!guard(req, res, 'POST')) return
       const config = getConfig()
       const dir = config.outputDir
-      exec(`explorer "${dir.replace(/"/g, '')}"`, (error) => {
-        if (error) {
-          writeJson(res, 500, { ok: false, error: error.message })
-        } else {
-          writeJson(res, 200, { ok: true })
-        }
+      const child = spawn('explorer', [dir], { shell: false })
+      let responded = false
+      child.on('error', (error) => {
+        if (responded) return
+        responded = true
+        writeJson(res, 500, { ok: false, error: error.message })
+      })
+      child.on('exit', (code) => {
+        if (responded) return
+        responded = true
+        if (code === 0) writeJson(res, 200, { ok: true })
+        else writeJson(res, 500, { ok: false, error: `explorer 退出码 ${code}` })
       })
     },
   }

package/src/run.ts

@@ -306,11 +306,12 @@ export class ProductionRunner {
 
   private applyDraft(project: ProjectState, chapter: ChapterPlan, draft: string, report: ReviewReport): void {
     const config = this.deps.getConfig()
+    const outputDir = this.bookDir ?? config.outputDir
     const fileName = chapterFileName(chapter)
-    mkdirSync(config.outputDir, { recursive: true })
-    const targetPath = join(config.outputDir, fileName)
+    mkdirSync(outputDir, { recursive: true })
+    const targetPath = join(outputDir, fileName)
     if (existsSync(targetPath)) {
-      copyFileSync(targetPath, join(config.outputDir, `${fileName.replace(/\.md$/, '')}.bak.md`))
+      copyFileSync(targetPath, join(outputDir, `${fileName.replace(/\.md$/, '')}.bak.md`))
     }
     writeFileSync(targetPath, `# 第${chapter.no}章 ${chapter.title}\n\n${draft}\n`, 'utf8')
     chapter.pendingDraft = undefined
@@ -325,6 +326,6 @@ export class ProductionRunner {
     }
     chapter.error = undefined
     project.updatedAt = new Date().toISOString()
-    saveProject(config.outputDir, project)
+    saveProject(outputDir, project)
   }
 }

package/src/shot-language.ts

@@ -0,0 +1,181 @@
+/**
+ * 镜头语言词库（分镜规范化基准）。
+ * 分镜表的 shot/camera/composition/light 字段统一从这里取值（英文 id），
+ * 生成提示词时用 zh 中文词块；适配英文平台时用 en。
+ * 目的：让"景别/运镜/构图/光效"有标准词表，避免 LLM 自由发挥导致漂移。
+ */
+
+/** 景别。 */
+export type ShotSizeId =
+  | 'extreme_wide' | 'wide' | 'full' | 'medium'
+  | 'medium_close' | 'close' | 'extreme_close' | 'big_extreme_close'
+
+/** 运镜/机位。 */
+export type CameraMoveId =
+  | 'static' | 'dolly_in' | 'dolly_out' | 'pan_left' | 'pan_right'
+  | 'track_left' | 'track_right' | 'follow' | 'pedestal_up' | 'pedestal_down'
+  | 'orbit' | 'handheld' | 'low_angle' | 'high_angle' | 'over_shoulder'
+
+/** 构图。 */
+export type CompositionId =
+  | 'rule_of_thirds' | 'center' | 'leading_line' | 'foreground'
+  | 'low' | 'overhead' | 'symmetry'
+
+/** 光效。 */
+export type LightingId =
+  | 'front' | 'side' | 'back' | 'top' | 'rembrandt'
+  | 'neon' | 'hard' | 'soft' | 'mood' | 'contrast'
+
+export interface ShotLangEntry<T extends string> {
+  id: T
+  /** 中文（提示词/展示用）。 */
+  zh: string
+  /** 英文（英文平台适配用）。 */
+  en: string
+  /** 一句话说明（下拉/卡片）。 */
+  hint: string
+}
+
+export const SHOT_SIZES: readonly ShotLangEntry<ShotSizeId>[] = [
+  { id: 'extreme_wide', zh: '大远景', en: 'extreme wide shot', hint: '环境为主，人物很小' },
+  { id: 'wide', zh: '远景', en: 'wide shot', hint: '人在景中，交代环境' },
+  { id: 'full', zh: '全景', en: 'full shot', hint: '全身』人物整体' },
+  { id: 'medium', zh: '中景', en: 'medium shot', hint: '膝部以上，叙事主力' },
+  { id: 'medium_close', zh: '中近景', en: 'medium close-up', hint: '胸以上，表情+动作' },
+  { id: 'close', zh: '近景', en: 'close-up', hint: '肩以上，突出表情' },
+  { id: 'extreme_close', zh: '特写', en: 'extreme close-up', hint: '脸/物细节' },
+  { id: 'big_extreme_close', zh: '大特写', en: 'big close-up', hint: '局部（眼/手/标志物）' },
+]
+
+export const CAMERA_MOVES: readonly ShotLangEntry<CameraMoveId>[] = [
+  { id: 'static', zh: '固定机位', en: 'static camera', hint: '机位不动' },
+  { id: 'dolly_in', zh: '推近', en: 'dolly in', hint: '镜头向主体逼近' },
+  { id: 'dolly_out', zh: '拉远', en: 'dolly out', hint: '镜头远离主体' },
+  { id: 'pan_left', zh: '左摇', en: 'pan left', hint: '机位不动，镜头左转' },
+  { id: 'pan_right', zh: '右摇', en: 'pan right', hint: '机位不动，镜头右转' },
+  { id: 'track_left', zh: '左横移', en: 'track left', hint: '机位随主体左移' },
+  { id: 'track_right', zh: '右横移', en: 'track right', hint: '机位随主体右移' },
+  { id: 'follow', zh: '跟随', en: 'follow shot', hint: '镜头跟着主体运动' },
+  { id: 'pedestal_up', zh: '升镜', en: 'pedestal up', hint: '机位抬高' },
+  { id: 'pedestal_down', zh: '降镜', en: 'pedestal down', hint: '机位降低' },
+  { id: 'orbit', zh: '环绕', en: 'orbit shot', hint: '镜头绕主体转' },
+  { id: 'handheld', zh: '手持晃动', en: 'handheld', hint: '真实感/紧张感' },
+  { id: 'low_angle', zh: '低机位仰拍', en: 'low angle', hint: '突出威严/压迫' },
+  { id: 'high_angle', zh: '高机位俯拍', en: 'high angle', hint: '突出渺小/全知' },
+  { id: 'over_shoulder', zh: '过肩镜头', en: 'over-the-shoulder', hint: '对话常用' },
+]
+
+export const COMPOSITIONS: readonly ShotLangEntry<CompositionId>[] = [
+  { id: 'rule_of_thirds', zh: '三分法', en: 'rule of thirds', hint: '主体偏三分之一处' },
+  { id: 'center', zh: '中心对称', en: 'centered', hint: '主体居中' },
+  { id: 'leading_line', zh: '引导线', en: 'leading lines', hint: '视线沿线条引向主体' },
+  { id: 'foreground', zh: '前景遮挡', en: 'foreground framing', hint: '前景物框住主体' },
+  { id: 'low', zh: '低机位', en: 'low camera', hint: '低于视线' },
+  { id: 'overhead', zh: '俯拍', en: 'overhead', hint: '从上方俯视' },
+  { id: 'symmetry', zh: '对称构图', en: 'symmetrical', hint: '左右镜像' },
+]
+
+export const LIGHTINGS: readonly ShotLangEntry<LightingId>[] = [
+  { id: 'front', zh: '顺光', en: 'front light', hint: '正面均匀照明' },
+  { id: 'side', zh: '侧光', en: 'side light', hint: '明暗对比强' },
+  { id: 'back', zh: '逆光', en: 'back light', hint: '轮廓光/剪影' },
+  { id: 'top', zh: '顶光', en: 'top light', hint: '俯照硬朗' },
+  { id: 'rembrandt', zh: '伦勃朗光', en: 'rembrandt lighting', hint: '侧逆光，经典人像' },
+  { id: 'neon', zh: '霓虹光', en: 'neon lighting', hint: '赛博/夜景' },
+  { id: 'hard', zh: '硬光', en: 'hard light', hint: '犀利阴影' },
+  { id: 'soft', zh: '柔光', en: 'soft light', hint: '柔和过渡' },
+  { id: 'mood', zh: '氛围光', en: 'mood lighting', hint: '情绪化色温' },
+  { id: 'contrast', zh: '高反差', en: 'high contrast', hint: '黑白/强明暗' },
+]
+
+export interface ShotLanguage {
+  shot?: ShotSizeId
+  camera: CameraMoveId[]
+  composition?: CompositionId
+  light: LightingId[]
+}
+
+/** 从中文文本归一化到景别（处理旧数据/LLM 口语）。未知回退 medium。 */
+export function normalizeShotSize(text: string | undefined): ShotSizeId {
+  if (text === undefined || text === '') return 'medium'
+  const t = text.trim()
+  if (t.includes('大远景')) return 'extreme_wide'
+  if (t.includes('远景')) return 'wide'
+  if (t.includes('全景')) return 'full'
+  if (t.includes('中近景') || t.includes('中景')) return 'medium'
+  if (t.includes('近景') || t.includes('胸')) return 'close'
+  if (t.includes('大特写')) return 'big_extreme_close'
+  if (t.includes('特写')) return 'extreme_close'
+  return 'medium'
+}
+
+/** 从中文文本归一化到运镜列表。 */
+export function normalizeCameras(text: string | undefined): CameraMoveId[] {
+  if (text === undefined || text === '') return ['static']
+  const t = text.trim()
+  const out: CameraMoveId[] = []
+  const push = (id: CameraMoveId) => { if (!out.includes(id)) out.push(id) }
+  if (t.includes('推近') || t.includes('推进')) push('dolly_in')
+  if (t.includes('拉远') || t.includes('拉出')) push('dolly_out')
+  if (t.includes('左摇')) push('pan_left')
+  if (t.includes('右摇')) push('pan_right')
+  if (t.includes('横移')) push(t.includes('左') ? 'track_left' : 'track_right')
+  if (t.includes('跟随') || t.includes('跟拍')) push('follow')
+  if (t.includes('升降') || t.includes('升') || t.includes('降')) push('pedestal_up')
+  if (t.includes('环绕')) push('orbit')
+  if (t.includes('手持') || t.includes('晃动')) push('handheld')
+  if (t.includes('低机位') || t.includes('仰拍') || t.includes('仰')) push('low_angle')
+  if (t.includes('高机位') || t.includes('俯拍') || t.includes('俯')) push('high_angle')
+  if (t.includes('过肩')) push('over_shoulder')
+  if (out.length === 0) push('static')
+  return out
+}
+
+/** 从中文文本归一化到构图（可选）。 */
+export function normalizeComposition(text: string | undefined): CompositionId | undefined {
+  if (text === undefined || text === '') return undefined
+  const t = text.trim()
+  if (t.includes('三分')) return 'rule_of_thirds'
+  if (t.includes('中心') || t.includes('居中')) return 'center'
+  if (t.includes('引导')) return 'leading_line'
+  if (t.includes('前景')) return 'foreground'
+  if (t.includes('低机位')) return 'low'
+  if (t.includes('俯拍') || t.includes('俯视')) return 'overhead'
+  if (t.includes('对称')) return 'symmetry'
+  return undefined
+}
+
+/** 从中文文本归一化到光效列表。 */
+export function normalizeLightings(text: string | undefined): LightingId[] {
+  if (text === undefined || text === '') return ['soft']
+  const t = text.trim()
+  const out: LightingId[] = []
+  const push = (id: LightingId) => { if (!out.includes(id)) out.push(id) }
+  if (t.includes('顺光')) push('front')
+  if (t.includes('侧光') || t.includes('伦勃朗')) push(t.includes('伦勃朗') ? 'rembrandt' : 'side')
+  if (t.includes('逆光')) push('back')
+  if (t.includes('顶光')) push('top')
+  if (t.includes('霓虹')) push('neon')
+  if (t.includes('硬光')) push('hard')
+  if (t.includes('柔光')) push('soft')
+  if (t.includes('氛围') || t.includes('情绪')) push('mood')
+  if (t.includes('高反差')) push('contrast')
+  if (out.length === 0) push('soft')
+  return out
+}
+
+/** 取词条中文（ZHs 合并句子）。 */
+export function sizeZh(id: ShotSizeId | undefined): string {
+  return SHOT_SIZES.find(e => e.id === id)?.zh ?? '中景'
+}
+export function cameraZh(ids: CameraMoveId[] | undefined): string {
+  if (ids === undefined || ids.length === 0) return '固定机位'
+  return CAMERA_MOVES.filter(e => ids.includes(e.id)).map(e => e.zh).join(' + ')
+}
+export function compoZh(id: CompositionId | undefined): string {
+  return COMPOSITIONS.find(e => e.id === id)?.zh ?? ''
+}
+export function lightZh(ids: LightingId[] | undefined): string {
+  if (ids === undefined || ids.length === 0) return '柔光'
+  return LIGHTINGS.filter(e => ids.includes(e.id)).map(e => e.zh).join(' + ')
+}

package/src/story-beat-language.ts

@@ -0,0 +1,130 @@
+/**
+ * 编剧词库（剧情骨架规范化基准）。
+ * 骨架的 function（叙事功能）与 emotion（情绪走向）统一从这里取值（英文 id），
+ * 生成提示词/展示时用 zh 中文。
+ * 目的：让"叙事功能/情绪"有标准词表，避免 LLM 自由发挥导致情绪链漂移。
+ */
+
+/** 叙事功能（对应节拍在剧情中的作用）。 */
+export type StoryFunctionId =
+  | 'exposition' | 'conflict' | 'turn' | 'climax'
+  | 'resolve' | 'foreshadow' | 'character'
+
+/** 情绪词（低→高能量的情绪阶，角色在节拍中的主要情绪点）。 */
+export type EmotionId =
+  // 起：低能量
+  | 'calm' | 'indifferent' | 'expectant' | 'curious' | 'alert'
+  // 承：蓄势
+  | 'suppressed' | 'enduring' | 'worried' | 'irritable' | 'uneasy'
+  // 转：激化
+  | 'terrified' | 'angry' | 'collapsing' | 'resolute' | 'grieved'
+  // 合：落点
+  | 'relieved' | 'bittersweet' | 'triumphant' | 'reborn' | 'numb'
+
+export interface BeatLangEntry<T extends string> {
+  id: T
+  /** 中文（展示用）。 */
+  zh: string
+  /** 英文（英文平台适配用）。 */
+  en: string
+  /** 一句话说明。 */
+  hint: string
+}
+
+/** 叙事功能词表。 */
+export const STORY_FUNCTIONS: readonly BeatLangEntry<StoryFunctionId>[] = [
+  { id: 'exposition', zh: '铺垫', en: 'exposition', hint: '介绍背景/人物/悬念' },
+  { id: 'conflict', zh: '冲突', en: 'conflict', hint: '矛盾显现/加剧' },
+  { id: 'turn', zh: '转折', en: 'turning point', hint: '剧情反转/方向改变' },
+  { id: 'climax', zh: '高潮', en: 'climax', hint: '冲突顶峰/揭示' },
+  { id: 'resolve', zh: '收束', en: 'resolution', hint: '矛盾化解/结果' },
+  { id: 'foreshadow', zh: '伏笔', en: 'foreshadowing', hint: '埋下后续线索' },
+  { id: 'character', zh: '人物塑造', en: 'characterization', hint: '展现人物特质/转变' },
+]
+
+/** 情绪词表（按能量/阶段排序）。 */
+export const EMOTIONS: readonly BeatLangEntry<EmotionId>[] = [
+  // 起：低能量
+  { id: 'calm', zh: '平静', en: 'calm', hint: '无波澜' },
+  { id: 'indifferent', zh: '淡然', en: 'indifferent', hint: '不在乎' },
+  { id: 'expectant', zh: '期待', en: 'expectant', hint: '有所期盼' },
+  { id: 'curious', zh: '好奇', en: 'curious', hint: '想要探究' },
+  { id: 'alert', zh: '警觉', en: 'alert', hint: '察觉到异样' },
+  // 承：蓄势
+  { id: 'suppressed', zh: '压抑', en: 'suppressed', hint: '情绪被压制' },
+  { id: 'enduring', zh: '隐忍', en: 'enduring', hint: '强忍着' },
+  { id: 'worried', zh: '担忧', en: 'worried', hint: '担心后果' },
+  { id: 'irritable', zh: '焦躁', en: 'irritable', hint: '烦躁不耐' },
+  { id: 'uneasy', zh: '不安', en: 'uneasy', hint: '心里没底' },
+  // 转：激化
+  { id: 'terrified', zh: '惊惧', en: 'terrified', hint: '极度恐惧' },
+  { id: 'angry', zh: '愤怒', en: 'angry', hint: '强烈不满' },
+  { id: 'collapsing', zh: '崩溃', en: 'collapsing', hint: '情绪失控' },
+  { id: 'resolute', zh: '决绝', en: 'resolute', hint: '下定狠心' },
+  { id: 'grieved', zh: '痛心', en: 'grieved', hint: '悲伤心痛' },
+  // 合：落点
+  { id: 'relieved', zh: '释然', en: 'relieved', hint: '放下包袱' },
+  { id: 'bittersweet', zh: '悲凉', en: 'bittersweet', hint: '苦涩无奈' },
+  { id: 'triumphant', zh: '得意', en: 'triumphant', hint: '占据上风' },
+  { id: 'reborn', zh: '重生', en: 'reborn', hint: '脱胎换骨' },
+  { id: 'numb', zh: '麻木', en: 'numb', hint: '失去感知' },
+]
+
+export interface StoryBeatLanguage {
+  function: StoryFunctionId
+  emotion: EmotionId[]
+}
+
+/** 从中文归一化叙事功能（未知回退 exposition）。 */
+export function normalizeStoryFunction(text: string | undefined): StoryFunctionId {
+  if (text === undefined || text === '') return 'exposition'
+  const t = text.trim()
+  if (t.includes('铺垫')) return 'exposition'
+  if (t.includes('冲突')) return 'conflict'
+  if (t.includes('转折')) return 'turn'
+  if (t.includes('高潮')) return 'climax'
+  if (t.includes('收束')) return 'resolve'
+  if (t.includes('伏笔')) return 'foreshadow'
+  if (t.includes('人物塑造')) return 'character'
+  return 'exposition'
+}
+
+/** 从中文文本归一化情绪词列表（可含→箭头链）。 */
+export function normalizeEmotions(text: string | undefined): EmotionId[] {
+  if (text === undefined || text === '') return ['calm']
+  const t = text.trim()
+  const out: EmotionId[] = []
+  const push = (id: EmotionId) => { if (!out.includes(id)) out.push(id) }
+  if (t.includes('平静')) push('calm')
+  if (t.includes('淡然')) push('indifferent')
+  if (t.includes('期待')) push('expectant')
+  if (t.includes('好奇')) push('curious')
+  if (t.includes('警觉')) push('alert')
+  if (t.includes('压抑')) push('suppressed')
+  if (t.includes('隐忍')) push('enduring')
+  if (t.includes('担忧')) push('worried')
+  if (t.includes('焦躁')) push('irritable')
+  if (t.includes('不安')) push('uneasy')
+  if (t.includes('惊惧')) push('terrified')
+  if (t.includes('愤怒')) push('angry')
+  if (t.includes('崩溃')) push('collapsing')
+  if (t.includes('决绝')) push('resolute')
+  if (t.includes('痛心')) push('grieved')
+  if (t.includes('释然')) push('relieved')
+  if (t.includes('悲凉')) push('bittersweet')
+  if (t.includes('得意')) push('triumphant')
+  if (t.includes('重生')) push('reborn')
+  if (t.includes('麻木')) push('numb')
+  if (out.length === 0) push('calm')
+  return out
+}
+
+/** 叙事功能中文。 */
+export function functionZh(id: StoryFunctionId | undefined): string {
+  return STORY_FUNCTIONS.find(e => e.id === id)?.zh ?? '铺垫'
+}
+/** 情绪中文（箭头连接）。 */
+export function emotionZh(ids: EmotionId[] | undefined): string {
+  if (ids === undefined || ids.length === 0) return '平静'
+  return EMOTIONS.filter(e => ids.includes(e.id)).map(e => e.zh).join('→')
+}

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

@@ -1,15 +0,0 @@
-import type { NovelApi } from '../api.ts';
-import type { ImageModelConfig, ProjectState } from '../../protocol.ts';
-export declare function RoleVisualPanel({ api, project, refresh, styleId, filterId, imageApiEnabled, imageModels, onGotoRoles, onProgress, }: {
-    api: NovelApi;
-    project: ProjectState | null;
-    refresh: () => void | Promise<void>;
-    styleId?: string;
-    filterId?: string;
-    imageApiEnabled?: boolean;
-    /** 生图模型库（AI 生图时可选择用哪条）。 */
-    imageModels?: ImageModelConfig[];
-    onGotoRoles?: () => void;
-    /** 上报到「AI进度」控制台（角色形象页 / 漫剧工作台共用）。 */
-    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
-}): import("react").JSX.Element;