merge: promote beta updates to main

Author: wnagchi

AGENTS.md

@@ -20,6 +20,16 @@
   - deterministic post-processing of already-structured AI output.
 - When adding a new capability, first extend the AI schema / structured output / tool contract. Do not patch behavior by stacking special-case string rules.
 
+## Auto-Director Quality Gate Rules (Highest Priority)
+
+- Chapter audit, acceptance, and quality-loop results must not automatically block the global auto-director or full-book execution chain.
+- Non-global chapter quality problems, including `local_patch_plan`, `continue_with_warning`, `patchable_obligation_gap`, `draft_obligation_unmet`, recoverable repair failures, and `defer_and_continue` quality debt, must be recorded as chapter-level quality debt or local repair guidance and allow the remaining chapter range to continue.
+- Only an explicit `stop_for_replan`, `replan_required`, `recommendedAction=replan`, unrecoverable generation failure with no usable chapter content, or a runtime safety/data integrity failure may stop the global chain.
+- Do not route local audit issues into `replanAlertDetails`, `PIPELINE_REPLAN_REQUIRED`, or the `replan_required` checkpoint unless the structured AI/runtime decision explicitly says the neighboring chapter plan must stop for replan.
+- If local repair has already been attempted and residual issues remain but the chapter has usable content, prefer degraded finalization plus quality debt over failing the whole auto-director task.
+- UI, task projection, and recovery logic must preserve this distinction: local quality debt is a visible warning and follow-up item, not a failed auto-director workflow.
+- Book-level auto-director projections with `failed`, `blocked`, or `waiting_recovery` status and a latest task must remain visible in AI cockpit, task drawer, and recovery entrypoints even when the URL does not include `directorTaskId`; `workspaceTaskId` is a manual workspace lane and must never be used as a substitute director task id.
+
 ## Product Context (Highest Priority)
 
 - The primary target users of this project are complete writing beginners who do not understand fiction craft, structure, or novel production workflows.

README.md

@@ -124,24 +124,54 @@
 
 完整历史更新见 [docs/releases/release-notes.md](./docs/releases/release-notes.md)。
 
