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

package/src/market-radar-scan.ts

@@ -18,12 +18,6 @@ export interface MarketScanResult {
   groups: MarketRadarGroup[]
 }
 
-let lastScan: MarketScanResult | null = null
-
-export function getLastMarketScan(): MarketScanResult | null {
-  return lastScan
-}
-
 export async function scanMarketRanking(platforms?: string[]): Promise<MarketScanResult> {
   const wanted = new Set<string>(platforms?.length ? platforms : ['fanqie', 'qidian', 'jinjiang'])
   const sources = MARKET_RADAR_SOURCES.filter(s => wanted.has(s.platform))
@@ -36,6 +30,6 @@ export async function scanMarketRanking(platforms?: string[]): Promise<MarketSca
       groups.push({ platform: source.platform, platformLabel: source.platformLabel, listKey: source.listKey, listLabel: source.listLabel, status: 'error', error: (error as Error).message, items: [] })
     }
   }))
-  lastScan = { scannedAt: new Date().toISOString(), groups }
-  return lastScan
+  const result: MarketScanResult = { scannedAt: new Date().toISOString(), groups }
+  return result
 }

package/src/model-capability.ts

@@ -0,0 +1,215 @@
+/**
+ * 模型参数能力兼容层。
+ *
+ * 设计原则：**界面上保存的温度/思考档位是用户偏好，不是最终请求值。** 构造请求前
+ * 必须经过本层收敛到厂商允许的范围 —— 否则换模型、走自定义中转、或厂商改了约束，
+ * 就会出现「换个 provider 就报参数错误」这类故障。
+ *
+ * 两条硬要求：
+ *  1. **按模型身份判断，不按 provider 判断**。同一个模型经由自定义中转调用时，
+ *     provider 名可能完全自定义，但参数约束属于模型本身；把判断写成
+ *     `provider === '某个厂商' && ...` 会让走中转的调用绕过约束。
+ *  2. **约束要有出处**。每条规则的来源写在规则上，不靠猜。下列规则来自厂商官方
+ *     《模型参数参考》（https://platform.kimi.com/docs/api/models-overview.md）：
+ *       · kimi-k3        : temperature 固定 1.0；支持顶层 reasoning_effort
+ *       · kimi-k2.7-code : temperature 固定 1.0；不支持 reasoning_effort（用 thinking，且不可禁用）
+ *       · kimi-k2.6      : thinking 固定 1.0 / 非 thinking 固定 0.6；不支持 reasoning_effort
+ *     官方同时建议：这类模型**不要显式传入 temperature**。本层因此优先「不传」，
+ *     仅在调用方无法省略该参数时才钳到允许值。
+ */
+
+/** 一次请求的参数约束。 */
+export interface ModelCapability {
+  /** 该模型只接受这一个温度值（如 Kimi 全系），缺省表示不约束。 */
+  fixedTemperature?: number
+  /** 温度允许的下界（默认 0）。 */
+  minTemperature?: number
+  /** 温度允许的上界（默认 2，主流 OpenAI 兼容区间）。 */
+  maxTemperature?: number
+  /**
+   * 是否支持 OpenAI 兼容的 `reasoning_effort`。
+   * false 表示**不得下发**该参数（如 Kimi K2.x 用的是 `thinking`），下发会被厂商拒绝。
+   */
+  supportsReasoning?: boolean
+  /**
+   * 推理控制方式：`reasoning_effort`（OpenAI 兼容顶层参数）或 `thinking`（Kimi K2.x 专属）。
+   * 运行时若适配层支持，应按此选择参数名；仅为诊断与后续适配保留。
+   */
+  reasoningControl?: 'reasoning-effort' | 'thinking' | 'none'
+  /** 严格结构化输出必须关闭思考（覆盖用户偏好）。 */
+  reasoningForcedOff?: boolean
+  /** 命中的规则名，用于日志与测试断言。 */
+  rule: string
+  /** 约束出处（文档 URL 或说明），便于复核与更新。 */
+  source: string
+}
+
+/** 一道匹配规则：先命中先生效。 */
+interface CapabilityRule {
+  /** 规则名。 */
+  rule: string
+  /** 约束出处。 */
+  source: string
+  /** 模型 id 归一化后是否命中。 */
+  matches: (canonical: string) => boolean
+  capability: Omit<ModelCapability, 'rule' | 'source'>
+}
+
+const KIMI_SOURCE = 'https://platform.kimi.com/docs/api/models-overview.md'
+
+/**
+ * 把模型 id 归一化为「模型身份」。
+ *
+ * 处理：去空白与首尾斜杠、小写、剥掉供应商前缀（`kimi/kimi-k3` → `kimi-k3`）。
+ * @param model - 原始模型 id。
+ * @returns 归一化后的身份（小写、无前缀）。
+ */
+export function canonicalModelId(model: string | undefined): string {
+  if (typeof model !== 'string') return ''
+  const trimmed = model.trim().toLowerCase().replace(/^\/+|\/+$/g, '')
+  if (trimmed === '') return ''
+  const segments = trimmed.split('/')
+  return segments[segments.length - 1] ?? ''
+}
+
+const RULES: CapabilityRule[] = [
+  {
+    rule: 'kimi-k3-fixed-temperature',
+    source: KIMI_SOURCE,
+    // 只命中 k3 本身；k2.6 / k2.7 另立规则（约束不同）。
+    matches: (m) => /^kimi[-_.]?k-?3(?:[-_.]|$)/.test(m),
+    capability: { fixedTemperature: 1, supportsReasoning: true, reasoningControl: 'reasoning-effort' },
+  },
+  {
+    rule: 'kimi-k2.7-code-fixed-temperature',
+    source: KIMI_SOURCE,
+    matches: (m) => /^kimi[-_.]?k-?2[-_.]?7(?:[-_.]|$)/.test(m),
+    capability: {
+      fixedTemperature: 1,
+      // 不支持 reasoning_effort；思考由 thinking 控制且不可禁用。
+      supportsReasoning: false,
+      reasoningControl: 'thinking',
+      reasoningForcedOff: true,
+    },
+  },
+  {
+    rule: 'kimi-k2.6-temperature-by-thinking',
+    source: KIMI_SOURCE,
+    matches: (m) => /^kimi[-_.]?k-?2[-_.]?6(?:[-_.]|$)/.test(m),
+    capability: {
+      // 思考模式 1.0 / 非思考 0.6；本插件的结构化任务默认关闭思考，故取 0.6 不安全，
+      // 统一收敛到 1.0（思考档），避免"关思考却给 1.0"这类组合出错。
+      fixedTemperature: 1,
+      supportsReasoning: false,
+      reasoningControl: 'thinking',
+    },
+  },
+  {
+    rule: 'deepseek-reasoner-fixed-temperature',
+    source: 'OpenAI 兼容约定：DeepSeek R1/reasoner 不接受自定义 temperature',
+    matches: (m) => /^deepseek[-_.]?(r1|reasoner)(?:[-_.]|$)/.test(m),
+    capability: { fixedTemperature: 1, supportsReasoning: true, reasoningControl: 'reasoning-effort' },
+  },
+]
+
+/**
+ * 解析一条模型的能力约束。
+ * @param model - 模型 id（可能带供应商前缀）。
+ * @returns 命中的能力；无约束时返回 undefined。
+ */
+export function resolveModelCapability(model: string | undefined): ModelCapability | undefined {
+  const canonical = canonicalModelId(model)
+  if (canonical === '') return undefined
+  for (const rule of RULES) {
+    if (rule.matches(canonical)) return { ...rule.capability, rule: rule.rule, source: rule.source }
+  }
+  return undefined
+}
+
+/** 一次待收敛的请求参数。 */
+export interface RequestParams {
+  temperature: number
+  /** 请求方（含用户偏好）希望使用的思考档位；undefined 表示不涉及。 */
+  reasoningEffort?: 'off' | 'low' | 'high' | 'max'
+}
+
+/** 收敛结果：最终请求值 + 发生了哪些调整（便于日志与诊断）。 */
+export interface ConvergedParams {
+  /**
+   * 最终要下发的温度；`undefined` 表示**应当省略该参数**。
+   * 厂商建议这类模型不要显式传 temperature 时，本层返回 undefined。
+   */
+  temperature: number | undefined
+  reasoningEffort?: 'off' | 'low' | 'high' | 'max'
+  /** 被本层改掉的项，形如 `temperature: 0.3 -> 省略`。 */
+  adjustments: string[]
+  /** 命中的规则名。 */
+  rule?: string
+  /** 约束出处。 */
+  source?: string
+}
+
+/**
+ * 把请求参数收敛到模型允许的范围。
+ *
+ * @param params - 调用方希望使用的参数。
+ * @param model - 实际要调用的模型 id（应传**实际模型**；换备用模型后需重算）。
+ * @param options - `structured: true` 表示这是严格结构化输出任务；
+ *   `omitFixedTemperature: true` 表示调用方可以不传温度（推荐，厂商建议如此），
+ *   此时固定温度会收敛为 undefined 而不是钳到固定值。
+ * @returns 最终请求值与被调整项。
+ */
+export function convergeRequestParams(
+  params: RequestParams,
+  model: string | undefined,
+  options: { structured?: boolean; omitFixedTemperature?: boolean } = {},
+): ConvergedParams {
+  const capability = resolveModelCapability(model)
+  const adjustments: string[] = []
+  let temperature: number | undefined = params.temperature
+  let reasoningEffort = params.reasoningEffort
+
+  if (capability?.fixedTemperature !== undefined) {
+    const fixed = capability.fixedTemperature
+    if (options.omitFixedTemperature === true) {
+      if (temperature !== undefined) {
+        adjustments.push(`temperature: ${temperature} -> 省略（${capability.rule} 固定 ${fixed}，厂商建议不要显式传入）`)
+      }
+      temperature = undefined
+    } else if (temperature !== fixed) {
+      adjustments.push(`temperature: ${temperature} -> ${fixed}（${capability.rule} 固定值）`)
+      temperature = fixed
+    }
+  } else if (capability !== undefined) {
+    const min = capability.minTemperature ?? 0
+    const max = capability.maxTemperature ?? 2
+    const clamped = Math.min(max, Math.max(min, temperature ?? min))
+    if (clamped !== temperature) {
+      adjustments.push(`temperature: ${temperature} -> ${clamped}（${capability.rule} 取值范围）`)
+      temperature = clamped
+    }
+  }
+
+  // 不支持 reasoning_effort 的模型：不得下发该参数，否则厂商直接报错。
+  if (capability?.supportsReasoning === false && reasoningEffort !== undefined) {
+    if (reasoningEffort !== 'off') {
+      adjustments.push(`reasoningEffort: ${reasoningEffort} -> 省略（${capability.rule} 不支持该参数）`)
+    }
+    reasoningEffort = undefined
+  }
+
+  // 严格结构化任务：能力档案要求关闭思考时，覆盖用户偏好（输出稳定性优先）。
+  if (options.structured === true && capability?.reasoningForcedOff === true && reasoningEffort !== undefined) {
+    adjustments.push(`reasoningEffort: ${reasoningEffort} -> off（结构化任务强制关闭思考）`)
+    reasoningEffort = 'off'
+    // 该模型通过 thinking 控制且不可禁用：等价于不传任何推理参数。
+    if (capability.reasoningControl === 'thinking') reasoningEffort = undefined
+  }
+
+  return {
+    temperature,
+    reasoningEffort,
+    adjustments,
+    ...(capability === undefined ? {} : { rule: capability.rule, source: capability.source }),
+  }
+}

