@waterwx/dsh-novel-forge 2.0.0-alpha.1 → 2.0.0

package/src/comic-presets.ts

@@ -1,67 +0,0 @@
-/** 漫画风格预设：每个预设对应一组出图提示词与排版偏好。 */
-
-export interface ComicStylePreset {
-  id: string
-  label: string
-  /** 注入 imagePrompt 的风格描述词。 */
-  prompt: string
-  /** 可选：排版偏好说明。 */
-  layoutHint?: string
-}
-
-export const COMIC_STYLE_PRESETS: ComicStylePreset[] = [
-  {
-    id: 'japan',
-    label: '日漫 / 黑白',
-    prompt: 'manga style, screentone, bold ink lines, high contrast, black and white, cel shading',
-    layoutHint: '页漫优先',
-  },
-  {
-    id: 'korea',
-    label: '韩漫 / 条漫',
-    prompt: 'manhwa style, soft cel shading, vibrant colors, clean lineart, webtoon vertical composition, glossy highlights',
-    layoutHint: '条漫优先',
-  },
-  {
-    id: 'china',
-    label: '国漫 / 古风',
-    prompt: 'chinese ink painting style, flowing brush strokes, traditional palette, ethereal atmosphere, xianxia aesthetic',
-    layoutHint: '页漫/条漫均可',
-  },
-  {
-    id: 'america',
-    label: '美漫 / 超级英雄',
-    prompt: 'american comic style, bold outlines, dramatic lighting, dynamic poses, vibrant colors, halftone shading',
-    layoutHint: '页漫优先',
-  },
-  {
-    id: 'chibi',
-    label: 'Q版 / 搞笑',
-    prompt: 'chibi style, cute proportions, big head, exaggerated expressions, simple background, bright colors',
-    layoutHint: '条漫/四格优先',
-  },
-  {
-    id: 'realistic',
-    label: '写实 / 电影感',
-    prompt: 'realistic cinematic style, detailed textures, natural lighting, film grain, high detail',
-    layoutHint: '页漫/全彩',
-  },
-  {
-    id: 'cyber',
-    label: '赛博 / 暗黑',
-    prompt: 'cyberpunk style, neon lights, dark atmosphere, high contrast, futuristic city, cool tones',
-    layoutHint: '页漫/全彩',
-  },
-]
-
-export function getComicStylePrompt(styleId?: string): string {
-  if (!styleId) return ''
-  const preset = COMIC_STYLE_PRESETS.find(s => s.id === styleId)
-  return preset?.prompt ?? ''
-}
-
-export function getComicStyleLabel(styleId?: string): string {
-  if (!styleId) return ''
-  const preset = COMIC_STYLE_PRESETS.find(s => s.id === styleId)
-  return preset?.label ?? styleId
-}

package/src/manga-genre-rules.ts

