@waterwx/dsh-novel-forge 1.3.2 → 1.3.3-alpha

package/src/routes.ts

@@ -9,16 +9,25 @@
  */
 
 import type { IncomingMessage, ServerResponse } from 'node:http'
-import { exec } from 'node:child_process'
+import { spawn } from 'node:child_process'
 import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
-import { join } from 'node:path'
+import { join, basename, extname } from 'node:path'
+import { randomBytes } from 'node:crypto'
 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,
+  type AddModelRequest,
+  type AddModelResponse,
+  type LlmModelsResponse,
+  type LlmProvidersResponse,
+  type LlmVendorsResponse,
+  type RemoveProviderRequest,
+  type RemoveProviderResponse,
   type AssistantFrame,
   type AssistantHistoryResponse,
   type AssistantRequest,
@@ -35,6 +44,9 @@ import {
   type BibleResponse,
   type BookActivateRequest,
   type BookCreateRequest,
+  type BookImportDirRequest,
+  type BookImportTextRequest,
+  type BookImportTextPreviewRequest,
   type BookRemoveRequest,
   type BookshelfSnapshot,
   type ChapterResponse,
@@ -42,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,
@@ -50,6 +69,17 @@ import {
   type JobFrame,
   type LoadOutlineRequest,
   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,
@@ -65,11 +95,6 @@ import {
   type RewriteRequest,
   type RolesRequest,
   type RolesResponse,
-  type SceneCard,
-  type ScenesRequest,
-  type ScenesResponse,
-  type VisualRulesRequest,
-  type VisualRulesResponse,
   type OutlineSuggestRequest,
   type OutlineSuggestResponse,
   type BreakdownRequest,
@@ -77,17 +102,53 @@ import {
   type SensitiveCheckRequest,
   type SensitiveCheckResponse,
   type SensitiveHit,
+  type ProjectState,
   type StatusResponse,
   type StoryBible,
+  type LlmTestRequest,
+  type LlmTestResponse,
   type StyleEngineRequest,
   type SummaryRequest,
   type VolumesRequest,
   type VolumesResponse,
+  type AuthorAssetsResponse,
+  type AuthorAssetUpsertRequest,
+  type AuthorAssetRemoveRequest,
+  type AdaptAnalyzeRequest,
+  type AdaptAnalyzeResponse,
+  type AdaptProposeRequest,
+  type AdaptProposeResponse,
+  type AdaptExecuteRequest,
+  type AdaptExecuteResponse,
+  type AdaptSaveRequest,
+  type AdaptSaveResponse,
+  type AdaptMaterializeRequest,
+  type AdaptMaterializeResponse,
+  type AdaptMaterializeSaveRequest,
+  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, loadBookshelf, removeBook, renameBook, seedBookshelfFromOutputDir } from './bookshelf.ts'
-import { BUILTIN_ANTI_AI_RULES, BUILTIN_GENRE_LIBRARY, BUILTIN_PROGRESSION_MODES, BUILTIN_STYLE_TEMPLATES, emptyProjectAssets } from './assets.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_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,
@@ -95,9 +156,19 @@ import {
   autoLinkPlotlines,
   backfillFacts,
   createProject,
-  exportBook,
+  exportScope,
+  importBookText,
+  importBookTextFromText,
+  previewBookText,
   extractBible,
   extractStyleAsset,
+  extractStyleFormula,
+  runMarketRadar,
+  runMarketCreativeBrief,
+  runBookAnalysis,
+  runIdeaInspiration,
+  runMarketIdeaInspiration,
+  runDirectorAdvice,
   extractWorld,
   generateBlurb,
   generateChapterStream,
@@ -118,23 +189,52 @@ import {
   analyzePlotlineHealth,
   designPlotlinePlan,
   extractRoles,
-  extractScenes,
-  generateRolePromptKit,
-  extractVisualRules,
-  extractRoleVisual,
   suggestOutlines,
+  reverseOutlineFromChapters,
   breakdownBook,
-  generateRoleReferenceImage,
+  analyzeAdaptation,
+  proposeAdaptation,
+  applyAdaptationReplacements,
+  rewriteAdaptationBook,
+  materializeAdaptedBook,
+  saveMaterializedBook,
+  testLlmModel,
+  registerLlmModel,
+  listLlmVendors,
+  listLlmModels,
+  listLlmProviders,
+  removeLlmProvider,
   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 = 16 * 1024 * 1024
+const MAX_JSON_BODY_BYTES = 64 * 1024 * 1024
+
+/** 包内置风格效果图目录（assets/styles，随 npm 包分发）。 */
+
+/** 解析请求级目标书目录：优先按请求携带的 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 {
@@ -188,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.
@@ -203,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 }
 
@@ -239,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，避免"生成中"状态卡死无法重新生成。
@@ -256,18 +381,55 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
             }
           }
         }
-        syncProjectWithDisk(project, config.outputDir)
-        saveProject(config.outputDir, project)
+        syncProjectWithDisk(project, outputDir)
+        saveProject(outputDir, project)
       }
-      const response: StatusResponse = {
-        config,
+      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 = {
+          bookName: project.bookName,
+          outline: project.outline.slice(0, 200),
+          chapters: project.chapters.map(c => ({
+            no: c.no,
+            volume: c.volume,
+            title: c.title,
+            status: c.status,
+            chars: c.chars,
+            error: c.error,
+            review: c.review !== undefined ? { score: c.review.score, passed: c.review.passed } : undefined,
+          })) as unknown as ProjectState['chapters'],
+          createdAt: project.createdAt,
+          updatedAt: project.updatedAt,
+        } as unknown as ProjectState
+      } else {
         // 瘦身：facts 只回最近 80 条（客户端最多展示 60），避免长篇后
         // status 响应体随编年录无限膨胀。
-        project: project !== undefined
-          ? { ...project, facts: (project.facts ?? []).slice(-80) }
-          : undefined,
+        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)
     },
@@ -372,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
@@ -388,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) {
@@ -403,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
@@ -441,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 须为正整数' })
@@ -479,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 })
+            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)
@@ -557,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 })
@@ -581,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
@@ -620,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
@@ -685,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
@@ -760,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.
@@ -817,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 })
@@ -839,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 须为正整数' })
@@ -852,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
@@ -918,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
       // 保存即审稿：携带工作区审查报告则沿用（不重复审）；否则自动正式审稿一次。
@@ -947,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: '消息不能为空' })
@@ -963,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()
@@ -986,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)
     },
   }
@@ -996,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 })
     },
   }
@@ -1020,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
@@ -1040,14 +1281,16 @@ 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)
     },
@@ -1091,177 +1334,995 @@ 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)
-      if (project === undefined) {
-        writeJson(res, 400, { error: '输出目录中没有项目，无需重置' })
-        return
+      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 })
       }
-      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
+    },
+  }
+
+  // ------------------------------------------------- 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 })
       }
-      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 = {
+  // ------------------------------------------------- market-radar apply
+  /** 把雷达生产底座一键应用到某本书（写入项目资产/开书定盘，供后续规划与生成遵守）。 */
+  const marketRadarApplyRoute: WebRoute = {
     kind: 'exact',
-    path: '/api/dsh-novel-forge/bookshelf/activate',
+    path: NOVEL_API.marketRadarApply,
     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<{ bookId?: string; 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} 不存在` })
+      const config = getConfig()
+      const outputDir = resolveOutputDir(config, body?.bookId)
+      const project = loadProject(outputDir)
+      if (project === undefined) {
+        writeJson(res, 400, { error: '输出目录中没有项目' })
         return
       }
-      writeJson(res, 200, bookshelfSnapshot(loadBookshelf()))
+      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.updatedAt = new Date().toISOString()
+      saveProject(outputDir, project)
+      writeJson(res, 200, { ok: true, bookName: project.bookName })
     },
   }
 
-  // ---------------------------------------------------- bookshelf remove
-  const bookshelfRemoveRoute: WebRoute = {
+  // ------------------------------------------------- market-radar sync
+  /** 把雷达生产底座里的「新资产」同步进全局资源库（跨书复用；已有名字跳过）。 */
+  const marketRadarSyncRoute: WebRoute = {
     kind: 'exact',
-    path: '/api/dsh-novel-forge/bookshelf/remove',
+    path: NOVEL_API.marketRadarSync,
     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 body = await readJsonBody<{ foundation?: ProductionFoundation }>(req)
+      const pf = body?.foundation
+      if (pf === undefined) {
+        writeJson(res, 400, { error: '缺少 foundation' })
         return
       }
-      const removed = removeBook(body.id)
-      if (!removed) {
-        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 })
     },
   }
 
-  // ---------------------------------------------------------------- audit
-  /** 全书一致性质检。 */
-  const auditRoute: WebRoute = {
+  // ------------------------------------------------- market-radar brief
+  /** 开书创意简报：用选中的市场信号 + 影响模式生成。 */
+  const marketRadarBriefRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.audit,
+    path: NOVEL_API.marketRadarBrief,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
       const config = getConfig()
-      const project = requireProject(res)
-      if (project === undefined) return
-      const startedAt = new Date().toISOString()
-      auditState = { status: 'running', startedAt, totalBatches: 0, completedBatches: 0 }
+      const body = await readJsonBody<MarketRadarBriefRequest>(req)
+      if (body === undefined || body.influenceMode === undefined) {
+        writeJson(res, 400, { error: '缺少 influenceMode' })
+        return
+      }
       try {
-        const issues = await auditBook(ctx, config, project, config.outputDir, (completed, total) => {
-          auditState.totalBatches = total
-          auditState.completedBatches = completed
-        })
-        const auditedChapters = project.chapters.filter(c => c.status !== 'pending' && c.status !== 'generating').length
-        auditState = {
-          status: 'done',
-          startedAt,
-          finishedAt: new Date().toISOString(),
-          totalBatches: auditState.totalBatches,
-          completedBatches: auditState.totalBatches,
-          auditedChapters,
-          issuesCount: issues.length,
-          issues,
-        }
-        const response: AuditResponse = {
-          issues,
-          auditedChapters,
-          auditedAt: auditState.finishedAt!,
-        }
-        writeJson(res, 200, response)
+        const creativeBrief = await runMarketCreativeBrief(ctx, config, body)
+        writeJson(res, 200, { creativeBrief })
       } catch (error) {
-        auditState = {
-          ...auditState,
-          status: 'error',
-          finishedAt: new Date().toISOString(),
-          error: (error as Error).message,
-        }
         writeJson(res, 500, { error: (error as Error).message })
       }
     },
   }
 
-  // ----------------------------------------------------- characters refresh
-  /** 角色卡刷新（出场统计精确化 + LLM 聚合状态）。 */
-  const charactersRefreshRoute: WebRoute = {
+  // ------------------------------------------------------------- knowledge
+  /** 书内知识库：GET 读取 / POST 增删改（按书路由）。 */
+  const knowledgeRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.charactersRefresh,
+    path: NOVEL_API.knowledge,
     handler: async (req, res) => {
-      if (!guard(req, res, 'POST')) return
-      const config = getConfig()
+      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
+      }
+      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 })
+    },
+  }
+
+  // ---------------------------------------------------------- book-analysis
+  /** 书分析/拆书：输入文本 → 卖点/结构/可借鉴点/风险。 */
+  const bookAnalysisRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.bookAnalysis,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      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 result = await runBookAnalysis(ctx, config, body)
+        writeJson(res, 200, { result })
+      } catch (error) {
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ---------------------------------------------------------- idea-inspiration
+  /** 创意灵感：一句话/题材 → 多方向开书灵感。 */
+  const ideaInspirationRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.ideaInspiration,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const body = await readJsonBody<IdeaInspirationRequest>(req)
+      if (body === undefined || (body.idea ?? '').trim().length < 2) {
+        writeJson(res, 400, { error: '请填写你的方向/一句话想法' })
+        return
+      }
+      try {
+        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
+        }
+        // 模式一：服务器本地文件
+        const filePath = body?.filePath?.trim()
+        if (filePath === undefined || filePath === '') {
+          writeJson(res, 400, { error: 'filePath 不能为空（或请上传文件内容）' })
+          return
+        }
+        if (!existsSync(filePath)) {
+          writeJson(res, 400, { error: `文件不存在：${filePath}` })
+          return
+        }
+        const bookName = basename(filePath, extname(filePath)).slice(0, 40) || '导入小说'
+        const outDir = body?.outputDir?.trim() !== undefined && body.outputDir.trim() !== ''
+          ? body.outputDir.trim()
+          : defaultBookDir(bookName)
+        const result = importBookText(filePath, outDir)
+        const { book } = importDir(outDir)
+        writeJson(res, 200, { ...result, book })
+      } catch (err) {
+        writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) })
+      }
+    },
+  }
+
+  // --------------------------------------- bookshelf import-text preview
+  /** 上传全文做拆章预览（不落盘、不登记书架）。 */
+  const bookshelfImportTextPreviewRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.bookshelfImportTextPreview,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<BookImportTextPreviewRequest>(req)
+      if (body?.text === undefined || body.text.length === 0) {
+        writeJson(res, 400, { error: 'text 不能为空' })
+        return
+      }
+      try {
+        const bookName = (body.fileName ?? '').replace(/\.[^.]+$/, '').trim().slice(0, 40) || '导入小说'
+        const preview = previewBookText(body.text)
+        writeJson(res, 200, { bookName, ...preview })
+      } catch (err) {
+        writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) })
+      }
+    },
+  }
+
+  // ---------------------------------------------------------------- audit
+  /** 全书一致性质检。 */
+  const auditRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.audit,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) 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 {
+        const issues = await auditBook(ctx, config, project, config.outputDir, (completed, total) => {
+          auditState.totalBatches = total
+          auditState.completedBatches = completed
+        })
+        const auditedChapters = project.chapters.filter(c => c.status !== 'pending' && c.status !== 'generating').length
+        auditState = {
+          status: 'done',
+          startedAt,
+          finishedAt: new Date().toISOString(),
+          totalBatches: auditState.totalBatches,
+          completedBatches: auditState.totalBatches,
+          auditedChapters,
+          issuesCount: issues.length,
+          issues,
+        }
+        const response: AuditResponse = {
+          issues,
+          auditedChapters,
+          auditedAt: auditState.finishedAt!,
+          model: config.auditModel || config.model,
+        }
+        writeJson(res, 200, response)
+      } catch (error) {
+        auditState = {
+          ...auditState,
+          status: 'error',
+          finishedAt: new Date().toISOString(),
+          error: (error as Error).message,
+        }
+        writeJson(res, 500, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ----------------------------------------------------- characters refresh
+  /** 角色卡刷新（出场统计精确化 + LLM 聚合状态）。 */
+  const charactersRefreshRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.charactersRefresh,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
       const project = requireProject(res)
       if (project === undefined) return
       try {
@@ -1297,7 +2358,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
   }
 
   // ---------------------------------------------------------- bible patch
-  /** 设定圣经局部修补（世界观规则/红线/风格）。 */
+  /** 道藏局部修补（世界观规则/红线/风格）。 */
   const biblePatchRoute: WebRoute = {
     kind: 'exact',
     path: NOVEL_API.biblePatch,
@@ -1337,7 +2398,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
   }
 
   // ---------------------------------------------------------------- blurb
-  /** 小说简介：AI 生成/补全，或手动保存。 */
+  /** 小说简介：生成/补全，或手动保存。 */
   const blurbRoute: WebRoute = {
     kind: 'exact',
     path: NOVEL_API.blurb,
@@ -1451,7 +2512,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
   }
 
   // ---------------------------------------------------------------- world
-  /** 大世界：AI 提炼或手动保存（境界体系/区域/势力）。 */
+  /** 大世界：提炼或手动保存（境界体系/区域/势力）。 */
   const worldRoute: WebRoute = {
     kind: 'exact',
     path: NOVEL_API.world,
@@ -1563,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) {
@@ -1658,7 +2719,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
   }
 
   // ---------------------------------------------------------------- roles
-  /** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+  /** 角色库：提炼 / 采纳 / 更新 / 删除。 */
   const rolesRoute: WebRoute = {
     kind: 'exact',
     path: NOVEL_API.roles,
@@ -1686,111 +2747,6 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         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 === 'imageGenerate') {
-        const name = body?.name?.trim()
-        if (name === undefined || name === '') {
-          writeJson(res, 400, { error: 'name（角色名）必填' })
-          return
-        }
-        try {
-          const imageUrl = await generateRoleReferenceImage(ctx, config, project, config.outputDir, name, body?.style ?? '')
-          project.updatedAt = new Date().toISOString()
-          saveProject(config.outputDir, project)
-          writeJson(res, 200, { roles: project.roles, imageUrl } satisfies RolesResponse)
-          return
-        } catch (error) {
-          writeJson(res, 500, { error: `角色参考图生成失败：${(error as Error).message}` })
-          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)
-          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)
-          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
@@ -1942,77 +2898,254 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
           console.warn(`[dsh-novel-forge] author backfill ch.${chapter.no} failed:`, (error as Error).message)
         }
       }
-      project.updatedAt = new Date().toISOString()
-      saveProject(config.outputDir, project)
-      send({ type: 'author-backfill-done', count: done })
-      res.end()
+      project.updatedAt = new Date().toISOString()
+      saveProject(config.outputDir, project)
+      send({ type: 'author-backfill-done', count: done })
+      res.end()
+    },
+  }
+
+  // --------------------------------------------------------------- config
+  const configRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.config,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<ConfigPatch>(req)
+      if (body === undefined) {
+        writeJson(res, 400, { error: '无效的配置 JSON' })
+        return
+      }
+      try {
+        const result = await patchConfig(body)
+        writeJson(res, 200, result satisfies ConfigResponse)
+      } catch (error) {
+        writeJson(res, 400, { error: (error as Error).message })
+      }
+    },
+  }
+
+  // ---------------------------------------------------------- open-folder
+  const openFolderRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.openFolder,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const dir = config.outputDir
+      const child = spawn('explorer', [dir], { shell: false })
+      let responded = false
+      child.on('error', (error) => {
+        if (responded) return
+        responded = true
+        writeJson(res, 500, { ok: false, error: error.message })
+      })
+      child.on('exit', (code) => {
+        if (responded) return
+        responded = true
+        if (code === 0) writeJson(res, 200, { ok: true })
+        else writeJson(res, 500, { ok: false, error: `explorer 退出码 ${code}` })
+      })
+    },
+  }
+
+  // ---------------------------------------------------------- plugin update
+  /** 插件自更新：在 DSH profile 目录拉取最新 npm 版（仅下载，需重启 DSH 生效）。 */
+  const pluginUpdateRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.pluginUpdate,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      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 = ''
+        child.stdout.on('data', (d: Buffer) => { acc += String(d) })
+        child.stderr.on('data', (d: Buffer) => { acc += String(d) })
+        child.on('error', (error) => resolve({ ok: false, message: '无法执行更新：' + error.message }))
+        child.on('close', (code) => {
+          if (code === 0) resolve({ ok: true, message: '已更新到最新版本，请重启 DSH 生效。' })
+          else resolve({ ok: false, message: '更新失败（退出码 ' + code + '）：' + acc.slice(-400) })
+        })
+      })
+      writeJson(res, 200, response)
+    },
+  }
+
+  // ------------------------------------------------------- outline suggest
+  /** 开书想法 → AI 大纲：2-3 个可选方案（支持暂留换批：count 只补空槽 + exclude 避开已留方向）。 */
+  const outlineSuggestRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.outlineSuggest,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const body = await readJsonBody<OutlineSuggestRequest>(req)
+      const idea = body?.idea?.trim() ?? ''
+      if (idea.length < 50) {
+        writeJson(res, 400, { error: '想法太短（<50 字），请多写一两句：主角是谁、什么世界、想要什么爽点' })
+        return
+      }
+      const count = body?.count !== undefined ? Math.max(1, Math.min(3, Math.floor(body.count))) : 3
+      const exclude = Array.isArray(body?.exclude) ? body.exclude.filter((e): e is string => typeof e === 'string' && e.trim() !== '').map(e => e.trim().slice(0, 200)) : []
+      try {
+        const candidates = await suggestOutlines(ctx, config, idea, count, exclude)
+        const response: OutlineSuggestResponse = { candidates }
+        writeJson(res, 200, response)
+      } catch (error) {
+        writeJson(res, 500, { error: `大纲方案生成失败：${(error as Error).message}` })
+      }
+    },
+  }
+
+  // ------------------------------------------------- outline reverse
+  /** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流式进度）。 */
+  const outlineReverseRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.outlineReverse,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const config = getConfig()
+      const project = requireProject(res)
+      if (project === undefined) return
+      res.writeHead(200, {
+        'content-type': 'application/x-ndjson; charset=utf-8',
+        'cache-control': 'no-cache',
+        'x-accel-buffering': 'no',
+        'referrer-policy': 'no-referrer',
+      })
+      const send = (frame: JobFrame): void => {
+        res.write(JSON.stringify(frame) + '\n')
+      }
+      try {
+        const outline = await reverseOutlineFromChapters(ctx, config, project, config.outputDir, (done, total, phase) => {
+          send({ type: 'outline-progress', done, total, phase })
+        })
+        // 保存总纲（仅更新文本，不动书名/进度）。
+        project.outline = outline
+        project.updatedAt = new Date().toISOString()
+        saveProject(config.outputDir, project)
+        send({ type: 'outline-done', outline, chars: outline.length })
+      } catch (error) {
+        send({ type: 'error', no: 0, message: (error as Error).message })
+      } finally {
+        res.end()
+      }
+    },
+  }
+
+  // ------------------------------------------------------------- llm-test
+  /** LLM 连通性测试：对选中的提供商/模型发一次最小真实调用。 */
+  const llmTestRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.llmTest,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<LlmTestRequest>(req)
+      const provider = (body?.provider ?? '').trim()
+      const model = (body?.model ?? '').trim()
+      if (provider === '' || model === '') {
+        writeJson(res, 400, { error: 'provider 与 model 必填' })
+        return
+      }
+      const result = await testLlmModel(ctx, provider, model)
+      writeJson(res, 200, result satisfies LlmTestResponse)
     },
   }
 
-  // --------------------------------------------------------------- config
-  const configRoute: WebRoute = {
+  // ------------------------------------------------------------- llm-add
+  /** 添加模型：厂商直填 API Key，或自定义 OpenAI 兼容路由（写 DSH 凭据 + router）。 */
+  const addModelRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.config,
+    path: NOVEL_API.addModel,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const body = await readJsonBody<ConfigPatch>(req)
+      const body = await readJsonBody<AddModelRequest>(req)
       if (body === undefined) {
-        writeJson(res, 400, { error: '无效的配置 JSON' })
+        writeJson(res, 400, { error: '缺少请求体' })
         return
       }
       try {
-        const next = await patchConfig(body)
-        writeJson(res, 200, { config: next })
+        const result = await registerLlmModel(ctx, body)
+        writeJson(res, 200, result satisfies AddModelResponse)
       } catch (error) {
-        writeJson(res, 400, { error: (error as Error).message })
+        writeJson(res, 500, { error: `添加模型失败：${(error as Error).message}` })
       }
     },
   }
 
-  // ---------------------------------------------------------- open-folder
-  const openFolderRoute: WebRoute = {
+  // ---------------------------------------------------------- llm-vendors
+  /** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+  const llmVendorsRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.openFolder,
+    path: NOVEL_API.llmVendors,
     handler: async (req, res) => {
-      if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const dir = config.outputDir
-      exec(`explorer "${dir.replace(/"/g, '')}"`, (error) => {
-        if (error) {
-          writeJson(res, 500, { ok: false, error: error.message })
-        } else {
-          writeJson(res, 200, { ok: true })
-        }
-      })
+      if (!guard(req, res, 'GET')) return
+      try {
+        const result = await listLlmVendors(ctx)
+        writeJson(res, 200, result satisfies LlmVendorsResponse)
+      } catch (error) {
+        writeJson(res, 500, { error: `读取厂商目录失败：${(error as Error).message}` })
+      }
     },
   }
 
