@waterwx/dsh-novel-forge 1.7.2 → 1.8.0

package/src/engine.ts

@@ -30,7 +30,29 @@ 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 {
+  AdaptationDimension,
+  AdaptAnalyzeResponse,
+  AdaptationMapping,
+  AdaptationProposal,
+  AdaptationRules,
+  AdaptProposeResponse,
+  AdaptExecuteResponse,
   AuditIssue,
   AuthorReview,
   BreakdownResponse,
@@ -3033,8 +3055,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 +3084,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 +3177,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 +3205,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 +3247,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 +3267,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 !== '')
@@ -3315,6 +3343,220 @@ export async function reverseOutlineFromChapters(
   return outline.trim()
 }
 
+/**
+ * 改编模式 P0：全文分析 → 原文设定卡片 / 可改范围矩阵。
+ * 拆章统计 + 取样正文，让 LLM 一次输出结构化 JSON：
+ * { bookName, outline, dimensions: [{key,title,mutability,current,evidence,candidates,impact,risk}] }。
+ */
+export async function analyzeAdaptation(
+  ctx: Context,
+  config: NovelConfig,
+  text: string,
+): Promise<AdaptAnalyzeResponse> {
+  const chapters = splitBookText(text).filter(c => c.body.length >= 50)
+  if (chapters.length === 0) throw new Error('未能从全文拆出章节（内容过短或无章节结构）')
+
+  // 取样：取首/1/3/2/3/尾各章正文节选，控制 token 预算。
+  const sampleBodies: string[] = []
+  const n = chapters.length
+  const pick = (i: number): void => {
+    const c = chapters[i]
+    if (c !== undefined) sampleBodies.push('第' + c.no + '章《' + (c.title || '无题') + '》\n' + c.body.slice(0, 1200))
+  }
+  pick(0)
+  if (n > 3) { pick(Math.floor(n / 3)); pick(Math.floor((2 * n) / 3)) }
+  if (n > 1) pick(n - 1)
+
+  const system = '你是改编策划分析助手。'
+  const user = [
+    '你是一位资深网文编辑兼改编策划。下面给你一部已完结/连载小说的若干章正文节选。请通读并输出该书的「原文设定卡片」与「可改范围矩阵」。',
+    '输出合法 JSON 对象：',
+    '{"bookName": "书名", "outline": "一句话主线梗概（100字内）", "dimensions": [{"key":"realm","title":"大世界","mutability":"big|small|free|locked|visual","current":"当前值","evidence":"证据（出现章节/频次）","candidates":["候选1","候选2"],"impact":"改了会影响什么","risk":"high|medium|low"}]}',
+    'dimensions 至少覆盖以下维度（key/title）：realm 大世界、cultivation 修为体系、protagonist 主角、goldenFinger 金手指、supporting 配角与势力人物名、faction 势力/组织、style 文风与叙事、ending 结局走向、timeline 时间线/编年、foreshadow 伏笔/暗线。',
+    'mutability 取值：locked=建议保留、big=可改影响大、small=可改影响小、free=可自由改、visual=仅视觉包装。',
+    '每个 dimension.current 必须忠于文本，能引用原文就用原文（尤其角色名/境界名/势力名/金手指名）。',
+    '重要：所有字符串值内部不得包含换行符；JSON 必须在一段内完整结束；直接输出 JSON，不要 Markdown 代码块。',
+  ].join('\n')
+  const textOut = await complete(ctx, config, {
+    system,
+    user: user + '\n\n' + sampleBodies.join('\n\n---\n\n'),
+    temperature: 0.3,
+    maxTokens: Math.max(config.maxTokens, 6000),
+    reasoning: config.analysisReasoning ?? 'low',
+  })
+  const raw = parseJsonObject<{ bookName?: unknown; outline?: unknown; dimensions?: unknown }>(textOut)
+  const bookName = typeof raw.bookName === 'string' ? raw.bookName.trim() : '未命名'
+  const dims = Array.isArray(raw.dimensions)
+    ? raw.dimensions
+        .filter((d): d is Record<string, unknown> => typeof d === 'object' && d !== null)
+        .map(d => normalizeAdaptationDimension(d))
+        .filter((d): d is AdaptationDimension => d !== null)
+    : []
+  // 反推大纲：独立 LLM 调用，从章节正文节选生成全书总纲（Markdown）。
+  let outline: string | undefined
+  try {
+    outline = await reverseOutlineFromAdaptationText(ctx, config, chapters)
+  } catch {
+    outline = typeof raw.outline === 'string' && raw.outline.trim() !== '' ? raw.outline.trim() : undefined
+  }
+  return {
+    bookName,
+    chapters: chapters.length,
+    outline,
+    dimensions: dims,
+    note: '基于节选分析（首/中/末取样）+ 反推大纲。如需逐章全文级深度分析请后续启用全文流式入口。',
+  }
+}
+
+/** 校验并归一化一行的改编维度数据（来自 LLM）。 */
+function normalizeAdaptationDimension(d: Record<string, unknown>): AdaptationDimension | null {
+  const key = typeof d.key === 'string' ? d.key : ''
+  const title = typeof d.title === 'string' ? d.title : ''
+  if (key === '' || title === '') return null
+  const mutability = (['locked', 'big', 'small', 'free', 'visual'] as const).includes(d.mutability as AdaptationDimension['mutability'])
+    ? d.mutability as AdaptationDimension['mutability']
+    : 'small'
+  const risk = (['high', 'medium', 'low'] as const).includes(d.risk as AdaptationDimension['risk'])
+    ? d.risk as AdaptationDimension['risk']
+    : 'medium'
+  return {
+    key,
+    title,
+    mutability,
+    current: typeof d.current === 'string' ? d.current : '',
+    evidence: typeof d.evidence === 'string' ? d.evidence : undefined,
+    candidates: Array.isArray(d.candidates) ? d.candidates.filter((x): x is string => typeof x === 'string') : [],
+    impact: typeof d.impact === 'string' ? d.impact : '',
+    risk,
+  }
+}
+
+/** 从全文拆出的章节节选反推全书总纲（Markdown），用于改编 P0 的「反推大纲」。 */
+async function reverseOutlineFromAdaptationText(
+  ctx: Context,
+  config: NovelConfig,
+  chapters: Array<{ no: number; title: string; body: string }>,
+): Promise<string> {
+  // 均匀采样最多 20 章，每章正文前 600 字，控制成本。
+  const n = chapters.length
+  const sample: string[] = []
+  const count = Math.min(n, 20)
+  for (let i = 0; i < count; i++) {
+    const idx = Math.floor((i * n) / count)
+    const c = chapters[idx]
+    if (c === undefined) continue
+    sample.push('第' + c.no + '章《' + (c.title || '无题') + '》\n' + c.body.slice(0, 600))
+  }
+  const system = [
+    '你是一位经验丰富的小说主编。根据下面若干章节的正文节选，反推出这本书的总纲（可作为后续改编与章节续写的骨架）。',
+    '要求：',
+    '1. 第一行写《书名》（可从正文推断，否则《未命名》）。',
+    '2. 按故事弧线划分卷/部分：每卷给卷名与主旨（标注覆盖章节范围）。',
+    '3. 对每章列出：章节号 + 标题 + 一句话核心情节。',
+    '4. 最后给出：全书主线、主要人物弧线、已埋设待回收的伏笔清单。',
+    '5. 输出纯文本 Markdown 结构（# 一级标题、## 二级标题、- 列表），不要寒暄，不要其他输出。',
+  ].join('\n')
+  const user = sample.join('\n\n---\n\n')
+  const text = await complete(ctx, config, { system, user, temperature: 0.4, maxTokens: Math.max(config.maxTokens, 6000), reasoning: config.analysisReasoning ?? 'low' })
+  return text.trim()
+}
+
+/** 改编方案：由用户勾选的维度与新值，生成 LLM 映射表/规则/影响清单。 */
+export async function proposeAdaptation(
+  ctx: Context,
+  config: NovelConfig,
+  text: string,
+  selections: Array<{ key: string; title: string; current: string; target: string; mutability: string }>,
+  dimensions?: AdaptationDimension[],
+): Promise<AdaptProposeResponse> {
+  const selLines = selections.map(s => '- ' + s.title + '（' + s.key + '）：' + s.current + ' → ' + s.target).join('\n')
+  const dimLines = (dimensions ?? []).map(d => '- ' + d.title + '：' + d.current + '（可改度：' + d.mutability + '，风险：' + d.risk + '）').join('\n')
+  const system = '你是改编策划。'
+  const user = [
+    '下面给出改编决策：用户想改哪些维度、改成什么值。请生成一份可执行的「改编方案」。',
+    '要求输出合法 JSON 对象：',
+    '{"mappings": [{"source":"原值","target":"新值","scope":"name|realm|faction|term|other","note":"说明"}], "rules": {"preserve":["必须保留的要素"],"change":["允许改变的要素"],"constraints":["改编红线/一致性要求"]}, "impacts": [{"item":"受影响项","detail":"说明","risk":"high|medium|low","chapters":[章号]}]}',
+    'mappings 需把用户确认的新值展开为「原→新」条目（如主角名/境界名/势力名/术语），并补充用户未填但关联的必改项（如改了修为体系名，相关的境界名一并列映射）。',
+    'rules.preserve 至少包含：故事骨架、人物动机、伏笔逻辑、爽点结构。',
+    'impacts 列出每个改动会影响的内容（术语/角色/章节/伏笔），能定位章号尽量定位；无法定位则给章节区间提示。',
+    '重要：所有字符串值内部不得包含换行符；JSON 必须在一段内完整结束；直接输出 JSON，不要 Markdown 代码块。',
+    '',
+    '用户要改：',
+    selLines,
+    '',
+    '原文可改矩阵（已分析）：',
+    dimLines,
+  ].join('\n')
+  const out = await complete(ctx, config, { system, user, temperature: 0.3, maxTokens: Math.max(config.maxTokens, 6000), reasoning: config.analysisReasoning ?? 'low' })
+  const raw = parseJsonObject<{ mappings?: unknown; rules?: unknown; impacts?: unknown }>(out)
+  const mappings = Array.isArray(raw.mappings)
+    ? raw.mappings
+        .filter((m): m is Record<string, unknown> => typeof m === 'object' && m !== null)
+        .map(m => normalizeAdaptationMapping(m))
+        .filter((m): m is AdaptationMapping => m !== null)
+    : []
+  const rules = normalizeAdaptationRules(raw.rules)
+  const impacts = Array.isArray(raw.impacts)
+    ? raw.impacts
+        .filter((i): i is Record<string, unknown> => typeof i === 'object' && i !== null)
+        .map(i => normalizeAdaptationImpact(i))
+    : []
+  return { proposal: { mappings, rules, impacts } }
+}
+
+/** 剧本术语替换执行：按映射表做精确替换并统计命中。 */
+export function applyAdaptationReplacements(
+  text: string,
+  mappings: AdaptationMapping[],
+): { adaptedText: string; hits: Array<{ source: string; target: string; count: number }> } {
+  const seen = new Set<string>()
+  const unique = mappings.filter(m => {
+    const s = m.source.trim()
+    if (s === '' || s === m.target.trim()) return false
+    if (seen.has(s)) return false
+    seen.add(s)
+    return true
+  }).sort((a, b) => b.source.length - a.source.length)
+  let adapted = text
+  const hits: Array<{ source: string; target: string; count: number }> = []
+  for (const m of unique) {
+    const count = adapted.split(m.source).length - 1
+    if (count > 0) adapted = adapted.split(m.source).join(m.target)
+    hits.push({ source: m.source, target: m.target, count })
+  }
+  return { adaptedText: adapted, hits }
+}
+
+/** 校验归一化一条映射（来自 LLM）。 */
+function normalizeAdaptationMapping(m: Record<string, unknown>): AdaptationMapping | null {
+  const source = typeof m.source === 'string' ? m.source.trim() : ''
+  const target = typeof m.target === 'string' ? m.target.trim() : ''
+  if (source === '' || target === '') return null
+  const scope = (['name', 'realm', 'faction', 'term', 'other'] as const).includes(m.scope as AdaptationMapping['scope'])
+    ? m.scope as AdaptationMapping['scope']
+    : 'other'
+  return { source, target, scope, note: typeof m.note === 'string' ? m.note : undefined }
+}
+
+/** 校验归一化改编规则（来自 LLM）。 */
+function normalizeAdaptationRules(r: unknown): AdaptationRules {
+  const obj = typeof r === 'object' && r !== null ? r as Record<string, unknown> : {}
+  const arr = (v: unknown): string[] => Array.isArray(v) ? v.filter((x): x is string => typeof x === 'string') : []
+  return { preserve: arr(obj.preserve), change: arr(obj.change), constraints: arr(obj.constraints) }
+}
+
+/** 校验归一化一条影响项（来自 LLM）。 */
+function normalizeAdaptationImpact(i: Record<string, unknown>): { item: string; detail: string; risk: 'high' | 'medium' | 'low'; chapters?: number[] } {
+  const risk = (['high', 'medium', 'low'] as const).includes(i.risk as 'high' | 'medium' | 'low') ? i.risk as 'high' | 'medium' | 'low' : 'medium'
+  const chapters = Array.isArray(i.chapters) ? i.chapters.filter((x): x is number => typeof x === 'number') : undefined
+  return {
+    item: typeof i.item === 'string' ? i.item : '',
+    detail: typeof i.detail === 'string' ? i.detail : '',
+    risk,
+    chapters: chapters !== undefined && chapters.length > 0 ? chapters : undefined,
+  }
+}
+
 /**
  * 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
  * 批量生成时整体开销约省 25%）。

package/src/index.ts

@@ -70,6 +70,14 @@ export interface Config {
   imageApiModel?: string
   /** 是否启用豆包生图（旧字段，兼容迁移用）。 */
   imageApiEnabled?: boolean
