@waterwx/dsh-novel-forge 1.7.2 → 1.7.3

package/lib/types/protocol.d.ts

@@ -4,6 +4,8 @@
  * 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 declare const NOVEL_API: {
     readonly status: "/api/dsh-novel-forge/status";
@@ -208,10 +210,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;
 }
@@ -239,10 +241,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;
     /** 画面内容：角色动作 + 表情 + 服装/标志物。 */
@@ -251,8 +255,8 @@ export interface StoryboardShot {
     line: string;
     /** 音效（无则空字符串）。 */
     sound: string;
-    /** 光效（如 雨夜顶光 + 手机屏幕冷光）。 */
-    light: string;
+    /** 光效（枚举 id 数组，来自 shot-language 词库）。 */
+    light: LightingId[];
     /** 承接上一镜头结尾状态（位置/动作/情绪/服装）。 */
     prevState: string;
     /** 本镜头结束状态。 */

package/lib/types/shot-language.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 镜头语言词库（分镜规范化基准）。
+ * 分镜表的 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 declare const SHOT_SIZES: readonly ShotLangEntry<ShotSizeId>[];
+export declare const CAMERA_MOVES: readonly ShotLangEntry<CameraMoveId>[];
+export declare const COMPOSITIONS: readonly ShotLangEntry<CompositionId>[];
+export declare const LIGHTINGS: readonly ShotLangEntry<LightingId>[];
+export interface ShotLanguage {
+    shot?: ShotSizeId;
+    camera: CameraMoveId[];
+    composition?: CompositionId;
+    light: LightingId[];
+}
+/** 从中文文本归一化到景别（处理旧数据/LLM 口语）。未知回退 medium。 */
+export declare function normalizeShotSize(text: string | undefined): ShotSizeId;
+/** 从中文文本归一化到运镜列表。 */
+export declare function normalizeCameras(text: string | undefined): CameraMoveId[];
+/** 从中文文本归一化到构图（可选）。 */
+export declare function normalizeComposition(text: string | undefined): CompositionId | undefined;
+/** 从中文文本归一化到光效列表。 */
+export declare function normalizeLightings(text: string | undefined): LightingId[];
+/** 取词条中文（ZHs 合并句子）。 */
+export declare function sizeZh(id: ShotSizeId | undefined): string;
+export declare function cameraZh(ids: CameraMoveId[] | undefined): string;
+export declare function compoZh(id: CompositionId | undefined): string;
+export declare function lightZh(ids: LightingId[] | undefined): string;

package/lib/types/story-beat-language.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 编剧词库（剧情骨架规范化基准）。
+ * 骨架的 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 declare const STORY_FUNCTIONS: readonly BeatLangEntry<StoryFunctionId>[];
+/** 情绪词表（按能量/阶段排序）。 */
+export declare const EMOTIONS: readonly BeatLangEntry<EmotionId>[];
+export interface StoryBeatLanguage {
+    function: StoryFunctionId;
+    emotion: EmotionId[];
+}
+/** 从中文归一化叙事功能（未知回退 exposition）。 */
+export declare function normalizeStoryFunction(text: string | undefined): StoryFunctionId;
+/** 从中文文本归一化情绪词列表（可含→箭头链）。 */
+export declare function normalizeEmotions(text: string | undefined): EmotionId[];
+/** 叙事功能中文。 */
+export declare function functionZh(id: StoryFunctionId | undefined): string;
+/** 情绪中文（箭头连接）。 */
+export declare function emotionZh(ids: EmotionId[] | undefined): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@waterwx/dsh-novel-forge",
   "description": "AI 编译小说工作台 for the dsh web GUI: import a novel outline (docx/text), plan chapters with LLM, generate chapter by chapter (3000-4000 chars each), and save every chapter as Markdown into your chosen output folder.",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -80,9 +80,9 @@
     "lib/**/*.js",
     "lib/**/*.js.map",
     "lib/**/*.d.ts",
-    "lib/**/*.d.ts.map",
     "src",
     "assets/styles",
+    "skills",
     "scripts/patch-schemastery.mjs",
     "cordis.patch.yml",
     "README.md"
@@ -95,6 +95,8 @@
     "watch": "tsdown --watch",
     "typecheck": "tsc --noEmit",
     "check:styles": "node scripts/check-theme-sizes.mjs",
+    "release": "node scripts/release.mjs",
+    "release:dry": "node scripts/release.mjs --dry-run",
     "test": "vitest run"
   }
 }