@@ -1,87 +0,0 @@
-/**
- * 题材规则库（可插拔）—— 漫剧分镜/提示词生成的「题材专用规则」。
- * 参考短剧工业导演规范：不同题材用不同的视觉语言 / 打斗 / 特效规则，
- * 按漫剧方案的 genre 注入 generateStoryboardPrompts，避免「一套模板跑所有题材」。
- * 每个题材给一组「生成提示词时必须遵守的题材规则」；未选题材则不注入（走通用规则）。
- */
-
-export interface GenreRule {
-  /** 题材 id。 */
-  id: string
-  /** 题材名（展示）。 */
-  label: string
-  /** 该题材的生成提示词核心规则（每行一条，注入生成时）。 */
-  rules: string[]
-}
-
-/** 内置题材（通用题材 default 为空规则）。 */
-export const GENRES: GenreRule[] = [
-  {
-    id: 'xuanhuan',
-    label: '玄幻 / 仙侠',
-    rules: [
-      '施法必须经法宝媒介（笛/扇/印/笔等实体法宝），写清法宝本体材质+施法动作+特效出口，禁止只写"施法"。',
-      '每个角色绑定主属性+双色粒子（雷=蓝白+紫电、冰=冰蓝+银白、金=亮金+暖白、火=赤红+暗金、木=粉白+草木青），属性决定术法形态与配色。',
-      '术法攻防走"罡气→破罡→防御转攻"：护体罡气被划开、防御术法炸裂化千万飞刃/剑气，防守转攻是高光点，必写。',
-      '能量具象化：光柱/雷龙/法相/领域；"光柱"要写成"洪流/弧光/波纹/光丝雨"（禁裸光柱，防呆板发光管）。',
-      '终招蓄力必写：天地灵韵向角色/法宝汇聚、能量漩涡成型，再接幂击。',
-      '对军清场：扇形冲击波/剑气暴雨洗地/能量扇镇压大军核心，战场弹坑/碎片/云层撕开反馈。',
-    ],
-  },
-  {
-    id: 'wuxia',
-    label: '武侠 / 国风',
-    rules: [
-      '打斗用 Hit-Stop 三件套：碰撞瞬间 1~2 帧微停顿 + 接触点火花 + 双刃咬死高频震颤，杜绝滑步/空气假打。',
-      '武术动作链：起手/攻防/收势，标明具体招式（刀/剑/轻功/擒拿），剑走轻灵、刀走厚重。',
-      '镜头强化打击感：碰撞点微环绕、贴身横移、命中定格，禁静止对峙。',
-      '轻功/身法：衣袂翻飞、发丝飘动、残影，身形轻盈不僵硬。',
-    ],
-  },
-  {
-    id: 'anime',
-    label: '二次元 / 动漫',
-    rules: [
-      '大招三段式：蓄力→释放→爆发，能量形态+爆发特效，段段画质声明复用。',
-      '双色粒子：每角色一套主色+材质+轨迹，双方互补对冲（冷 vs 暖），防混战混淆。',
-      '色指定：明确主色调+高光色+特效撞色，防发灰。',
-      '禁止评价词/裸光效/空泛"粒子"；能量写"光丝雨/弧光/波纹"+方向+材质。',
-    ],
-  },
-  {
-    id: 'urban',
-    label: '都市 / 现实',
-    rules: [
-      '微表情生理递进：眼神/眉心/唇部/鼻翼/喉头/手指，情绪逐层推进，不夸张不脸谱。',
-      '对白语速 3.5~5 字/秒（台词从声音层按此把控，留 0.3~0.8s 落口发酵）。',
-      '防棚拍假冷光：用真实光线（自然光/路灯/窗光/霓虹），日景不陰间冷蓝、局部留暖光。',
-      '场景真实还原（街头/室内/医院等），人物服装生活化，肢体动作自然不律動化。',
-    ],
-  },
-  {
-    id: 'scifi',
-    label: '科幻 / 未来',
-    rules: [
-      '机甲/能量武器设定明确（颜色/材质/发光部位），能量轨迹具体。',
-      '霓虹/屏幕光/激光防眩光，用冷色主调+重点发光处。',
-      '宏大场景（飞船/城市/废墟）用大远景/俯拍，人物相对渺小。',
-    ],
-  },
-]
-
-/** 通用题材（空规则，走通用生成）。 */
-export const DEFAULT_GENRE: GenreRule = { id: 'default', label: '通用（不限定）', rules: [] }
-
-/** 按题材 id 取规则（未找到返回通用）。 */
-export function getGenreRules(id?: string): string[] {
-  if (id === undefined || id === '') return DEFAULT_GENRE.rules
-  const g = GENRES.find(x => x.id === id)
-  return g !== undefined ? g.rules : DEFAULT_GENRE.rules
-}
-
-/** 取题材 label（展示用）。 */
-export function getGenreLabel(id?: string): string {
-  if (id === undefined || id === '') return DEFAULT_GENRE.label
-  const g = GENRES.find(x => x.id === id)
-  return g !== undefined ? g.label : id
-}

package/src/prompt-utils.ts