package/src/output-budget.ts

@@ -0,0 +1,147 @@
+/**
+ * 结构化输出预算与字段长度合同。
+ *
+ * 背景：本插件此前给每个 LLM 调用写死一个 `Math.max(config.maxTokens, N)`。短任务
+ * 与长任务拿到同一个额度，长任务（分卷、拆章、逐章规划）**额度不随规模增长**，
+ * 截断后只能抛「请增大 maxTokens」。这里把额度改成按规模推算，并给结构化字段
+ * 定长度上限，让预算花在结构上而不是被自由发挥吃光。
+ *
+ * 设计取舍：结构化输出的额度应当**随本次要产出的条目数增长**，并由硬上限兜住，
+ * 否则要么短任务浪费额度，要么长任务写到一半被截断。字段长度上限同时写进提示词
+ * 与解析端，两处共用一张表，避免漂移。
+ *
+ * 一条硬纪律：**不要用 JSON repair 去补被截断的结构**。repair 只能修已有结构，
+ * 补不出尚未输出的条目；在服务层手工补齐缺失项，等于把不完整的规划伪装成可用
+ * 资产。预算给够 + 输出够紧凑，才是正解。
+ */
+
+/** 一次调用的输出规模描述：给出能决定输出体量的那个量。 */
+export interface OutputScope {
+  /** 预期卷数（分卷/卷战略类）。 */
+  volumes?: number
+  /** 预期章节数（章节列表/批量拆章类）。 */
+  chapters?: number
+  /** 预期角色数（角色阵容/资产提炼类）。 */
+  characters?: number
+  /** 预期条目数（伏笔、题材、资产等清单类）。 */
+  items?: number
+  /** 需要覆盖的正文规模（字），用于拆书/反推这类按输入体量走的任务。 */
+  sourceChars?: number
+}
+
+/** 一类结构化任务的预算规格。 */
+export interface OutputBudgetSpec {
+  /** 无视规模也要给到的下限。 */
+  floor: number
+  /** 规模为 0 时的起步额度。 */
+  base: number
+  /** 每单位规模追加的额度。 */
+  perUnit: number
+  /** 硬上限：超过它只会让模型啰嗦，不会让结构更完整。 */
+  ceiling: number
+}
+
+/** 结构化任务分组——按"输出里每个单位要写多少字段"分档，而不是按业务名。 */
+export type OutputBudgetKind =
+  | 'volume-strategy'
+  | 'chapter-list'
+  | 'character-cast'
+  | 'item-list'
+  | 'analysis'
+
+/**
+ * 数值口径：以**本插件真实产出字段的体积**折算，不是照搬参考项目的数字
+ * （它的卷战略字段与本插件的章节字段结构不同，直接套用会造成新的截断）。
+ *
+ * 折算假设：中文约 1.5-2 token/字；账本式 JSON 的键名与括号再占约 15%。
+ * 例如单章条目 = 标题(≤40) + 摘要(≤300) + 本章目标(≤200) + beats + 最多 4 条
+ * payoff 指令 → 约 250-400 字 → **约 350 token/章**。若字段合同调整，这里必须同步。
+ */
+const SPECS: Record<OutputBudgetKind, OutputBudgetSpec> = {
+  // 每卷：roleLabel(≤32) + coreReward(≤64) + escalationFocus(≤64) + uncertainty，
+  // 再加书级阶梯字段（readerRewardLadder/escalationLadder/midpointShift/notes）。
+  'volume-strategy': { floor: 1_800, base: 1_200, perUnit: 220, ceiling: 6_000 },
+  // 每章 ≈350 token（见上方折算说明），另留写作余量；上限对齐单次调用能力。
+  'chapter-list': { floor: 2_500, base: 2_000, perUnit: 350, ceiling: 20_000 },
+  // 每角色：名字 + roleLabel + 定位 + 关系 + 弧线 ≈150 token。
+  'character-cast': { floor: 1_500, base: 1_000, perUnit: 150, ceiling: 8_000 },
+  // 清单类，每条几个短字段。
+  'item-list': { floor: 1_000, base: 800, perUnit: 60, ceiling: 4_000 },
+  // 拆书/反推：按输入正文体量走，每千字约 120 token。
+  analysis: { floor: 3_000, base: 2_000, perUnit: 12, ceiling: 16_000 },
+}
+
+/**
+ * 取出与任务类型相关的那一个规模量。
+ * @param kind - 任务类型。
+ * @param scope - 规模描述。
+ * @returns 单位数；分析类返回千字单位（向上取整）。
+ */
+export function scopeUnits(kind: OutputBudgetKind, scope: OutputScope): number {
+  const positive = (value: number | undefined): number =>
+    typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : 0
+  switch (kind) {
+    case 'volume-strategy':
+      return positive(scope.volumes)
+    case 'chapter-list':
+      return positive(scope.chapters)
+    case 'character-cast':
+      return positive(scope.characters)
+    case 'item-list':
+      return positive(scope.items)
+    case 'analysis':
+      // 输入正文每 1000 字算一个单位。
+      return Math.ceil(positive(scope.sourceChars) / 1_000)
+  }
+}
+
+/**
+ * 按规模推算输出额度。
+ * @param kind - 结构化任务类型。
+ * @param scope - 本次任务的规模（缺省时按最小规模处理）。
+ * @returns 建议的 `maxTokens`，落在该类型的 [floor, ceiling] 内。
+ */
+export function resolveOutputBudget(kind: OutputBudgetKind, scope: OutputScope = {}): number {
+  const spec = SPECS[kind]
+  const raw = spec.base + scopeUnits(kind, scope) * spec.perUnit
+  return Math.min(spec.ceiling, Math.max(spec.floor, Math.round(raw)))
+}
+
+/** 读取某类任务的规格（供诊断与测试断言）。 */
+export function outputBudgetSpec(kind: OutputBudgetKind): OutputBudgetSpec {
+  return { ...SPECS[kind] }
+}
+
+/**
+ * 结构化字段长度合同 —— 与 prompt 里的长度声明必须逐项一致。
+ *
+ * 两边同步的理由：只写进 schema，模型不知道就会超长被拒；只写进 prompt，模型
+ * 偶尔超长没人拦。本表是单一数据源。
+ */
+export const STRUCTURED_FIELD_LIMITS = {
+  /** 分卷战略：书级阶梯类字段。 */
+  volumeLadder: 160,
+  /** 分卷战略：每卷定位标签。 */
+  volumeRoleLabel: 32,
+  /** 分卷战略：每卷核心回报 / 升级焦点。 */
+  volumeReward: 64,
+  /** 分卷战略：不确定项原因。 */
+  volumeUncertaintyReason: 64,
+  /** 章节计划：单章标题。 */
+  chapterTitle: 40,
+  /** 章节计划：单章摘要。 */
+  chapterSummary: 300,
+  /** 章节计划：本章目标。 */
+  chapterGoal: 200,
+} as const
+
+/**
+ * 把长度合同渲染成可直接塞进 system prompt 的一句话，避免 prompt 与表漂移。
+ * @param entries - 要声明的字段（描述 + 上限），按声明顺序渲染。
+ * @returns 形如「为保证输出完整：A 不超过 160 字；B 不超过 64 字。」的中文说明。
+ */
+export function renderLengthContract(entries: ReadonlyArray<readonly [string, number]>): string {
+  if (entries.length === 0) return ''
+  const parts = entries.map(([label, limit]) => `${label}不超过 ${limit} 字`)
+  return `为保证输出完整：${parts.join('；')}。每个字段只保留完成本阶段决策所需的信息，写完后立即结束输出，不要展开细纲或重复说明。`
+}