package/skills/chapter-batch/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: novel-forge-chapter-batch
+description: 批量生成小说章节并值守处理审稿未过的章节。当用户说「生成 N 章」「连写」「批量生成」「继续写章节」「值守处理未过章节」时使用。依赖 dsh-novel-forge 插件（http://127.0.0.1:3080/api/dsh-novel-forge/*）。
+---
+
+# 小说章节批量生产与值守处理
+
+把「批量生成章节 + 审稿未过处理」固化为可复现流程。所有操作通过 dsh-novel-forge 的 HTTP API 执行。
+
+## 0. 值守纪律（最高优先级，违反即空转）
+
+1. **启动后台任务后立即停下，不轮询、不连续 wait、不做无意义动作**——后台任务（批量生成/处理）由运行时在完成时自动通知。
+2. 只有收到「任务完成」通知或用户新消息时，才继续下一步（读结果 → 处理未过 → 汇报）。
+3. 等待期间可以做「与当前任务无关」的其他有用工作（如用户提出的其他问题、代码改进），但不得为等任务而空转。
+4. 任务因 web 重启中断时：等用户确认或检测到 3080 恢复后，复位卡死章节（generating/error → reset）再续跑，并向用户说明中断原因。
+
+## 1. 前置检查（每次必做）
+
+1. 确认服务在跑：`GET /api/dsh-novel-forge/status` 返回 200，读 `project.chapters` 数量与书名。
+2. 确认目标章节状态：列出 `pending`（待生成）章节号区间，避免重复生成已 approved/rejected 的章。
+3. **串行执行，禁止并行写 project.json**——多个脚本同时调 API 会造成状态互相覆盖（实测教训：第 166 章曾被并发回滚成 rejected）。
+
+## 2. 批量生成
+
+对目标章节区间（如 181-205）逐章串行调用：
+
+```
+POST /api/dsh-novel-forge/generate
+{ "chapterNo": N, "skipReview": false }
+```
+
+- `skipReview: false` 走完整质量门（生成 → 摘要+编年录 → AI 审稿 → 作者复盘）。
+- 响应为 NDJSON 流；找 `{"type":"review","report":{...}}` 帧取 `score`/`passed`。
+- 每章 2-5 分钟；失败自动重试 1 次（间隔 3 秒）。
+- 预估总时长并告知用户（25 章 ≈ 45-75 分钟），放后台跑，期间可并行做别的（只读操作不受影响）。
+- 推荐用 Node 脚本（fetch + 逐章循环），避免 PowerShell 的引号/UTF-8 转义坑；脚本用完删除。
+
+## 2. 未过章节处理（分级策略）
+
+生成完成后汇总：通过 / 未过（rejected）/ 失败（error）。对未过章按此分级：
+
+### A. 无 high（全是 medium/low 主观项）→ 豁免通过
+```
+POST /api/dsh-novel-forge/chapter/approve  { "chapterNo": N }
+```
+主观项（套话/节奏/比喻/心理描写）不值得逐章磨，直接通过。
+
+### B. 有 high 且问题明确（逻辑/设定/时间线/用词）→ 按意见修订 + 验证模式
+1. 取 review 的 high（无 high 取前 3 条 medium），拼指令：
+   `按审稿意见修订（优先处理）：\n[severity] item → suggestion`
+2. `POST /rewrite` `{ chapterNo, instructions }` → 产出 pendingDraft
+3. **验证模式**：`POST /chapter/check` `{ chapterNo, text: draft, previousReport: review }`——携带上一轮报告，LLM 只核对原意见是否解决 + 只挑新增 high，不全新找茬
+4. 判定：`passed || issues 全非 high` → 可接受
+5. 可接受 → `POST /draft/apply` `{ chapterNo, report: { score: max(score,70), passed: true, issues: [], ... } }` 落盘为 approved
+6. 不可接受 → 看剩余 high 是否明确可修 → 第二轮修订（指令更精确，如「把第 141 章的养伤时间线统一为七天」）→ 再验证
+7. **每章最多修订 2 轮**，仍不过 → 保留草稿，标记「待人工」，不硬来
+
+### C. 有 high 但结构性（修订改不好，如逻辑矛盾被坐实）→ 重新生成
+- `POST /draft/discard` 清草稿 → `POST /generate` 整章重写
+- 重新生成后若只剩主观项 → 走 A 豁免
+
+### D. error 状态（无审稿、chars 丢失）→ 重置重生成
+- `POST /chapter/reset`  `{ chapterNo }` → `POST /generate`
+
+### 特殊注意
+- **approved 但 review 有 high**：已通过状态保留，不折腾（high 可能已被正文处理或审稿误标）。
+- **修订指令越精确越有效**：具体数字/行为（如「茶梗尺寸统一为半截指节」）一次就过；泛泛的「修正矛盾」容易改不到位。
+
+## 3. 收尾
+
+1. 最终验证：`GET /status` 读目标区间全部 approved。
+2. 可选：对涉及剧情的章节刷新剧情线进度（`POST /plotlines` `{ op:'refresh', id }`）——注意刷新函数只读最近 8 章摘要，早期章节的线可能刷不准，必要时手动 update progress + link 章节。
+3. 向用户汇报：通过/未过/失败数量 + 每章处理方式 + 遗留待人工项。
+
+## 4. 已知陷阱（血泪教训）
+
+- **并发写 project.json 会互相覆盖**——多个生成/处理任务必须串行。
+- **rewrite 的草稿可能不落盘**（偶发 500 或时序）——应用前检查 `pendingDraft` 是否存在，不存在则重跑 rewrite。
+- **PowerShell 调 API 的引号/中文转义是坑**——统一用 Node 脚本。
+- **status 接口会做数据快照**——以磁盘 novel-project.json 为准复核关键状态。
+- **验证模式 500 偶发**——重试一次即可（LLM 瞬时错误）。