@@ -1,73 +0,0 @@
-/**
- * 提示词共享常量与工具
- *
- * 所有 JSON 输出规则、通用约束集中在此，避免各阶段重复定义、互相打架。
- */
-
-/** JSON 输出规则（所有要求模型输出 JSON 的地方共用） */
-export const JSON_OUTPUT_RULES = [
-  '输出必须是合法 JSON 对象或数组，不要输出任何其他文字、解释、Markdown 标记或代码块。',
-  '所有字符串值内部不得包含换行符（用 \\n 转义），JSON 必须在一段内完整结束。',
-  '直接输出 JSON 结果本身，不要把思考过程写在输出里。',
-  '数值字段必须是数字类型，不要用字符串包裹。',
-  '数组为空时输出 []，对象为空时输出 {}。',
-]
-
-/** JSON 输出规则的紧凑版（适合放在提示词末尾） */
-export const JSON_OUTPUT_RULES_COMPACT = JSON_OUTPUT_RULES.join(' ')
-
-/**
- * 估算 prompt 的 token 数（粗略估算，用于上下文预算控制）
- * 中文约 1.7 字/token，英文约 4 字符/token
- */
-export function estimateTokens(text: string): number {
-  if (text.length === 0) return 0
-  // 统计中文字符数
-  const chineseChars = (text.match(/[\u4e00-\u9fff]/g) ?? []).length
-  const otherChars = text.length - chineseChars
-  return Math.round(chineseChars / 1.7 + otherChars / 4)
-}
-
-/**
- * 按 token 预算截断文本（保留开头，末尾加省略标记）
- * 用于控制单块上下文不超预算。
- */
-export function truncateByTokens(text: string, maxTokens: number, marker = '…（已截断）'): string {
-  if (estimateTokens(text) <= maxTokens) return text
-  // 二分查找最大可保留长度
-  let lo = 0
-  let hi = text.length
-  while (lo < hi) {
-    const mid = Math.floor((lo + hi + 1) / 2)
-    if (estimateTokens(text.slice(0, mid)) <= maxTokens - estimateTokens(marker)) {
-      lo = mid
-    } else {
-      hi = mid - 1
-    }
-  }
-  return text.slice(0, lo) + marker
-}
-
-/** 通用「只改表达不改情节」约束（润色/局部修订共用） */
-export const EXPRESSION_ONLY_RULE = [
-  '只改表达，不改情节走向、人物设定、已确立事实、对话核心内容。',
-  '保留角色口吻与性格，角色行为需符合角色卡。',
-  '必须遵守内容合规红线与本书红线，任何一条命中（含影射、暗示）都必须避免。',
-  '避免 AI 套话：不禁、仿佛、一时间、不由得、顿时、然而、缓缓、轻轻、微微、默默、似乎、终于等滥用。',
-]
-
-/** 章节上下文各阶段的 token 预算（粗略，用于控制注入量） */
-export const CONTEXT_BUDGET = {
-  /** 章节生成：道藏+角色+大纲+事实+伏笔 */
-  writing: 12000,
-  /** AI 审稿：道藏+角色+事实+正文 */
-  review: 10000,
-  /** 修订：原意见+相关事实+目标正文 */
-  revise: 8000,
-  /** 润色：风格资产+原正文 */
-  polish: 6000,
-  /** 分章规划：大纲+道藏+角色+近期事实 */
-  plan: 15000,
-} as const
-
-export type ContextStage = keyof typeof CONTEXT_BUDGET

package/src/review-policy.ts