package/src/protocol.ts

@@ -229,7 +229,7 @@ export interface BookImportTextRequest {
   text?: string
   /** 模式二：原文件名（txt/md），用于推断书名与显示。 */
   fileName?: string
-  /** 输出目录；缺省为 ~/.dsh/novels/书名。 */
+  /** 输出目录；缺省为「输出目录」设置下的书名子目录。 */
   outputDir?: string
 }
 
@@ -350,7 +350,7 @@ export interface AuthorReview {
   reviewedAt: string
 }
 
-/** 审稿维度（结构化定位问题类别；与 review-policy.ts 的 REVIEW_DIMENSIONS 对齐）。 */
+/** 审稿维度（结构化定位问题类别）。权威清单是 reviewSystemPrompt 里的九条维度。 */
 export type ReviewDimension = 'character' | 'setting' | 'redline' | 'writing' | 'pacing' | 'logic' | 'anti-ai' | 'presentation' | 'compliance'
 
 /** One review finding. */
@@ -531,6 +531,13 @@ export interface MarketRadarResult {
   productionFoundation: ProductionFoundation
   /** 开书创意简报（可选；用「用信号创作」接口单独生成）。 */
   creativeBrief?: MarketCreativeBrief
+  /**
+   * 本次分析的报告 id（服务端生成）。
+   *
+   * 前端据此判断「是否换了一份新报告」：只有报告变了才重置信号勾选，否则重渲染/
+   * 轮询会把作者手选的信号冲掉。缺省（旧版产物）时前端按「首次看到」处理。
+   */
+  reportId?: string
 }
 
 /** POST /market-radar request。 */
