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

package/src/routes.ts

@@ -12,13 +12,12 @@ import type { IncomingMessage, ServerResponse } from 'node:http'
 import { spawn } from 'node:child_process'
 import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { join, basename, extname } from 'node:path'
-import { homedir } from 'node:os'
 import { randomBytes } from 'node:crypto'
-import { fileURLToPath } from 'node:url'
 import type { WebRoute } from '@deepseek-ai/dsh-host-webserver'
 import type { Context } from '@deepseek-ai/cordis'
 import { ProductionRunner } from './run.ts'
 import {
+  EXPORT_SCOPE_VALUES,
   NOVEL_API,
   type AssetsPatch,
   type AssetsResponse,
@@ -46,11 +45,8 @@ import {
   type BookActivateRequest,
   type BookCreateRequest,
   type BookImportDirRequest,
-  type BookImportDirResponse,
   type BookImportTextRequest,
-  type BookImportTextResponse,
   type BookImportTextPreviewRequest,
-  type BookImportTextPreviewResponse,
   type BookRemoveRequest,
   type BookshelfSnapshot,
   type ChapterResponse,
@@ -58,6 +54,13 @@ import {
   type ChapterSaveResponse,
   type ChapterTextRequest,
   type ConfigPatch,
+  type ConfigResponse,
+  type GenerateRequest,
+  type MoveOutputDirRequest,
+  type MoveOutputDirResponse,
+  type BookSettings,
+  type BookSettingsRequest,
+  type BookSettingsResponse,
   type DraftDecisionRequest,
   type ExportRequest,
   type ExportResponse,
@@ -65,13 +68,18 @@ import {
   type ForeshadowResponse,
   type JobFrame,
   type LoadOutlineRequest,
-  type MangaPlan,
-  type MangaPlansRequest,
-  type MangaPlansResponse,
-  type MangaRoleCard,
-  type MangaRolesRequest,
-  type MangaRolesResponse,
   type LoadOutlineResponse,
+  type ExportScope,
+  type PromptSlotsRequest,
+  type PromptSlotsResponse,
+  type SnapshotRequest,
+  type SnapshotResponse,
+  type RevisionPlanRequest,
+  type RevisionPlanResponse,
+  type TensionRequest,
+  type TensionResponse,
+  type TimelineRequest,
+  type TimelineResponse,
   type NovelConfig,
   type PlotlinesRequest,
   type PlotlinesResponse,
@@ -87,13 +95,6 @@ import {
   type RewriteRequest,
   type RolesRequest,
   type RolesResponse,
-  type SceneCard,
-  type ScenesRequest,
-  type ScenesResponse,
-  type MangaPropsRequest,
-  type MangaPropsResponse,
-  type VisualRulesRequest,
-  type VisualRulesResponse,
   type OutlineSuggestRequest,
   type OutlineSuggestResponse,
   type BreakdownRequest,
@@ -104,16 +105,8 @@ import {
   type ProjectState,
   type StatusResponse,
   type StoryBible,
-  type StoryboardSkeletonRequest,
-  type StoryboardSkeletonResponse,
-  type StoryboardTableRequest,
-  type StoryboardTableResponse,
-  type StoryboardPromptsRequest,
-  type ImageTestRequest,
-  type ImageTestResponse,
   type LlmTestRequest,
   type LlmTestResponse,
-  type StoryboardPromptsResponse,
   type StyleEngineRequest,
   type SummaryRequest,
   type VolumesRequest,
@@ -135,12 +128,27 @@ import {
   type AdaptMaterializeSaveResponse,
   type AdaptRewriteFrame,
   type PluginUpdateResponse,
+  type MarketRadarRequest,
+  type MarketRadarBriefRequest,
+  type ProductionFoundation,
+  type ProgressionMode,
+  type GenreNode,
+  type KnowledgeRequest,
+  type BookAnalysisRequest,
+  type IdeaInspirationRequest,
+  type DirectorRequest,
+  type DirectorTodo,
 } from './protocol.ts'
 import { readOutlineFromDocx } from './docx.ts'
 import { clearAssistantHistory, loadAssistantHistory, runAssistantTurn } from './assistant.ts'
-import { activateBook, bookshelfSnapshot, createBook, defaultOutputDirFor, importDir, loadBookshelf, removeBook, renameBook, seedBookshelfFromOutputDir } from './bookshelf.ts'
+import { activateBook, bookshelfSnapshot, createBook, defaultOutputDirFor, importDir, loadBookshelf, removeBook, renameBook, repointBookDirs, seedBookshelfFromOutputDir } from './bookshelf.ts'
+import { copyDirContents, listDirContents, normalizeDir, removeDir } from './migrate-output.ts'
 import { loadAuthorAssets, upsertAuthorAsset, removeAuthorAsset, importDefaultAuthorAssets } from './author-assets.ts'
-import { BUILTIN_ANTI_AI_RULES, BUILTIN_GENRE_LIBRARY, BUILTIN_PLOT_BEATS, BUILTIN_PROGRESSION_MODES, BUILTIN_STYLE_TEMPLATES, emptyProjectAssets } from './assets.ts'
+import { BUILTIN_ANTI_AI_RULES, BUILTIN_GENRE_LIBRARY, BUILTIN_PLOT_BEATS, BUILTIN_PROGRESSION_MODES, BUILTIN_STARTER_STYLE_PROFILES, BUILTIN_STYLE_TEMPLATES, emptyProjectAssets, ensureBuiltinAssets } from './assets.ts'
+import { scanAiFlavor } from './ai-scan.ts'
+import { emitLive, livePrompt, liveUsage, nextSessionId, resetLiveUsage, subscribeLiveFeed } from './llm-live.ts'
+import { scanMarketRanking } from './market-radar-scan.ts'
+import { addGlobalGenre, addGlobalMode, globalGenreLibrary, globalProgressionLibrary } from './global-assets.ts'
 import {
   chapterFileName,
   auditBook,
@@ -148,12 +156,19 @@ import {
   autoLinkPlotlines,
   backfillFacts,
   createProject,
-  exportBook,
+  exportScope,
   importBookText,
   importBookTextFromText,
   previewBookText,
   extractBible,
   extractStyleAsset,
+  extractStyleFormula,
+  runMarketRadar,
+  runMarketCreativeBrief,
+  runBookAnalysis,
+  runIdeaInspiration,
+  runMarketIdeaInspiration,
+  runDirectorAdvice,
   extractWorld,
   generateBlurb,
   generateChapterStream,
@@ -174,14 +189,6 @@ import {
   analyzePlotlineHealth,
   designPlotlinePlan,
   extractRoles,
-  extractScenes,
-  generateRolePromptKit,
-  generateMangaRolePromptKit,
-  extractVisualRules,
-  extractProps,
-  extractRoleVisual,
-  extractMangaRoleVisual,
-  nominateMangaRoles,
   suggestOutlines,
   reverseOutlineFromChapters,
   breakdownBook,
@@ -191,32 +198,43 @@ import {
   rewriteAdaptationBook,
   materializeAdaptedBook,
   saveMaterializedBook,
-  getActiveMangaStyle,
   testLlmModel,
   registerLlmModel,
   listLlmVendors,
   listLlmModels,
   listLlmProviders,
   removeLlmProvider,
-  generateStoryboardSkeleton,
-  generateStoryboardTable,
-  generateStoryboardPrompts,
-  autoGenerateMangaChapter,
-  mangaAssetsDir,
-  saveMangaAssetPackage,
   checkSensitiveText,
   suggestForeshadows,
   suggestPlotlines,
   summarizeAndExtractFacts,
+  extractTimelineForChapter,
+  reviewTimeline,
   summarizeChapter,
   syncProjectWithDisk,
 } from './engine.ts'
+import { countHanzi } from './engine.ts'
+import { computeBookStage } from './stage-contract.ts'
+import { createSnapshot, loadSnapshots, pruneSnapshots, removeSnapshot, restoreSnapshot, snapshotsBytes } from './snapshots.ts'
+import { detectTimelineIssues } from './timeline.ts'
+import { buildCurveData, detectTensionIssues, TENSION_MAX, TENSION_MIN, TENSION_PRESETS, clampTension } from './tension.ts'
+import { PROMPT_SLOTS, normalizeSlotValue, readPromptSlots } from './prompt-slots.ts'
+import { buildRevisionPlan, describeRevisionPlan, REVISION_ITEM_CAP } from './revision.ts'
+import { dshHomePath } from './home.ts'
 
 /** Cap on JSON request bodies (generous: cover images travel as base64). */
 const MAX_JSON_BODY_BYTES = 64 * 1024 * 1024
 
 /** 包内置风格效果图目录（assets/styles，随 npm 包分发）。 */
-const builtinStyleDir = fileURLToPath(new URL('../assets/styles/', import.meta.url))
+
+/** 解析请求级目标书目录：优先按请求携带的 bookId 查书架，否则回退全局 active 书目录。 */
+function resolveOutputDir(config: NovelConfig, bookId?: string): string {
+  if (bookId !== undefined && bookId !== '') {
+    const book = loadBookshelf().books.find(b => b.id === bookId)
+    if (book !== undefined && book.outputDir !== '') return book.outputDir
+  }
+  return config.outputDir
+}
 
 /** Loopback-only fence (mirrors the family plugins' pairing routes). */
 function isLoopbackRequest(request: IncomingMessage): boolean {
@@ -270,13 +288,29 @@ export interface NovelRoutesDeps {
   ctx: Context
   /** Resolve the live plugin config (settings-aware). */
   getConfig: () => NovelConfig
-  /** Persist a config patch through the settings seam. */
-  patchConfig: (patch: ConfigPatch) => Promise<NovelConfig>
+  /** Persist a config patch through the settings seam (memory fallback included). */
+  patchConfig: (patch: ConfigPatch) => Promise<ConfigResponse>
+  /** Raw settings config（未与激活书合并）——目录迁移判断默认目录是否需同步用。 */
+  rawConfig?: () => { outputDir?: string }
+  /** Loader entry id the settings section is addressed by (undefined when unknown). */
+  settingsNs?: string
 }
 
 /** Default chapter count for planning when the request omits it. */
 const DEFAULT_PLAN_COUNT = 30
 
+/**
+ * The profile this host booted (`--profile <name>` on the dsh CLI invocation).
+ * Profile-scoped paths must not assume a name: the shipped template is `web`,
+ * but a custom profile (`web-alpha`) is the one actually running.
+ * @returns the profile name, or undefined when the flag is absent.
+ */
+function argvProfile(): string | undefined {
+  const flag = process.argv.indexOf('--profile')
+  const value = flag === -1 ? undefined : process.argv[flag + 1]
+  return value !== undefined && !value.startsWith('-') ? value : undefined
+}
+
 /**
  * Build every /api/dsh-novel-forge route.
  * @param deps - context, config resolver, config patcher.
@@ -285,6 +319,13 @@ const DEFAULT_PLAN_COUNT = 30
 export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
   const { ctx, getConfig, patchConfig } = deps
 
+  /**
+   * 新书默认目录的基准：settings 里配置的输出目录（未经激活书合并，激活书的
+   * outputDir 指向它自己，不能当作新书的父目录）。未配置时 `defaultOutputDirFor`
+   * 回退到 `<DSH_HOME>/novels`。
+   */
+  const defaultBookDir = (bookName: string): string => defaultOutputDirFor(bookName, deps.rawConfig?.().outputDir)
+
   /** 全书质检实时状态（内存态，重启后回到 idle；用于 /status 暴露进度）。 */
   let auditState: AuditStatus = { status: 'idle', totalBatches: 0, completedBatches: 0 }
 
@@ -321,9 +362,11 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     handler: (req, res) => {
       if (!guard(req, res, 'GET')) return
       const config = getConfig()
+      const qurl = new URL(req.url ?? '/', 'http://localhost')
+      const outputDir = resolveOutputDir(config, qurl.searchParams.get('bookId') ?? undefined)
       // 书架为空时播种 settings 默认输出目录里的已有项目。
-      seedBookshelfFromOutputDir(config.outputDir)
-      const project = loadProject(config.outputDir)
+      seedBookshelfFromOutputDir(outputDir)
+      const project = loadProject(outputDir)
       if (project !== undefined) {
         // 自动兜底：generating 超过 10 分钟（正常一章 2-5 分钟）视为卡死/中断，
         // 复位为 pending，避免"生成中"状态卡死无法重新生成。
@@ -338,14 +381,18 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
             }
           }
         }
-        syncProjectWithDisk(project, config.outputDir)
-        saveProject(config.outputDir, project)
+        syncProjectWithDisk(project, outputDir)
+        saveProject(outputDir, project)
       }
       const slim = new URL(req.url ?? '/', 'http://localhost').searchParams.get('slim') === '1'
+      // 截断显式化：任何被裁掉的字段都要在响应里声明，客户端/模型不能
+      // 把"看到的"当成"全部"。静默截断会让一致性判断建立在不完整事实上。
+      const truncations: string[] = []
       let projectPayload: StatusResponse['project']
       if (project === undefined) {
         projectPayload = undefined
       } else if (slim) {
+        truncations.push('slim=1：正文/beats/图集/道藏/大世界/资产等重字段未返回，大纲仅返回前 200 字')
         // slim 瘦身：轮询/角标只需章节状态与分数 + 轻量元数据，
         // 去掉正文、beats、图集（base64）、道藏/大世界/资产等重字段，避免长书轮询反复传输大体积。
         projectPayload = {
@@ -366,13 +413,23 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
       } else {
         // 瘦身：facts 只回最近 80 条（客户端最多展示 60），避免长篇后
         // status 响应体随编年录无限膨胀。
-        projectPayload = { ...project, facts: (project.facts ?? []).slice(-80) }
+        const allFacts = project.facts ?? []
+        const shownFacts = allFacts.slice(-80)
+        if (allFacts.length > shownFacts.length) {
+          truncations.push(`编年录：共 ${allFacts.length} 条，仅返回最近 ${shownFacts.length} 条（较早 ${allFacts.length - shownFacts.length} 条未返回）`)
+        }
+        projectPayload = { ...project, facts: shownFacts }
       }
       const response: StatusResponse = {
         config,
         project: projectPayload,
         generatedFiles: listChapterFiles(config.outputDir),
         audit: auditState,
+        // 阶段契约：宿主算一次，面板角标、助手提示词、外部自动化共用同一结论。
+        stage: computeBookStage(project),
+        // 本次运行（进程内）的 LLM 用量：调用次数 / 输入·输出·思考 token / 耗时。
+        usage: liveUsage(),
+        ...(truncations.length > 0 ? { truncations } : {}),
       }
       writeJson(res, 200, response)
     },
@@ -477,9 +534,11 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.volumes,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const body = await readJsonBody<VolumesRequest>(req)
-      const config = getConfig()
-      const project = loadProject(config.outputDir)
+      const body = await readJsonBody<VolumesRequest & { bookId?: string }>(req)
+      const config0 = getConfig()
+      const outputDir = resolveOutputDir(config0, body?.bookId)
+      const config = { ...config0, outputDir }
+      const project = loadProject(outputDir)
       const outline = body?.outline?.trim() !== '' && body?.outline !== undefined
         ? body.outline
         : project?.outline
@@ -493,7 +552,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         const next = project ?? createProject(outline)
         next.volumes = volumes
         next.updatedAt = now
-        saveProject(config.outputDir, next)
+        saveProject(outputDir, next)
         const response: VolumesResponse = { volumes }
         writeJson(res, 200, response)
       } catch (error) {
@@ -508,9 +567,11 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.plan,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const body = await readJsonBody<PlanRequest>(req)
-      const config = getConfig()
-      const project = loadProject(config.outputDir)
+      const body = await readJsonBody<PlanRequest & { bookId?: string }>(req)
+      const config0 = getConfig()
+      const outputDir = resolveOutputDir(config0, body?.bookId)
+      const config = { ...config0, outputDir }
+      const project = loadProject(outputDir)
       const outline = body?.outline?.trim() !== '' && body?.outline !== undefined
         ? body.outline
         : project?.outline
@@ -546,10 +607,15 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.generate,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<{ chapterNo?: number; skipReview?: boolean }>(req)
+      const config0 = getConfig()
+      const body = await readJsonBody<GenerateRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config0, body?.bookId)
+      const config = { ...config0, outputDir }
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
       const rawNo = body?.chapterNo
       if (!Number.isInteger(rawNo) || rawNo === undefined || rawNo < 1) {
         writeJson(res, 400, { error: 'chapterNo 须为正整数' })
@@ -584,21 +650,38 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         res.write(JSON.stringify(frame) + '\n')
       }
 
+      const liveSession = nextSessionId()
+      emitLive({ type: 'session_started', sessionId: liveSession, label: '正文生成', model: config.generateModel || config.model, at: new Date().toISOString(), context: { interactionId: liveSession, taskId: `ch-${no}` } })
+      emitLive({ type: 'phase_changed', sessionId: liveSession, phase: 'streaming', phaseMessage: '模型正在返回正文', at: new Date().toISOString() })
+
       try {
         send({ type: 'start', no, title: chapter.title })
+        let genChars = 0
         for await (const step of generateChapterStream(ctx, config, project, config.outputDir, no)) {
           if (step.frame === 'delta') {
             send({ type: 'delta', text: step.text })
+            genChars += step.text.length
+            emitLive({ type: 'output_delta', sessionId: liveSession, content: step.text, totalChars: genChars, at: new Date().toISOString() })
           } else if (step.frame === 'done') {
             send({ type: 'done', no, file: step.file, chars: step.chars, title: chapter.title, warn: step.warn })
           }
         }
-        // Auto pipeline: summary + facts（一次调用）-> review（unless skipped）。
+        emitLive({ type: 'session_completed', sessionId: liveSession, totalChars: genChars, preview: '', at: new Date().toISOString(), phase: 'completed' })
+        // Auto pipeline: summary + facts（一次调用）-> timeline -> review（unless skipped）。
         try {
           await summarizeAndExtractFacts(ctx, config, project, config.outputDir, no)
         } catch (error) {
           console.warn('[dsh-novel-forge] summary/facts failed:', (error as Error).message)
         }
+        // 故事时间线：抽取本章事件（失败不阻断出章，作者可在时间线页手工补）。
+        if (config.autoTimeline ?? true) {
+          try {
+            await extractTimelineForChapter(ctx, config, project, config.outputDir, no)
+            saveProject(config.outputDir, project)
+          } catch (error) {
+            console.warn('[dsh-novel-forge] timeline extract failed:', (error as Error).message)
+          }
+        }
         // 伏笔落地标记：正文中命中 planned 伏笔关键词 → 自动标为 planted（暗线管理页与正文同步）。
         try {
           const marked = markForeshadowPlanted(project, config.outputDir, no)
@@ -662,17 +745,22 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.review,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<ReviewRequest>(req)
+      const config0 = getConfig()
+      const body = await readJsonBody<ReviewRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config0, body?.bookId)
+      const config = { ...config0, outputDir }
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
       if (!Number.isInteger(body?.chapterNo)) {
         writeJson(res, 400, { error: 'chapterNo 须为正整数' })
         return
       }
       const no = body!.chapterNo!
       try {
-        const report = await reviewChapter(ctx, config, project, config.outputDir, no)
+        const report = await reviewChapter(ctx, config, project, outputDir, no)
         writeJson(res, 200, { report })
       } catch (error) {
         writeJson(res, 500, { error: (error as Error).message })
@@ -686,10 +774,15 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.rewrite,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<RewriteRequest>(req)
+      const config0 = getConfig()
+      const body = await readJsonBody<RewriteRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config0, body?.bookId)
+      const config = { ...config0, outputDir }
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
       if (!Number.isInteger(body?.chapterNo)) {
         writeJson(res, 400, { error: 'chapterNo 须为正整数' })
         return
@@ -725,10 +818,15 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.polish,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<PolishRequest>(req)
+      const config0 = getConfig()
+      const body = await readJsonBody<PolishRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config0, body?.bookId)
+      const config = { ...config0, outputDir }
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
       if (!Number.isInteger(body?.chapterNo)) {
         writeJson(res, 400, { error: 'chapterNo 须为正整数' })
         return
@@ -790,7 +888,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
       }
       writeFileSync(targetPath, `# 第${chapter.no}章 ${chapter.title}\n\n${draft}\n`, 'utf8')
       chapter.pendingDraft = undefined
-      chapter.chars = draft.length
+      chapter.chars = countHanzi(draft)
       chapter.file = fileName
       // 携带审查报告则沿用结论定状态（修订后审查通过 → approved）；否则置 written 待审。
       const carried = body?.report
@@ -865,10 +963,15 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.foreshadow,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<ForeshadowRequest>(req)
+      const config0 = getConfig()
+      const body = await readJsonBody<ForeshadowRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config0, body?.bookId)
+      const config = { ...config0, outputDir }
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
       try {
         if (body?.suggest === true) {
           // AI suggestion pass: create several foreshadows from the outline.
@@ -922,14 +1025,21 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.exportBook,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<ExportRequest>(req)
-      const format = body?.format === 'md' ? 'md' : 'txt'
+      const config0 = getConfig()
+      const body = await readJsonBody<ExportRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config0, body?.bookId)
+      const config = { ...config0, outputDir }
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
+      const format: 'txt' | 'md' | 'json' = body?.format === 'json' ? 'json' : body?.format === 'md' ? 'md' : 'txt'
+      // 导出范围：整本正文 / 设定 / 规划 / 角色 / 质检记录 / 项目 JSON。
+      const scope: ExportScope = body?.scope !== undefined && EXPORT_SCOPE_VALUES.includes(body.scope) ? body.scope : 'book'
       try {
-        const result = exportBook(config.outputDir, project, format)
-        const response: ExportResponse = { ...result }
+        const result = exportScope(config.outputDir, project, scope, format)
+        const response: ExportResponse = { ...result, scope, format }
         writeJson(res, 200, response)
       } catch (error) {
         writeJson(res, 500, { error: (error as Error).message })
@@ -944,9 +1054,13 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     handler: async (req, res) => {
       if (!guard(req, res, 'GET')) return
       const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
       const url = new URL(req.url ?? '/', 'http://localhost')
+      const outputDir = resolveOutputDir(config, url.searchParams.get('bookId') ?? undefined)
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
       const rawNo = Number(url.searchParams.get('no') ?? '0')
       if (!Number.isInteger(rawNo) || rawNo < 1) {
         writeJson(res, 400, { error: 'no 须为正整数' })
@@ -957,7 +1071,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         writeJson(res, 404, { error: `章节 ${rawNo} 不在计划中` })
         return
       }
-      const markdown = readChapterFile(config.outputDir, chapter)
+      const markdown = readChapterFile(outputDir, chapter)
       if (markdown === undefined) {
         writeJson(res, 404, { error: `章节 ${rawNo} 尚未生成` })
         return
@@ -1023,9 +1137,11 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
       if (existsSync(targetPath)) {
         copyFileSync(targetPath, join(config.outputDir, `${fileName.replace(/\.md$/, '')}.bak.md`))
       }
+      // 覆盖前留一份历史版本：采纳草稿改坏了可以回滚。
+      createSnapshot(config.outputDir, chapter, '采纳草稿前')
       writeFileSync(targetPath, `# 第${chapter.no}章 ${chapter.title}\n\n${text}\n`, 'utf8')
       chapter.status = 'written'
-      chapter.chars = text.length
+      chapter.chars = countHanzi(text)
       chapter.file = fileName
       chapter.pendingDraft = undefined
       // 保存即审稿：携带工作区审查报告则沿用（不重复审）；否则自动正式审稿一次。
@@ -1052,9 +1168,13 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
       const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<AssistantRequest>(req)
+      const body = await readJsonBody<AssistantRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
       const message = body?.message?.trim()
       if (message === undefined || message === '') {
         writeJson(res, 400, { error: '消息不能为空' })
@@ -1068,10 +1188,11 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
       })
       const send = (frame: AssistantFrame): void => { res.write(JSON.stringify(frame) + '\n') }
       try {
-        for await (const step of runAssistantTurn(ctx, config, project, config.outputDir, message)) {
+        for await (const step of runAssistantTurn(ctx, config, project, outputDir, message)) {
           if (step.frame === 'delta') send({ type: 'delta', text: step.text })
           else if (step.frame === 'tool') send({ type: 'tool', name: step.name, status: step.status, detail: step.detail })
           else if (step.frame === 'toolDelta') send({ type: 'toolDelta', name: step.name, text: step.text })
+          else if (step.frame === 'toolResult') send({ type: 'toolResult', name: step.name, text: step.text })
         }
         send({ type: 'done' })
         res.end()
@@ -1091,7 +1212,9 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     handler: (req, res) => {
       if (!guard(req, res, 'GET')) return
       const config = getConfig()
-      const response: AssistantHistoryResponse = { messages: loadAssistantHistory(config.outputDir) }
+      const qurl = new URL(req.url ?? '/', 'http://localhost')
+      const outputDir = resolveOutputDir(config, qurl.searchParams.get('bookId') ?? undefined)
+      const response: AssistantHistoryResponse = { messages: loadAssistantHistory(outputDir) }
       writeJson(res, 200, response)
     },
   }
@@ -1101,10 +1224,12 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
   const assistantClearRoute: WebRoute = {
     kind: 'exact',
     path: NOVEL_API.assistantClear,
-    handler: (req, res) => {
+    handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
       const config = getConfig()
-      clearAssistantHistory(config.outputDir)
+      const body = await readJsonBody<{ bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      clearAssistantHistory(outputDir)
       writeJson(res, 200, { ok: true })
     },
   }
@@ -1125,10 +1250,21 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         return
       }
       const config = getConfig()
-      const project = loadProject(config.outputDir)
-      const projectAssets = project?.assets ?? emptyProjectAssets()
+      let postBody: (AssetsPatch & { bookId?: string }) | undefined
+      if (req.method === 'POST') {
+        postBody = await readJsonBody<AssetsPatch & { bookId?: string }>(req)
+        if (postBody === undefined) {
+          writeJson(res, 400, { error: '无效的 JSON' })
+          return
+        }
+      }
+      const qurl = new URL(req.url ?? '/', 'http://localhost')
+      const queryBookId = qurl.searchParams.get('bookId') ?? undefined
+      const outputDir = resolveOutputDir(config, postBody?.bookId ?? queryBookId)
+      const project = loadProject(outputDir)
+      const projectAssets = ensureBuiltinAssets(project?.assets ?? emptyProjectAssets())
       if (req.method === 'POST') {
-        const body = await readJsonBody<AssetsPatch>(req)
+        const body = postBody
         if (body === undefined) {
           writeJson(res, 400, { error: '无效的 JSON' })
           return
@@ -1145,14 +1281,15 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         projectAssets.updatedAt = new Date().toISOString()
         project.assets = projectAssets
         project.updatedAt = new Date().toISOString()
-        saveProject(config.outputDir, project)
+        saveProject(outputDir, project)
       }
       const response: AssetsResponse = {
         projectAssets,
-        genreLibrary: BUILTIN_GENRE_LIBRARY,
+        genreLibrary: [...BUILTIN_GENRE_LIBRARY, ...globalGenreLibrary()],
         antiAiLibrary: BUILTIN_ANTI_AI_RULES,
         styleTemplates: BUILTIN_STYLE_TEMPLATES,
-        progressionLibrary: BUILTIN_PROGRESSION_MODES,
+        progressionLibrary: [...BUILTIN_PROGRESSION_MODES, ...globalProgressionLibrary()],
+        starterStyleProfiles: BUILTIN_STARTER_STYLE_PROFILES,
         plotBeatLibrary: BUILTIN_PLOT_BEATS,
       }
       writeJson(res, 200, response)
@@ -1197,161 +1334,885 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     },
   }
 
-  // ------------------------------------------------------------- bookshelf
-  const bookshelfRoute: WebRoute = {
+  // ----------------------------------------------------------- style-formula
+  const styleFormulaRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.bookshelf,
+    path: NOVEL_API.styleFormula,
     handler: async (req, res) => {
-      // GET = snapshot; POST = create book.
-      if (req.method === 'GET') {
-        if (!isLoopbackRequest(req)) {
-          writeJson(res, 403, { error: 'forbidden: loopback-only' })
-          return
-        }
-        // 书架为空时，把 settings 默认输出目录里已有的项目播种为第一本书。
-        seedBookshelfFromOutputDir(getConfig().outputDir)
-        const snapshot: BookshelfSnapshot = bookshelfSnapshot(loadBookshelf())
-        writeJson(res, 200, snapshot)
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const project = loadProject(config.outputDir)
+      const body = await readJsonBody<StyleEngineRequest & { depth?: string }>(req)
+      const sample = body?.sampleText?.trim()
+      if (sample === undefined || sample.length < 50) {
+        writeJson(res, 400, { error: '样本文本过短（<50 字符），请粘贴一段能代表目标风格的文字' })
         return
       }
-      if (req.method === 'POST') {
-        if (!isLoopbackRequest(req)) {
-          writeJson(res, 403, { error: 'forbidden: loopback-only' })
-          return
-        }
-        const body = await readJsonBody<BookCreateRequest>(req)
-        const bookName = body?.bookName?.trim()
-        if (bookName === undefined || bookName === '') {
-          writeJson(res, 400, { error: 'bookName 不能为空' })
-          return
-        }
-        const outputDir = body?.outputDir?.trim() !== '' && body?.outputDir !== undefined
-          ? body.outputDir
-          : defaultOutputDirFor(bookName)
-        const book = createBook(bookName, outputDir)
-        // 开书向导：创建时带大纲 → 立即建立项目（书名以大纲首行为准）。
-        const outline = body?.outline?.trim()
-        if (outline !== undefined && outline.length >= 50) {
-          const project = createProject(outline)
-          saveProject(outputDir, project)
-          renameBook(book.id, project.bookName)
+      const depth = (['basic', 'standard', 'deep'] as const).includes(body?.depth as never)
+        ? body!.depth! as 'basic' | 'standard' | 'deep'
+        : 'standard'
+      try {
+        const formula = await extractStyleFormula(ctx, config, sample, depth)
+        const key = `sf-${Date.now().toString(36)}`
+        const styleFormula = { key, ...formula, depth, createdAt: new Date().toISOString() }
+        if (project !== undefined) {
+          project.assets ??= emptyProjectAssets()
+          project.assets.styleFormulas ??= []
+          project.assets.styleFormulas.push(styleFormula)
+          project.assets.updatedAt = new Date().toISOString()
+          project.updatedAt = new Date().toISOString()
+          saveProject(config.outputDir, project)
         }
-        writeJson(res, 200, bookshelfSnapshot(loadBookshelf()))
+        writeJson(res, 200, { styleFormula })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ----------------------------------------------------------- style-detect
+  /** 正文实时 AI 味检测（本地确定性扫描，免 LLM）。 */
+  const styleDetectRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.styleDetect,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<{ text?: string }>(req)
+      const text = body?.text?.trim() ?? ''
+      if (text.length < 20) {
+        writeJson(res, 400, { error: '文本过短（<20 字符）' })
         return
       }
-      writeJson(res, 405, { error: 'method not allowed (expected GET or POST)' })
+      const scan = scanAiFlavor(text.slice(0, 20000))
+      writeJson(res, 200, { scan })
     },
   }
 
-  // --------------------------------------------------------------- reset
-  /** 重置项目：清空设定/卷/章节计划/正文/伏笔/资产/事实库（可携带新大纲）。 */
-  const resetRoute: WebRoute = {
+  // --------------------------------------------------------- market-radar
+  /** 热门题材雷达：输入平台/题材/榜单文本 → 信号 + 生产底座 + 开书创意。 */
+  const marketRadarRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.reset,
+    path: NOVEL_API.marketRadar,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
       const config = getConfig()
-      const project = loadProject(config.outputDir)
+      const body = await readJsonBody<MarketRadarRequest>(req)
+      try {
+        const result = await runMarketRadar(ctx, config, body ?? {})
+        writeJson(res, 200, { result })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ------------------------------------------------- market-radar scan
+  /** 真实榜单扫榜：抓取公开榜单（容错），返回分组候选。 */
+  const marketRadarScanRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.marketRadarScan,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<{ platforms?: string[] }>(req)
+      try {
+        const result = await scanMarketRanking(body?.platforms)
+        writeJson(res, 200, { result })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ------------------------------------------------- market-radar apply
+  /** 把雷达生产底座一键应用到某本书（写入项目资产/开书定盘，供后续规划与生成遵守）。 */
+  const marketRadarApplyRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.marketRadarApply,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<{ bookId?: string; foundation?: ProductionFoundation }>(req)
+      const pf = body?.foundation
+      if (pf === undefined) {
+        writeJson(res, 400, { error: '缺少 foundation' })
+        return
+      }
+      const config = getConfig()
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
       if (project === undefined) {
-        writeJson(res, 400, { error: '输出目录中没有项目，无需重置' })
+        writeJson(res, 400, { error: '输出目录中没有项目' })
         return
       }
-      const body = await readJsonBody<ResetRequest>(req)
-      const outline = body?.outline?.trim()
-      if (outline !== undefined && outline.length >= 50) {
-        project.outline = outline
-        project.bookName = createProject(outline).bookName
+      const genreBuiltin = BUILTIN_GENRE_LIBRARY.find(g => g.name === (pf.genre.existingId || pf.genre.name))
+      const genreNode: GenreNode = genreBuiltin !== undefined
+        ? { ...genreBuiltin }
+        : { name: pf.genre.name.slice(0, 40), description: pf.genre.description, template: pf.genre.template, children: [] }
+      const findMode = (m: { existingId?: string; name: string }): ProgressionMode | undefined => BUILTIN_PROGRESSION_MODES.find(x => x.name === (m.existingId || m.name))
+      const primary = findMode(pf.primaryStoryMode) ?? {
+        name: pf.primaryStoryMode.name.slice(0, 40),
+        driver: pf.primaryStoryMode.driver,
+        readerExpectation: pf.primaryStoryMode.readerExpectation,
+        payoffs: [],
+        risks: [],
+        primary: true,
+      }
+      const aux: ProgressionMode[] = []
+      if (pf.secondaryStoryMode !== undefined) {
+        const sec = findMode(pf.secondaryStoryMode) ?? {
+          name: pf.secondaryStoryMode.name.slice(0, 40),
+          driver: pf.secondaryStoryMode.driver,
+          readerExpectation: pf.secondaryStoryMode.readerExpectation,
+          payoffs: [],
+          risks: [],
+          primary: false,
+        }
+        aux.push(sec)
+      }
+      project.assets ??= emptyProjectAssets()
+      project.assets.genre = genreNode
+      project.assets.primaryProgression = primary
+      project.assets.auxiliaryProgressions = aux
+      project.bookContract = {
+        promise: pf.genre.description.slice(0, 120),
+        primaryModeName: pf.primaryStoryMode.name,
+        secondaryModeNames: pf.secondaryStoryMode !== undefined ? [pf.secondaryStoryMode.name] : [],
+        tone: pf.genre.template,
+        targetPlatform: undefined,
       }
-      project.bible = undefined
-      project.volumes = undefined
-      project.chapters = []
-      project.foreshadows = []
-      project.assets = emptyProjectAssets()
-      project.facts = []
       project.updatedAt = new Date().toISOString()
-      saveProject(config.outputDir, project)
+      saveProject(outputDir, project)
       writeJson(res, 200, { ok: true, bookName: project.bookName })
     },
   }
 
-  // --------------------------------------------------- bookshelf activate
-  const bookshelfActivateRoute: WebRoute = {
+  // ------------------------------------------------- market-radar sync
+  /** 把雷达生产底座里的「新资产」同步进全局资源库（跨书复用；已有名字跳过）。 */
+  const marketRadarSyncRoute: WebRoute = {
     kind: 'exact',
-    path: '/api/dsh-novel-forge/bookshelf/activate',
+    path: NOVEL_API.marketRadarSync,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const body = await readJsonBody<BookActivateRequest>(req)
-      if (body?.id === undefined || body.id === '') {
-        writeJson(res, 400, { error: 'id 不能为空' })
+      const body = await readJsonBody<{ foundation?: ProductionFoundation }>(req)
+      const pf = body?.foundation
+      if (pf === undefined) {
+        writeJson(res, 400, { error: '缺少 foundation' })
         return
       }
-      const book = activateBook(body.id)
-      if (book === undefined) {
-        writeJson(res, 404, { error: `书 ${body.id} 不存在` })
-        return
+      const synced = { genre: false, primaryMode: false, secondaryMode: false }
+      if (pf.genre.existingId === undefined && pf.genre.name !== '') {
+        synced.genre = addGlobalGenre({ name: pf.genre.name.slice(0, 40), description: pf.genre.description, template: pf.genre.template, children: [] })
       }
-      writeJson(res, 200, bookshelfSnapshot(loadBookshelf()))
+      if (pf.primaryStoryMode.existingId === undefined && pf.primaryStoryMode.name !== '') {
+        synced.primaryMode = addGlobalMode({ name: pf.primaryStoryMode.name.slice(0, 40), driver: pf.primaryStoryMode.driver, readerExpectation: pf.primaryStoryMode.readerExpectation, payoffs: [], risks: [], primary: true })
+      }
+      if (pf.secondaryStoryMode !== undefined && pf.secondaryStoryMode !== null && pf.secondaryStoryMode.existingId === undefined && pf.secondaryStoryMode.name !== '') {
+        synced.secondaryMode = addGlobalMode({ name: pf.secondaryStoryMode.name.slice(0, 40), driver: pf.secondaryStoryMode.driver, readerExpectation: pf.secondaryStoryMode.readerExpectation, payoffs: [], risks: [], primary: false })
+      }
+      writeJson(res, 200, { ok: true, synced })
     },
   }
 
-  // ---------------------------------------------------- bookshelf remove
-  const bookshelfRemoveRoute: WebRoute = {
+  // ------------------------------------------------- market-radar brief
+  /** 开书创意简报：用选中的市场信号 + 影响模式生成。 */
+  const marketRadarBriefRoute: WebRoute = {
     kind: 'exact',
-    path: '/api/dsh-novel-forge/bookshelf/remove',
+    path: NOVEL_API.marketRadarBrief,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const body = await readJsonBody<BookRemoveRequest>(req)
-      if (body?.id === undefined || body.id === '') {
-        writeJson(res, 400, { error: 'id 不能为空' })
+      const config = getConfig()
+      const body = await readJsonBody<MarketRadarBriefRequest>(req)
+      if (body === undefined || body.influenceMode === undefined) {
+        writeJson(res, 400, { error: '缺少 influenceMode' })
         return
       }
-      const removed = removeBook(body.id)
-      if (!removed) {
-        writeJson(res, 404, { error: `书 ${body.id} 不存在` })
+      try {
+        const creativeBrief = await runMarketCreativeBrief(ctx, config, body)
+        writeJson(res, 200, { creativeBrief })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ------------------------------------------------------------- knowledge
+  /** 书内知识库：GET 读取 / POST 增删改（按书路由）。 */
+  const knowledgeRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.knowledge,
+    handler: async (req, res) => {
+      if (req.method === 'POST') {
+        if (!guard(req, res, 'POST')) return
+      } else {
+        if (!guard(req, res, 'GET')) return
+      }
+      const config = getConfig()
+      const qurl = new URL(req.url ?? '/', 'http://localhost')
+      const body = req.method === 'POST' ? await readJsonBody<KnowledgeRequest & { bookId?: string }>(req) : undefined
+      const outputDir = resolveOutputDir(config, body?.bookId ?? qurl.searchParams.get('bookId') ?? undefined)
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
         return
       }
-      writeJson(res, 200, bookshelfSnapshot(loadBookshelf()))
+      project.knowledgeDocs ??= []
+      if (req.method === 'POST' && body !== undefined) {
+        if (body.action === 'add' && body.doc !== undefined) {
+          project.knowledgeDocs.push({ id: body.doc.id ?? `kd-${Date.now().toString(36)}`, title: body.doc.title, content: body.doc.content, updatedAt: new Date().toISOString() })
+        } else if (body.action === 'remove' && body.id !== undefined) {
+          project.knowledgeDocs = project.knowledgeDocs.filter(d => d.id !== body.id)
+        } else if (body.action === 'replace' && body.doc !== undefined) {
+          project.knowledgeDocs = project.knowledgeDocs.map(d => d.id === body.doc!.id ? { ...d, title: body.doc!.title, content: body.doc!.content, updatedAt: new Date().toISOString() } : d)
+        }
+        project.updatedAt = new Date().toISOString()
+        saveProject(outputDir, project)
+      }
+      writeJson(res, 200, { docs: project.knowledgeDocs })
     },
   }
 
-  // ------------------------------------------- bookshelf import-dir
-  /** 导入已有项目目录（Mode A）：校验 novel-project.json，登记/激活书架。 */
-  const bookshelfImportDirRoute: WebRoute = {
+  // ---------------------------------------------------------- book-analysis
+  /** 书分析/拆书：输入文本 → 卖点/结构/可借鉴点/风险。 */
+  const bookAnalysisRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.bookshelfImportDir,
+    path: NOVEL_API.bookAnalysis,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const body = await readJsonBody<BookImportDirRequest>(req)
-      const outputDir = body?.outputDir?.trim()
-      if (outputDir === undefined || outputDir === '') {
-        writeJson(res, 400, { error: 'outputDir 不能为空' })
+      const config = getConfig()
+      const body = await readJsonBody<BookAnalysisRequest>(req)
+      if (body === undefined || (body.text ?? '').trim().length < 50) {
+        writeJson(res, 400, { error: '文本过短（<50 字符）' })
         return
       }
       try {
-        const { book, existed } = importDir(outputDir)
-        writeJson(res, 200, { book, existed })
-      } catch (err) {
-        writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) })
+        const result = await runBookAnalysis(ctx, config, body)
+        writeJson(res, 200, { result })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
       }
     },
   }
 
-  // ------------------------------------------- bookshelf import-text
-  /** 导入 txt/md 全本（Mode B）：拆章落盘建项目，登记书架。支持浏览器上传（text+fileName）与服务器本地文件（filePath）两种模式。 */
-  const bookshelfImportTextRoute: WebRoute = {
+  // ---------------------------------------------------------- idea-inspiration
+  /** 创意灵感：一句话/题材 → 多方向开书灵感。 */
+  const ideaInspirationRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.bookshelfImportText,
+    path: NOVEL_API.ideaInspiration,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const body = await readJsonBody<BookImportTextRequest>(req)
+      const config = getConfig()
+      const body = await readJsonBody<IdeaInspirationRequest>(req)
+      if (body === undefined || (body.idea ?? '').trim().length < 2) {
+        writeJson(res, 400, { error: '请填写你的方向/一句话想法' })
+        return
+      }
       try {
-        // 模式二：浏览器上传全文内容
-        if (body?.text !== undefined && body.text.length > 0) {
-          const bookName = (body.fileName ?? '').replace(/\.[^.]+$/, '').trim().slice(0, 40) || '导入小说'
-          const outDir = body?.outputDir?.trim() !== undefined && body.outputDir.trim() !== ''
-            ? body.outputDir.trim()
-            : defaultOutputDirFor(bookName)
-          const result = importBookTextFromText(body.text, outDir, bookName)
+        const result = await runIdeaInspiration(ctx, config, body)
+        writeJson(res, 200, { result })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ------------------------------------------------------- idea-inspiration/market
+  /** 雷达→灵感：基于市场信号/生产底座/创意简报生成开书灵感。 */
+  const marketIdeaInspirationRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.ideaInspirationMarket,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const body = await readJsonBody<{ signals?: import('./protocol.ts').MarketRadarSignal[]; foundation?: import('./protocol.ts').ProductionFoundation; brief?: import('./protocol.ts').MarketCreativeBrief; count?: number }>(req)
+      if (body === undefined) {
+        writeJson(res, 400, { error: '缺少市场分析参数' })
+        return
+      }
+      try {
+        const result = await runMarketIdeaInspiration(ctx, config, body)
+        writeJson(res, 200, { result })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ------------------------------------------------------------- director
+  /** 自动导演编排建议：基于全书上下文。 */
+  const directorRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.director,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const body = await readJsonBody<DirectorRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
+      try {
+        const result = await runDirectorAdvice(ctx, config, project, body ?? {})
+        writeJson(res, 200, { result })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ------------------------------------------------------------- director/todos
+  /** 自动导演「采纳」出的书内待办：GET 读取 / POST 增删勾选（按书路由）。 */
+  const directorTodosRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.directorTodos,
+    handler: async (req, res) => {
+      type DirectorTodosReq = { op?: 'add' | 'toggle' | 'remove'; text?: string; source?: DirectorTodo['source']; id?: string; bookId?: string }
+      let body: DirectorTodosReq | undefined
+      if (req.method === 'POST') {
+        if (!guard(req, res, 'POST')) return
+        body = await readJsonBody<DirectorTodosReq>(req)
+      } else {
+        if (!guard(req, res, 'GET')) return
+      }
+      const config = getConfig()
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
+      project.todos ??= []
+      if (req.method === 'POST' && body !== undefined) {
+        if (body.op === 'add' && (body.text ?? '').trim() !== '') {
+          project.todos.unshift({ id: `td-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`, text: body.text!.trim(), source: body.source ?? 'fix', done: false, createdAt: new Date().toISOString() })
+        } else if (body.op === 'toggle' && body.id !== undefined) {
+          project.todos = project.todos.map(t => t.id === body.id ? { ...t, done: !t.done } : t)
+        } else if (body.op === 'remove' && body.id !== undefined) {
+          project.todos = project.todos.filter(t => t.id !== body.id)
+        }
+        project.updatedAt = new Date().toISOString()
+        saveProject(outputDir, project)
+      }
+      writeJson(res, 200, { todos: project.todos })
+    },
+  }
+
+  // ------------------------------------------------------------- llm-live
+  /** AI 创作实况：订阅 LLM 实时事件流（NDJSON；订阅时先重放最近缓冲）。 */
+  const llmLiveRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.llmLive,
+    handler: async (req, res) => {
+      if (req.method !== 'GET') {
+        writeJson(res, 405, { error: 'GET only' })
+        return
+      }
+      if (!isLoopbackRequest(req)) {
+        writeJson(res, 403, { error: 'forbidden: loopback-only' })
+        return
+      }
+      res.writeHead(200, {
+        'content-type': 'text/event-stream; charset=utf-8',
+        'cache-control': 'no-cache',
+        'x-accel-buffering': 'no',
+        'referrer-policy': 'no-referrer',
+      })
+      const unsubscribe = subscribeLiveFeed((frame) => {
+        try { res.write('data: ' + JSON.stringify(frame) + '\n\n') } catch { /* client closed */ }
+      })
+      const hb = setInterval(() => { try { res.write(': ping\n\n') } catch { /* closed */ } }, 25000)
+      // 关键：让 handler 一直挂起，直到客户端关闭，避免 WebRoute 框架在 handler 返回后关闭响应。
+      await new Promise<void>((resolve) => {
+        res.on('close', () => {
+          clearInterval(hb)
+          unsubscribe()
+          resolve()
+        })
+      })
+    },
+  }
+
+  // --------------------------------------------------- llm-live prompt/usage
+  /** 查看某次调用实际发送的 Prompt（面板「查看 Prompt」按钮用）。 */
+  const llmPromptRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.llmPrompt,
+    handler: (req, res) => {
+      if (!guard(req, res, 'GET')) return
+      const qurl = new URL(req.url ?? '/', 'http://localhost')
+      const sessionId = qurl.searchParams.get('sessionId') ?? ''
+      const record = livePrompt(sessionId)
+      if (record === undefined) {
+        writeJson(res, 404, { error: '该调用的 Prompt 记录已过期（只保留最近 40 次调用）' })
+        return
+      }
+      writeJson(res, 200, record)
+    },
+  }
+
+  /** 清零本次运行的用量账本。 */
+  const usageResetRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.usageReset,
+    handler: (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      resetLiveUsage()
+      writeJson(res, 200, { ok: true, usage: liveUsage() })
+    },
+  }
+
+  // ------------------------------------------------------------- timeline
+  /**
+   * 故事时间线：GET 列表（含规则初筛问题）；POST op=extract|check|update|remove|clear。
+   */
+  const timelineRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.timeline,
+    handler: async (req, res) => {
+      const config = getConfig()
+      const qurl = new URL(req.url ?? '/', 'http://localhost')
+      if (req.method === 'GET') {
+        if (!isLoopbackRequest(req)) { writeJson(res, 403, { error: 'forbidden: loopback-only' }); return }
+        const outputDir = resolveOutputDir(config, qurl.searchParams.get('bookId') ?? undefined)
+        const project = loadProject(outputDir)
+        if (project === undefined) { writeJson(res, 400, { error: '输出目录中没有项目' }); return }
+        const response: TimelineResponse = {
+          events: project.timeline ?? [],
+          issues: detectTimelineIssues(project),
+        }
+        writeJson(res, 200, response)
+        return
+      }
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<TimelineRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
+      if (project === undefined) { writeJson(res, 400, { error: '输出目录中没有项目' }); return }
+      try {
+        if (body?.op === 'extract') {
+          const no = body.chapterNo
+          if (typeof no !== 'number' || !Number.isFinite(no)) { writeJson(res, 400, { error: 'extract 需要 chapterNo' }); return }
+          const events = await extractTimelineForChapter(ctx, config, project, outputDir, no)
+          saveProject(outputDir, project)
+          writeJson(res, 200, { events, all: project.timeline ?? [] })
+          return
+        }
+        if (body?.op === 'check') {
+          const ruleIssues = detectTimelineIssues(project)
+          let aiIssues: typeof ruleIssues = []
+          try {
+            aiIssues = await reviewTimeline(ctx, config, project)
+          } catch (error) {
+            // AI 复核失败不阻断：规则初筛结果照常返回，并说明原因。
+            writeJson(res, 200, { issues: ruleIssues, aiError: (error as Error).message })
+            return
+          }
+          writeJson(res, 200, { issues: [...ruleIssues, ...aiIssues] })
+          return
+        }
+        if (body?.op === 'update') {
+          const event = body.event
+          if (event === undefined || typeof event.id !== 'string') { writeJson(res, 400, { error: 'update 需要 event' }); return }
+          const list = project.timeline ?? []
+          const idx = list.findIndex(e => e.id === event.id)
+          if (idx === -1) { writeJson(res, 404, { error: '时间线事件不存在' }); return }
+          list[idx] = { ...event, source: 'manual' }
+          project.timeline = list
+          project.updatedAt = new Date().toISOString()
+          saveProject(outputDir, project)
+          writeJson(res, 200, { events: project.timeline })
+          return
+        }
+        if (body?.op === 'remove') {
+          project.timeline = (project.timeline ?? []).filter(e => e.id !== body.id)
+          project.updatedAt = new Date().toISOString()
+          saveProject(outputDir, project)
+          writeJson(res, 200, { events: project.timeline })
+          return
+        }
+        if (body?.op === 'clear') {
+          project.timeline = []
+          project.updatedAt = new Date().toISOString()
+          saveProject(outputDir, project)
+          writeJson(res, 200, { events: [] })
+          return
+        }
+        writeJson(res, 400, { error: `未知 op：${String(body?.op)}` })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ------------------------------------------------------------ revision plan
+  /** 修订指令合并：POST { op: 'plan', chapterNo, reviewIssues? } → 一份合并指令 + 验证基准。
+   *  面板与生产单共用，保证「同一章只改一轮」；张力/时间线问题默认只是建议（advisory）。 */
+  const revisionPlanRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.revisionPlan,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const body = await readJsonBody<RevisionPlanRequest>(req)
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
+      if (project === undefined) { writeJson(res, 400, { error: '输出目录中没有项目' }); return }
+      const chapterNo = body?.chapterNo
+      if (chapterNo !== undefined && !project.chapters.some(c => c.no === chapterNo)) {
+        writeJson(res, 404, { error: `章节 ${String(chapterNo)} 不在计划中` })
+        return
+      }
+      const chapter = chapterNo === undefined ? undefined : project.chapters.find(c => c.no === chapterNo)
+      try {
+        const plan = buildRevisionPlan(project, {
+          chapterNo,
+          reviewIssues: body?.reviewIssues,
+          includeTimeline: body?.includeTimeline,
+          includeTension: body?.includeTension,
+          baseReport: chapter?.review,
+          cap: REVISION_ITEM_CAP,
+        })
+        const response: RevisionPlanResponse = {
+          chapterNo: chapterNo ?? 0,
+          items: plan.items,
+          instruction: plan.instruction,
+          counts: plan.counts,
+          omitted: plan.omitted,
+          baseline: plan.baseline,
+          summary: describeRevisionPlan(plan),
+        }
+        writeJson(res, 200, response)
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ------------------------------------------------------------ snapshots
+  /** 章节历史版本：GET 列表；POST op=create|restore|remove|prune。 */
+  const snapshotRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.snapshot,
+    handler: async (req, res) => {
+      const config = getConfig()
+      const qurl = new URL(req.url ?? '/', 'http://localhost')
+      if (req.method === 'GET') {
+        if (!isLoopbackRequest(req)) { writeJson(res, 403, { error: 'forbidden: loopback-only' }); return }
+        const outputDir = resolveOutputDir(config, qurl.searchParams.get('bookId') ?? undefined)
+        const response: SnapshotResponse = { snapshots: loadSnapshots(outputDir), bytes: snapshotsBytes(outputDir) }
+        writeJson(res, 200, response)
+        return
+      }
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<SnapshotRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
+      try {
+        if (body?.op === 'create') {
+          if (project === undefined) { writeJson(res, 400, { error: '输出目录中没有项目' }); return }
+          const chapter = project.chapters.find(c => c.no === body.chapterNo)
+          if (chapter === undefined) { writeJson(res, 404, { error: `章节 ${String(body.chapterNo)} 不在计划中` }); return }
+          const snapshot = createSnapshot(outputDir, chapter, '手工存档')
+          if (snapshot === undefined) { writeJson(res, 400, { error: '该章暂无正文文件，无法存档' }); return }
+          writeJson(res, 200, { snapshot, snapshots: loadSnapshots(outputDir) })
+          return
+        }
+        if (body?.op === 'restore') {
+          if (project === undefined) { writeJson(res, 400, { error: '输出目录中没有项目' }); return }
+          const id = body.id ?? ''
+          const snap = loadSnapshots(outputDir).find(x => x.id === id)
+          if (snap === undefined) { writeJson(res, 404, { error: '快照不存在' }); return }
+          const chapter = project.chapters.find(c => c.no === snap.chapterNo)
+          if (chapter === undefined) { writeJson(res, 404, { error: `章节 ${snap.chapterNo} 不在计划中` }); return }
+          const chars = restoreSnapshot(outputDir, chapter, id)
+          chapter.chars = countHanzi(readChapterFile(outputDir, chapter) ?? '')
+          chapter.status = chapter.status === 'approved' ? 'written' : chapter.status
+          chapter.review = undefined
+          project.updatedAt = new Date().toISOString()
+          saveProject(outputDir, project)
+          writeJson(res, 200, { ok: true, chapterNo: chapter.no, chars, snapshots: loadSnapshots(outputDir) })
+          return
+        }
+        if (body?.op === 'remove') {
+          const ok = removeSnapshot(outputDir, body.id ?? '')
+          writeJson(res, ok ? 200 : 404, { ok, snapshots: loadSnapshots(outputDir) })
+          return
+        }
+        if (body?.op === 'prune') {
+          const removed = pruneSnapshots(outputDir, body.keep)
+          writeJson(res, 200, { removed, snapshots: loadSnapshots(outputDir), bytes: snapshotsBytes(outputDir) })
+          return
+        }
+        writeJson(res, 400, { error: `未知 op：${String(body?.op)}` })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // --------------------------------------------------------------- tension
+  /** 张力曲线：GET 数据（含规则核对）；POST op=preset|set|clear。 */
+  const tensionRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.tension,
+    handler: async (req, res) => {
+      const config = getConfig()
+      const qurl = new URL(req.url ?? '/', 'http://localhost')
+      if (req.method === 'GET') {
+        if (!isLoopbackRequest(req)) { writeJson(res, 403, { error: 'forbidden: loopback-only' }); return }
+        const outputDir = resolveOutputDir(config, qurl.searchParams.get('bookId') ?? undefined)
+        const project = loadProject(outputDir)
+        if (project === undefined) { writeJson(res, 400, { error: '输出目录中没有项目' }); return }
+        const curve = buildCurveData(project)
+        const response: TensionResponse = { preset: curve.preset, points: curve.points, issues: detectTensionIssues(project) }
+        writeJson(res, 200, response)
+        return
+      }
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<TensionRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
+      if (project === undefined) { writeJson(res, 400, { error: '输出目录中没有项目' }); return }
+      if (body?.op === 'preset') {
+        const preset = body.preset
+        if (preset === undefined || !TENSION_PRESETS.includes(preset)) { writeJson(res, 400, { error: '未知的张力曲线预设' }); return }
+        project.tensionCurve = { ...(project.tensionCurve ?? {}), preset }
+        project.updatedAt = new Date().toISOString()
+        saveProject(outputDir, project)
+        writeJson(res, 200, { ok: true, preset })
+        return
+      }
+      if (body?.op === 'set') {
+        const no = body.chapterNo
+        if (typeof no !== 'number' || !Number.isFinite(no)) { writeJson(res, 400, { error: 'set 需要 chapterNo' }); return }
+        const chapter = project.chapters.find(c => c.no === no)
+        if (chapter === undefined) { writeJson(res, 404, { error: `章节 ${no} 不在计划中` }); return }
+        if (body.tension === undefined) {
+          chapter.tension = undefined
+        } else {
+          if (body.tension < TENSION_MIN || body.tension > TENSION_MAX) { writeJson(res, 400, { error: `张力需在 ${TENSION_MIN}-${TENSION_MAX} 之间` }); return }
+          chapter.tension = clampTension(body.tension)
+        }
+        project.updatedAt = new Date().toISOString()
+        saveProject(outputDir, project)
+        writeJson(res, 200, { ok: true, chapterNo: no, tension: chapter.tension })
+        return
+      }
+      if (body?.op === 'clear') {
+        for (const c of project.chapters) c.tension = undefined
+        project.updatedAt = new Date().toISOString()
+        saveProject(outputDir, project)
+        writeJson(res, 200, { ok: true })
+        return
+      }
+      writeJson(res, 400, { error: `未知 op：${String(body?.op)}` })
+    },
+  }
+
+  // ---------------------------------------------------------- prompt slots
+  /** 提示词槽位：GET 列表（含说明与上限）；POST 写入或清空单个槽位。 */
+  const promptSlotsRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.promptSlots,
+    handler: async (req, res) => {
+      const config = getConfig()
+      const qurl = new URL(req.url ?? '/', 'http://localhost')
+      if (req.method === 'GET') {
+        if (!isLoopbackRequest(req)) { writeJson(res, 403, { error: 'forbidden: loopback-only' }); return }
+        const outputDir = resolveOutputDir(config, qurl.searchParams.get('bookId') ?? undefined)
+        const project = loadProject(outputDir)
+        if (project === undefined) { writeJson(res, 400, { error: '输出目录中没有项目' }); return }
+        const values = new Map(readPromptSlots(project).map(s => [s.id, s.text] as const))
+        const response: PromptSlotsResponse = {
+          slots: PROMPT_SLOTS.map(spec => ({
+            id: spec.id,
+            label: spec.label,
+            hint: spec.hint,
+            placeholder: spec.placeholder,
+            maxChars: spec.maxChars,
+            value: values.get(spec.id) ?? '',
+          })),
+        }
+        writeJson(res, 200, response)
+        return
+      }
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<PromptSlotsRequest & { bookId?: string }>(req)
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
+      if (project === undefined) { writeJson(res, 400, { error: '输出目录中没有项目' }); return }
+      let value: string
+      try {
+        value = normalizeSlotValue(String(body?.id ?? ''), String(body?.value ?? ''))
+      } catch (error) {
+        writeJson(res, 400, { error: (error as Error).message })
+        return
+      }
+      const slots = { ...(project.promptSlots ?? {}) }
+      if (value === '') delete slots[body!.id]
+      else slots[body!.id] = value
+      project.promptSlots = slots
+      project.updatedAt = new Date().toISOString()
+      saveProject(outputDir, project)
+      writeJson(res, 200, { ok: true, id: body!.id, chars: value.length })
+    },
+  }
+
+  // ------------------------------------------------------------- bookshelf
+  const bookshelfRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.bookshelf,
+    handler: async (req, res) => {
+      // GET = snapshot; POST = create book.
+      if (req.method === 'GET') {
+        if (!isLoopbackRequest(req)) {
+          writeJson(res, 403, { error: 'forbidden: loopback-only' })
+          return
+        }
+        // 书架为空时，把 settings 默认输出目录里已有的项目播种为第一本书。
+        seedBookshelfFromOutputDir(getConfig().outputDir)
+        const snapshot: BookshelfSnapshot = bookshelfSnapshot(loadBookshelf())
+        writeJson(res, 200, snapshot)
+        return
+      }
+      if (req.method === 'POST') {
+        if (!isLoopbackRequest(req)) {
+          writeJson(res, 403, { error: 'forbidden: loopback-only' })
+          return
+        }
+        const body = await readJsonBody<BookCreateRequest>(req)
+        const bookName = body?.bookName?.trim()
+        if (bookName === undefined || bookName === '') {
+          writeJson(res, 400, { error: 'bookName 不能为空' })
+          return
+        }
+        const outputDir = body?.outputDir?.trim() !== '' && body?.outputDir !== undefined
+          ? body.outputDir
+          : defaultBookDir(bookName)
+        const book = createBook(bookName, outputDir)
+        // 开书向导：创建时带大纲 → 立即建立项目（书名以大纲首行为准）。
+        const outline = body?.outline?.trim()
+        if (outline !== undefined && outline.length >= 50) {
+          const project = createProject(outline)
+          saveProject(outputDir, project)
+          renameBook(book.id, project.bookName)
+        }
+        writeJson(res, 200, bookshelfSnapshot(loadBookshelf()))
+        return
+      }
+      writeJson(res, 405, { error: 'method not allowed (expected GET or POST)' })
+    },
+  }
+
+  // --------------------------------------------------------------- reset
+  /** 重置项目：清空设定/卷/章节计划/正文/伏笔/资产/事实库（可携带新大纲）。 */
+  const resetRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.reset,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const project = loadProject(config.outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目，无需重置' })
+        return
+      }
+      const body = await readJsonBody<ResetRequest>(req)
+      const outline = body?.outline?.trim()
+      if (outline !== undefined && outline.length >= 50) {
+        project.outline = outline
+        project.bookName = createProject(outline).bookName
+      }
+      project.bible = undefined
+      project.volumes = undefined
+      project.chapters = []
+      project.foreshadows = []
+      project.assets = emptyProjectAssets()
+      project.facts = []
+      project.updatedAt = new Date().toISOString()
+      saveProject(config.outputDir, project)
+      writeJson(res, 200, { ok: true, bookName: project.bookName })
+    },
+  }
+
+  // --------------------------------------------------- bookshelf activate
+  const bookshelfActivateRoute: WebRoute = {
+    kind: 'exact',
+    path: '/api/dsh-novel-forge/bookshelf/activate',
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<BookActivateRequest>(req)
+      if (body?.id === undefined || body.id === '') {
+        writeJson(res, 400, { error: 'id 不能为空' })
+        return
+      }
+      const book = activateBook(body.id)
+      if (book === undefined) {
+        writeJson(res, 404, { error: `书 ${body.id} 不存在` })
+        return
+      }
+      writeJson(res, 200, bookshelfSnapshot(loadBookshelf()))
+    },
+  }
+
+  // ---------------------------------------------------- bookshelf remove
+  const bookshelfRemoveRoute: WebRoute = {
+    kind: 'exact',
+    path: '/api/dsh-novel-forge/bookshelf/remove',
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<BookRemoveRequest>(req)
+      if (body?.id === undefined || body.id === '') {
+        writeJson(res, 400, { error: 'id 不能为空' })
+        return
+      }
+      const removed = removeBook(body.id)
+      if (!removed) {
+        writeJson(res, 404, { error: `书 ${body.id} 不存在` })
+        return
+      }
+      writeJson(res, 200, bookshelfSnapshot(loadBookshelf()))
+    },
+  }
+
+  // ------------------------------------------- bookshelf import-dir
+  /** 导入已有项目目录（Mode A）：校验 novel-project.json，登记/激活书架。 */
+  const bookshelfImportDirRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.bookshelfImportDir,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<BookImportDirRequest>(req)
+      const outputDir = body?.outputDir?.trim()
+      if (outputDir === undefined || outputDir === '') {
+        writeJson(res, 400, { error: 'outputDir 不能为空' })
+        return
+      }
+      try {
+        const { book, existed } = importDir(outputDir)
+        writeJson(res, 200, { book, existed })
+      } catch (err) {
+        writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) })
+      }
+    },
+  }
+
+  // ------------------------------------------- bookshelf import-text
+  /** 导入 txt/md 全本（Mode B）：拆章落盘建项目，登记书架。支持浏览器上传（text+fileName）与服务器本地文件（filePath）两种模式。 */
+  const bookshelfImportTextRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.bookshelfImportText,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<BookImportTextRequest>(req)
+      try {
+        // 模式二：浏览器上传全文内容
+        if (body?.text !== undefined && body.text.length > 0) {
+          const bookName = (body.fileName ?? '').replace(/\.[^.]+$/, '').trim().slice(0, 40) || '导入小说'
+          const outDir = body?.outputDir?.trim() !== undefined && body.outputDir.trim() !== ''
+            ? body.outputDir.trim()
+            : defaultBookDir(bookName)
+          const result = importBookTextFromText(body.text, outDir, bookName)
           const { book } = importDir(outDir)
           writeJson(res, 200, { ...result, book })
           return
@@ -1369,7 +2230,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         const bookName = basename(filePath, extname(filePath)).slice(0, 40) || '导入小说'
         const outDir = body?.outputDir?.trim() !== undefined && body.outputDir.trim() !== ''
           ? body.outputDir.trim()
-          : defaultOutputDirFor(bookName)
+          : defaultBookDir(bookName)
         const result = importBookText(filePath, outDir)
         const { book } = importDir(outDir)
         writeJson(res, 200, { ...result, book })
@@ -1408,9 +2269,15 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.audit,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
+      const body = await readJsonBody<{ bookId?: string }>(req)
+      const config0 = getConfig()
+      const outputDir = resolveOutputDir(config0, body?.bookId)
+      const config = { ...config0, outputDir }
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
+        return
+      }
       const startedAt = new Date().toISOString()
       auditState = { status: 'running', startedAt, totalBatches: 0, completedBatches: 0 }
       try {
@@ -1433,6 +2300,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
           issues,
           auditedChapters,
           auditedAt: auditState.finishedAt!,
+          model: config.auditModel || config.model,
         }
         writeJson(res, 200, response)
       } catch (error) {
@@ -1530,7 +2398,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
   }
 
   // ---------------------------------------------------------------- blurb
-  /** 小说简介：AI 生成/补全，或手动保存。 */
+  /** 小说简介：生成/补全，或手动保存。 */
   const blurbRoute: WebRoute = {
     kind: 'exact',
     path: NOVEL_API.blurb,
@@ -1644,7 +2512,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
   }
 
   // ---------------------------------------------------------------- world
-  /** 大世界：AI 提炼或手动保存（境界体系/区域/势力）。 */
+  /** 大世界：提炼或手动保存（境界体系/区域/势力）。 */
   const worldRoute: WebRoute = {
     kind: 'exact',
     path: NOVEL_API.world,
@@ -1756,7 +2624,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
           writeJson(res, 200, { plotlines: project.plotlines, suggestions } satisfies PlotlinesResponse)
           return
         } catch (error) {
-          writeJson(res, 500, { error: `AI 建议失败：${(error as Error).message}` })
+          writeJson(res, 500, { error: `建议失败：${(error as Error).message}` })
           return
         }
       } else if (op === 'refresh' && body?.id !== undefined) {
@@ -1779,424 +2647,114 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
       } else if (op === 'health') {
         try {
           const health = await analyzePlotlineHealth(ctx, config, project)
-          writeJson(res, 200, { plotlines: project.plotlines, health } satisfies PlotlinesResponse)
-          return
-        } catch (error) {
-          writeJson(res, 500, { error: `健康检查失败：${(error as Error).message}` })
-          return
-        }
-      } else if (op === 'plan') {
-        try {
-          const health = await analyzePlotlineHealth(ctx, config, project)
-          const plan = await designPlotlinePlan(ctx, config, project, health)
-          writeJson(res, 200, { plotlines: project.plotlines, health, plan } satisfies PlotlinesResponse)
-          return
-        } catch (error) {
-          writeJson(res, 500, { error: `剧情方案生成失败：${(error as Error).message}` })
-          return
-        }
-      }
-      project.updatedAt = new Date().toISOString()
-      saveProject(config.outputDir, project)
-      const response: PlotlinesResponse = { plotlines: project.plotlines }
-      writeJson(res, 200, response)
-    },
-  }
-
-  // --------------------------------------------------------- sensitive
-  /** 敏感词检查：指定章节 / 任意文本 / 全书已写章节。 */
-  const sensitiveRoute: WebRoute = {
-    kind: 'exact',
-    path: NOVEL_API.sensitiveCheck,
-    handler: async (req, res) => {
-      if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<SensitiveCheckRequest>(req)
-      const hits: SensitiveHit[] = []
-      let scanned = 0
-      if (body?.text !== undefined) {
-        for (const hit of checkSensitiveText(body.text)) {
-          hits.push({ chapterNo: 0, word: hit.word, category: hit.category, count: hit.count })
-        }
-      } else if (typeof body?.chapterNo === 'number') {
-        const chapter = project.chapters.find(c => c.no === body.chapterNo)
-        if (chapter !== undefined) {
-          const text = readChapterFile(config.outputDir, chapter)
-          if (text !== undefined) {
-            scanned = 1
-            for (const hit of checkSensitiveText(text)) {
-              hits.push({ chapterNo: chapter.no, word: hit.word, category: hit.category, count: hit.count })
-            }
-          }
-        }
-      } else if (body?.all === true) {
-        for (const chapter of project.chapters) {
-          if (chapter.status === 'pending' || chapter.status === 'generating') continue
-          const text = readChapterFile(config.outputDir, chapter)
-          if (text === undefined) continue
-          scanned++
-          for (const hit of checkSensitiveText(text)) {
-            hits.push({ chapterNo: chapter.no, word: hit.word, category: hit.category, count: hit.count })
-          }
-        }
-      } else {
-        writeJson(res, 400, { error: '请提供 chapterNo / text / all 之一' })
-        return
-      }
-      const response: SensitiveCheckResponse = { hits, scannedChapters: scanned }
-      writeJson(res, 200, response)
-    },
-  }
-
-  // ---------------------------------------------------------------- roles
-  /** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
-  const rolesRoute: WebRoute = {
-    kind: 'exact',
-    path: NOVEL_API.roles,
-    handler: async (req, res) => {
-      if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<RolesRequest>(req)
-      if (project.roles === undefined) project.roles = []
-      const op = body?.op
-      if (op === 'extract') {
-        try {
-          const candidates = await extractRoles(ctx, config, project)
-          writeJson(res, 200, { roles: project.roles, candidates } satisfies RolesResponse)
-          return
-        } catch (error) {
-          writeJson(res, 500, { error: `角色提炼失败：${(error as Error).message}` })
-          return
-        }
-      } else if ((op === 'adopt' || op === 'update') && body?.role !== undefined) {
-        const r = body.role
-        const idx = project.roles.findIndex(x => x.name === r.name)
-        if (idx === -1) project.roles.push(r)
-        else project.roles[idx] = r
-      } else if (op === 'remove' && body?.name !== undefined) {
-        project.roles = project.roles.filter(x => x.name !== body.name)
-      } else if (op === 'image') {
-        const name = body?.name?.trim()
-        const dataUrl = body?.dataUrl?.trim()
-        if (name === undefined || name === '') {
-          writeJson(res, 400, { error: 'name（角色名）必填' })
-          return
-        }
-        if (dataUrl === undefined || dataUrl === '') {
-          writeJson(res, 400, { error: 'dataUrl（参考图）必填' })
-          return
-        }
-        const role = project.roles.find(r => r.name === name)
-        if (role === undefined) {
-          writeJson(res, 404, { error: `当前激活《${project.bookName}》，角色 ${name} 不存在——若期望的书不对，请先在书架切换该书并刷新` })
-          return
-        }
-        const label = body?.label?.trim() ?? ''
-        if (label !== '') {
-          // 图集上传：带用途标签。标签「立绘」时同步为角色参考图（imageUrl）。
-          role.gallery ??= []
-          role.gallery = role.gallery.filter(g => g.label !== label)
-          role.gallery.push({ label, dataUrl })
-          if (label === '立绘' || label.includes('立绘')) role.imageUrl = dataUrl
-        } else {
-          // 兼容旧行为：不带标签 = 角色参考图。
-          role.imageUrl = dataUrl
-        }
-        project.updatedAt = new Date().toISOString()
-        saveProject(config.outputDir, project)
-        writeJson(res, 200, { roles: project.roles, imageUrl: role.imageUrl } satisfies RolesResponse)
-        return
-      } else if (op === 'removeImage') {
-        const name = body?.name?.trim()
-        const label = body?.label?.trim() ?? ''
-        const role = project.roles.find(r => r.name === name)
-        if (role !== undefined) {
-          if (label !== '') {
-            role.gallery = (role.gallery ?? []).filter(g => g.label !== label)
-            if (label === '立绘' || label.includes('立绘')) role.imageUrl = undefined
-          } else {
-            role.imageUrl = undefined
-          }
-        }
-        project.updatedAt = new Date().toISOString()
-        saveProject(config.outputDir, project)
-        writeJson(res, 200, { roles: project.roles } satisfies RolesResponse)
-        return
-      } else if (op === 'visual') {
-        // 动漫形象描述词提炼：扫描正文外貌描写 → LLM 提炼 → 写入角色卡。
-        const name = body?.name?.trim()
-        if (name === undefined || name === '') {
-          writeJson(res, 400, { error: 'name（角色名）必填' })
-          return
-        }
-        try {
-          const visual = await extractRoleVisual(ctx, config, project, config.outputDir, name, body?.styleId, body?.filterId)
-          const role = project.roles.find(r => r.name === name)
-          if (role !== undefined) {
-            role.imagePrompt = visual
-            if ((visual.expressions ?? []).length > 0) role.expressions = visual.expressions
-            if (visual.promptKit !== undefined) role.promptKit = visual.promptKit
-          }
-          project.updatedAt = new Date().toISOString()
-          saveProject(config.outputDir, project)
-          writeJson(res, 200, { roles: project.roles, visual } satisfies RolesResponse)
-          return
-        } catch (error) {
-          writeJson(res, 500, { error: `形象提炼失败：${(error as Error).message}` })
-          return
-        }
-      } else if (op === 'promptKit') {
-        // 角色四类提示词精修包（立绘/四视图/表情/细节）
-        const name = body?.name?.trim()
-        if (name === undefined || name === '') {
-          writeJson(res, 400, { error: 'name（角色名）必填' })
-          return
-        }
-        try {
-          const kit = await generateRolePromptKit(ctx, config, project, name, body?.styleId, body?.filterId)
-          const role = project.roles.find(r => r.name === name)
-          if (role !== undefined) role.promptKit = kit
-          project.updatedAt = new Date().toISOString()
-          saveProject(config.outputDir, project)
-          writeJson(res, 200, { roles: project.roles, promptKit: kit } satisfies RolesResponse)
-          return
-        } catch (error) {
-          writeJson(res, 500, { error: `提示词精修失败：${(error as Error).message}` })
-          return
-        }
-      } else {
-        writeJson(res, 400, { error: '未知的 roles op' })
-        return
-      }
-      project.updatedAt = new Date().toISOString()
-      saveProject(config.outputDir, project)
-      const response: RolesResponse = { roles: project.roles }
-      writeJson(res, 200, response)
-    },
-  }
-
-  // ------------------------------------------------------- manga roles
-  /** 漫剧角色库：从分镜提名（规则+LLM 两段式）/ 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
-  const mangaRolesRoute: WebRoute = {
-    kind: 'exact',
-    path: NOVEL_API.mangaRoles,
-    handler: async (req, res) => {
-      if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<MangaRolesRequest>(req)
-      if (project.mangaRoles === undefined) project.mangaRoles = []
-      const op = body?.op
-      if (op === 'nominate') {
-        const chapterNo = body?.chapterNo
-        if (typeof chapterNo !== 'number' || chapterNo <= 0) {
-          writeJson(res, 400, { error: 'chapterNo（章号）必填' })
-          return
-        }
-        try {
-          const candidates = await nominateMangaRoles(ctx, config, project, config.outputDir, chapterNo)
-          writeJson(res, 200, { cards: project.mangaRoles, candidates } satisfies MangaRolesResponse)
-          return
-        } catch (error) {
-          writeJson(res, 500, { error: `提名失败：${(error as Error).message}` })
-          return
-        }
-      } else if (op === 'adopt' || op === 'update') {
-        const card = body?.card
-        if (card === undefined || typeof card !== 'object') {
-          writeJson(res, 400, { error: 'card（漫剧角色卡）必填' })
-          return
-        }
-        const name = (card.name ?? '').trim()
-        if (name === '') {
-          writeJson(res, 400, { error: '漫剧角色名不能为空' })
-          return
-        }
-        const now = new Date().toISOString()
-        const existing = card.id !== '' ? project.mangaRoles.find(c => c.id === card.id) : undefined
-        const next: MangaRoleCard = {
-          id: card.id !== '' ? card.id : 'mr-' + Date.now().toString(36) + '-' + Math.random().toString(36).slice(2, 6),
-          sourceRoleName: card.sourceRoleName !== undefined && card.sourceRoleName !== '' ? card.sourceRoleName : undefined,
-          name,
-          identity: card.identity ?? '',
-          coreFunction: card.coreFunction ?? 'functional',
-          protagonistRelation: card.protagonistRelation ?? 'neutral',
-          speechStyle: card.speechStyle ?? '',
-          traits: Array.isArray(card.traits) ? card.traits.map(t => String(t).slice(0, 20)).filter(t => t !== '').slice(0, 3) : [],
-          appearance: card.appearance ?? '',
-          keyScenes: Array.isArray(card.keyScenes) ? card.keyScenes.map(k => String(k).slice(0, 120)).filter(k => k !== '').slice(0, 6) : [],
-          appearsInEpisodes: Array.isArray(card.appearsInEpisodes)
-            ? [...new Set(card.appearsInEpisodes.map(n => Number(n)).filter(n => Number.isFinite(n) && n > 0))].sort((a, b) => a - b).slice(0, 200)
-            : [],
-          status: card.status ?? 'imported',
-          imagePrompt: card.imagePrompt,
-          expressions: card.expressions,
-          promptKit: card.promptKit,
-          imageUrl: card.imageUrl,
-          gallery: card.gallery,
-          promptStyleId: card.promptStyleId,
-          createdAt: existing?.createdAt ?? now,
-          updatedAt: now,
-        }
-        if (existing !== undefined) {
-          const idx = project.mangaRoles.findIndex(c => c.id === card.id)
-          project.mangaRoles[idx] = next
-        } else {
-          project.mangaRoles.push(next)
-        }
-        project.updatedAt = now
-        saveProject(config.outputDir, project)
-        writeJson(res, 200, { cards: project.mangaRoles } satisfies MangaRolesResponse)
-        return
-      } else if (op === 'remove') {
-        const id = body?.id
-        if (typeof id !== 'string' || id === '') {
-          writeJson(res, 400, { error: 'id（漫剧卡 id）必填' })
-          return
-        }
-        project.mangaRoles = project.mangaRoles.filter(c => c.id !== id)
-        project.updatedAt = new Date().toISOString()
-        saveProject(config.outputDir, project)
-        writeJson(res, 200, { cards: project.mangaRoles } satisfies MangaRolesResponse)
-        return
-      } else if (op === 'visual') {
-        const id = body?.id?.trim()
-        if (id === undefined || id === '') {
-          writeJson(res, 400, { error: 'id（漫剧卡 id）必填' })
-          return
-        }
-        try {
-          const activeStyle = getActiveMangaStyle(project); const visual = await extractMangaRoleVisual(ctx, config, project, config.outputDir, id, body?.styleId ?? activeStyle.styleId, body?.filterId ?? activeStyle.filterId)
-          project.updatedAt = new Date().toISOString()
-          saveProject(config.outputDir, project)
-          writeJson(res, 200, { cards: project.mangaRoles, visual } satisfies MangaRolesResponse)
-          return
-        } catch (error) {
-          writeJson(res, 500, { error: `形象锚点生成失败：${(error as Error).message}` })
-          return
-        }
-      } else if (op === 'promptKit') {
-        const id = body?.id?.trim()
-        if (id === undefined || id === '') {
-          writeJson(res, 400, { error: 'id（漫剧卡 id）必填' })
-          return
-        }
-        try {
-          const activeStyle2 = getActiveMangaStyle(project); const kit = await generateMangaRolePromptKit(ctx, config, project, id, body?.styleId ?? activeStyle2.styleId, body?.filterId ?? activeStyle2.filterId)
-          project.updatedAt = new Date().toISOString()
-          saveProject(config.outputDir, project)
-          writeJson(res, 200, { cards: project.mangaRoles, promptKit: kit } satisfies MangaRolesResponse)
+          writeJson(res, 200, { plotlines: project.plotlines, health } satisfies PlotlinesResponse)
           return
         } catch (error) {
-          writeJson(res, 500, { error: `提示词精修失败：${(error as Error).message}` })
+          writeJson(res, 500, { error: `健康检查失败：${(error as Error).message}` })
           return
         }
-      } else if (op === 'image') {
-        // 定妆图上传：带标签进图集；标签含「立绘」时同步为参考图（imageUrl）。
-        const id = body?.id?.trim()
-        const dataUrl = body?.dataUrl?.trim()
-        if (id === undefined || id === '') {
-          writeJson(res, 400, { error: 'id（漫剧卡 id）必填' })
+      } else if (op === 'plan') {
+        try {
+          const health = await analyzePlotlineHealth(ctx, config, project)
+          const plan = await designPlotlinePlan(ctx, config, project, health)
+          writeJson(res, 200, { plotlines: project.plotlines, health, plan } satisfies PlotlinesResponse)
           return
-        }
-        if (dataUrl === undefined || dataUrl === '') {
-          writeJson(res, 400, { error: 'dataUrl（定妆图）必填' })
+        } catch (error) {
+          writeJson(res, 500, { error: `剧情方案生成失败：${(error as Error).message}` })
           return
         }
-        const card = project.mangaRoles.find(c => c.id === id)
-        if (card === undefined) {
-          writeJson(res, 404, { error: '漫剧角色卡不存在' })
-          return
+      }
+      project.updatedAt = new Date().toISOString()
+      saveProject(config.outputDir, project)
+      const response: PlotlinesResponse = { plotlines: project.plotlines }
+      writeJson(res, 200, response)
+    },
+  }
+
+  // --------------------------------------------------------- sensitive
+  /** 敏感词检查：指定章节 / 任意文本 / 全书已写章节。 */
+  const sensitiveRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.sensitiveCheck,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const project = requireProject(res)
+      if (project === undefined) return
+      const body = await readJsonBody<SensitiveCheckRequest>(req)
+      const hits: SensitiveHit[] = []
+      let scanned = 0
+      if (body?.text !== undefined) {
+        for (const hit of checkSensitiveText(body.text)) {
+          hits.push({ chapterNo: 0, word: hit.word, category: hit.category, count: hit.count })
         }
-        const label = body?.label?.trim() ?? ''
-        if (label !== '') {
-          card.gallery ??= []
-          card.gallery = card.gallery.filter(g => g.label !== label)
-          card.gallery.push({ label, dataUrl })
-          if (label.includes('立绘')) card.imageUrl = dataUrl
-        } else {
-          card.imageUrl = dataUrl
+      } else if (typeof body?.chapterNo === 'number') {
+        const chapter = project.chapters.find(c => c.no === body.chapterNo)
+        if (chapter !== undefined) {
+          const text = readChapterFile(config.outputDir, chapter)
+          if (text !== undefined) {
+            scanned = 1
+            for (const hit of checkSensitiveText(text)) {
+              hits.push({ chapterNo: chapter.no, word: hit.word, category: hit.category, count: hit.count })
+            }
+          }
         }
-        card.updatedAt = new Date().toISOString()
-        project.updatedAt = new Date().toISOString()
-        saveProject(config.outputDir, project)
-        writeJson(res, 200, { cards: project.mangaRoles, imageUrl: card.imageUrl } satisfies MangaRolesResponse)
-        return
-      } else if (op === 'removeImage') {
-        const id = body?.id?.trim()
-        const label = body?.label?.trim() ?? ''
-        const card = project.mangaRoles.find(c => c.id === id)
-        if (card !== undefined) {
-          if (label !== '') {
-            card.gallery = (card.gallery ?? []).filter(g => g.label !== label)
-            if (label.includes('立绘')) card.imageUrl = undefined
-          } else {
-            card.imageUrl = undefined
+      } else if (body?.all === true) {
+        for (const chapter of project.chapters) {
+          if (chapter.status === 'pending' || chapter.status === 'generating') continue
+          const text = readChapterFile(config.outputDir, chapter)
+          if (text === undefined) continue
+          scanned++
+          for (const hit of checkSensitiveText(text)) {
+            hits.push({ chapterNo: chapter.no, word: hit.word, category: hit.category, count: hit.count })
           }
-          card.updatedAt = new Date().toISOString()
         }
-        project.updatedAt = new Date().toISOString()
-        saveProject(config.outputDir, project)
-        writeJson(res, 200, { cards: project.mangaRoles } satisfies MangaRolesResponse)
-        return
-      } else if (op === 'mode') {
-        // 短剧精简模式开关（漫剧角色库 5-8 人 / 功能标签 / 关系闭环 / 人设极致化）。
-        project.shortDramaMode = body?.shortDramaMode === true
-        project.updatedAt = new Date().toISOString()
-        saveProject(config.outputDir, project)
-        writeJson(res, 200, { cards: project.mangaRoles, shortDramaMode: project.shortDramaMode } satisfies MangaRolesResponse)
-        return
-            } else if (op === 'autoGenerate') {
-        const chapterNo = body?.chapterNo
-        if (typeof chapterNo !== 'number' || chapterNo <= 0) { writeJson(res, 400, { error: 'chapterNo（章号）必填' }); return }
-        try {
-          const activeStyle3 = getActiveMangaStyle(project); const result = await autoGenerateMangaChapter(ctx, config, project, config.outputDir, chapterNo, body?.styleId ?? activeStyle3.styleId, body?.filterId ?? activeStyle3.filterId)
-          writeJson(res, 200, { cards: project.mangaRoles, autoGenerate: result } satisfies MangaRolesResponse)
-          return
-        } catch (error) { writeJson(res, 500, { error: '一键生成失败：' + (error as Error).message }); return }
-      } else if (op === 'openAssets') {
-        const dir = mangaAssetsDir(config.outputDir)
-        try {
-          mkdirSync(dir, { recursive: true })
-          if (process.platform === 'win32') { spawn('explorer', [dir], { detached: true }) }
-          else if (process.platform === 'darwin') { spawn('open', [dir], { detached: true }) }
-          else { spawn('xdg-open', [dir], { detached: true }) }
-          writeJson(res, 200, { ok: true, dir })
-          return
-        } catch (error) { writeJson(res, 500, { error: '打开资产库失败：' + (error as Error).message, dir }); return }
       } else {
-        writeJson(res, 400, { error: '未知的 manga/roles op' })
+        writeJson(res, 400, { error: '请提供 chapterNo / text / all 之一' })
         return
       }
+      const response: SensitiveCheckResponse = { hits, scannedChapters: scanned }
+      writeJson(res, 200, response)
     },
   }
 
-  // --------------------------------------------------- manga export-package
-  /** 导出「即梦素材包」落盘到资产库 manga-assets/素材包/（前端组装 markdown，后端写文件）。 */
-  const exportPackageRoute: WebRoute = {
+  // ---------------------------------------------------------------- roles
+  /** 角色库：提炼 / 采纳 / 更新 / 删除。 */
+  const rolesRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.exportPackage,
+    path: NOVEL_API.roles,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
       const config = getConfig()
-      const body = await readJsonBody<{ chapterNo?: number; title?: string; markdown?: string }>(req)
-      const chapterNo = Number(body?.chapterNo)
-      const markdown = body?.markdown ?? ''
-      if (!Number.isInteger(chapterNo) || chapterNo < 1 || markdown.trim() === '') {
-        writeJson(res, 400, { error: 'chapterNo 须为正整数，且 markdown 不能为空' })
+      const project = requireProject(res)
+      if (project === undefined) return
+      const body = await readJsonBody<RolesRequest>(req)
+      if (project.roles === undefined) project.roles = []
+      const op = body?.op
+      if (op === 'extract') {
+        try {
+          const candidates = await extractRoles(ctx, config, project)
+          writeJson(res, 200, { roles: project.roles, candidates } satisfies RolesResponse)
+          return
+        } catch (error) {
+          writeJson(res, 500, { error: `角色提炼失败：${(error as Error).message}` })
+          return
+        }
+      } else if ((op === 'adopt' || op === 'update') && body?.role !== undefined) {
+        const r = body.role
+        const idx = project.roles.findIndex(x => x.name === r.name)
+        if (idx === -1) project.roles.push(r)
+        else project.roles[idx] = r
+      } else if (op === 'remove' && body?.name !== undefined) {
+        project.roles = project.roles.filter(x => x.name !== body.name)
+      } else {
+        writeJson(res, 400, { error: '未知的 roles op' })
         return
       }
-      try {
-        const file = saveMangaAssetPackage(config.outputDir, chapterNo, (body?.title ?? '').trim(), markdown)
-        writeJson(res, 200, { ok: true, file })
-      } catch (error) {
-        writeJson(res, 500, { error: (error as Error).message })
-      }
+      project.updatedAt = new Date().toISOString()
+      saveProject(config.outputDir, project)
+      const response: RolesResponse = { roles: project.roles }
+      writeJson(res, 200, response)
     },
   }
 
@@ -2359,8 +2917,8 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         return
       }
       try {
-        const next = await patchConfig(body)
-        writeJson(res, 200, { config: next })
+        const result = await patchConfig(body)
+        writeJson(res, 200, result satisfies ConfigResponse)
       } catch (error) {
         writeJson(res, 400, { error: (error as Error).message })
       }
@@ -2398,7 +2956,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.pluginUpdate,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const profileDir = join(homedir(), '.dsh', 'profiles', 'web')
+      const profileDir = dshHomePath('profiles', argvProfile() ?? 'web')
       const response: PluginUpdateResponse = await new Promise((resolve) => {
         const child = spawn('pnpm', ['add', '@waterwx/dsh-novel-forge@latest'], { cwd: profileDir, shell: true })
         let acc = ''
@@ -2476,35 +3034,6 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     },
   }
 
-  // ------------------------------------------------- storyboard prompts
-  /** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
-  const storyboardPromptsRoute: WebRoute = {
-    kind: 'exact',
-    path: NOVEL_API.storyboardPrompts,
-    handler: async (req, res) => {
-      if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<StoryboardPromptsRequest>(req)
-      const no = body?.chapterNo
-      if (!Number.isInteger(no) || no === undefined || no < 1) {
-        writeJson(res, 400, { error: 'chapterNo 须为正整数' })
-        return
-      }
-      if (body?.table === undefined || (body.table.shots ?? []).length === 0) {
-        writeJson(res, 400, { error: 'table 不能为空，请先生成分镜表' })
-        return
-      }
-      try {
-        const activeStyle5 = getActiveMangaStyle(project); const prompts = await generateStoryboardPrompts(ctx, config, project, config.outputDir, no, body.table, body?.styleId ?? activeStyle5.styleId, body?.filterId ?? activeStyle5.filterId)
-        writeJson(res, 200, { prompts } satisfies StoryboardPromptsResponse)
-      } catch (error) {
-        writeJson(res, 500, { error: `视频提示词生成失败：${(error as Error).message}` })
-      }
-    },
-  }
-
   // ------------------------------------------------------------- llm-test
   /** LLM 连通性测试：对选中的提供商/模型发一次最小真实调用。 */
   const llmTestRoute: WebRoute = {
@@ -2616,149 +3145,6 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     },
   }
 
-  // ---------------------------------------------------- storyboard table
-  /** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
-  const storyboardTableRoute: WebRoute = {
-    kind: 'exact',
-    path: NOVEL_API.storyboardTable,
-    handler: async (req, res) => {
-      if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<StoryboardTableRequest>(req)
-      const no = body?.chapterNo
-      if (!Number.isInteger(no) || no === undefined || no < 1) {
-        writeJson(res, 400, { error: 'chapterNo 须为正整数' })
-        return
-      }
-      if (body?.skeleton === undefined || (body.skeleton.beats ?? []).length === 0) {
-        writeJson(res, 400, { error: 'skeleton 不能为空，请先生成剧情骨架' })
-        return
-      }
-      try {
-        const activeStyle6 = getActiveMangaStyle(project); const table = await generateStoryboardTable(ctx, config, project, config.outputDir, no, body.skeleton, body?.styleId ?? activeStyle6.styleId, body?.filterId ?? activeStyle6.filterId)
-        writeJson(res, 200, { table } satisfies StoryboardTableResponse)
-      } catch (error) {
-        writeJson(res, 500, { error: `分镜表生成失败：${(error as Error).message}` })
-      }
-    },
-  }
-
-  // ------------------------------------------------------ manhua plans
-  /** 漫剧方案管理：create / remove / activate。 */
-  const manhuaPlansRoute: WebRoute = {
-    kind: 'exact',
-    path: NOVEL_API.manhuaPlans,
-    handler: async (req, res) => {
-      if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<MangaPlansRequest>(req)
-      if (project.mangaPlans === undefined) project.mangaPlans = []
-      if (body?.op === 'create') {
-        const name = body.name?.trim()
-        const styleId = body.styleId?.trim()
-        if (name === undefined || name === '' || styleId === undefined || styleId === '') {
-          writeJson(res, 400, { error: 'name 与 styleId 不能为空' })
-          return
-        }
-        if (project.mangaPlans.some(p => p.name === name)) {
-          writeJson(res, 400, { error: `方案名「${name}」已存在` })
-          return
-        }
-        const id = `manga-${Date.now().toString(36)}`
-        project.mangaPlans.push({
-          id,
-          name: name.slice(0, 40),
-          styleId,
-          filterId: body.filterId?.trim() !== '' ? body.filterId?.trim() : undefined,
-          genre: body.genre?.trim() !== '' ? body.genre?.trim() : undefined,
-          active: project.mangaPlans.length === 0,
-          createdAt: new Date().toISOString(),
-          updatedAt: new Date().toISOString(),
-        })
-      } else if (body?.op === 'remove' && body.id !== undefined) {
-        const removed = project.mangaPlans.find(p => p.id === body.id)
-        project.mangaPlans = project.mangaPlans.filter(p => p.id !== body.id)
-        if (removed?.active === true && project.mangaPlans.length > 0) {
-          project.mangaPlans[0].active = true
-        }
-        // 删除方案时同时清除该方案的漫剧产出：分镜（骨架/表/提示词）、角色卡
-        // 场景库与视觉规则是全书资产，保留供后续方案复用
-        project.storyboards = []
-        project.mangaRoles = []
-      } else if (body?.op === 'activate' && body.id !== undefined) {
-        project.mangaPlans.forEach(p => { p.active = p.id === body.id })
-      } else {
-        writeJson(res, 400, { error: 'op 须为 create/remove/activate' })
-        return
-      }
-      project.updatedAt = new Date().toISOString()
-      saveProject(config.outputDir, project)
-      writeJson(res, 200, { plans: project.mangaPlans } satisfies MangaPlansResponse)
-    },
-  }
-
-  // ------------------------------------------------------ style image
-  /** 风格库效果图：GET /styles/image?id=<styleId>，从 ~/.dsh/dsh-novel-forge-styles/<id>.png 读取。 */
-  const styleImageRoute: WebRoute = {
-    kind: 'exact',
-    path: '/api/dsh-novel-forge/styles/image',
-    handler: async (req, res) => {
-      if (!isLoopbackRequest(req)) {
-        writeJson(res, 403, { error: 'forbidden: loopback-only' })
-        return
-      }
-      const url = new URL(req.url ?? '', 'http://localhost')
-      const id = (url.searchParams.get('id') ?? '').replace(/[^a-z0-9-]/gi, '')
-      if (id === '') {
-        writeJson(res, 404, { error: 'style image not found' })
-        return
-      }
-      // 图片来源：用户数据目录缩略图（自定义覆盖）→ 原图 → 包内置缩略图（随插件分发）。
-      const base = join(homedir(), '.dsh', 'dsh-novel-forge-styles')
-      const candidates: Array<{ file: string; type: string }> = [
-        { file: join(base, 'thumbs', id + '.webp'), type: 'image/webp' },
-        { file: join(base, id + '.png'), type: 'image/png' },
-        { file: join(builtinStyleDir, id + '.webp'), type: 'image/webp' },
-      ]
-      for (const c of candidates) {
-        if (existsSync(c.file)) {
-          res.writeHead(200, { 'content-type': c.type, 'cache-control': 'public, max-age=86400' })
-          res.end(readFileSync(c.file))
-          return
-        }
-      }
-      writeJson(res, 404, { error: 'style image not found' })
-    },
-  }
-
-  // ------------------------------------------------------- storyboard
-  /** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
-  const storyboardSkeletonRoute: WebRoute = {
-    kind: 'exact',
-    path: NOVEL_API.storyboardSkeleton,
-    handler: async (req, res) => {
-      if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<StoryboardSkeletonRequest>(req)
-      const no = body?.chapterNo
-      if (!Number.isInteger(no) || no === undefined || no < 1) {
-        writeJson(res, 400, { error: 'chapterNo 须为正整数' })
-        return
-      }
-      try {
-        const skeleton = await generateStoryboardSkeleton(ctx, config, project, config.outputDir, no)
-        writeJson(res, 200, { skeleton } satisfies StoryboardSkeletonResponse)
-      } catch (error) {
-        writeJson(res, 500, { error: `剧情骨架生成失败：${(error as Error).message}` })
-      }
-    },
-  }
 
   // ----------------------------------------------------------- breakdown
   /** 拆书分析：对已写章节做结构/人物/文风/卖点体检（两阶段：源笔记→分节分析）。 */
@@ -2788,151 +3174,128 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     },
   }
 
-  // --------------------------------------------------------------- scenes
-  /** 场景库：AI 提炼 / 采纳 / 更新 / 删除 / 图集。 */
-  const scenesRoute: WebRoute = {
+
+  // ----------------------------------------------------------- production run
+  /** 生产单执行器（单例）：计划补足 → 逐章生成 → 被拒分级处理 → 断点续跑。 */
+  const runner = new ProductionRunner({ ctx, getConfig })
+
+  // --------------------------------------------------------- move-output-dir
+  /**
+   * 输出目录迁移：dryRun 预览；确认后 copy 全部内容 → 书架重指向 → settings
+   * 默认目录同步（仅当默认目录就是被搬目录）→ 最后删源目录（数据零丢失排序）。
+   */
+  const moveOutputDirRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.scenes,
+    path: NOVEL_API.moveOutputDir,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<ScenesRequest>(req)
-      if (project.scenes === undefined) project.scenes = []
-      const op = body?.op
-      if (op === 'extract') {
+      const from = getConfig().outputDir
+      const body = await readJsonBody<MoveOutputDirRequest>(req)
+      // 预览：只列内容，不搬移。
+      if (body?.dryRun === true) {
         try {
-          const activeStyle4 = getActiveMangaStyle(project); const candidates = await extractScenes(ctx, config, project, body?.chapterNo, body?.styleId ?? activeStyle4.styleId, body?.filterId ?? activeStyle4.filterId)
-          writeJson(res, 200, { scenes: project.scenes, candidates } satisfies ScenesResponse)
-          return
+          const contents = listDirContents(from)
+          writeJson(res, 200, { from, files: contents.files.slice(0, 300), bytes: contents.bytes, movedBooks: 0, defaultUpdated: false } satisfies MoveOutputDirResponse)
         } catch (error) {
-          writeJson(res, 500, { error: `场景提炼失败：${(error as Error).message}` })
-          return
-        }
-      } else if ((op === 'adopt' || op === 'update') && body?.scene !== undefined) {
-        const s = body.scene
-        const idx = project.scenes.findIndex(x => x.name === s.name)
-        if (idx === -1) project.scenes.push(s)
-        else project.scenes[idx] = s
-      } else if (op === 'remove' && body?.name !== undefined) {
-        project.scenes = project.scenes.filter(x => x.name !== body.name)
-      } else if (op === 'image') {
-        const name = body?.name?.trim()
-        const dataUrl = body?.dataUrl?.trim()
-        if (name === undefined || name === '' || dataUrl === undefined || dataUrl === '') {
-          writeJson(res, 400, { error: 'name（场景名）与 dataUrl 必填' })
-          return
-        }
-        const scene = project.scenes.find(x => x.name === name)
-        if (scene === undefined) {
-          writeJson(res, 404, { error: `当前激活《${project.bookName}》，场景 ${name} 不存在——若期望的书不对，请先在书架切换该书并刷新` })
-          return
+          writeJson(res, 400, { error: (error as Error).message })
         }
-        const label = body?.label?.trim() ?? '全景'
-        scene.gallery ??= []
-        scene.gallery = scene.gallery.filter(g => g.label !== label)
-        scene.gallery.push({ label, dataUrl })
-      } else if (op === 'removeImage') {
-        const name = body?.name?.trim()
-        const label = body?.label?.trim() ?? ''
-        const scene = project.scenes.find(x => x.name === name)
-        if (scene !== undefined && label !== '') {
-          scene.gallery = (scene.gallery ?? []).filter(g => g.label !== label)
-        }
-      } else {
-        writeJson(res, 400, { error: `未知操作 ${op}` })
         return
       }
-      project.updatedAt = new Date().toISOString()
-      saveProject(config.outputDir, project)
-      writeJson(res, 200, { scenes: project.scenes } satisfies ScenesResponse)
-    },
-  }
-
-  // ----------------------------------------------------------- visual rules
-  /** 视觉世界观规则：从道藏提炼（生图/生视频纠偏），或手动保存。 */
-  const visualRulesRoute: WebRoute = {
-    kind: 'exact',
-    path: NOVEL_API.visualRules,
-    handler: async (req, res) => {
-      if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<VisualRulesRequest>(req)
-      if (body?.op === 'extract') {
-        try {
-          const rules = await extractVisualRules(ctx, config, project)
-          project.visualRules = rules
-          project.updatedAt = new Date().toISOString()
-          saveProject(config.outputDir, project)
-          writeJson(res, 200, { rules } satisfies VisualRulesResponse)
-          return
-        } catch (error) {
-          writeJson(res, 500, { error: `视觉规则提炼失败：${(error as Error).message}` })
-          return
-        }
-      } else if (body?.op === 'save' && Array.isArray(body.rules)) {
-        project.visualRules = body.rules.filter(r => typeof r === 'string' && r.trim() !== '').map(r => r.trim().slice(0, 80)).slice(0, 12)
-        project.updatedAt = new Date().toISOString()
-        saveProject(config.outputDir, project)
-        writeJson(res, 200, { rules: project.visualRules } satisfies VisualRulesResponse)
+      if (runner.isWorking()) {
+        writeJson(res, 409, { error: '生产单正在运行中，请先停止后再迁移目录' })
+        return
+      }
+      const to = body?.to?.trim() ?? ''
+      if (to === '') {
+        writeJson(res, 400, { error: '新目录路径不能为空' })
         return
       }
-      writeJson(res, 400, { error: 'op 须为 extract 或 save' })
+      if (normalizeDir(to) === normalizeDir(from)) {
+        writeJson(res, 400, { error: '新目录与当前目录相同' })
+        return
+      }
+      try {
+        // 1. copy 全部内容（源目录保留；失败即中止，源数据无损）。
+        copyDirContents(from, to)
+      } catch (error) {
+        writeJson(res, 400, { error: `迁移中止：${(error as Error).message}` })
+        return
+      }
+      // 2. 书架重指向（outputDir === from 的条目全部改到 to）。
+      let movedBooks = 0
+      let repointError = ''
+      try { movedBooks = repointBookDirs(from, to) } catch (error) { repointError = (error as Error).message }
+      // 3. settings 默认目录同步（仅当默认目录就是被搬的这个）。
+      let defaultUpdated = false
+      let defaultError = ''
+      const raw = deps.rawConfig?.()
+      if (raw !== undefined && raw.outputDir !== undefined && raw.outputDir !== '' && normalizeDir(raw.outputDir) === normalizeDir(from)) {
+        try {
+          await patchConfig({ outputDir: to })
+          defaultUpdated = true
+        } catch (error) { defaultError = (error as Error).message }
+      }
+      // 4. 收尾：重指向全部成功才删源目录；否则保留源目录兜底并如实上报。
+      if (repointError === '' && defaultError === '') {
+        removeDir(from)
+        const contents = listDirContents(to)
+        writeJson(res, 200, { from, to, files: contents.files.slice(0, 300), bytes: contents.bytes, movedBooks, defaultUpdated } satisfies MoveOutputDirResponse)
+        return
+      }
+      writeJson(res, 500, {
+        error: `文件已复制到 ${to}，但收尾未完成${repointError !== '' ? `（书架重指向失败：${repointError}）` : ''}${defaultError !== '' ? `（默认目录更新失败：${defaultError}）` : ''}。源目录已保留，请检查后重试或手动处理。`,
+        from,
+        to,
+        movedBooks,
+        defaultUpdated,
+      })
     },
   }
 
-  const mangaPropsRoute: WebRoute = {
+  // ----------------------------------------------------------- book-settings
+  /**
+   * 本书参数：POST {} 读取当前书的 settings + 生效配置（全局+本书回退链）；
+   * POST {patch} 白名单合并保存到 novel-project.json.bookSettings。
+   */
+  const bookSettingsRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.mangaProps,
+    path: NOVEL_API.bookSettings,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const body = await readJsonBody<MangaPropsRequest>(req)
-      if (body?.op === 'extract') {
-        try {
-          const props = await extractProps(ctx, config, project)
-          if (props.length > 0) {
-            project.props = props
-            project.updatedAt = new Date().toISOString()
-            saveProject(config.outputDir, project)
-          }
-          writeJson(res, 200, { props: project.props ?? [] } satisfies MangaPropsResponse)
-          return
-        } catch (error) {
-          writeJson(res, 500, { error: `道具提炼失败：${(error as Error).message}` })
+      const outputDir = getConfig().outputDir
+      const body = await readJsonBody<BookSettingsRequest>(req)
+      if (body?.patch !== undefined) {
+        const project = loadProject(outputDir)
+        if (project === undefined) {
+          writeJson(res, 400, { error: '当前没有打开的书（未找到 novel-project.json）' })
           return
         }
-      } else if (body?.op === 'save' && Array.isArray(body.props)) {
-        project.props = body.props
-          .filter(p => typeof p === 'object' && p !== null && typeof p.name === 'string' && p.name.trim() !== '')
-          .map(p => ({ name: p.name.trim().slice(0, 20), desc: (typeof p.desc === 'string' ? p.desc.trim() : '').slice(0, 120) }))
-          .slice(0, 8)
+        const cur: BookSettings = project.bookSettings ?? {}
+        const p = body.patch
+        const next: Record<string, unknown> = { ...cur }
+        for (const key of ['provider', 'model', 'reasoningEffort', 'analysisReasoning', 'chapterChars', 'maxTokens', 'reviewPassScore', 'autoReview', 'autoAuthorReview', 'autoReviewAfterRevise'] as const) {
+          const v = (p as Record<string, unknown>)[key]
+          if (v === null) delete next[key]
+          else if (v !== undefined) next[key] = v
+        }
+        project.bookSettings = next as BookSettings
         project.updatedAt = new Date().toISOString()
-        saveProject(config.outputDir, project)
-        writeJson(res, 200, { props: project.props } satisfies MangaPropsResponse)
-        return
+        saveProject(outputDir, project)
       }
-      writeJson(res, 400, { error: 'op 须为 extract 或 save' })
+      const project = loadProject(outputDir)
+      writeJson(res, 200, { settings: project?.bookSettings ?? {}, effective: getConfig(), hasBook: project !== undefined } satisfies BookSettingsResponse)
     },
   }
 
-  // ----------------------------------------------------------- production run
-  /** 生产单执行器（单例）：计划补足 → 逐章生成 → 被拒分级处理 → 断点续跑。 */
-  const runner = new ProductionRunner({ ctx, getConfig })
-
   const runStartRoute: WebRoute = {
     kind: 'exact',
     path: NOVEL_API.runStart,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const body = await readJsonBody<RunStartRequest>(req)
+      const body = await readJsonBody<RunStartRequest & { bookId?: string }>(req)
       const config = getConfig()
-      const project = loadProject(config.outputDir)
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
       if (project === undefined) {
         writeJson(res, 400, { error: '输出目录中没有项目' })
         return
@@ -2949,7 +3312,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         return
       }
       try {
-        const state = await runner.start(startNo, endNo)
+        const state = await runner.start(startNo, endNo, outputDir)
         writeJson(res, 200, state satisfies RunState)
       } catch (error) {
         writeJson(res, 409, { error: (error as Error).message })
@@ -3279,7 +3642,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
   }
 
   // ------------------------------------------ theme custom background (upload + serve)
-  const THEME_BG_DIR = join(homedir(), '.dsh', 'dsh-novel-forge-assets')
+  const THEME_BG_DIR = dshHomePath('dsh-novel-forge-assets')
   const MIME_BY_EXT: Record<string, string> = { png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', webp: 'image/webp', gif: 'image/gif' }
 
   const themeBackgroundUploadRoute: WebRoute = {
@@ -3340,8 +3703,29 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     chapterSaveRoute,
     assetsRoute,
     styleEngineRoute,
+    styleFormulaRoute,
+    styleDetectRoute,
+    marketRadarRoute,
+    marketRadarScanRoute,
+    marketRadarApplyRoute,
+    marketRadarSyncRoute,
+    marketRadarBriefRoute,
+    knowledgeRoute,
+    bookAnalysisRoute,
+    ideaInspirationRoute,
+    marketIdeaInspirationRoute,
+    directorRoute,
+    directorTodosRoute,
+    llmLiveRoute,
     assistantRoute,
     assistantHistoryRoute,
+    llmPromptRoute,
+    usageResetRoute,
+    timelineRoute,
+    revisionPlanRoute,
+    snapshotRoute,
+    tensionRoute,
+    promptSlotsRoute,
     assistantClearRoute,
     bookshelfRoute,
     bookshelfActivateRoute,
@@ -3360,31 +3744,23 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     renameRoute,
     plotlinesRoute,
     rolesRoute,
-    mangaRolesRoute,
-    exportPackageRoute,
-    scenesRoute,
-    mangaPropsRoute,
-    visualRulesRoute,
     sensitiveRoute,
     reviewBackfillRoute,
     chapterResetRoute,
     chapterApproveRoute,
     configRoute,
+    moveOutputDirRoute,
+    bookSettingsRoute,
     openFolderRoute,
     pluginUpdateRoute,
     outlineSuggestRoute,
     outlineReverseRoute,
-    manhuaPlansRoute,
-    styleImageRoute,
-    storyboardSkeletonRoute,
     llmTestRoute,
     addModelRoute,
     llmVendorsRoute,
     llmModelsRoute,
     llmProvidersRoute,
     llmRemoveRoute,
-    storyboardTableRoute,
-    storyboardPromptsRoute,
     breakdownRoute,
     runStartRoute,
     runControlRoute,