lingfengQAQ/webnovel-writer

项目概览

它把长篇连载的一致性问题工程化：以'Story System'作为情节事实的唯一事实源并按章提交，新事实自动同步到可查询的状态、索引、章节摘要、长期记忆与向量库；搭配 37 个内置网文类型模板和可回退 BM25 的混合检索，为长文一致性提供了可查证的一套约束流水线。

项目类型

AI Agent · RAG 与知识库 · 提示词工程

应用场景

文档办公 · 知识问答

部署方式

查看项目说明

License

GPL-3.0

适合谁

• 希望借助 AI 写长篇连载、且重视设定与情节一致性的中文网文创作者。
• 能够接受以 CLI Skill 命令为主要交互方式、愿意维护项目状态的作者。

核心能力

• 为章节定义契约并执行提交，作为写作前和提交后情节事实的唯一事实源，是整套一致性机制的基础。
• 完成一章的完整流水线：准备上下文、起草文本、执行多维审校、润色、抽取事实，并驱动后续的状态/索引/记忆投影。
• 将新提交的事实自动同步到可查询的状态、索引、章节摘要、长期记忆与向量库中，保持后续章节可引用。
• 对已写章节从一致性、节奏、角色行为偏差（out-of-character）和读者粘性指标等维度进行审阅。
• 提供预打包的只读面板，可浏览项目状态、实体关系图、章节内容与粘性数据，无需运行 npm build。
• 管理向量索引与检索状态；在未提供 Embedding API 密钥时回退到 BM25 关键词检索。
• 内置 37 个中文网文类型模板，并支持多类型组合使用。
• 检查目录、文件、数据库、RAG、依赖和面板产物，按阶段给出状态与修复建议。

限制与风险

• 项目的自动化流水线依赖 Claude Code 环境来运行 Skill 命令，脱离该环境无法执行其流程。
• 要获得最佳语义召回效果，需要配置外部付费的 Embedding 与 Rerank API 密钥；不配置时只能回退到 BM25 关键词检索。

如何开始

• 通过 Claude Code Marketplace 安装插件，安装 Python 依赖，使用 /webnovel-init 初始化一本书，复制 .env.example 为 .env 配置 RAG。整体难度为中等，主要源于需要 Claude Code 环境、Python 依赖安装，以及为获得最佳语义召回需配置外部 RAG API。

核验依据

• GitHub 项目简介: 基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级 连载创作。
• README: 这套系统做的事，就是把上面这些“必须记住、不能写崩”的约束，变成 Claude Code 会自动执行的步骤：动笔前先查资料，写完后把新发生的事实记下来、做一致性审查，再把最新状态同步进检索索引、章节摘要、长期记忆和 Dashboard。它不只是“会写”，而是边写边攒。
• README: 一个跑在 Claude Code 上的长篇网文创作插件。从初始化设定、规划卷纲，到写章、审查、沉淀记忆、查询状态，再到一个只读的可视化面板——整条创作流程都给你串好了。
• README: | 能力 | 命令 | 说明 | |------|------|------| | 深度初始化 | `/webnovel-init` | 分阶段问答，帮你把书的骨架、设定集、总纲和初始状态搭起来 | | 卷纲规划 | `/webnovel-plan` | 基于总纲拆卷、拆章、补时间线，并写回新增设定 | | 章节创作 | `/webnovel-write`…
• README: - `.story-system/`：唯一的事实源头，动笔前的“合同”和写完后的“提交”都存在这里 - accepted 的 `CHAPTER_COMMIT`：一章写完，新事实从这里入账

来源更新时间：2026-07-14T18:05:18Z

打开原始 GitHub 项目