lingfengQAQ/webnovel-writer

解决的问题

Webnovel Writer 旨在解决长篇网络小说创作中的一致性问题。它能防止 AI 在数百章的创作过程中忘记角色动机、世界观规则、情节要点（伏笔）和时间线，确保叙事的连贯性和逻辑严密性。

工作原理

该项目作为 Claude Code 的插件运行，实现了一个将“写作行为”与“事实记录行为”分离的“故事系统”。它使用专业代理（Context、Reviewer 和 Data 代理）流水线来管理创作过程：

1. 规划与初始化：设置故事骨架、世界观设定和整体大纲。

2. 写作流水线：在写作章节之前，检索必要的上下文；写作完成后，提取新事实并将其提交到永久记录中。

3. 一致性管理：使用 RAG（检索增强生成）系统，并可选配嵌入（embedding）和重排序（reranking）来查询角色状态和情节要点。

4. 状态投影：事实被投影到只读视图中，如状态 JSON、摘要和长期记忆草稿本。

5. 可视化：只读仪表板允许作者浏览实体关系图和项目状态。

适用对象

使用 AI 辅助长期连载故事创作，并需要一个系统来在海量文本中保持严格叙事一致性的网络小说作者。

亮点

• 端到端工作流：集成了初始化、规划、写作、评审和查询的命令。
• 基于事实的提交：使用 CHAPTER_COMMIT 系统，确保每个新的情节要点都被正式记录和索引。
• 多维度评审：根据节奏、一致性、OOC（角色崩坏）行为和“酷点”（读者满意度）对章节进行评审。
• RAG 集成：支持通过 OpenAI 兼容的嵌入和重排序 API 进行语义搜索，并提供 BM25 关键词搜索作为备选方案。
• 类型模板：包含 37 个内置的中文网络小说类型模板。
• 可视化仪表板：提供用于跟踪实体图和故事进度的只读界面。