-### 2026-05-29
-
-重大更新：本次把 2026-05-24 之后在预发布分支验证过的自动导演、章节生产、角色阵容、模型选择、灵感辅助和运行态治理合并进主线，并同步准备 Windows 桌面版 `0.3.16`。
-
-- 自动导演从“当前项目继续”更顺：弹窗会先展示卷规划、拆章同步、章节细化、正文书写和质量进度，并按系统推荐位置一键继续；需要连续推进时，可以直接选择“推进至第 N 章”。
-- 已有项目从故事宏观规划、角色准备、卷战略或章节执行接管时，会更准确识别当前真实进度；已经完成的角色准备不会被重新显示为待推进，章节范围也不会误套到整书前置接管上。
-- 角色阵容应用更快：手动应用阵容会先同步角色和关系，外显资料与角色动态在后台补齐，按钮不再长时间卡在“应用中”。
-- 节奏拆章和章节执行衔接更直接：拆好的章节会自动连接到执行章节，旧项目也会优先按章节身份匹配，减少章节执行区看不到拆章结果的情况。
-- 章节生产链更稳：质量债会绑定到实际触发问题且已有正文的章节，空章节不会被误跳过；时间线、状态抽取和质量修复会更稳定地支撑后续章节继续写。
-- 自动导演驾驶舱状态统一：进度弹窗、小说页提示、任务中心和执行详情会优先使用同一份驾驶舱状态，减少同一任务在不同入口显示不同进度、不同等待状态或无效确认按钮。
-- 运行中的任务会优先显示真实推进态；历史审批投影、章节标题提醒或旧的等待确认信息不会再把正在细化、写作或审校的任务误显示成“等待确认”。
-- “让 AI 从当前项目继续自动导演”只会把真正的自动导演任务识别为当前任务；普通编辑流程任务不会再让接管弹窗误显示“进入当前任务”。
-- 未完成的等待确认提醒会明确显示为“收起此提醒”，避免让用户误以为收起动作会完成或结束任务。
-- 自动导演创建更适合新手默认路径：默认推荐“先准备到可开写”，并新增“读者频道倾向”，帮助 AI 判断男频 / 女频等阅读预期和爽点侧重。
-- 起始想法旁新增“没有想法？”入口，可临时生成 5 个横向灵感卡片；点击“使用这个”会把灵感填入上方输入框，已有内容时会先确认再覆盖。
-- 模型选择器切换厂商时会即时刷新该厂商模型列表，减少先去设置页刷新再回来选择的操作。
-- 首页、小说列表和任务恢复等首屏读取更轻，模型状态、恢复摘要和小说列表会分级加载，打开页面时更不容易被后台接口拖慢。
-- 后端章节运行时、自动导演模块、小说应用服务、事件副作用和路由边界继续收敛，Prompt 调用也补上质量遥测，为后续排查长链路生成和恢复问题提供更稳定的基础。
+### 2026-06-05
+
+自动导演连续执行更稳，章节生成上下文更聚焦：系统会减少无明确目标窗口的伏笔逾期误判，避免批量写章被重复账本错误打断，并让章节检索更贴合当前章节任务。
+
+- 节奏拆章中的章节列表聚焦查看、生成和删改既有章节，不再提供容易绕开自动规划链路的手动新增章节入口。
+- 伏笔账本同步会识别同义标题并复用已有未完成账本，减少 AI 把同一 payoff 新建成重复逾期项。
+- 缺少明确目标章节窗口的逾期 payoff 会降级为待跟进风险，不再直接触发整窗重规划或停止后续章节执行。
+- 章节写作会用当前章节目标、必须推进事项、冲突和出场角色组装知识库检索问题，让 RAG 上下文更贴近本章写作任务。
+- 章节生成上下文会减少未被正文写作实际消费的旧式大块背景拼接，把相关信息放入结构化运行时上下文，降低无效上下文膨胀。
+
+### 2026-06-04
+
+自动导演连续写章更省资源、更少重复等待：系统会复用同一章节同一正文的质量门控结果，并收敛时间线上下文，减少任务重启后重复审校、重复抽取和重复细化章节合同。
+
+- 章节质量门控会复用已成功的接收判断和时间线检测，同一正文在任务取消、失败或重启后不再默认重新消耗一次 AI 调用。
+- 时间线抽取只携带近期关键事件和必要钩子，让后续章节不会因为整本历史持续增长而越来越慢。
+- 章节接收判断会区分硬阻断和可继续跟进的质量债务，轻量义务风险会保留提示并继续推进，减少不必要的自动补写。
+- 已经准备好任务单和场景预算的章节不会在恢复流程里重复生成章节执行合同，带有新指令的重生成仍可正常覆盖。
+- 自动导演会监控每章 AI 用量，单章消耗异常时自动暂停后续执行，避免上下文膨胀或质量循环继续扩大成本。
+- 时间线抽取不再阻塞章节接收，正文通过接收后会继续完成时间线定稿；下一章开始前仍会自动补齐必要的时间线 checkpoint。
+- 自动导演的用量暂停会聚焦仍在推进的章节范围，已经完成的章节不会因为历史累计用量偏高而反复拦住后续章节。
+- 章节批次会按当前执行范围统一判断审校、修复和状态提交；已经登记为可继续质量债的局部问题不会再把自动导演卡在章节状态提交，减少反复恢复和异常 Token 消耗。
+- 时间线定稿和章节资产回灌会在调用 AI 前先抢占同步记录，减少同一章节同一正文被并发后台入口重复抽取的情况。
+
+### 2026-06-03
+
+章节批量生成更不容易被重复质量债务打断：系统会区分“继续但提示”“局部修复计划”和“必须停止重规划”，避免同一批逾期伏笔在连续章节里反复触发整窗重规划。
+
+- 短窗口、未直接影响当前章的逾期伏笔会作为提示保留，不再默认停止后续章节流水线。
+- 只有明确需要整窗调整的重规划建议才会暂停后续章节；局部计划问题会进入修复和质量提示，不再直接升级成整本流程阻塞。
+- 章节任务里的“必须推进”会过滤接收闸门不可用、结构化缺口等系统审计标签，避免 AI 把系统问题当成剧情义务去写。
+- 章节质量闭环会按新的重规划动作判断风险，减少把可继续的质量债务显示成必须重规划。
+
+### 2026-06-02
+
+重大更新：世界观从“字段表单”升级为更适合新手理解和直接开书的世界手册与世界骨架流程，同时自动导演可以在宏观规划后自动准备本书世界，让角色、地点、势力和章节上下文更容易保持一致。
+
+- 世界生成默认走“世界意图 -> 世界规模 -> 骨架预览 -> 保存世界”的流程，用户可以选择轻量舞台、标准长篇或复杂群像，并调整规则、势力、地点、冲突和故事入口数量。
+- 世界库和世界工作台会以世界卡片、世界手册、核心规则、主要势力、关键地点、关系网络和完整度诊断来展示结果，减少直接面对 `background / geography / factions` 这类字段名的负担。
+- 世界地图和势力图谱拥有更完整的数据支撑：地点包含相对坐标、方位、风险、控制势力和连接关系，势力包含目标、资源、控制地点、关系类型和紧张度。
+- 小说内新增本书世界管理能力：可以从世界库导入为本书副本，也可以根据本书主题生成专属世界，并由用户决定是否保存回世界库或手动同步差异。
+- 自动导演在宏观规划和书级约定之后新增本书世界准备步骤；没有选择参考世界时，系统会默认生成本书世界并在角色准备前构建可用的世界上下文。
+- 角色生成可以选择是否基于当前世界观，并能结合势力倾向、世界规则和身份边界生成更贴合本书舞台的人物。
+- 世界生成的参考资料检索更收敛，默认只使用当前世界、模板和用户明确选择的参考内容，减少无关知识库文档混入新世界生成。
+- 接收闸门会更稳定地识别“本章必须完成但正文缺失”的义务，减少把缺失义务输出成散乱文本而触发修复器的情况。
+- 时间线抽取会更稳定地记录事件、状态变化和后续钩子，中文类型名或简写钩子会被归一到可保存的结构化格式。
+- 章节资产抽取会更稳地处理资源状态，自动导演的高创造温度不会再传染到事实抽取类任务。
+- JSON 修复日志可以按 Prompt 和失败字段聚合，方便定位到底是示例、枚举、上下文还是模型输出导致的结构化失败。
 
 ## 功能预览
 ### 功能概览中的95%以上编写都是AI完成