-  // ------------------------------------------------------- outline suggest
-  /** 开书想法 → AI 大纲：2-3 个可选方案（支持暂留换批：count 只补空槽 + exclude 避开已留方向）。 */
-  const outlineSuggestRoute: WebRoute = {
+  // ---------------------------------------------------------- llm-models
+  /** 查询某个 provider 当前可用的模型（添加成功后可即时刷新下拉）。 */
+  const llmModelsRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.outlineSuggest,
+    path: NOVEL_API.llmModels,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'GET')) return
+      const url = new URL(req.url ?? '', 'http://localhost')
+      const provider = decodeURIComponent((url.searchParams.get('provider') ?? '').trim())
+      try {
+        const result = await listLlmModels(ctx, provider)
+        writeJson(res, 200, result satisfies LlmModelsResponse)
+      } catch (error) {
+        writeJson(res, 500, { error: `读取模型列表失败：${(error as Error).message}` })
+      }
+    },
+  }
+
+  // ---------------------------------------------------------- llm-providers
+  /** 已注册的提供方路由列表（提供方管理卡片）。 */
+  const llmProvidersRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.llmProviders,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'GET')) return
+      try {
+        const result = await listLlmProviders(ctx)
+        writeJson(res, 200, result satisfies LlmProvidersResponse)
+      } catch (error) {
+        writeJson(res, 500, { error: `读取提供方列表失败：${(error as Error).message}` })
+      }
+    },
+  }
+
+  // ------------------------------------------------------------- llm-remove
+  /** 移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+  const llmRemoveRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.llmRemove,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const config = getConfig()
-      const body = await readJsonBody<OutlineSuggestRequest>(req)
-      const idea = body?.idea?.trim() ?? ''
-      if (idea.length < 50) {
-        writeJson(res, 400, { error: '想法太短（<50 字），请多写一两句：主角是谁、什么世界、想要什么爽点' })
+      const body = await readJsonBody<RemoveProviderRequest>(req)
+      if (body === undefined) {
+        writeJson(res, 400, { error: '缺少请求体' })
         return
       }
-      const count = body?.count !== undefined ? Math.max(1, Math.min(3, Math.floor(body.count))) : 3
-      const exclude = Array.isArray(body?.exclude) ? body.exclude.filter((e): e is string => typeof e === 'string' && e.trim() !== '').map(e => e.trim().slice(0, 200)) : []
       try {
-        const candidates = await suggestOutlines(ctx, config, idea, count, exclude)
-        const response: OutlineSuggestResponse = { candidates }
-        writeJson(res, 200, response)
+        const result = await removeLlmProvider(ctx, body)
+        writeJson(res, 200, result satisfies RemoveProviderResponse)
       } catch (error) {
-        writeJson(res, 500, { error: `大纲方案生成失败：${(error as Error).message}` })
+        writeJson(res, 500, { error: `移除提供方失败：${(error as Error).message}` })
       }
     },
   }
 
+
   // ----------------------------------------------------------- breakdown
   /** 拆书分析：对已写章节做结构/人物/文风/卖点体检（两阶段：源笔记→分节分析）。 */
   const breakdownRoute: WebRoute = {
@@ -2041,114 +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 candidates = await extractScenes(ctx, config, project)
-          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)
+      if (runner.isWorking()) {
+        writeJson(res, 409, { error: '生产单正在运行中，请先停止后再迁移目录' })
+        return
+      }
+      const to = body?.to?.trim() ?? ''
+      if (to === '') {
+        writeJson(res, 400, { error: '新目录路径不能为空' })
+        return
+      }
+      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,
+      })
     },
   }
 