+  /** 自定义背景图（URL / dataURL / 服务端路径引用）。 */
+  themeBackground?: string
+  /** 自定义背景遮罩/模糊强度 0-80。 */
+  themeBackgroundBlur?: number
+  /** 玻璃透明度 0-100（100=当前原样）。 */
+  themeOpacity?: number
+  /** 是否启用改编模式（默认关闭）。 */
+  enableAdaptMode?: boolean
 }
 
 export const Config: z<Config> = z.object({
@@ -98,6 +106,10 @@ export const Config: z<Config> = z.object({
   imageApiKey: z.string().default(''),
   imageApiModel: z.string().default(''),
   imageApiEnabled: z.boolean().default(false),
+  themeBackground: z.string().default(''),
+  themeBackgroundBlur: z.number().default(0),
+  themeOpacity: z.number().default(100),
+  enableAdaptMode: z.boolean().default(false),
 })
 
 /** Schema defaults, re-read for hand-built test contexts. */
@@ -157,6 +169,10 @@ export function resolveConfig(value: Partial<Config> | undefined): NovelConfig {
       return active?.model ?? value?.imageApiModel
     })(),
     imageApiEnabled: value?.imageApiEnabled ?? false,
+    themeBackground: value?.themeBackground ?? '',
+    themeBackgroundBlur: value?.themeBackgroundBlur ?? 0,
+    themeOpacity: value?.themeOpacity ?? 100,
+    enableAdaptMode: value?.enableAdaptMode ?? false,
   }
 }
 
@@ -199,6 +215,11 @@ 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.themeBackground !== undefined) next.themeBackground = patch.themeBackground
+    if (patch.themeBackgroundBlur !== undefined) next.themeBackgroundBlur = patch.themeBackgroundBlur
+    if (patch.themeOpacity !== undefined) next.themeOpacity = patch.themeOpacity
+    if (patch.enableAdaptMode !== undefined) next.enableAdaptMode = patch.enableAdaptMode
+    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.)