client/src/api/bookAnalysis.ts

@@ -34,6 +34,7 @@ export async function createBookAnalysis(payload: {
   temperature?: number;
   maxTokens?: number;
   includeTimeline?: boolean;
+  enabledSectionKeys?: BookAnalysisSectionKey[];
 }) {
   const { data } = await apiClient.post<ApiResponse<BookAnalysisDetail>>("/book-analysis", payload);
   return data;

client/src/api/novel/characters.ts

@@ -122,6 +122,11 @@ export async function generateCharacterCastOptions(
     model?: string;
     temperature?: number;
     storyInput?: string;
+    useWorldContext?: boolean;
+    worldFocusHints?: {
+      preferFaction?: string;
+      forceCompliance?: boolean;
+    };
   },
 ) {
   const { data } = await apiClient.post<ApiResponse<CharacterCastOption[]>>(

client/src/api/novelWorldSlice.ts

@@ -1,12 +1,56 @@
 import type { ApiResponse } from "@ai-novel/shared/types/api";
 import type { LLMProvider } from "@ai-novel/shared/types/llm";
+import type {
+  NovelWorldGenerateInput,
+  NovelWorldImportInput,
+  NovelWorldManualInput,
+  NovelWorldSaveToLibraryInput,
+  NovelWorldSyncDiff,
+  NovelWorldSyncInput,
+  NovelWorldView,
+} from "@ai-novel/shared/types/novelWorld";
 import type {
   StoryWorldSliceBuilderMode,
   StoryWorldSliceOverrides,
   StoryWorldSliceView,
 } from "@ai-novel/shared/types/storyWorldSlice";
 import { apiClient } from "./client";
 
+export async function getNovelWorld(id: string) {
+  const { data } = await apiClient.get<ApiResponse<NovelWorldView>>(`/novels/${id}/novel-world`);
+  return data;
+}
+
+export async function importNovelWorldFromLibrary(id: string, payload: NovelWorldImportInput) {
+  const { data } = await apiClient.post<ApiResponse<NovelWorldView>>(`/novels/${id}/novel-world/import`, payload);
+  return data;
+}
+
+export async function createManualNovelWorld(id: string, payload: NovelWorldManualInput) {
+  const { data } = await apiClient.post<ApiResponse<NovelWorldView>>(`/novels/${id}/novel-world/manual`, payload);
+  return data;
+}
+
+export async function generateNovelWorldFromTheme(id: string, payload: NovelWorldGenerateInput) {
+  const { data } = await apiClient.post<ApiResponse<NovelWorldView>>(`/novels/${id}/novel-world/generate`, payload);
+  return data;
+}
+
+export async function saveNovelWorldToLibrary(id: string, payload: NovelWorldSaveToLibraryInput) {
+  const { data } = await apiClient.post<ApiResponse<NovelWorldView>>(`/novels/${id}/novel-world/save-to-library`, payload);
+  return data;
+}
+
+export async function getNovelWorldSyncDiff(id: string) {
+  const { data } = await apiClient.get<ApiResponse<NovelWorldSyncDiff>>(`/novels/${id}/novel-world/sync-diff`);
+  return data;
+}
+
+export async function syncNovelWorldWithLibrary(id: string, payload: NovelWorldSyncInput) {
+  const { data } = await apiClient.post<ApiResponse<NovelWorldSyncDiff>>(`/novels/${id}/novel-world/sync`, payload);
+  return data;
+}
+
 export async function getNovelWorldSlice(id: string) {
   const { data } = await apiClient.get<ApiResponse<StoryWorldSliceView>>(`/novels/${id}/world-slice`);
   return data;

client/src/api/queryKeys.ts

@@ -32,6 +32,8 @@ export const queryKeys = {
     autoDirectorTask: (id: string) => ["novels", "auto-director-task", id] as const,
     directorBookAutomation: (id: string) => ["novels", "director-book-automation", id] as const,
     autoDirectorTakeoverReadiness: (id: string) => ["novels", "auto-director-takeover-readiness", id] as const,
+    novelWorld: (id: string) => ["novels", "novel-world", id] as const,
+    novelWorldSyncDiff: (id: string) => ["novels", "novel-world", id, "sync-diff"] as const,
     worldSlice: (id: string) => ["novels", "world-slice", id] as const,
     snapshots: (id: string) => ["novels", "snapshots", id] as const,
   },

client/src/api/world.ts

@@ -17,8 +17,12 @@ import type {
   WorldOptionRefinementLevel,
   WorldPropertyOption,
   WorldReferenceAnchor,
+  WorldGenerationBlueprint,
   WorldReferenceMode,
+  WorldReferenceContext,
   WorldReferenceSeedBundle,
+  WorldSkeletonGenerationOptions,
+  WorldSkeletonGenerationPayload,
 } from "@ai-novel/shared/types/worldWizard";
 import { apiClient } from "./client";
 
@@ -215,6 +219,23 @@ export async function analyzeWorldInspiration(payload: {
   return data;
 }
 
+export async function generateWorldSkeleton(payload: {
+  idea: string;
+  worldType?: string;
+  template?: string;
+  referenceContext?: WorldReferenceContext | null;
+  blueprint?: WorldGenerationBlueprint | null;
+  options: WorldSkeletonGenerationOptions;
+  provider?: LLMProvider;
+  model?: string;
+}) {
+  const { data } = await apiClient.post<ApiResponse<WorldSkeletonGenerationPayload>>(
+    "/worlds/skeleton/generate",
+    payload,
+  );
+  return data;
+}
+
 export async function suggestWorldAxioms(
   id: string,
   payload?: {

client/src/components/layout/NovelWorkspaceRail.tsx

@@ -9,7 +9,7 @@ import {
   ListTodo,
 } from "lucide-react";
 import { useLocation, useNavigate, useSearchParams } from "react-router-dom";
-import type { DirectorContinuationMode, DirectorLockScope } from "@ai-novel/shared/types/novelDirector";
+import type { DirectorLockScope } from "@ai-novel/shared/types/novelDirector";
 import type { VolumePlan } from "@ai-novel/shared/types/novel";
 import type { UnifiedTaskDetail } from "@ai-novel/shared/types/task";
 import { getNovelDetail, getNovelQualityReport, getNovelVolumeWorkspace } from "@/api/novel";
@@ -29,7 +29,7 @@ import DirectorBookAutomationCard from "@/components/autoDirector/DirectorBookAu
 import NovelAutoDirectorProgressPanel from "@/pages/novels/components/NovelAutoDirectorProgressPanel";
 import { shouldShowPinnedBookAutomationProjection } from "@/pages/novels/novelEditAutomationStatus";
 import { cn } from "@/lib/utils";
-import { resolveWorkflowContinuationFeedback } from "@/lib/novelWorkflowContinuation";
+import { resolveDirectorContinueMode, resolveWorkflowContinuationFeedback } from "@/lib/novelWorkflowContinuation";
 import {
   applyAutoDirectorResetStepReadiness,
   extractAutoDirectorResetStepsFromMeta,
@@ -100,6 +100,7 @@ function shouldShowBookAutomationProjectionWithoutActiveTask(input: {
     || input.status === "waiting_approval"
     || input.status === "waiting_recovery"
     || input.status === "blocked"
+    || input.status === "failed"
   ) {
     return true;
   }
@@ -118,26 +119,6 @@ function shouldShowBookAutomationProjectionWithoutActiveTask(input: {
   });
 }
 
-function resolveDirectorContinueMode(task: Pick<
-  UnifiedTaskDetail,
-  "checkpointType" | "currentItemKey" | "currentStage" | "pendingManualRecovery"
-> | null | undefined): DirectorContinuationMode {
-  if (task?.pendingManualRecovery) {
-    return "resume";
-  }
-  if (
-    task?.checkpointType === "replan_required"
-    || task?.currentItemKey === "quality_repair"
-    || task?.currentStage?.includes("质量")
-  ) {
-    return "skip_quality_repair";
-  }
-  if (task?.checkpointType === "chapter_batch_ready") {
-    return "auto_execute_range";
-  }
-  return "resume";
-}
-
 export default function NovelWorkspaceRail(props: NovelWorkspaceRailProps) {
   const { novelId, chapterId = "", collapsed, onToggle, onSwitchToProjectNav } = props;
   const navigate = useNavigate();

client/src/components/layout/Sidebar.tsx

@@ -62,7 +62,7 @@ const navGroups: NavGroup[] = [
       { to: "/story-modes", label: "推进模式库", icon: Workflow },
       { to: "/titles", label: "标题工坊", icon: SquarePen },
       { to: "/knowledge", label: "知识库", icon: Database },
-      { to: "/worlds", label: "世界观", icon: Globe2 },
+      { to: "/worlds", label: "世界样本库", icon: Globe2 },
       { to: "/style-engine", label: "写法引擎", icon: WandSparkles },
       { to: "/anti-ai-rules", label: "反 AI 规则", icon: ShieldCheck },
       { to: "/base-characters", label: "基础角色库", icon: UsersRound },