-  // ----------------------------------------------------------- visual rules
-  /** 视觉世界观规则：从道藏提炼（生图/生视频纠偏），或手动保存。 */
-  const visualRulesRoute: WebRoute = {
+  // ----------------------------------------------------------- book-settings
+  /**
+   * 本书参数：POST {} 读取当前书的 settings + 生效配置（全局+本书回退链）；
+   * POST {patch} 白名单合并保存到 novel-project.json.bookSettings。
+   */
+  const bookSettingsRoute: WebRoute = {
     kind: 'exact',
-    path: NOVEL_API.visualRules,
+    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<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}` })
+      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.rules)) {
-        project.visualRules = body.rules.filter(r => typeof r === 'string' && r.trim() !== '').map(r => r.trim().slice(0, 80)).slice(0, 12)
+        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, { rules: project.visualRules } satisfies VisualRulesResponse)
-        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
@@ -2165,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 })
@@ -2204,6 +3351,337 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     },
   }
 
+  // -------------------------------------------------- author assets (总数据)
+  const authorAssetsRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.authorAssets,
+    handler: (req, res) => {
+      if (!guard(req, res, 'GET')) return
+      const response: AuthorAssetsResponse = { assets: loadAuthorAssets() }
+      writeJson(res, 200, response)
+    },
+  }
+
+  const authorAssetsUpsertRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.authorAssetsUpsert,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<AuthorAssetUpsertRequest>(req)
+      const asset = body?.asset
+      if (asset === undefined || asset.name.trim() === '' || asset.content.trim() === '') {
+        writeJson(res, 400, { error: 'asset 须含 name / content' })
+        return
+      }
+      const response: AuthorAssetsResponse = { assets: upsertAuthorAsset(asset) }
+      writeJson(res, 200, response)
+    },
+  }
+
+  const authorAssetsRemoveRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.authorAssetsRemove,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<AuthorAssetRemoveRequest>(req)
+      const id = body?.id ?? ''
+      if (id === '') { writeJson(res, 400, { error: 'id 必填' }); return }
+      const response: AuthorAssetsResponse = { assets: removeAuthorAsset(id) }
+      writeJson(res, 200, response)
+    },
+  }
+
+  const authorAssetsImportDefaultRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.authorAssetsImportDefault,
+    handler: (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const response: AuthorAssetsResponse = { assets: importDefaultAuthorAssets() }
+      writeJson(res, 200, response)
+    },
+  }
+
+  // --------------------------------------------------- adaptation (改编 P0 分析)
+  const adaptAnalyzeRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.adaptAnalyze,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      if (!getConfig().enableAdaptMode) { writeJson(res, 404, { error: '改编模式未开启' }); return }
+      const body = await readJsonBody<AdaptAnalyzeRequest>(req)
+      const config = getConfig()
+      let text = body?.text?.trim() ?? ''
+      if (text === '' && body?.filePath !== undefined && body.filePath !== '') {
+        try {
+          text = readFileSync(body.filePath, 'utf8')
+        } catch (err) {
+          writeJson(res, 400, { error: '读取文件失败：' + (err as Error).message })
+          return
+        }
+      }
+      if (text.length < 200) {
+        writeJson(res, 400, { error: '全文内容过短（<200 字符），请上传完整小说文本' })
+        return
+      }
+      try {
+        const response: AdaptAnalyzeResponse = await analyzeAdaptation(ctx, config, text)
+        writeJson(res, 200, response)
+      } catch (err) {
+        writeJson(res, 400, { error: (err as Error).message })
+      }
+    },
+  }
+
+  const adaptProposeRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.adaptPropose,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      if (!getConfig().enableAdaptMode) { writeJson(res, 404, { error: '改编模式未开启' }); return }
+      const body = await readJsonBody<AdaptProposeRequest>(req)
+      const config = getConfig()
+      const text = (body?.text ?? '').trim()
+      const selections = body?.selections ?? []
+      if (text.length < 200 || selections.length === 0) {
+        writeJson(res, 400, { error: '请提供全文与至少一条要改的维度' })
+        return
+      }
+      try {
+        const response: AdaptProposeResponse = await proposeAdaptation(ctx, config, text, selections, body?.dimensions)
+        writeJson(res, 200, response)
+      } catch (err) {
+        writeJson(res, 400, { error: (err as Error).message })
+      }
+    },
+  }
+
+  const adaptExecuteRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.adaptExecute,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      if (!getConfig().enableAdaptMode) { writeJson(res, 404, { error: '改编模式未开启' }); return }
+      const body = await readJsonBody<AdaptExecuteRequest>(req)
+      const text = body?.text ?? ''
+      const mappings = body?.mappings ?? []
+      if (text.length < 200 || mappings.length === 0) {
+        writeJson(res, 400, { error: '请提供全文与映射表' })
+        return
+      }
+      if (body?.mode === 'rewrite') {
+        try {
+          const result = await rewriteAdaptationBook(ctx, getConfig(), text, mappings, body?.rules, { maxChapters: body?.maxChapters, startNo: body?.startNo, endNo: body?.endNo })
+          const response: AdaptExecuteResponse = { adaptedText: result.adaptedText, mappings: mappings.length, hits: result.hits, mode: 'rewrite', rewritten: result.rewritten, skipped: result.skipped }
+          writeJson(res, 200, response)
+        } catch (err) {
+          writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) })
+        }
+        return
+      }
+      const { adaptedText, hits } = applyAdaptationReplacements(text, mappings)
+      const response: AdaptExecuteResponse = { adaptedText, mappings: mappings.length, hits, mode: 'replace' }
+      writeJson(res, 200, response)
+    },
+  }
+
+  /** rewrite 逐章重写：NDJSON 流式进度（支持分段 startNo/endNo）。 */
+  const adaptRewriteStreamRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.adaptRewriteStream,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      if (!getConfig().enableAdaptMode) { writeJson(res, 404, { error: '改编模式未开启' }); return }
+      const body = await readJsonBody<AdaptExecuteRequest>(req)
+      const text = body?.text ?? ''
+      const mappings = body?.mappings ?? []
+      if (text.length < 200 || mappings.length === 0) { writeJson(res, 400, { error: '请提供全文与映射表' }); return }
+      res.writeHead(200, {
+        'content-type': 'application/x-ndjson; charset=utf-8',
+        'cache-control': 'no-cache',
+        'x-accel-buffering': 'no',
+        'referrer-policy': 'no-referrer',
+      })
+      const send = (frame: AdaptRewriteFrame): void => { res.write(JSON.stringify(frame) + '\n') }
+      try {
+        const result = await rewriteAdaptationBook(ctx, getConfig(), text, mappings, body?.rules, {
+          maxChapters: body?.maxChapters,
+          startNo: body?.startNo,
+          endNo: body?.endNo,
+          onProgress: (info) => send({ type: 'progress', completed: info.completed, total: info.total, no: info.no, title: info.title }),
+        })
+        const response: AdaptExecuteResponse = { adaptedText: result.adaptedText, mappings: mappings.length, hits: result.hits, mode: 'rewrite', rewritten: result.rewritten, skipped: result.skipped }
+        send({ type: 'done', result: response })
+      } catch (err) {
+        send({ type: 'error', message: err instanceof Error ? err.message : String(err) })
+      } finally {
+        res.end()
+      }
+    },
+  }
+
+  /** 保存改编全文为新书（原书保留，登记书架）。 */
+  const adaptSaveRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.adaptSave,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      if (!getConfig().enableAdaptMode) { writeJson(res, 404, { error: '改编模式未开启' }); return }
+      const body = await readJsonBody<AdaptSaveRequest>(req)
+      const text = (body?.text ?? '').trim()
+      if (text.length < 200) {
+        writeJson(res, 400, { error: '改编全文内容过短（<200 字符）' })
+        return
+      }
+      const bookName = (body?.bookName ?? '').trim().slice(0, 40) || '改编新书'
+      const outDir = (body?.outputDir ?? '').trim() !== '' && body?.outputDir !== undefined && body.outputDir.trim() !== ''
+        ? body.outputDir.trim()
+        : defaultOutputDirFor(bookName)
+      // 原书保留：若目录已被另一本书占用则拒绝，避免误覆盖原书/别的书。
+      const occupied = loadBookshelf().books.find(b => b.outputDir === outDir)
+      if (occupied !== undefined && occupied.bookName !== bookName) {
+        writeJson(res, 409, { error: `目录已被《${occupied.bookName}》占用，请更换书名或输出目录` })
+        return
+      }
+      try {
+        const result = importBookTextFromText(text, outDir, bookName)
+        // 有反推大纲时写进新项目，便于后续续写/编辑（importBookTextFromText 默认 outline=书名）。
+        const outline = (body?.outline ?? '').trim()
+        if (outline !== '') {
+          const project = loadProject(outDir)
+          if (project !== undefined) {
+            project.outline = outline
+            saveProject(outDir, project)
+          }
+        }
+        const { book } = importDir(outDir)
+        const response: AdaptSaveResponse = { book, bookName: result.bookName, chapters: result.chapters, skipped: result.skipped, outputDir: outDir }
+        writeJson(res, 200, response)
+      } catch (err) {
+        writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) })
+      }
+    },
+  }
+
+  /** 从源全文 + 编辑后方案提炼新书资料并保存为「待写新书」。 */
+  const adaptMaterializeRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.adaptMaterialize,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      if (!getConfig().enableAdaptMode) { writeJson(res, 404, { error: '改编模式未开启' }); return }
+      const body = await readJsonBody<AdaptMaterializeRequest>(req)
+      const text = (body?.text ?? '').trim()
+      if (text.length < 200) { writeJson(res, 400, { error: '源书全文内容过短（<200 字符）' }); return }
+      const proposal = body?.proposal
+      if (proposal === undefined || proposal.mappings.length === 0) { writeJson(res, 400, { error: '请先提供至少一条映射的改编方案' }); return }
+      const bookName = (body?.bookName ?? '').trim().slice(0, 40) || '改编新书'
+      const outDir = (body?.outputDir ?? '').trim() !== '' && body?.outputDir !== undefined && body.outputDir.trim() !== ''
+        ? body.outputDir.trim()
+        : defaultOutputDirFor(bookName)
+      // 原书保留：若目录已被另一本书占用则拒绝。
+      const occupied = loadBookshelf().books.find(b => b.outputDir === outDir)
+      if (occupied !== undefined && occupied.bookName !== bookName) {
+        writeJson(res, 409, { error: `目录已被《${occupied.bookName}》占用，请更换书名或输出目录` })
+        return
+      }
+      try {
+        const result = await materializeAdaptedBook(ctx, getConfig(), {
+          text,
+          bookName,
+          outputDir: outDir,
+          outline: body?.outline,
+          proposal,
+          chapterCount: body?.chapterCount,
+        })
+        // 预览：只返回提炼资料，不落盘；保存走 /adapt/materialize-save。
+        const response: AdaptMaterializeResponse = result
+        writeJson(res, 200, response)
+      } catch (err) {
+        writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) })
+      }
+    },
+  }
+
+  /** 保存预览/微调后的新书资料为新书（原书保留，登记书架）。 */
+  const adaptMaterializeSaveRoute: WebRoute = {
+    kind: 'exact',
+    path: NOVEL_API.adaptMaterializeSave,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      if (!getConfig().enableAdaptMode) { writeJson(res, 404, { error: '改编模式未开启' }); return }
+      const body = await readJsonBody<AdaptMaterializeSaveRequest>(req)
+      if (body === undefined || body === null || (body.outline ?? '').trim() === '') {
+        writeJson(res, 400, { error: '请提供改编后总纲' })
+        return
+      }
+      const bookName = (body.bookName ?? '').trim().slice(0, 40) || '改编新书'
+      const outDir = (body.outputDir ?? '').trim() !== '' && body.outputDir !== undefined && body.outputDir.trim() !== ''
+        ? body.outputDir.trim()
+        : defaultOutputDirFor(bookName)
+      const occupied = loadBookshelf().books.find(b => b.outputDir === outDir)
+      if (occupied !== undefined && occupied.bookName !== bookName) {
+        writeJson(res, 409, { error: `目录已被《${occupied.bookName}》占用，请更换书名或输出目录` })
+        return
+      }
+      try {
+        const result = saveMaterializedBook(outDir, bookName, {
+          outline: body.outline,
+          bible: body.bible,
+          roles: body.roles,
+          world: body.world,
+          volumes: body.volumes,
+          chapters: body.chapters,
+        })
+        const { book } = importDir(outDir)
+        const response: AdaptMaterializeSaveResponse = { ...result, book }
+        writeJson(res, 200, response)
+      } catch (err) {
+        writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) })
+      }
+    },
+  }
+
+  // ------------------------------------------ theme custom background (upload + serve)
+  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 = {
+    kind: 'exact',
+    path: NOVEL_API.themeBackgroundUpload,
+    handler: async (req, res) => {
+      if (!guard(req, res, 'POST')) return
+      const body = await readJsonBody<{ dataUrl?: string }>(req)
+      const dataUrl = body?.dataUrl ?? ''
+      const m = /^data:image\/(png|jpeg|jpg|webp|gif);base64,(.+)$/i.exec(dataUrl)
+      if (m === null) { writeJson(res, 400, { error: '仅支持 PNG/JPG/WebP/GIF 图片' }); return }
+      const ext = m[1]!.toLowerCase() === 'jpg' ? 'jpeg' : m[1]!.toLowerCase()
+      const buf = Buffer.from(m[2]!, 'base64')
+      if (buf.length === 0) { writeJson(res, 400, { error: '图片数据为空' }); return }
+      mkdirSync(THEME_BG_DIR, { recursive: true })
+      const name = 'theme-bg-' + Date.now().toString(36) + '-' + randomBytes(3).toString('hex') + '.' + ext
+      writeFileSync(join(THEME_BG_DIR, name), buf)
+      writeJson(res, 200, { url: NOVEL_API.themeBackgroundGet + '/' + name })
+    },
+  }
+
+  const themeBackgroundGetRoute: WebRoute = {
+    kind: 'prefix',
+    path: NOVEL_API.themeBackgroundGet,
+    handler: (req, res) => {
+      if (!guard(req, res, 'GET')) return
+      let pathName = ''
+      try { pathName = new URL(req.url ?? '', 'http://localhost').pathname } catch { /* ignore */ }
+      const name = basename(pathName)
+      if (!name.startsWith('theme-bg-')) { writeJson(res, 404, { error: 'not found' }); return }
+      const file = join(THEME_BG_DIR, name)
+      if (!existsSync(file)) { writeJson(res, 404, { error: 'not found' }); return }
+      const ext = extname(file).slice(1)
+      const type = MIME_BY_EXT[ext] ?? 'application/octet-stream'
+      res.writeHead(200, { 'content-type': type, 'cache-control': 'public, max-age=31536000' })
+      res.end(readFileSync(file))
+    },
+  }
+
   return [
     statusRoute,
     loadOutlineRoute,
@@ -2225,12 +3703,36 @@ 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,
     bookshelfRemoveRoute,
+    bookshelfImportDirRoute,
+    bookshelfImportTextRoute,
+    bookshelfImportTextPreviewRoute,
     resetRoute,
     auditRoute,
     charactersRefreshRoute,
@@ -2242,19 +3744,40 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     renameRoute,
     plotlinesRoute,
     rolesRoute,
-    scenesRoute,
-    visualRulesRoute,
     sensitiveRoute,
     reviewBackfillRoute,
     chapterResetRoute,
     chapterApproveRoute,
     configRoute,
+    moveOutputDirRoute,
+    bookSettingsRoute,
     openFolderRoute,
+    pluginUpdateRoute,
     outlineSuggestRoute,
+    outlineReverseRoute,
+    llmTestRoute,
+    addModelRoute,
+    llmVendorsRoute,
+    llmModelsRoute,
+    llmProvidersRoute,
+    llmRemoveRoute,
     breakdownRoute,
     runStartRoute,
     runControlRoute,
     runStatusRoute,
+    authorAssetsRoute,
+    authorAssetsUpsertRoute,
+    authorAssetsRemoveRoute,
+    authorAssetsImportDefaultRoute,
+    adaptAnalyzeRoute,
+    adaptProposeRoute,
+    adaptExecuteRoute,
+    adaptSaveRoute,
+    adaptMaterializeRoute,
+    adaptMaterializeSaveRoute,
+    adaptRewriteStreamRoute,
+    themeBackgroundUploadRoute,
+    themeBackgroundGetRoute,
   ]
 }