@waterwx/dsh-novel-forge 2.1.2-alpha → 2.1.3

package/src/run.ts

@@ -1,338 +0,0 @@
-/**
- * 生产单（Production Run）：批量章节生产的标准执行器。
- * 职责：计划补足 → 逐章生成（完整质量门）→ 被拒分级处理（豁免/修订+验证/待人工）→ 断点续跑。
- * 与路由层解耦：只依赖 engine 导出函数与磁盘状态，自身不碰 HTTP。
- * 串行纪律：单例执行器 + working 锁；每章重新从磁盘加载，写前合并易变字段。
- */
-import { existsSync, mkdirSync, readFileSync, copyFileSync, writeFileSync } from 'node:fs'
-import { join } from 'node:path'
-import type { Context } from '@deepseek-ai/cordis'
-import type { ChapterPlan, NovelConfig, ProjectState, ReviewReport, RunState } from './protocol.ts'
-import {
-  loadProject,
-  saveProject,
-  mergeVolatileFromDisk,
-  planChapters,
-  generateChapterStream,
-  summarizeAndExtractFacts,
-  markForeshadowPlanted,
-  reviewChapter,
-  reviewChapterText,
-  authorReviewChapter,
-  autoLinkPlotlines,
-  readChapterFile,
-  rewriteChapterStream,
-  chapterFileName,
-} from './engine.ts'
-import { loadBookshelf } from './bookshelf.ts'
-
-/** 生产单 checkpoint 文件名（放在书目录下）。 */
-function runStateFile(outputDir: string): string {
-  return join(outputDir, 'run-state.json')
-}
-
-export class ProductionRunner {
-  private state: RunState | null = null
-  private working = false
-  private pauseRequested = false
-  private stopRequested = false
-  /** 生产单绑定目录（start 时快照；所有读写固定用它，防止运行中切书导致写错目录）。 */
-  private bookDir: string | null = null
-
-  constructor(private deps: { ctx: Context; getConfig: () => NovelConfig }) {}
-
-  /** 当前生产单状态（内存优先；web 重启后从磁盘恢复）。 */
-  status(): RunState | null {
-    if (this.state !== null) return this.state
-    // 重启恢复：先找当前激活书目录，再扫书架所有书目录（防切书后找不到）。
-    const candidates: string[] = [this.deps.getConfig().outputDir]
-    const bookshelf = loadBookshelf()
-    for (const b of bookshelf.books) if (!candidates.includes(b.outputDir)) candidates.push(b.outputDir)
-    for (const outputDir of candidates) {
-      const file = runStateFile(outputDir)
-      if (!existsSync(file)) continue
-      try {
-        const raw = readFileSync(file, 'utf8')
-        const parsed = JSON.parse(raw) as RunState
-        if (parsed?.runId === undefined) continue
-        // 重启恢复：若之前 running，则视为可续跑（loop 未在跑）。
-        if (parsed.status === 'running') parsed.status = 'paused'
-        this.state = parsed
-        this.bookDir = outputDir
-        return this.state
-      } catch { /* 该目录 run-state 损坏则跳过 */ }
-    }
-    return null
-  }
-
-  private persist(): void {
-    if (this.state === null) return
-    const outputDir = this.bookDir ?? this.deps.getConfig().outputDir
-    mkdirSync(outputDir, { recursive: true })
-    writeFileSync(runStateFile(outputDir), JSON.stringify(this.state, null, 2), 'utf8')
-  }
-
-  private log(text: string): void {
-    if (this.state === null) return
-    this.state.log.push({ at: new Date().toISOString(), text })
-    if (this.state.log.length > 300) this.state.log = this.state.log.slice(-300)
-    this.state.updatedAt = new Date().toISOString()
-  }
-
-  /** 启动/续跑生产单：startNo..endNo 区间，endNo 超出计划时先自动补计划。 */
-  async start(startNo: number, endNo: number, runDir?: string): Promise<RunState> {
-    const config = this.deps.getConfig()
-    if (this.working) throw new Error('生产单正在运行中，请先暂停或停止')
-    const outputDir = runDir ?? config.outputDir
-    let project = loadProject(outputDir)
-    if (project === undefined) throw new Error('输出目录中没有项目')
-
-    // 计划补足：目标区间超出已有计划 → 续写规划追加。
-    if (endNo > project.chapters.length) {
-      const need = endNo - project.chapters.length
-      this.log(`计划不足，追加 ${need} 章计划…`)
-      const chapters = await planChapters(this.deps.ctx, config, project, need, undefined, outputDir)
-      mergeVolatileFromDisk(outputDir, project)
-      project.chapters.push(...chapters)
-      project.updatedAt = new Date().toISOString()
-      saveProject(outputDir, project)
-      this.log(`计划已追加，全书 ${project.chapters.length} 章`)
-    }
-
-    this.state = {
-      runId: `run-${Date.now().toString(36)}`,
-      startNo,
-      endNo,
-      status: 'running',
-      currentNo: startNo,
-      stats: { generated: 0, revised: 0, exempted: 0, regenerated: 0, error: 0 },
-      pendingManual: [],
-      log: [],
-      startedAt: new Date().toISOString(),
-      updatedAt: new Date().toISOString(),
-    }
-    this.pauseRequested = false
-    this.stopRequested = false
-    // 绑定生产单目录（快照）：运行期间切书不影响本单的读写目标。
-    this.bookDir = outputDir
-    this.working = true
-    this.persist()
-    void this.loop()
-    return this.state
-  }
-
-  pause(): void { this.pauseRequested = true }
-  resume(): void {
-    if (this.state === null || this.state.status !== 'paused') return
-    this.state.status = 'running'
-    this.working = true
-    this.pauseRequested = false
-    this.stopRequested = false
-    this.persist()
-    void this.loop()
-  }
-  stop(): void { this.stopRequested = true }
-
-  /** 主循环：从 currentNo 扫描到 endNo，逐章处理；支持暂停/停止。 */
-  private async loop(): Promise<void> {
-    // 全部读写固定使用生产单绑定目录（bookDir），绝不跟随当前激活书。
-    const config = this.deps.getConfig()
-    const outputDir = this.bookDir ?? config.outputDir
-    try {
-      while (this.state !== null) {
-        if (this.stopRequested) {
-          this.stopRequested = false
-          this.state.status = 'stopped'
-          this.log('生产单已停止')
-          this.persist()
-          break
-        }
-        if (this.pauseRequested) {
-          this.pauseRequested = false
-          this.state.status = 'paused'
-          this.log('生产单已暂停（随时可继续）')
-          this.persist()
-          break
-        }
-        const project = loadProject(outputDir)
-        if (project === undefined) {
-          this.state.status = 'error'
-          this.state.error = '项目丢失'
-          this.persist()
-          break
-        }
-        // 找下一个需要处理的章（approved 快进）。
-        let next: ChapterPlan | undefined
-        for (let no = this.state.currentNo; no <= this.state.endNo; no++) {
-          const ch = project.chapters.find(c => c.no === no)
-          if (ch === undefined) continue
-          if (ch.status === 'approved') { this.state.currentNo = no; continue }
-          next = ch
-          break
-        }
-        if (next === undefined) {
-          this.state.status = 'done'
-          this.log(`生产单完成：${this.state.startNo}-${this.state.endNo} 章处理完毕`)
-          this.persist()
-          break
-        }
-        this.state.currentNo = next.no
-        await this.processChapter(project, next)
-        this.persist()
-      }
-    } catch (error) {
-      if (this.state !== null) {
-        this.state.status = 'error'
-        this.state.error = (error as Error).message
-        this.log(`生产单异常：${(error as Error).message}`)
-        this.persist()
-      }
-    } finally {
-      this.working = false
-    }
-  }
-
-  private async processChapter(project: ProjectState, chapter: ChapterPlan): Promise<void> {
-    if (chapter.status === 'pending' || chapter.status === 'error' || chapter.status === 'written') {
-      await this.produce(project, chapter)
-    } else if (chapter.status === 'rejected') {
-      await this.handleRejected(project, chapter)
-    } else if (chapter.status === 'generating') {
-      // 中断残留：复位重生成。
-      chapter.status = 'pending'
-      await this.produce(project, chapter)
-    }
-  }
-
-  /** 完整质量门：生成 → 摘要+事实 → 伏笔标记 → 审稿 → 作者复盘。 */
-  private async produce(project: ProjectState, chapter: ChapterPlan): Promise<void> {
-    const { ctx, getConfig } = this.deps
-    const config = getConfig()
-    const outputDir = this.bookDir ?? config.outputDir
-    const no = chapter.no
-    const wasError = chapter.status === 'error'
-    chapter.status = 'generating'
-    chapter.error = undefined
-    chapter.generatingAt = new Date().toISOString()
-    mergeVolatileFromDisk(outputDir, project)
-    saveProject(outputDir, project)
-    this.log(`${wasError ? '重新生成' : '生成'} 第${no}章《${chapter.title}》…（模型 ${config.generateModel || config.model}）`)
-    try {
-      for await (const step of generateChapterStream(ctx, config, project, outputDir, no)) { /* drain */ }
-      try { await summarizeAndExtractFacts(ctx, config, project, outputDir, no) } catch (e) { console.warn('[dsh-novel-forge] run summary/facts:', (e as Error).message) }
-      try { markForeshadowPlanted(project, outputDir, no) } catch (e) { console.warn('[dsh-novel-forge] run foreshadow:', (e as Error).message) }
-      if (config.autoReview ?? true) {
-        const report = await reviewChapter(ctx, config, project, outputDir, no)
-        if (this.state !== null) this.state.stats[wasError ? 'regenerated' : 'generated']++
-        this.log(`第${no}章 审稿 ${report.score}分 ${report.passed ? '✅ 通过' : '⚠️ 被拒'}（模型 ${config.reviewModel || config.model}）`)
-      } else {
-        chapter.status = 'approved'
-        mergeVolatileFromDisk(outputDir, project)
-        saveProject(outputDir, project)
-      }
-      if (config.autoAuthorReview ?? true) {
-        try {
-          const body = readChapterFile(outputDir, chapter)
-          if (body !== undefined) {
-            let prevTail = ''
-            if (no > 1) {
-              const prev = project.chapters.find(c => c.no === no - 1)
-              if (prev !== undefined) prevTail = (readChapterFile(outputDir, prev) ?? '').replace(/^#.*$/m, '').trim().slice(-600)
-            }
-            const review = await authorReviewChapter(ctx, config, project, no, body, prevTail)
-            chapter.authorReview = review
-            if (review.advancedLines !== undefined) autoLinkPlotlines(project, no, review.advancedLines)
-            // 结果回灌：把本章状态变化/新线索写进编年录事实库，供后续计划与整本控制用。
-            const backfillFacts: string[] = [...(review.stateChanges ?? []), ...(review.clues ?? [])]
-            if (backfillFacts.length > 0) {
-              project.facts ??= []
-              for (const text of backfillFacts) project.facts.push({ chapterNo: no, text })
-            }
-            mergeVolatileFromDisk(outputDir, project)
-            saveProject(outputDir, project)
-          }
-        } catch (e) { console.warn('[dsh-novel-forge] run author review:', (e as Error).message) }
-      }
-    } catch (error) {
-      chapter.status = 'error'
-      chapter.error = (error as Error).message
-      mergeVolatileFromDisk(outputDir, project)
-      saveProject(outputDir, project)
-      if (this.state !== null) this.state.stats.error++
-      this.log(`第${no}章 失败：${(error as Error).message}`)
-    }
-  }
-
-  /** 被拒分级处理：无 high 豁免；有 high 按意见修订（最多 2 轮）+ 验证模式；仍不过 → 待人工。 */
-  private async handleRejected(project: ProjectState, chapter: ChapterPlan): Promise<void> {
-    const { ctx, getConfig } = this.deps
-    const config = getConfig()
-    const outputDir = this.bookDir ?? config.outputDir
-    const no = chapter.no
-    const report = chapter.review
-    const highs = (report?.issues ?? []).filter(i => i.severity === 'high')
-    if (highs.length === 0) {
-      chapter.status = 'approved'
-      project.updatedAt = new Date().toISOString()
-      saveProject(outputDir, project)
-      if (this.state !== null) this.state.stats.exempted++
-      this.log(`第${no}章 豁免通过（无 high）`)
-      return
-    }
-    this.log(`第${no}章 修订（${highs.length} 个 high）…`)
-    for (let round = 1; round <= 2; round++) {
-      const instr = '按审稿意见修订（优先处理）：\n' + highs.map(h => `[${h.severity}] ${h.item}${h.suggestion !== '' ? `\n建议：${h.suggestion}` : ''}`).join('\n\n')
-      try {
-        for await (const step of rewriteChapterStream(ctx, config, project, outputDir, no, instr, undefined)) { /* drain */ }
-      } catch (error) {
-        this.log(`第${no}章 第${round}轮修订出错：${(error as Error).message}`)
-        continue
-      }
-      // rewrite 已写盘（pendingDraft + saveProject），重载拿最新草稿。
-      const fresh = loadProject(outputDir)
-      const freshCh = fresh?.chapters.find(c => c.no === no)
-      const draft = freshCh?.pendingDraft
-      if (draft === undefined || draft.length < 50) {
-        this.log(`第${no}章 第${round}轮草稿缺失，重试`)
-        continue
-      }
-      const verify = await reviewChapterText(ctx, config, fresh!, draft, chapter.review)
-      const highs2 = (verify.issues ?? []).filter(i => i.severity === 'high')
-      if (verify.passed || highs2.length === 0) {
-        // 应用草稿（与 draft/apply 路由同逻辑）：备份原稿 → 落盘 → 定状态。
-        this.applyDraft(fresh!, freshCh!, draft, verify)
-        if (this.state !== null) this.state.stats.revised++
-        this.log(`第${no}章 第${round}轮修订通过（${verify.score}分）`)
-        return
-      }
-      this.log(`第${no}章 第${round}轮仍不过（${highs2.length} high）`)
-    }
-    if (this.state !== null) this.state.pendingManual.push(no)
-    this.log(`第${no}章 ⚠️ 两轮修订仍不过 → 保留草稿待人工`)
-  }
-
-  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(outputDir, { recursive: true })
-    const targetPath = join(outputDir, fileName)
-    if (existsSync(targetPath)) {
-      copyFileSync(targetPath, join(outputDir, `${fileName.replace(/\.md$/, '')}.bak.md`))
-    }
-    writeFileSync(targetPath, `# 第${chapter.no}章 ${chapter.title}\n\n${draft}\n`, 'utf8')
-    chapter.pendingDraft = undefined
-    chapter.chars = draft.length
-    chapter.file = fileName
-    if (typeof report.score === 'number') {
-      chapter.review = report
-      chapter.status = report.passed === true ? 'approved' : 'rejected'
-    } else {
-      chapter.status = 'written'
-      chapter.review = undefined
-    }
-    chapter.error = undefined
-    project.updatedAt = new Date().toISOString()
-    saveProject(outputDir, project)
-  }
-}

package/src/shot-language.ts

@@ -1,181 +0,0 @@
-/**
- * 镜头语言词库（分镜规范化基准）。
- * 分镜表的 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

@@ -1,130 +0,0 @@
-/**
- * 编剧词库（剧情骨架规范化基准）。
- * 骨架的 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('→')
-}