1. Webnovel Writer项目概述Webnovel Writer是一个基于Claude Code构建的长篇网文AI辅助创作系统由开发者lingfengQAQ在GitHub上开源。这个项目专门针对网络小说创作中的两大核心痛点——遗忘和幻觉问题提供了一套完整的解决方案。作为一个长期从事网文创作的作者我深知写到几十万字后保持设定一致性的困难。角色性格漂移、战力崩坏、时间线混乱等问题几乎困扰着每个长篇作者。Webnovel Writer的价值在于它不只是个简单的文本生成工具而是一套完整的长篇创作管理系统从初始设定、大纲规划到章节写作、质量审查和状态维护覆盖了整个创作流程。项目目前已在GitHub获得5.4k星标最新版本为v6.2.0采用GPL v3开源协议。它支持最大200万字量级的连载创作内置37种中文网文题材模板包括玄幻修仙、都市现代、言情等主流类型。2. 核心功能解析2.1 创作流程管理Webnovel Writer将长篇创作分解为8个标准化步骤每个步骤对应一个专用命令深度初始化(/webnovel-init)通过分阶段问答建立书籍骨架包括世界观、角色设定、力量体系等基础元素。这个阶段生成的设定集会作为后续创作的宪法所有内容都必须与之保持一致。卷纲规划(/webnovel-plan)基于总纲拆解为卷、章结构补充时间线和关键事件节点。系统会确保新增内容与已有设定不冲突避免后期出现吃书情况。章节创作(/webnovel-write)完整的章节生产流水线包括上下文准备检索相关记忆和设定初稿生成多维审查一致性、节奏、OOC等润色排版事实提取与记录质量审查(/webnovel-review)从爽点设计、角色一致性、剧情连贯性等维度进行专业评估类似网文编辑的审读功能。2.2 状态维护系统项目的核心技术突破在于其状态维护机制通过.story-system目录实现运行时合同每章写作前生成的创作约束明确本章必须遵守的设定和待解决的伏笔章节提交完成后的章节事实会被结构化记录形成不可篡改的创作历史状态投影将提交内容同步到四个只读视图state.json当前状态快照index.db向量检索库summaries章节摘要memory_scratchpad.json临时记忆这种设计确保了无论写到第几章系统都能准确知道之前发生过什么从根本上解决了AI写作的遗忘问题。2.3 可视化监控/webnovel-dashboard命令会启动一个本地可视化面板实时展示角色关系图谱未回收伏笔战力变化曲线章节热度预测世界规则一致性检查这个面板对长篇创作尤其重要相当于给作者提供了一个上帝视角的创作控制台。3. 技术架构深度解析3.1 核心组件设计系统采用多Agent协作架构Context Agent负责写作前的上下文准备从记忆库和设定集中检索相关信息确保生成的章节建立在正确的基础上。Reviewer Agent质量审查专家包含多个专业评估模块一致性检查角色行为是否符合设定节奏分析爽点分布是否合理伏笔追踪是否有未回收的线索防AI检测避免生成明显机械化的文本Data Agent事实提取引擎从完成的章节中结构化抽取出新出现的人物/地点/物品发生的重大事件变化的角色关系设定的新增或修改Deconstruction Agent负责将复杂设定拆解为可执行的创作约束比如把元婴期修士可御剑飞行转化为具体的行为规则。3.2 记忆管理系统项目通过三层结构实现长期记忆短期记忆存放最近3-5章的细节信息保证上下文连贯中期记忆保存卷级的重要事件和设定变化长期记忆存储全书核心设定和关键伏笔记忆检索采用混合策略RAG关键词优先使用语义搜索当API不可用时自动回退到BM25算法。实测显示这种设计在保持检索准确率的同时大幅提高了系统鲁棒性。3.3 防幻觉机制针对AI写作常见的胡编乱造问题系统实现了多重防护合同约束每章写作前必须签署运行时合同明确创作边界事实锚定新内容必须引用已有设定或合理扩展双校验机制生成的内容要经过模型自检和专门的事实核查追溯审计所有设定变更都有完整的历史记录4. 安装与配置指南4.1 基础环境准备安装Python 3.8推荐3.10准备Claude Code运行环境获取必要的API KeyEmbedding服务如ModelscopeRerank服务如Jina AI4.2 项目安装步骤# 通过Claude插件市场安装 claude plugin marketplace add lingfengQAQ/webnovel-writer --scope user claude plugin install webnovel-writerwebnovel-writer-marketplace --scope user # 安装Python依赖 python -m pip install -r https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/requirements.txt4.3 项目初始化在Claude Code中执行/webnovel-init初始化过程会引导用户完成基础信息设置书名、作者、题材世界观构建时代背景、力量体系主要角色设定故事主线规划完成后会自动生成标准化的项目目录结构。4.4 RAG配置复制并修改.env文件cp .env.example .env关键配置项EMBED_BASE_URLhttps://api-inference.modelscope.cn/v1 EMBED_MODELQwen/Qwen3-Embedding-8B EMBED_API_KEYyour_key_here RERANK_BASE_URLhttps://api.jina.ai/v1 RERANK_MODELjina-reranker-v3 RERANK_API_KEYyour_key_here5. 实战创作流程5.1 从零开始创作示例初始化新书/webnovel-init选择玄幻修仙题材设置世界观为末法时代灵气复苏主角为重生仙尊。规划第一卷/webnovel-plan 1系统会引导拆解为8-10章包括重生觉醒1-3章初入修真界4-6章首个秘境副本7-10章写作第一章/webnovel-write 1系统会自动准备重生场景的常见写法检查主角行为是否符合仙尊重生设定记录觉醒的特殊能力审查章节/webnovel-review 1会收到包括以下维度的反馈节奏重生后的第一个冲突是否够早伏笔是否设置了足够的后续线索战力主角表现是否与设定匹配5.2 长篇维护技巧写到50章后可以使用/webnovel-query 未回收伏笔查看所有待解决的线索避免挖坑不填。当需要调整大设定时使用/webnovel-doctor --world-rules系统会评估修改对所有已写章节的影响。6. 常见问题排查6.1 写作中断处理当/webnovel-write意外中断时检查项目状态python -X utf8 scripts/webnovel.py --project-root . project-status从断点恢复/webnovel-write 15 --resume6.2 记忆检索失败如果发现AI不记得前期设定重建检索索引python -X utf8 scripts/webnovel.py --project-root . rag --rebuild检查记忆投影python -X utf8 scripts/webnovel.py --project-root . memory --validate6.3 性能优化建议当项目超过50万字时启用分卷存储[state] volume_based_storagetrue调整记忆策略[memory] active_volume_onlytrue7. 高阶使用技巧7.1 题材混合创作在/webnovel-init阶段可以指定多个题材如题材修仙系统流末世系统会自动融合相关设定元素生成独特的混合世界观。7.2 自定义审查规则在项目根目录创建.review_rules.json{ power_consistency: { strict: true, max_deviation: 0.2 }, foreshadowing: { min_per_chapter: 2, max_unresolved: 5 } }7.3 团队协作模式设置共享存储[collab] shared_storage/mnt/nfs/webnovel启用变更通知/webnovel-doctor --watch8. 项目演进方向根据项目RFC讨论v7版本将重点改进角色弧光系统量化角色成长曲线防止性格突变多线叙事支持完善支线剧情管理功能读者反馈集成对接常见网文平台API融入真实读者评价影视化适配增加分镜脚本和场景描述生成对于想要参与贡献的开发者推荐从以下方向入手新增题材模板增强Dashboard可视化优化RAG检索效率改进Windows平台兼容性