@@ -1828,6 +1835,16 @@ export interface ConfigPatch {
   savedModels?: SavedModel[]
 }
 
+/** POST /config response: the config the host will read next, plus persistence caveats. */
+export interface ConfigResponse {
+  config: NovelConfig
+  /**
+   * 已生效但**未持久化**时的说明（宿主 settings 段不可寻址：段 id 未知或宿主
+   * 未登记）。有值时设置只在本次进程内有效，重启回退，面板照此提示用户。
+   */
+  settingsWarning?: string
+}
+
 // ------------------------------------------------------------ assistant
 
 /** One assistant conversation message (persisted per project). */
@@ -2339,7 +2356,7 @@ export interface AdaptSaveRequest {
   text: string
   /** 新书名（缺省为「改编新书」；建议用「<原著>·改编版」）。 */
   bookName?: string
-  /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+  /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
   outputDir?: string
   /** 可附带反推大纲（写进新项目，便于后续续写/编辑）。 */
   outline?: string
@@ -2365,7 +2382,7 @@ export interface AdaptMaterializeRequest {
   text: string
   /** 新书名（缺省为「<源书名>·改编版」）。 */
   bookName?: string
-  /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+  /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
   outputDir?: string
   /** 反推大纲（来自分析；缺少时用源文章题兜底）。 */
   outline?: string
@@ -2401,7 +2418,7 @@ export interface AdaptMaterializeResponse {
 export interface AdaptMaterializeSaveRequest {
   /** 新书名（缺省为「改编版」）。 */
   bookName?: string
-  /** 新书输出目录（缺省 ~/.dsh/novels/书名）。 */
+  /** 新书输出目录（缺省为「输出目录」设置下的书名子目录）。 */
   outputDir?: string
   /** 改编后总纲。 */
   outline: string

package/src/routes.ts

@@ -12,7 +12,6 @@ import type { IncomingMessage, ServerResponse } from 'node:http'
 import { spawn } from 'node:child_process'
 import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { join, basename, extname } from 'node:path'
-import { homedir } from 'node:os'
 import { randomBytes } from 'node:crypto'
 import type { WebRoute } from '@deepseek-ai/dsh-host-webserver'
 import type { Context } from '@deepseek-ai/cordis'
@@ -55,6 +54,8 @@ import {
   type ChapterSaveResponse,
   type ChapterTextRequest,
   type ConfigPatch,
+  type ConfigResponse,
+  type GenerateRequest,
   type MoveOutputDirRequest,
   type MoveOutputDirResponse,
   type BookSettings,
@@ -219,6 +220,7 @@ import { detectTimelineIssues } from './timeline.ts'
 import { buildCurveData, detectTensionIssues, TENSION_MAX, TENSION_MIN, TENSION_PRESETS, clampTension } from './tension.ts'
 import { PROMPT_SLOTS, normalizeSlotValue, readPromptSlots } from './prompt-slots.ts'
 import { buildRevisionPlan, describeRevisionPlan, REVISION_ITEM_CAP } from './revision.ts'
+import { dshHomePath } from './home.ts'
 
 /** Cap on JSON request bodies (generous: cover images travel as base64). */
 const MAX_JSON_BODY_BYTES = 64 * 1024 * 1024
@@ -286,15 +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.
@@ -303,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 }
 
@@ -585,7 +608,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
       const config0 = getConfig()
-      const body = await readJsonBody<{ chapterNo?: number; skipReview?: boolean; bookId?: string }>(req)
+      const body = await readJsonBody<GenerateRequest & { bookId?: string }>(req)
       const outputDir = resolveOutputDir(config0, body?.bookId)
       const config = { ...config0, outputDir }
       const project = loadProject(outputDir)
@@ -2065,7 +2088,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         }
         const outputDir = body?.outputDir?.trim() !== '' && body?.outputDir !== undefined
           ? body.outputDir
-          : defaultOutputDirFor(bookName)
+          : defaultBookDir(bookName)
         const book = createBook(bookName, outputDir)
         // 开书向导：创建时带大纲 → 立即建立项目（书名以大纲首行为准）。
         const outline = body?.outline?.trim()
@@ -2188,7 +2211,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
           const bookName = (body.fileName ?? '').replace(/\.[^.]+$/, '').trim().slice(0, 40) || '导入小说'
           const outDir = body?.outputDir?.trim() !== undefined && body.outputDir.trim() !== ''
             ? body.outputDir.trim()
-            : defaultOutputDirFor(bookName)
+            : defaultBookDir(bookName)
           const result = importBookTextFromText(body.text, outDir, bookName)
           const { book } = importDir(outDir)
           writeJson(res, 200, { ...result, book })
@@ -2207,7 +2230,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         const bookName = basename(filePath, extname(filePath)).slice(0, 40) || '导入小说'
         const outDir = body?.outputDir?.trim() !== undefined && body.outputDir.trim() !== ''
           ? body.outputDir.trim()
-          : defaultOutputDirFor(bookName)
+          : defaultBookDir(bookName)
         const result = importBookText(filePath, outDir)
         const { book } = importDir(outDir)
         writeJson(res, 200, { ...result, book })
@@ -2894,8 +2917,8 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
         return
       }
       try {
-        const next = await patchConfig(body)
-        writeJson(res, 200, { config: next })
+        const result = await patchConfig(body)
+        writeJson(res, 200, result satisfies ConfigResponse)
       } catch (error) {
         writeJson(res, 400, { error: (error as Error).message })
       }
@@ -2933,7 +2956,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
     path: NOVEL_API.pluginUpdate,
     handler: async (req, res) => {
       if (!guard(req, res, 'POST')) return
-      const profileDir = join(homedir(), '.dsh', 'profiles', 'web')
+      const profileDir = dshHomePath('profiles', argvProfile() ?? 'web')
       const response: PluginUpdateResponse = await new Promise((resolve) => {
         const child = spawn('pnpm', ['add', '@waterwx/dsh-novel-forge@latest'], { cwd: profileDir, shell: true })
         let acc = ''
@@ -3619,7 +3642,7 @@ export function makeRoutes(deps: NovelRoutesDeps): WebRoute[] {
   }
 
   // ------------------------------------------ theme custom background (upload + serve)
-  const THEME_BG_DIR = join(homedir(), '.dsh', 'dsh-novel-forge-assets')
+  const THEME_BG_DIR = dshHomePath('dsh-novel-forge-assets')
   const MIME_BY_EXT: Record<string, string> = { png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', webp: 'image/webp', gif: 'image/gif' }
 
   const themeBackgroundUploadRoute: WebRoute = {