@@ -1,161 +0,0 @@
-/**
- * 审稿规则注册表
- *
- * 生成用 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 const REVIEW_DIMENSIONS = [
-  { id: 'character', name: '人设一致性', weight: 0.2 },
-  { id: 'setting', name: '设定一致性', weight: 0.15 },
-  { id: 'redline', name: '红线检查', weight: 0.15 },
-  { id: 'writing', name: '文笔质量', weight: 0.15 },
-  { id: 'pacing', name: '节奏与爽点', weight: 0.1 },
-  { id: 'logic', name: '逻辑漏洞', weight: 0.1 },
-  { id: 'anti-ai', name: '反 AI 规则', weight: 0.05 },
-  { id: 'presentation', name: '呈现方式', weight: 0.05 },
-  { id: 'compliance', name: '内容合规', weight: 0.05 },
-] as const
-
-export type ReviewDimensionId = typeof REVIEW_DIMENSIONS[number]['id']
-
-/** 维度结构化评分 */
-export interface DimensionScore {
-  dimension: ReviewDimensionId
-  score: number // 0-100
-  note: string
-}
-
-/**
- * 渲染审稿规则（compact 或 full 模式）
- *
- * compact: 只渲染禁止类 + high 严重度（用于生成时的约束）
- * full: 渲染全部启用规则（用于审稿时的检查清单）
- */
-export function renderReviewRules(
-  assets: WritingRule[] | undefined,
-  mode: 'compact' | 'full' = 'full',
-): string {
-  const lines: string[] = []
-
-  // 内置核心规则（所有模式都注入）
-  const coreRules = [
-    { dimension: 'character', desc: '角色行为符合角色卡设定（性格/目标/知情度/说话方式）' },
-    { dimension: 'setting', desc: '金手指规则、战力体系、世界观与道藏一致' },
-    { dimension: 'redline', desc: '不触犯本书写作红线' },
-    { dimension: 'compliance', desc: '不触犯内容合规红线（最高优先级）' },
-    { dimension: 'logic', desc: '无前后矛盾、时间线错误、对话失真' },
-    { dimension: 'presentation', desc: '不纯内心推理铺陈；反派有行动力；重要配角有辨识度' },
-  ]
-
-  if (mode === 'compact') {
-    lines.push('写作约束（核心规则）：')
-    for (const r of coreRules) {
-      lines.push(`- ${r.desc}`)
-    }
-  } else {
-    lines.push('审稿维度（逐条审查）：')
-    REVIEW_DIMENSIONS.forEach((d, i) => {
-      const core = coreRules.find(c => c.dimension === d.id)
-      lines.push(`${i + 1}. ${d.name}：${core?.desc ?? '按维度标准审查'}`)
-    })
-    lines.push('')
-    lines.push('反 AI 规则：逐条核对下方资产规则，命中即列为问题。')
-    lines.push('呈现方式：整章是否纯内心推理铺陈（无对话/无对抗）；反派是否纯背景板；重要配角是否无名标签化——命中即列为问题。')
-    lines.push('内容合规（最高优先级）：逐条核对合规红线，任何一条命中（含影射、暗示、详细描写）必须列为 high。')
-  }
-
-  // 注入用户自定义资产规则
-  if (assets !== undefined && assets.length > 0) {
-    const forbidden = assets.filter(a => a.type === 'forbidden' || a.type === 'rule')
-    const encourage = assets.filter(a => a.type === 'encourage' || a.type === 'style')
-    if (forbidden.length > 0) {
-      lines.push('')
-      lines.push('禁止类规则（命中即问题）：')
-      for (const a of forbidden) {
-        lines.push(`- ${a.name}：${a.description}`)
-      }
-    }
-    if (encourage.length > 0 && mode === 'full') {
-      lines.push('')
-      lines.push('鼓励类规则（不命中不算错，作为低优先级建议）：')
-      for (const a of encourage) {
-        lines.push(`- ${a.name}：${a.description}`)
-      }
-    }
-  }
-
-  return lines.join('\n')
-}
-
-/**
- * 从审稿 issues 中按维度统计
- * 用于结构化评分和 UI 展示。
- */
-export function groupIssuesByDimension(
-  issues: Array<{ severity: string; item: string; dimension?: string }>,
-): Record<string, Array<{ severity: string; item: string }>> {
-  const result: Record<string, Array<{ severity: string; item: string }>> = {}
-  for (const issue of issues) {
-    const dim = issue.dimension ?? inferDimension(issue.item)
-    if (result[dim] === undefined) result[dim] = []
-    result[dim]!.push({ severity: issue.severity, item: issue.item })
-  }
-  return result
-}
-
-/** 根据问题描述推断维度（兼容旧报告，没有 dimension 字段时用） */
-function inferDimension(item: string): ReviewDimensionId {
-  if (/人设|角色|性格|口吻|知情|OOC/.test(item)) return 'character'
-  if (/设定|世界观|战力|金手指|规则|道藏/.test(item)) return 'setting'
-  if (/红线|后宫|擦边|碾压|圣母/.test(item)) return 'redline'
-  if (/语病|翻译腔|套话|文笔|流水账|AI/.test(item)) return 'writing'
-  if (/节奏|拖沓|灌水|爽点|钩子|悬念/.test(item)) return 'pacing'
-  if (/矛盾|时间线|逻辑|对话失真/.test(item)) return 'logic'
-  if (/合规|敏感|色情|暴力|政治|未成年/.test(item)) return 'compliance'
-  if (/内心推理|背景板|标签化|瘦高个|灰衣人/.test(item)) return 'presentation'
-  return 'writing'
-}
-
-/**
- * 计算维度加权总分
- * 用于审稿报告的结构化评分。
- */
-export function calculateWeightedScore(
-  dimensions: DimensionScore[],
-): number {
-  let total = 0
-  let weightSum = 0
-  for (const d of dimensions) {
-    const def = REVIEW_DIMENSIONS.find(x => x.id === d.dimension)
-    const weight = def?.weight ?? 0.1
-    total += d.score * weight
-    weightSum += weight
-  }
-  return weightSum > 0 ? Math.round(total / weightSum) : 60
-}

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(' + ')
-}