✨ 项目简介
这是一个面向长篇小说完成度的 AI 生产系统，不是普通的”你写一句、AI 补一句”聊天壳子。
它的核心做法是：
- 👉 用一句灵感启动整本书的规划，AI 自动给出方向 / 世界 / 角色 / 卷战略 / 章节任务
- 👉 把章节生成、审核、修复、状态回灌串成可暂停可恢复的生产链
- 👉 把拆书、知识库、写法引擎、角色资源账本、世界手册都做成可召回的长期资产
- 👉 提供漫画、短剧等衍生工坊围绕已完成的小说内容做视觉与剧本延展
- 👉 配套公开介绍站、生产链深度文档和按阶段的恢复手册
适合完全不懂写作的新手走完一本长篇，也适合研究 AI Native 应用、Agent Workflow、LangGraph 编排和长链路任务的开发者参考。
项目定位
很多 AI 写作工具的使用方式其实差不多：你输入一句 Prompt，它回你一段正文，不满意就重试。写短篇还行，写长篇容易越写越散。
这个仓库是”AI 导演式长篇小说生产系统”，核心产品判断是：
- 目标用户优先是完全不懂写作的新手，而不是熟悉结构设计的资深作者
- 优先解决”如何把整本书写完”，再逐步优化”写得多精巧”
- AI 不只是补全文本的模型，而是参与规划、判断、调度、执行和追踪的系统角色
如果你在找下面这类项目，这个仓库会更值得关注：
- 想验证 AI 是否真的能参与整本小说生产，而不是只写单段文案
- 想研究 AI Native Product、Agent Workflow、LangGraph 编排怎样落到真实创作业务
- 想把世界观、角色、拆书、知识库、写法控制、章节生成、质量修复串成一套稳定工作流
现在已经能做什么
1. AI 自动导演开书与四种运行模式
- 从一句灵感直接进入自动导演，无需先手写世界观、主线、角色和卷纲；系统先整理项目设定、对齐书级 framing，再生成多套整本方向和对应标题组
- 方向不满意时可以继续生成、定向修订某一套方案、或只重做某套方案的标题组，避免”满意就确认 / 不满意就整批重来”
- 自动导演提供四种运行模式：先准备到可开写（推荐第一本书）、全书自动成书、按范围执行（全书 / 前 N 章 / 第 1 卷）、正文后去 AI 检测与修正（叠加质量闭环）
- 全自动驾驶模式下遇到模型不可用、配额耗尽、连续修复失败、要求重新规划等情况会主动停下，而不是无限重试；所有状态保存到导演跟进，可从原检查点恢复
- 全自动模式下每批章节完成后自动确认 pending 候选角色，角色进入正式名册并触发动态重建，消除后续章节角色一致性漂移
- 链路覆盖书级方向、故事宏观规划、本书世界、角色准备、卷战略 / 卷骨架、节奏板、章节清单、章节细化、章节执行、审核、修复，每一阶段都支持检查点恢复、接管和换模型重试
2. Creative Hub 与 Agent Runtime
- 统一创作中枢承载对话、追问、规划、工具调用、任务状态和回合总结，不再是分散的功能按钮
- 系统内有明确的 Planner、Tool Registry、Runtime、审批节点、状态卡片和中断恢复链路；自然语言意图会被路由到对应的自动导演阶段或章节任务
- 浏览器暂停通知：到达 checkpoint 时弹出系统通知，长链路任务挂机更安心
3. 整本生产主链与章节执行
- 单章运行时、章节执行和整本批量 pipeline 收敛到同一条主链
- 章节生成上下文按本章参与者精准筛选角色资源账本，避免把全部角色塞进 prompt；高风险已入账与待确认提案分别走不同审计代码，正文不会把待确认资源写成既成事实
- 章节执行链覆盖正文生成、AI 审核、可修复问题处理、质量债务记录、角色状态 / 事实 / 伏笔回灌、下一章入口
- LLM 限速器修复内存泄漏：provider 配置变更时淘汰旧限速器，长期运行内存稳定
4. 拆书工作台与角色形象演变
- 拆书角色档案分简要 / 标准 / 深入 / 完整四档，深入和完整档案会回溯原文片段补全维度
- 角色形象演变：按 25% / 50% / 75% / 100% 覆盖率增量扫描出场章节，沉淀每章外貌、服装、状态和场景锚点，并基于章节快照生成同一角色阶段形象图；提取的短外貌词条放入待确认区，勾选后融合到角色档案
- 章节形象图可引用角色基础形象图，保持脸型 / 发型 / 标志细节一致
- 拆书还提供双栏阅读、章节证据回溯、范围定向分析、token 预算守卫、稿件诊断模式
5. 写法引擎与反 AI 规则
- 写法不再只是提示词里的一段说明，而是可保存、编辑、绑定、试写、复用的长期资产
- 可从现有文本提取写法特征 + 原文样本；特征沉淀为可见特征池，逐项启用 / 停用 / 组合，规则同步重编译
- 写法引擎参与生成、检测和修正链路；反 AI 规则减少正文模板感、解释感和空泛表达
6. 本书世界、角色、知识库联动 + RAG
- 世界观从大段设定文本升级为可生成 / 复用 / 同步的本书世界；地图、势力图谱会进入章节上下文
- 拆书结果和知识库文档通过 RAG 回灌到规划、续写和正文生成
- RAG 索引流式并行：Embedding 与 Qdrant 写入并发可调；拆书产物入 facets 索引让召回包含拆书结论；chunk hash 去重防止重建产生重复向量；retrieval trace 后端可追踪召回为什么命中
7. 漫画与短剧衍生工坊
- 漫画工作台：场景一致性、角色视觉资产、视觉锚点控制；分镜与角色面板支持图像生成确认弹窗，避免误触消耗额度
- 短剧改编生产管线 v3：从小说内容衍生短剧剧本和镜头
- 衍生工坊不在主链跑通前打开——它们消费的是小说已生成的章节、角色和场景
8. 公开介绍站与文档体系
- GitHub Pages 公开介绍站（端口 4173）展示主链、产品截图、文档入口与下载链接
- 文档站提供本地全文搜索、面包屑、文内目录、上 / 下一篇导航、tip / warn / checkpoint 提示块、GFM 表格
- 33 篇公开文档：项目介绍、安装与准备、常见问题、故障排查、第一本小说实操路径、按阶段恢复手册、端到端生产链、自动导演阶段全景、章节执行链、知识与 RAG 召回链 + 模块说明
- 模块文档配套真实产品截图；自动导演阶段名用中文表达，技术别名对照表保留在自动导演阶段全景文末供开发者查阅
9. 模型路由与本地运行
- 支持 OpenAI、DeepSeek、SiliconFlow、xAI 等多提供商；规划、正文、审阅、拆书等链路可按任务拆开路由
- 默认 SQLite 即可跑通主链；需要 RAG 检索时再接入 Qdrant
- RAG 并发数、限速等运行时参数从 .env 迁到设置面板，改完即生效无需重启
- Monorepo 拆分（pnpm workspace），桌面版 / 介绍站 / 服务端 / 客户端独立可构建
- 典型使用路径
- 在小说创建页输入一句灵感，先让 AI 自动导演给出整本方向候选。
- 进入 项目设定，先把题材、卖点、目标读者感受和前 30 章承诺定下来。
- 用 故事宏观规划、本书世界 和 角色准备，把整本主线、舞台边界和角色网补到能写。
- 进入 卷战略 / 卷骨架 决定怎么分卷，再到 节奏 / 拆章 把当前卷落到章节列表和单章细化。
- 按需绑定拆书结果、知识库文档和写法资产，让后续正文不只是靠一次性提示词。
- 进入 章节执行 逐章写作、审计、修复，必要时回到卷工作台做再平衡和重规划。
- 想加速推进时，再启动整本生产任务，持续查看状态、失败原因和回灌结果。
典型使用路径
- 在小说创建页输入一句灵感，先让 AI 自动导演给出整本方向候选。
- 进入 项目设定，先把题材、卖点、目标读者感受和前 30 章承诺定下来。
- 用 故事宏观规划、本书世界 和 角色准备，把整本主线、舞台边界和角色网补到能写。
- 进入 卷战略 / 卷骨架 决定怎么分卷，再到 节奏 / 拆章 把当前卷落到章节列表和单章细化。
- 按需绑定拆书结果、知识库文档和写法资产，让后续正文不只是靠一次性提示词。
- 进入 章节执行 逐章写作、审计、修复，必要时回到卷工作台做再平衡和重规划。
- 想加速推进时，再启动整本生产任务，持续查看状态、失败原因和回灌结果。
当前长篇生成能力支撑图
- 开书定盘负责先把这本书“要写成什么样”说清楚，避免后面越写越散。
- 整本控制层和卷级规划层负责把长篇拆成可推进、可回看、可调整的结构，而不是一次性写死。
- 角色、世界观、写法、知识库和质量控制一起托住单章生成，让每一章都尽量还在同一本书里。
- 每写完一章，系统都会把新状态回灌回去，继续影响后续章节、卷级节奏和必要时的重规划。