package/src/client/panel/CreateBookView.tsx

@@ -188,7 +188,11 @@ export function CreateBookView({
           <label className={css.fieldLabel}>大纲</label>
           <div
             className={`${css.dropzone} ${dragActive ? css.dropzoneActive : ''}`}
+            role="button"
+            tabIndex={0}
+            aria-label="选择或拖入 docx 大纲文件"
             onClick={() => { outlineFileRef.current?.click() }}
+            onKeyDown={e => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); outlineFileRef.current?.click() } }}
             onDragOver={e => { e.preventDefault(); setDragActive(true) }}
             onDragLeave={() => { setDragActive(false) }}
             onDrop={e => {

package/src/client/panel/ImportModal.tsx

@@ -4,7 +4,7 @@
  *  B) txt/md 全本 → 点击选择文件，浏览器读取内容 → 服务器拆章预览 → 确认后导入。
  *  Mode B 也保留「服务器本地路径」高级选项（大文件或服务器端已有文件时用）。
  */
-import { useRef, useState } from 'react'
+import { useEffect, useRef, useState } from 'react'
 import type { NovelApi } from '../api.ts'
 import type { BookImportTextPreviewResponse } from '../../protocol.ts'
 import css from './panel.module.css'
@@ -118,8 +118,17 @@ export function ImportModal({
 
   const switchMode = (m: ImportMode) => { setMode(m); setError(''); setResult(null); setPreview(null) }
 
+  // Esc 关闭弹窗。
+  useEffect(() => {
+    const onKey = (e: KeyboardEvent): void => {
+      if (e.key === 'Escape') onClose()
+    }
+    window.addEventListener('keydown', onKey)
+    return () => { window.removeEventListener('keydown', onKey) }
+  }, [onClose])
+
   return (
-    <div className={css.importModalOverlay} onClick={e => { if (e.target === e.currentTarget) onClose() }}>
+    <div className={css.importModalOverlay} role="dialog" aria-modal="true" aria-label="导入小说" onClick={e => { if (e.target === e.currentTarget) onClose() }}>
       <div className={css.importModal}>
         <div className={css.importModalHead}>
           <span className={css.panelTitle} style={{ margin: 0 }}>📥 导入小说</span>

package/src/client/panel/NovelPanel.tsx

@@ -138,6 +138,7 @@ function statusBadge(chapter: ChapterPlan): { cls: string; label: string } {
     case 'approved': return { cls: css.badgeDone, label: tt('plan.approved') }
     case 'rejected': return { cls: css.badgeRejected, label: tt('plan.rejected') }
     case 'error': return { cls: css.badgeError, label: tt('plan.error') }
+    default: return { cls: css.badgeError, label: tt('plan.error') }
   }
 }
 

package/src/client/panel/RunPanel.tsx

@@ -169,7 +169,7 @@ export function RunPanel({ api, totalChapters }: { api: NovelApi; totalChapters:
         <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-6)' }}>
           <div className={css.row} style={{ flexWrap: 'wrap', gap: 'var(--nf-space-8)' }}>
             <span className={css.meta}>范围：第 {run.startNo} - {run.endNo} 章 · 当前：第 {run.currentNo} 章</span>
-            <span className={css.meta}>新生成 {run.stats.generated} · 修订通过 {run.stats.revised} · 豁免 {run.stats.exempted} · 重生成 {run.stats.regenerated} · 失败 {run.stats.error}</span>
+            <span className={css.meta}>新生成 {run.stats?.generated ?? 0} · 修订通过 {run.stats?.revised ?? 0} · 豁免 {run.stats?.exempted ?? 0} · 重生成 {run.stats?.regenerated ?? 0} · 失败 {run.stats?.error ?? 0}</span>
           </div>
           <div className={css.bigProgressBar}>
             <div className={css.bigProgressBarFill} style={{ width: `${Math.round(ratio * 100)}%` }} />

package/src/client/panel/SceneLibrary.tsx

@@ -266,7 +266,7 @@ export function SceneLibrary({
           {scenes.map(s => {
             const cover = (s.gallery ?? [])[0]
             return (
-              <div key={s.name} onClick={() => { openDetail(s.name) }} style={{ cursor: 'pointer', border: '1px solid var(--nf-border)', borderRadius: 'var(--nf-radius-12)', overflow: 'hidden', background: 'var(--nf-bg-inset)', display: 'flex', flexDirection: 'column' }}>
+              <div key={s.name} onClick={() => { openDetail(s.name) }} role="button" tabIndex={0} aria-label={`打开场景 ${s.name}`} onKeyDown={e => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); openDetail(s.name) } }} style={{ cursor: 'pointer', border: '1px solid var(--nf-border)', borderRadius: 'var(--nf-radius-12)', overflow: 'hidden', background: 'var(--nf-bg-inset)', display: 'flex', flexDirection: 'column' }}>
                 <div style={{ height: 100, display: 'flex', alignItems: 'center', justifyContent: 'center', background: 'var(--nf-bg-inset)', borderBottom: '1px solid var(--nf-border)', position: 'relative' }}>
                   {cover !== undefined
                     ? <img src={cover.dataUrl} alt={s.name} style={{ width: '100%', height: '100%', objectFit: 'cover' }} />

package/src/client/panel/ShelfView.tsx

@@ -223,14 +223,14 @@ export function ShelfView({
           ))}
 
           {/* 开书入口：进入独立向导页 */}
-          <div className={`${css.bookCard} ${css.bookAddCard}`} onClick={onAddBook}>
+          <div className={`${css.bookCard} ${css.bookAddCard}`} onClick={onAddBook} role="button" tabIndex={0} aria-label="开一本新书" onKeyDown={e => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); onAddBook() } }}>
             <div className={css.bookAddIcon}><Plus size={28} /></div>
             <span>开一本新书</span>
             <span className={css.meta}>书名 + 大纲，开书即建项目</span>
           </div>
 
           {/* 导入入口：已有项目目录 / txt/md 全本 */}
-          <div className={`${css.bookCard} ${css.bookAddCard}`} onClick={onImportBook}>
+          <div className={`${css.bookCard} ${css.bookAddCard}`} onClick={onImportBook} role="button" tabIndex={0} aria-label="导入已有小说" onKeyDown={e => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); onImportBook() } }}>
             <div className={css.bookAddIcon}><Download size={28} /></div>
             <span>导入已有小说</span>
             <span className={css.meta}>项目目录或 txt/md 全本</span>

package/src/client/panel/StoryboardTab.tsx

@@ -5,8 +5,25 @@
 import { useEffect, useMemo, useRef, useState } from 'react'
 import type { NovelApi } from '../api.ts'
 import type { ChapterPlan, ProjectState, StoryboardPrompt, StoryboardSkeleton, StoryboardTable } from '../../protocol.ts'
+import {
+  sizeZh, cameraZh, compoZh, lightZh,
+  normalizeShotSize, normalizeCameras, normalizeComposition, normalizeLightings,
+} from '../../shot-language.ts'
+import { functionZh, emotionZh, normalizeStoryFunction, normalizeEmotions } from '../../story-beat-language.ts'
+import type { StoryboardShot } from '../../protocol.ts'
 import css from './panel.module.css'
 
+/** 归一化旧分镜数据：把自由文本 shot/camera/light/composition 转成词库枚举。 */
+function normalizeStoryboardShot(s: StoryboardShot): StoryboardShot {
+  return {
+    ...s,
+    shot: normalizeShotSize(typeof s.shot === 'string' ? s.shot : undefined),
+    camera: normalizeCameras(typeof s.camera === 'string' ? s.camera : undefined),
+    composition: typeof s.composition === 'string' ? normalizeComposition(s.composition) : s.composition,
+    light: normalizeLightings(typeof s.light === 'string' ? s.light : undefined),
+  }
+}
+
 export function StoryboardTab({
   api,
   project,
@@ -76,8 +93,23 @@ export function StoryboardTab({
     if (chapterNo === null) return
     if (suppressRestoreRef.current === true) return
     const entry = (project?.storyboards ?? []).find(e => e.chapterNo === chapterNo)
-    setSkeleton(prev => prev ?? entry?.skeleton ?? null)
-    setTable(prev => prev ?? entry?.table ?? null)
+    setSkeleton(prev => {
+      if (prev !== null) return prev
+      if (entry?.skeleton === undefined) return null
+      return {
+        ...entry.skeleton,
+        beats: (entry.skeleton.beats ?? []).map(b => ({
+          ...b,
+          function: normalizeStoryFunction(typeof b.function === 'string' ? b.function : undefined),
+          emotion: normalizeEmotions(typeof b.emotion === 'string' ? b.emotion : b.emotion?.join('→')),
+        })),
+      }
+    })
+    setTable(prev => {
+      if (prev !== null) return prev
+      if (entry?.table === undefined) return null
+      return { ...entry.table, shots: (entry.table.shots ?? []).map(normalizeStoryboardShot) }
+    })
     setPrompts(prev => prev ?? entry?.prompts ?? null)
   }, [chapterNo, project?.storyboards])
 
@@ -268,8 +300,8 @@ export function StoryboardTab({
             <div key={b.id} style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-4)', border: '1px solid var(--nf-border)', borderRadius: 'var(--nf-radius-10)', padding: 'var(--nf-space-8) var(--nf-space-10)' }}>
               <div className={css.row} style={{ flexWrap: 'wrap' }}>
                 <b>节拍 {i + 1}</b>
-                <span className={`${css.badge} ${b.function === '高潮' ? css.badgeDone : b.function === '转折' ? css.badgeWritten : css.badgePending}`}>{b.function}</span>
-                <span className={css.meta}>{b.emotion}</span>
+                <span className={`${css.badge} ${b.function === 'climax' ? css.badgeDone : b.function === 'turn' ? css.badgeWritten : css.badgePending}`}>{functionZh(b.function)}</span>
+                <span className={css.meta}>💭 {emotionZh(b.emotion)}</span>
               </div>
               <span>{b.event}</span>
               {b.cause !== undefined && <span className={css.meta}>承接：{b.cause}</span>}
@@ -280,7 +312,7 @@ export function StoryboardTab({
               type="button"
               className={`${css.button} ${css.buttonSmall}`}
               onClick={() => {
-                const text = `第${skeleton.chapterNo}章 弧线：${skeleton.arc}\n出场角色：${skeleton.characters !== undefined && skeleton.characters.length > 0 ? skeleton.characters.join('、') : '（未标注）'}\n\n` + skeleton.beats.map((b, i) => `${i + 1}. [${b.function}] ${b.event}（情绪：${b.emotion}）${b.cause !== undefined ? `［承接：${b.cause}］` : ''}`).join('\n')
+                const text = `第${skeleton.chapterNo}章 弧线：${skeleton.arc}\n出场角色：${skeleton.characters !== undefined && skeleton.characters.length > 0 ? skeleton.characters.join('、') : '（未标注）'}\n\n` + skeleton.beats.map((b, i) => `${i + 1}. [${functionZh(b.function)}] ${b.event}（情绪：${emotionZh(b.emotion)}）${b.cause !== undefined ? `［承接：${b.cause}］` : ''}`).join('\n')
                 void navigator.clipboard?.writeText(text)
               }}
             >
@@ -318,7 +350,7 @@ export function StoryboardTab({
               onClick={() => {
                 const text = table.shots.map(s => {
                   const beat = skeleton?.beats.find(b => b.id === s.beatId)
-                  return `镜头 ${s.id}（节拍 ${beat?.id ?? s.beatId} · ${s.shot} · ${s.camera} · ${s.duration}s）\n出场：${s.characters !== undefined && s.characters.length > 0 ? s.characters.join('、') : '（未标注）'}\n定妆：${s.mangaRoleIds !== undefined && s.mangaRoleIds.length > 0 ? bindingNames(s.mangaRoleIds) : '（未绑定漫剧卡）'}\n画面：${s.visual}\n台词：${s.line !== '' ? s.line : '（无）'}\n音效：${s.sound !== '' ? s.sound : '（无）'}\n光效：${s.light !== '' ? s.light : '（无）'}\n承接：${s.prevState} → ${s.nextState}`
+                  return `镜头 ${s.id}（节拍 ${beat?.id ?? s.beatId} · ${sizeZh(s.shot)} · ${cameraZh(s.camera)} · ${s.duration}s）\n出场：${s.characters !== undefined && s.characters.length > 0 ? s.characters.join('、') : '（未标注）'}\n定妆：${s.mangaRoleIds !== undefined && s.mangaRoleIds.length > 0 ? bindingNames(s.mangaRoleIds) : '（未绑定漫剧卡）'}\n画面：${s.visual}\n台词：${s.line !== '' ? s.line : '（无）'}\n音效：${s.sound !== '' ? s.sound : '（无）'}\n光效：${lightZh(s.light) !== '' ? lightZh(s.light) : '（无）'}\n承接：${s.prevState} → ${s.nextState}`
                 }).join('\n\n')
                 void navigator.clipboard?.writeText(`第${table.chapterNo}章分镜表\n\n` + text)
               }}
@@ -357,9 +389,9 @@ export function StoryboardTab({
               <div key={s.id} style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-4)', border: '1px solid var(--nf-border)', borderRadius: 'var(--nf-radius-10)', padding: 'var(--nf-space-8) var(--nf-space-10)' }}>
                 <div className={css.row} style={{ flexWrap: 'wrap' }}>
                   <b>镜头 {s.id}</b>
-                  <span className={css.badge}>{s.shot}</span>
-                  <span className={css.meta}>{s.camera} · {s.duration}s</span>
-                  {beat !== undefined && <span className={css.meta}>节拍 {beat.id}「{beat.function}」</span>}
+                  <span className={css.badge}>{sizeZh(s.shot)}</span>
+                  <span className={css.meta}>{cameraZh(s.camera)}{compoZh(s.composition) !== '' ? ' · ' + compoZh(s.composition) : ''} · {s.duration}s</span>
+                  {beat !== undefined && <span className={css.meta}>节拍 {beat.id}「{functionZh(beat.function)}」</span>}
                   {s.characters !== undefined && s.characters.length > 0 && (
                     <span className={css.meta}>👥 {s.characters.join('、')}</span>
                   )}
@@ -371,7 +403,7 @@ export function StoryboardTab({
                 <div className={css.row} style={{ flexWrap: 'wrap' }}>
                   <span className={css.meta}>💬 {s.line !== '' ? s.line : '（无台词）'}</span>
                   <span className={css.meta}>🔊 {s.sound !== '' ? s.sound : '（无音效）'}</span>
-                  <span className={css.meta}>💡 {s.light !== '' ? s.light : '（无光效）'}</span>
+                  <span className={css.meta}>💡 {lightZh(s.light) !== '' ? lightZh(s.light) : '（无光效）'}</span>
                 </div>
                 <span className={css.meta}>承接：{s.prevState} → {s.nextState}</span>
               </div>

package/src/engine.ts

@@ -30,6 +30,21 @@ import type { Context } from '@deepseek-ai/cordis'
 import { emptyProjectAssets, renderAllAssets, styleEngineSystemPrompt } from './assets.ts'
 import { getComicStylePrompt } from './comic-presets.ts'
 import { findStyle, styleKeywords } from './style-library.ts'
+import {
+  normalizeShotSize,
+  normalizeCameras,
+  normalizeComposition,
+  normalizeLightings,
+  sizeZh,
+  cameraZh,
+  lightZh,
+} from './shot-language.ts'
+import {
+  normalizeStoryFunction,
+  normalizeEmotions,
+  functionZh,
+  emotionZh,
+} from './story-beat-language.ts'
 import type {
   AuditIssue,
   AuthorReview,
@@ -3033,8 +3048,11 @@ export async function generateStoryboardTable(
   const system = [
     '你是一位从业 10 年的电影导演兼分镜师，专长网文改编影视化。',
     '任务：把「剧情骨架」的每一个节拍展开为 1-3 个电影镜头，输出分镜表——只做画面层，禁止新增或改变剧情（骨架是只读输入）。',
-    '输出合法 JSON 对象：{"shots": [{"beatId": "骨架节拍id", "shot": "景别", "camera": "机位与运镜", "duration": 秒数, "visual": "画面内容", "line": "台词/旁白", "sound": "音效", "light": "光效", "prevState": "承接上一镜头结尾状态", "nextState": "本镜头结束状态", "characters": ["出镜角色名"]}]}',
-    '景别取值：远景/全景/中景/近景/特写。',
+    '输出合法 JSON 对象：{"shots": [{"beatId": "骨架节拍id", "shot": "景别", "camera": "机位与运镜", "composition": "构图", "duration": 秒数, "visual": "画面内容", "line": "台词/旁白", "sound": "音效", "light": "光效", "prevState": "承接上一镜头结尾状态", "nextState": "本镜头结束状态", "characters": ["出镜角色名"]}]}',
+    '景别取值（只能从这些词中选一）：大远景/远景/全景/中景/中近景/近景/特写/大特写。',
+    '运镜取值（可组合，用加号连接）：固定机位/推近/拉远/左摇/右摇/左横移/右横移/跟随/升镜/降镜/环绕/手持晃动/低机位仰拍/高机位俯拍/过肩镜头。',
+    '光效取值（可组合，用加号连接）：顺光/侧光/逆光/顶光/伦勃朗光/霓虹光/硬光/柔光/氛围光/高反差。',
+    '构图取值（可选，只能从这些词中选一）：三分法/中心对称/引导线/前景遮挡/低机位/俯拍/对称构图。',
     '硬性要求：',
     '【视觉风格】（必须内嵌进 visual/light 的画面措辞与光效描述）：',
     ...styleLines,
@@ -3059,23 +3077,23 @@ export async function generateStoryboardTable(
     '==== 章节正文（画面细节以此为准） ====',
     body.replace(/^#\s+.*$/m, '').trim().slice(0, 3000),
   ].filter(s => s !== '').join('\n\n')
-  const text = await complete(ctx, config, { system, user, temperature: 0.3, maxTokens: Math.max(config.maxTokens, 6000), reasoning: config.analysisReasoning ?? 'low' })
+  const text = await complete(ctx, config, { system, user, temperature: 0.3, maxTokens: Math.max(config.maxTokens, 16000), reasoning: config.analysisReasoning ?? 'low' })
   const raw = parseJsonObject<{ shots?: unknown }>(text)
   const beatIds = new Set(skeleton.beats.map(b => b.id))
-  const shotKinds = new Set(['远景', '全景', '中景', '近景', '特写'])
   const shots: StoryboardShot[] = Array.isArray(raw.shots)
     ? raw.shots
         .filter((v): v is Record<string, unknown> => typeof v === 'object' && v !== null)
         .map((entry, i) => ({
           id: 's' + (i + 1),
           beatId: beatIds.has(entry.beatId as string) ? entry.beatId as string : skeleton.beats[0]!.id,
-          shot: shotKinds.has(entry.shot as string) ? entry.shot as string : '中景',
-          camera: typeof entry.camera === 'string' ? entry.camera.trim().slice(0, 80) : '',
+          shot: normalizeShotSize(entry.shot as string | undefined),
+          camera: normalizeCameras(entry.camera as string | undefined),
+          composition: normalizeComposition(entry.composition as string | undefined),
           duration: typeof entry.duration === 'number' && entry.duration >= 1 && entry.duration <= 12 ? Math.round(entry.duration) : 4,
           visual: typeof entry.visual === 'string' ? entry.visual.trim().slice(0, 300) : '',
           line: typeof entry.line === 'string' ? entry.line.trim().slice(0, 120) : '',
           sound: typeof entry.sound === 'string' ? entry.sound.trim().slice(0, 80) : '',
-          light: typeof entry.light === 'string' ? entry.light.trim().slice(0, 80) : '',
+          light: normalizeLightings(entry.light as string | undefined),
           prevState: typeof entry.prevState === 'string' ? entry.prevState.trim().slice(0, 150) : '',
           nextState: typeof entry.nextState === 'string' ? entry.nextState.trim().slice(0, 150) : '',
           characters: sanitizeCharacters(entry.characters, 4),
@@ -3152,12 +3170,12 @@ export async function generateStoryboardPrompts(
       const ref = c.imageUrl !== undefined ? '（参考图）' : ''
       return c.name + '：' + anchor + ref
     }).join('；')
-    return `[${s.id}] 节拍${s.beatId} · ${s.shot} · ${s.camera} · ${s.duration}s
+    return `[${s.id}] 节拍${s.beatId} · ${sizeZh(s.shot)} · ${cameraZh(s.camera)} · ${s.duration}s
 出场：${s.characters !== undefined && s.characters.length > 0 ? s.characters.join('、') : '（未标注）'}
 定妆：${makeUp !== '' ? makeUp : '（未绑定漫剧卡）'}
 画面：${s.visual}
 台词：${s.line !== '' ? s.line : '（无）'}
-光效：${s.light !== '' ? s.light : '（无）'}
+光效：${lightZh(s.light) !== '' ? lightZh(s.light) : '（无）'}
 承接：${s.prevState} → ${s.nextState}`
   }).join('\n\n')
   const system = [
@@ -3180,7 +3198,7 @@ export async function generateStoryboardPrompts(
     shotLines,
     '只输出 JSON 对象。',
   ].filter(x => x !== '').join('\n\n')
-  const text = await complete(ctx, config, { system, user, temperature: 0.3, maxTokens: Math.max(config.maxTokens, 6000), reasoning: config.analysisReasoning ?? 'low' })
+  const text = await complete(ctx, config, { system, user, temperature: 0.3, maxTokens: Math.max(config.maxTokens, 16000), reasoning: config.analysisReasoning ?? 'low' })
   const raw = parseJsonObject<{ prompts?: unknown }>(text)
   const shotIds = new Set(table.shots.map(s => s.id))
   const shotBinding = new Map<string, string[]>(table.shots.map(s => [s.id, s.mangaRoleIds ?? []]))
@@ -3222,7 +3240,9 @@ export async function generateStoryboardSkeleton(
   const system = [
     '你是一位从业 15 年的电影编剧，专长网文改编影视化，深谙三幕结构与节拍（beat）写作。',
     '任务：把这一章改编成影视化「剧情骨架」——只做故事层，不做画面。',
-    '输出合法 JSON 对象：{"arc": "本章弧线一句话（起承转合，20-60字）", "beats": [{"event": "事件一句话（发生了什么）", "emotion": "人物情绪走向（如 压抑→隐忍→惊惧）", "function": "铺垫|冲突|转折|高潮|收束|伏笔|人物塑造", "cause": "承接上一节拍的原因（可省略）"}], "characters": ["出镜角色名1", "出镜角色名2"]}',
+    '输出合法 JSON 对象：{"arc": "本章弧线一句话（起承转合，20-60字）", "beats": [{"event": "事件一句话（发生了什么）", "emotion": "人物情绪走向（情绪词数组）", "function": "铺垫|冲突|转折|高潮|收束|伏笔|人物塑造", "cause": "承接上一节拍的原因（可省略）"}], "characters": ["出镜角色名1", "出镜角色名2"]}',
+    '情绪词取值（从这些词中选 1-3 个，用数组输出，按情绪发展顺序）：平静/淡然/期待/好奇/警觉/压抑/隐忍/担忧/焦躁/不安/惊惧/愤怒/崩溃/决绝/痛心/释然/悲凉/得意/重生/麻木。',
+    '功能取值（只能从这些词中选一）：铺垫/冲突/转折/高潮/收束/伏笔/人物塑造。',
     '硬性要求：',
     '1. beats 数量 4-9 个，严格按时间顺序，因果链完整：前一个 beat 的结果是后一个 beat 的原因。',
     '2. 必须覆盖本章全部剧情要点与正文关键事件，遗漏关键事件视为失败。',
@@ -3240,15 +3260,16 @@ export async function generateStoryboardSkeleton(
   const text = await complete(ctx, config, { system, user, temperature: 0.3, maxTokens: Math.max(config.maxTokens, 4000), reasoning: config.analysisReasoning ?? 'low' })
   const raw = parseJsonObject<{ arc?: unknown; beats?: unknown; characters?: unknown }>(text)
   const arc = typeof raw.arc === 'string' ? raw.arc.trim().slice(0, 200) : ''
-  const functions = new Set(['铺垫', '冲突', '转折', '高潮', '收束', '伏笔', '人物塑造'])
   const beats: StoryboardBeat[] = Array.isArray(raw.beats)
     ? raw.beats
         .filter((v): v is Record<string, unknown> => typeof v === 'object' && v !== null)
         .map((entry, i) => ({
           id: 'b' + (i + 1),
           event: typeof entry.event === 'string' ? entry.event.trim().slice(0, 200) : '',
-          emotion: typeof entry.emotion === 'string' ? entry.emotion.trim().slice(0, 100) : '',
-          function: functions.has(entry.function as string) ? entry.function as string : '铺垫',
+          emotion: Array.isArray(entry.emotion)
+            ? normalizeEmotions(entry.emotion.filter((x): x is string => typeof x === 'string').join('→'))
+            : normalizeEmotions(typeof entry.emotion === 'string' ? entry.emotion : undefined),
+          function: normalizeStoryFunction(typeof entry.function === 'string' ? entry.function : undefined),
           cause: typeof entry.cause === 'string' && entry.cause.trim() !== '' ? entry.cause.trim().slice(0, 150) : undefined,
         }))
         .filter(b => b.event !== '')

package/src/index.ts

@@ -199,6 +199,7 @@ export function apply(ctx: Context, config?: Config): void {
     if (patch.imageApiKey !== undefined) next.imageApiKey = patch.imageApiKey
     if (patch.imageApiModel !== undefined) next.imageApiModel = patch.imageApiModel
     if (patch.imageApiEnabled !== undefined) next.imageApiEnabled = patch.imageApiEnabled
+    if (patch.imageModels !== undefined) next.imageModels = patch.imageModels
     // Persist through the settings seam when available; otherwise keep in memory.
     // (ctx.get is the non-strict service access — no inject requirement, same
     // pattern installSettingsSection itself uses.)