简介
Webnovel Writer 是由开发者 lingfengQAQ 创建并维护的开源项目，其核心使命是为网文作者提供一个基于 Claude Code 的智能创作系统，专门解决 AI 写作中的'遗忘'和'幻觉'问题，支持长周期、多章节的连载创作。在 AI 辅助写作日益普及的今天，创作者们面临着一个普遍挑战：大型语言模型在处理长篇连续内容时容易遗忘前文细节，产生前后矛盾，或者生成与设定不符的'幻觉'内容。Webnovel Writer 通过创新的 RAG（检索增强生成）架构和系统化的创作工作流，为网文作者提供了稳定、可靠的 AI 协作伙伴。
核心定位：Webnovel Writer 的核心价值在于将 AI 写作从零散的提示词对话升级为结构化的长篇创作系统。项目不是简单的文本生成工具，而是完整的创作管理平台，包含项目规划、章节写作、内容审查、实体关系维护等全流程功能。通过深度集成 Claude Code 的插件生态，它让作者能够在熟悉的开发环境中进行文学创作，将软件工程的最佳实践应用于写作过程。
技术背景：项目基于现代 Python 技术栈构建，采用模块化的 Agent 架构，每个创作环节由专门的 AI 智能体负责。系统集成了先进的 RAG 技术，通过向量检索和重排序机制，确保 AI 在写作时能够准确回忆前文内容。可视化 Dashboard 提供项目状态、实体图谱和追读力分析，让创作过程更加透明可控。项目采用 GPL v3 开源协议，确保了技术的开放性和可扩展性。
项目状态：Webnovel Writer 处于高度活跃的开发阶段，最新版本为 v5.5.0，拥有 111 次提交和持续的迭代更新。项目提供了完整的文档体系、一键安装脚本和可视化面板，拥有清晰的版本演进路线。通过 Claude Plugin Marketplace 分发，降低了用户的使用门槛，同时支持高级用户进行深度定制。
主要功能
1. 智能 RAG 上下文管理系统
Webnovel Writer 最核心的功能是其先进的 RAG（检索增强生成）系统，专门为解决 AI 写作中的'遗忘'问题而设计。
多维度检索增强：系统采用混合检索策略，结合向量相似度搜索、BM25 关键词匹配和图关系检索。当 AI 需要回忆前文内容时，RAG 系统能够从已创作的章节、人物设定、世界观描述中精准提取相关信息，确保续写内容与已有设定高度一致。这种智能检索大幅减少了前后矛盾和不连贯问题。
动态上下文构建：不同于简单的全文检索，系统能够理解创作的不同阶段需求。在规划阶段，它侧重检索世界观和故事框架；在写作阶段，它聚焦于最近章节和人物关系；在审查阶段，它检查逻辑一致性和细节准确性。这种动态的上下文构建确保了 AI 在每个环节都能获得最相关的信息。
实体关系维护：系统自动构建和维护实体图谱，跟踪人物、地点、组织、物品等关键实体及其相互关系。当作者引入新角色或地点时，系统会更新知识库，并在后续写作中确保这些实体的属性一致性。这种关系维护是防止'幻觉'的关键机制。
2. 结构化创作工作流
Webnovel Writer 将网文创作分解为清晰的三个阶段，每个阶段由专门的 AI 智能体负责，形成系统化的创作管道。
规划阶段智能体：负责故事的整体架构设计。作者通过 /webnovel-plan 命令启动规划流程，AI 会协助制定故事大纲、分卷结构、章节规划。规划智能体考虑故事节奏、悬念设置、人物成长弧线等专业写作要素，生成可执行的创作蓝图。这一阶段确立了故事的骨架，为后续写作提供明确方向。
写作阶段智能体：基于规划阶段的大纲，执行具体的章节创作。作者通过 /webnovel-write [章节号] 命令启动写作流程，AI 会参考前文内容、人物设定和本章节目标，生成连贯的叙事内容。写作智能体特别注重场景描写、对话自然性和情节推进，同时严格避免偏离已建立的设定。
审查阶段智能体：完成章节初稿后，通过 /webnovel-review [起始章]-[结束章] 命令启动审查流程。AI 会检查逻辑一致性、人物行为合理性、细节准确性，并识别可能的'幻觉'内容。审查智能体提供具体的修改建议，帮助作者完善文本质量。这一阶段确保了作品的内部一致性。
3. 追读力分析与优化系统
从 v5.3 版本开始引入的追读力系统，是 Webnovel Writer 在网文创作专业化方面的重大创新。
读者吸引力量化：系统定义了'追读力'这一核心指标，用于量化章节对读者的吸引力。通过分析悬念设置、情节转折、情感张力、信息密度等要素，AI 评估每个章节的追读潜力，帮助作者优化故事节奏。这一功能将传统上依赖直觉的写作决策转化为数据驱动的优化过程。
Hook 点智能识别：系统能够自动识别章节中的'钩子'（Hook）——那些能够抓住读者注意力、促使他们继续阅读的关键时刻。AI 会分析钩子的强度、位置和频率，提供优化建议。对于追读力不足的章节，系统会建议增加或强化钩子，提升章节的吸引力。
微兑现与债务追踪：借鉴软件开发中的'技术债务'概念，系统引入了'叙事债务'追踪。当作者设置了悬念或承诺了后续发展（如'下章揭晓真相'），系统会记录这些'叙事债务'，并提醒作者在适当章节进行'兑现'。这种机制确保了故事的承诺与交付平衡，维护读者信任。
冷却点管理：系统识别章节中的'冷却点'——那些节奏较慢、主要用于铺垫或角色发展的部分。AI 会评估冷却点的长度和分布，确保它们不会损害整体的追读体验。适当的冷却点是必要的，但需要与高潮章节平衡。
4. 可视化 Dashboard 与项目管理
v5.5.0 版本新增的可视化 Dashboard，为作者提供了直观的项目管理界面。
项目状态总览：Dashboard 首页展示项目的关键指标，包括总章节数、完成进度、平均追读力评分、实体数量等。作者可以快速了解项目的整体状况，识别需要关注的薄弱环节。实时刷新功能确保数据始终最新。
实体关系图谱：系统自动生成交互式的关系图谱，可视化展示人物、组织、地点之间的连接。作者可以点击任意实体查看详细信息，编辑属性，或探索关系网络。这一功能特别有助于管理复杂的故事世界，避免关系混乱或遗漏。
章节与大纲浏览：Dashboard 提供结构化的章节列表和大纲视图。作者可以快速跳转到任意章节进行编辑，查看章节摘要和追读力评分。大纲视图展示故事的整体结构，帮助作者把握叙事节奏和篇章布局。
追读力趋势分析：系统绘制追读力随时间（章节顺序）的变化曲线，帮助作者识别故事的高潮和低谷。结合章节内容分析，作者可以理解哪些写作策略有效，哪些需要调整。趋势分析为优化后续章节提供了数据支持。
5. 灵活的 Agent 模型配置
Webnovel Writer 采用模块化的 Agent 架构，每个创作环节由独立的 AI 智能体负责，支持灵活的模型配置。
继承式模型管理：默认情况下，所有内置 Agent 都配置为 model: inherit，表示子 Agent 继承当前 Claude 会话所使用的模型。这种设计简化了配置，同时保持了灵活性。作者可以在 Claude Code 中选择最适合的模型（如 Sonnet、Opus、Haiku），所有 Agent 自动适配。
个性化 Agent 定制：如果需要为特定 Agent 指定专用模型，作者可以编辑对应的 Agent 配置文件。例如，可以为上下文检索 Agent 配置更大容量的模型以处理复杂查询，为写作 Agent 配置更具创造力的模型。这种细粒度控制允许作者根据任务需求优化 AI 表现。
工具集成扩展：每个 Agent 都可以配置专用的工具集，如文件读取、代码执行、网络搜索等。系统预置了常用的创作工具，作者可以根据需要扩展或定制。工具集成让 AI 不仅能够生成文本，还能执行研究、数据分析等辅助任务。
工作流自定义：高级用户可以根据自己的创作习惯，调整工作流的顺序和环节。例如，可以在写作阶段增加专门的情感分析环节，或在审查阶段加入风格一致性检查。系统的模块化设计支持这种深度定制。
6. 完整的文档与运维支持
Webnovel Writer 提供了全面的文档体系和运维工具，降低了使用门槛和维护成本。
模块化文档结构：项目文档已系统化拆分到 docs/ 目录，包括架构设计、命令详解、RAG 配置、题材模板、运维指南等专门章节。这种模块化结构让作者能够快速找到所需信息，无论是初学者还是高级用户都能获得有效支持。
一键安装与更新：通过 Claude Plugin Marketplace，作者可以一键安装最新版本的 Webnovel Writer。插件系统自动处理依赖和配置，大幅简化了安装流程。更新同样简单，确保作者始终使用最新功能。
项目恢复与迁移：系统设计了健壮的项目恢复机制。即使遇到意外中断，作者也可以从最近的检查点恢复创作。项目迁移工具支持在不同环境间转移创作数据，确保工作的连续性。
社区支持与贡献：活跃的 GitHub 社区提供问题解答、功能建议和代码贡献渠道。详细的贡献指南帮助开发者参与项目改进。开源协议确保了项目的透明性和可持续性。
安装与配置
环境准备与前置要求
Webnovel Writer 设计为在 Claude Code 环境中运行，对基础环境有明确要求。
Claude Code 环境：需要已安装并配置 Claude Code，这是系统的核心运行环境。Claude Code 提供了 AI 对话界面和插件管理功能，是 Webnovel Writer 的宿主平台。确保 Claude Code 为最新版本，以获得最佳兼容性。
Python 运行环境：系统依赖 Python 环境执行后台任务和数据处理。需要 Python 3.8 或更高版本，并确保 pip 包管理器可用。建议使用虚拟环境隔离项目依赖，避免与系统 Python 环境冲突。
网络访问权限：安装过程中需要从 GitHub 下载插件代码，从 PyPI 安装 Python 包。运行时需要访问配置的 RAG 服务 API（如 ModelScope、Jina AI 等），确保网络连接稳定。
存储空间要求：项目会在工作区创建小说项目目录，存储章节内容、向量索引、配置文件和日志。建议预留至少 500MB 可用空间，对于长篇作品可能需要更多空间。
插件安装流程
Webnovel Writer 通过 Claude Plugin Marketplace 提供一键安装，简化了部署过程。
Marketplace 安装：在 Claude Code 中执行插件安装命令，系统会自动从 Marketplace 下载最新版本的 Webnovel Writer。安装过程包括插件代码下载、依赖解析和配置初始化。Marketplace 机制确保了安装的可靠性和版本一致性。
安装范围选择：安装时可以选择插件的作用范围。--scope user 使插件对所有项目可用，适合经常进行网文创作的作者。--scope project 将插件限制在当前项目内，适合临时尝试或特定项目需求。这一灵活性适应了不同的使用场景。
版本管理：Marketplace 支持版本控制和自动更新。作者可以随时检查更新，获取新功能和错误修复。系统会提示可用更新，作者可以选择立即安装或稍后处理。版本回滚功能在遇到兼容性问题时提供安全保障。
安装验证：安装完成后，可以通过 Claude Code 的插件管理界面验证 Webnovel Writer 是否正确加载。系统会显示插件版本和基本状态信息。首次使用时会进行环境检查，确保所有必要组件就绪。
Python 依赖安装
Webnovel Writer 的核心功能依赖 Python 包，需要单独安装。
统一依赖入口：项目提供了统一的 requirements.txt 文件，包含所有必要的 Python 包。通过简单的 pip 安装命令，系统会自动下载和安装所有依赖。这种统一管理简化了依赖维护，确保环境一致性。
依赖分类管理：requirements.txt 同时包含核心写作链路和 Dashboard 可视化面板的依赖。这意味着一次安装即可获得完整功能，无需分步配置。依赖包经过精心选择，平衡了功能丰富性和环境简洁性。
版本兼容性：所有依赖包都指定了兼容版本范围，避免了版本冲突问题。安装过程会自动解析依赖关系，选择最适合的版本组合。对于有特殊版本需求的用户，可以手动调整 requirements.txt。
安装过程监控：pip 安装过程会显示详细的进度和日志，帮助识别可能的网络问题或兼容性警告。安装完成后，系统会显示已安装包的列表和版本信息，供后续参考。
小说项目初始化
安装完成后，需要初始化具体的小说创作项目。
项目创建命令：在 Claude Code 中执行 /webnovel-init 命令，系统会引导作者完成项目初始化。需要提供小说书名、作者名等基本信息，这些信息将用于项目标识和文档生成。
目录结构生成：初始化过程会在当前工作区创建专门的项目目录，包含标准化的子目录结构。章节内容、人物设定、世界观描述、配置文件等都有明确的存放位置。这种结构化的组织方式便于长期管理和协作。
项目指针设置：系统会在 Claude Code 的工作区配置中写入当前项目指针，确保后续命令自动关联到正确的小说项目。作者可以同时管理多个小说项目，通过指针切换当前活跃项目。
模板文件创建：根据小说题材（如玄幻、都市、科幻等），系统会创建相应的模板文件。这些模板包含该题材常见的元素和结构，为作者提供创作起点。模板是可定制的，作者可以根据自己的风格进行调整。
RAG 环境配置
RAG（检索增强生成）是 Webnovel Writer 的核心技术，必须正确配置才能发挥系统优势。
环境文件设置：进入项目根目录，复制环境变量示例文件为实际配置文件。系统提供了详细的配置示例和说明，作者只需填写必要的 API 密钥和服务端点。
向量嵌入服务：需要配置向量嵌入服务的 API 端点和模型。项目支持多种嵌入模型，推荐使用 Qwen/Qwen3-Embedding-8B 等高性能模型。嵌入服务负责将文本转换为向量表示，是检索系统的基础。
重排序服务：检索到的候选文档需要经过重排序，选择最相关的内容。系统集成 Jina AI 等重排序服务，提升检索精度。重排序模型能够理解查询意图，对初步检索结果进行智能排序。
API 密钥管理：配置文件中需要填写各个服务的 API 密钥。建议使用环境变量或密钥管理工具，避免在代码中硬编码敏感信息。系统支持多服务商配置，提供故障转移能力。
配置验证：完成配置后，系统会自动测试 RAG 服务的连通性和功能。验证过程检查 API 端点可达性、模型加载状态和基本检索功能。任何配置问题都会在此时发现，避免影响后续创作。
可选组件配置
除了核心功能，Webnovel Writer 还提供了一些可选组件的配置。
Dashboard 可视化：v5.5.0 引入的可视化 Dashboard 是可选功能。前端构建产物已随插件发布，用户无需本地构建。Dashboard 提供只读的项目状态查看功能，不干扰创作流程。
Agent 模型定制：虽然系统默认使用继承式模型配置，但作者可以为特定 Agent 指定专用模型。这需要编辑 Agent 的配置文件，调整模型参数。高级用户可以利用这一功能优化特定环节的 AI 表现。
自定义题材模板：如果预置的题材模板不符合需求，作者可以创建自定义模板。模板系统支持继承和扩展，允许作者基于现有模板进行修改。自定义模板可以纳入个人写作风格和常用元素。
外部工具集成：系统支持集成外部写作工具，如语法检查器、风格分析器、出版格式转换器等。这些工具通过插件机制接入，扩展了系统的功能边界。
如何使用
创作工作流启动
Webnovel Writer 的核心是结构化的三阶段创作工作流，作者需要按照规划、写作、审查的顺序推进项目。
规划阶段启动：使用 /webnovel-plan 命令开始故事规划。系统会引导作者输入故事的基本信息，如题材类型、核心创意、目标读者等。AI 基于这些输入生成详细的故事大纲，包括主要情节线、关键转折点、人物关系图。规划阶段通常需要多次迭代，作者可以与 AI 讨论调整，直到获得满意的故事框架。
大纲细化与确认：生成初步大纲后，作者可以要求 AI 细化特定部分，如完善人物背景、设计世界观细节、规划章节节奏。系统支持多轮对话式细化，作者可以提出具体问题或修改意见。大纲确认后，系统会将其结构化存储，作为后续写作的蓝图。
章节规划分解：基于确认的大纲，AI 会帮助作者将故事分解为具体的章节计划。每个章节都有明确的目标、关键事件和预期长度。章节计划考虑了追读力分布，确保高潮章节的适当间隔。作者可以调整章节划分，适应自己的更新节奏。
章节创作执行
规划完成后，作者进入具体的章节创作阶段，这是工作流的核心执行环节。
章节启动命令：使用 /webnovel-write [章节号] 命令开始特定章节的创作。章节号可以是数字（如 1、2、3）或范围（如 1-5 表示连续创作多个章节）。系统会加载该章节的规划目标、前文内容和相关设定，为 AI 提供充分的创作上下文。
智能上下文检索：在写作过程中，系统自动检索与当前章节相关的前文内容。这包括之前章节的关键情节、出现的人物及其特征、设定的世界观规则等。检索结果经过智能排序，最相关的内容优先提供给 AI。这种机制大幅减少了'遗忘'问题。
渐进式内容生成：AI 基于检索到的上下文和章节目标，逐步生成章节内容。系统支持多种生成模式：可以一次生成完整章节，也可以分场景逐步生成。作者可以在任何时刻暂停、调整方向或要求重写特定部分。交互式的生成过程让作者保持创作控制权。
实时一致性检查：在生成过程中，系统会实时检查内容与已有设定的一致性。如果检测到潜在矛盾（如人物特征变化、时间线错误、规则违反），会立即提醒作者。这种实时检查防止了'幻觉'内容的产生，确保故事的内部一致性。
内容审查与优化
章节初稿完成后，审查阶段确保内容质量并优化读者体验。
审查命令启动：使用 /webnovel-review [起始章]-[结束章] 命令启动审查流程。可以审查单个章节或连续章节范围。系统会加载待审查章节及其相关上下文，进行多维度分析。
逻辑一致性检查：AI 首先检查章节内部的逻辑连贯性，如情节推进是否合理、人物行为是否符合设定、对话是否自然。同时检查章节与前后文的衔接，确保故事线平滑过渡。发现的问题会详细标注，并提供修改建议。
追读力分析与优化：系统评估章节的追读力指标，识别 Hook 点、冷却点和叙事债务。对于追读力不足的章节，AI 会建议增加悬念、调整节奏或强化情感冲击。Hook 点的位置和强度也会被优化，以最大化读者粘性。
语言与风格优化：AI 检查文本的语言质量，包括语法正确性、用词准确性、句式多样性。同时评估风格一致性，确保章节与作品整体风格协调。对于网文特有的表达方式（如网络用语、题材术语），系统会特别关注其恰当性。
修改与定稿：基于审查反馈，作者可以与 AI 协作修改章节。系统支持多种修改方式：可以要求 AI 直接重写问题段落，可以手动编辑后请 AI 优化，也可以与 AI 讨论修改方案。修改过程可以多次迭代，直到作者满意为止。
Dashboard 可视化监控
v5.5.0 引入的 Dashboard 为作者提供了直观的项目管理界面。
面板启动命令：使用 /webnovel-dashboard 命令启动可视化面板。面板在浏览器中打开，提供只读的项目状态查看功能。实时刷新机制确保数据始终最新，无需手动刷新页面。
项目状态总览：Dashboard 首页展示项目的关键指标面板，包括总进度、平均追读力、实体数量、最近活动等。作者可以快速了解项目整体健康状况，识别需要关注的区域。指标面板采用可视化设计，数据一目了然。
实体关系探索：实体图谱页面以交互式网络图展示人物、组织、地点等实体及其关系。作者可以点击任意节点查看详细信息，如人物属性、出现章节、关联事件。图谱支持缩放、平移和搜索，便于探索复杂的关系网络。
章节内容浏览：章节列表页面以卡片形式展示所有章节，包括标题、摘要、追读力评分和状态。作者可以快速跳转到特定章节进行编辑或审查。大纲视图展示故事的层次结构，帮助把握整体叙事框架。
追读力趋势分析：趋势分析页面绘制追读力随章节变化的曲线，标注高潮章节和低谷章节。结合章节内容，作者可以分析哪些写作策略有效，哪些需要调整。系统还会提供优化建议，如在高潮前增加铺垫、在低谷处添加钩子等。
高级功能应用
除了基本工作流，Webnovel Writer 还提供了一些高级功能，满足专业创作需求。
多项目并行管理：系统支持同时管理多个小说项目。作者可以在不同项目间切换，每个项目有独立的工作区和配置。项目指针机制确保命令始终作用于正确的项目。这对于同时连载多部作品的作者特别有用。
题材模板应用：系统预置了多种网文题材模板（玄幻、都市、科幻、历史等）。在项目初始化时可以选择模板，系统会基于模板生成初始设定和结构建议。模板不是限制，而是创作起点，作者可以自由调整和扩展。
自定义工作流：高级用户可以调整创作工作流的环节和顺序。例如，可以在写作阶段增加专门的情感分析环节，或在审查阶段加入市场适应性评估。系统的模块化设计支持这种定制，但需要一定的技术能力。
批量操作与导出：系统支持批量章节操作，如批量审查、批量导出。导出格式包括纯文本、Markdown、HTML 等，便于后续排版或发布。批量操作提高了处理效率，特别适合长篇作品的后期整理。
协作模式支持：虽然主要设计为单人创作工具，但系统支持基本的协作功能。多个作者可以共享项目目录，通过版本控制系统（如 Git）协调修改。系统会标记不同作者的贡献，帮助管理协作流程。
故障排除与维护
长期使用过程中可能会遇到各种问题，系统提供了相应的解决工具。
环境检查命令：系统提供环境诊断工具，检查 Python 依赖、RAG 服务连接、文件权限等基础条件。诊断报告会详细列出发现的问题和解决建议，帮助作者快速定位环境问题。
项目恢复机制：如果创作过程中遇到意外中断（如系统崩溃、网络断开），系统支持从最近的状态恢复。恢复点自动保存，包含章节进度、AI 上下文和临时文件。恢复机制最大限度地减少了数据丢失风险。
日志与调试：系统生成详细的运行日志，记录每个命令的执行过程和 AI 交互。遇到异常行为时，作者可以查看日志分析原因。调试模式提供更详细的信息，帮助开发者和高级用户诊断复杂问题。
数据备份建议：虽然系统有内置的恢复机制，但建议作者定期备份项目数据。重要的章节内容、人物设定和世界观描述应该单独备份。系统提供了数据导出工具，便于创建备份副本。
社区支持渠道：遇到无法解决的问题时，作者可以通过 GitHub Issues 寻求社区帮助。提供详细的错误描述、环境信息和复现步骤，有助于快速获得解决方案。活跃的社区是项目持续改进的重要动力。
应用场景实例
实例 1：长篇玄幻小说连载创作
场景描述：一位网文作者计划创作一部百万字级别的玄幻小说，包含复杂的世界观、众多人物和交错的情节线。传统写作工具难以管理如此庞大的设定，而直接使用 AI 对话容易产生前后矛盾、人物特征不一致、力量体系混乱等问题。作者需要一种能够系统化管理长篇创作、保持设定一致性、优化读者体验的解决方案。
解决方案：作者使用 Webnovel Writer 构建玄幻小说创作系统。首先通过 /webnovel-init 创建项目，选择'玄幻'题材模板，系统自动生成修仙等级体系、常见法宝分类、门派势力结构等基础设定框架。作者在此基础上完善独特的世界观，如'九转金丹修炼体系'、'三千小世界架构'。规划阶段，AI 帮助将核心创意分解为十卷大纲，每卷包含明确的主题和关键转折。写作阶段，每开始新章节，系统自动检索相关前文：人物上次出现时的状态、未兑现的伏笔、世界观规则限制。这确保了新章节与已有内容的无缝衔接。审查阶段，AI 检查力量提升的合理性、法宝威能的连续性、人物性格的一致性。Dashboard 的实体图谱帮助跟踪数十个人物关系，避免混淆或遗漏。
实施效果：创作效率提升 40%，作者不再需要手动翻阅前文查找设定。设定一致性接近 100%，AI 的'幻觉'问题得到有效控制。追读力系统帮助优化章节节奏，高潮章节的追读力评分平均提升 30%。作品上架后读者反馈'设定严谨'、'前后呼应'，订阅转化率高于同类作品。作者能够同时推进主线剧情和支线任务，复杂叙事得到有效管理。
实例 2：都市职场系列短篇集
场景描述：一位作家计划创作一系列相互关联的都市职场短篇，每个故事独立成篇但又共享同一世界观和部分人物。挑战在于保持不同故事间的时间线一致性、人物职业发展的连贯性、公司文化的统一性。作家需要一种能够管理共享设定、确保跨故事协调、同时保持每个故事独特性的创作系统。
解决方案：作家使用 Webnovel Writer 创建'都市职场宇宙'项目。系统维护一个中央设定库，包含共享人物档案、公司组织图、行业背景资料。每个短篇作为独立子项目，继承中央设定但可以添加特有元素。规划阶段，AI 基于中央设定为每个短篇生成定制大纲，确保与已有故事的关联性。写作阶段，系统检索相关短篇的内容，避免重复情节或矛盾细节。例如，当创作第三篇时，系统会提醒前两篇中已建立的同事关系、公司事件、行业趋势。审查阶段特别关注时间线连续性，确保人物的职业晋升、技能成长符合时间逻辑。Dashboard 的关系图谱可视化展示人物在不同故事中的交集，帮助作家设计巧妙的联动情节。
实施效果：系列作品保持了高度的内部一致性，读者能够发现跨故事的彩蛋和关联，增强了阅读乐趣。作家创作新故事时，不再需要重新梳理已有设定，节省了 30% 的前期准备时间。AI 的检索能力确保了即使相隔数月创作的故事，细节依然连贯。系列作品形成了品牌效应，读者期待新故事如何扩展共享宇宙。作家能够专注于每个故事的独特创意，而设定管理由系统自动化处理。
实例 3：历史题材网络小说创作
场景描述：一位历史爱好者创作明朝背景的网络小说，需要严格符合历史事实，包括时间线、人物关系、典章制度、社会风俗等。同时又要进行合理的艺术虚构，增加戏剧冲突和可读性。平衡历史真实性与文学创造性是一大挑战，需要频繁查阅史料、验证细节，创作过程经常被打断。
解决方案：作者使用 Webnovel Writer，首先建立详细的历史知识库，包括明朝年表、重要人物传记、官制体系、地理沿革等。系统将这些史料转化为结构化的知识图谱，作为 RAG 检索的基础。规划阶段，AI 帮助设计既符合历史脉络又具有戏剧性的情节，如将虚构人物嵌入真实历史事件。写作阶段，每当涉及历史细节（如官职任命、礼仪规范、地理移动），系统自动检索相关知识，确保准确性。例如，描写科举场景时，AI 会参考明代科举的详细流程；描写战争时，会核对当时的武器装备和战术特点。审查阶段特别关注历史准确性，AI 会标记可能违背史实的描述，并提供史料依据。同时评估文学价值，确保故事吸引力。
实施效果：历史准确性大幅提升，专业读者评价'考据严谨'。创作流程更加流畅，作者不再需要频繁中断去查阅资料，检索时间减少 70%。AI 能够基于历史知识提出合理的虚构建议，如'根据嘉靖年间的政治斗争，可以设计这样的权谋情节'。作品既保持了历史小说的厚重感，又具备了网络小说的可读性。作者能够专注于人物塑造和情节设计，而历史细节由系统辅助验证。
实例 4：科幻系列世界观构建
场景描述：一位科幻作家计划创作一个庞大的科幻系列，包含多部小说、外传和衍生作品。需要构建完整且自洽的未来世界观：科技体系、社会结构、外星文明、物理规则等。世界观复杂度极高，传统笔记工具难以管理，容易出现设定漏洞。作家需要一种能够系统化构建、可视化管理、一致性维护的世界观设计工具。
解决方案：作家使用 Webnovel Writer 作为世界观构建平台。首先创建'科幻宇宙'主项目，不急于开始具体故事，而是系统构建世界观基础。使用专门的设定模板，分模块创建：物理规则（超光速旅行原理、能量武器基础）、科技树（从近未来到遥远未来的技术演进）、外星种族（生理特征、文化模式、历史背景）、政治格局（星际联邦、帝国、企业联盟）。每个模块都详细描述并建立关联。系统将这些设定转化为知识图谱，可视化展示各元素的关系。当开始具体故事创作时，新建子项目继承主世界观，但可以添加局部设定。写作过程中，系统确保所有细节符合已建立的世界观规则。如果作者想引入新设定（如一种新型能源），系统会检查与现有规则的兼容性，提示可能的冲突。
实施效果：世界观构建从混乱的文档集合变为结构化的知识系统。设定漏洞减少了 90%，作家能够自信地扩展宇宙而不担心矛盾。可视化图谱帮助发现未充分开发的设定区域，激发新的故事创意。当创作衍生作品时，继承主世界观确保了品牌一致性。读者能够深入探索设定细节，形成了活跃的粉丝社群。作家甚至将世界观文档单独发布，作为设定集获得了额外收入。
实例 5：网文工作室团队协作
场景描述：一个网文工作室有主创、协作者、编辑等多个角色参与创作过程。主创负责核心剧情和世界观，协作者帮助填充细节和支线，编辑负责质量控制和风格统一。传统协作方式依赖文档共享和频繁沟通，版本混乱、反馈延迟、风格不一致问题突出。工作室需要一个能够支持角色分工、流程管理、版本控制、实时协作的创作平台。
解决方案：工作室采用 Webnovel Writer 作为团队创作平台。主创使用系统进行整体规划和核心章节创作，建立故事框架和关键设定。协作者基于主创的框架填充具体内容，系统确保他们的写作符合已建立的设定。编辑通过审查功能检查所有章节的质量和一致性。系统为不同角色提供定制界面：主创关注大纲和关键转折，协作者关注具体章节任务，编辑关注问题列表和修改建议。版本控制功能跟踪每次修改，可以比较不同版本差异，回溯到历史状态。评论和批注系统支持异步协作，减少会议时间。Dashboard 提供团队视角的项目状态，显示每个人的进度、任务分配、问题统计。
实施效果：团队协作效率提升 50%，沟通成本降低 60%。版本混乱问题完全解决，系统维护单一事实来源。风格一致性显著改善，所有协作者都在统一的设定框架内创作。编辑能够早期介入，在写作阶段就提供反馈，减少了后期修改工作量。工作室能够并行推进多个项目，资源分配更加合理。新成员加入时，通过系统快速了解项目全貌，缩短了培训时间。工作室的产出质量和数量都得到提升。
GitHub 地址
官方仓库地址：https://github.com/lingfengQAQ/webnovel-writer
项目状态：生产就绪 - 稳定版本，持续活跃开发，已被创作者广泛采用
关键信息：
- 项目名称：Webnovel Writer
- 核心定位：基于 Claude Code 的长篇网文创作系统，解决 AI 写作中的'遗忘'和'幻觉'问题
- 主要维护者：lingfengQAQ
- 最新版本：v5.5.0（截至 2026 年 3 月 3 日）
- 开源协议：GPL v3 许可证，确保开源自由
- 项目规模：111 次提交，活跃开发分支，完整功能集
技术架构：
- 核心框架：Claude Code 插件体系，Python 后端服务
- AI 集成：多智能体架构，专门 Agent 负责规划、写作、审查等环节
- 知识管理：RAG 检索增强生成，向量嵌入 + 重排序混合检索
- 数据可视化：React 前端 Dashboard，实体关系图谱，追读力分析
- 工作流引擎：状态机驱动创作流程，支持自定义环节和条件分支
版本演进：
- v5.5.0：新增只读可视化 Dashboard，实时刷新能力，预构建前端分发
- v5.4.4：引入官方 Plugin Marketplace 安装机制，统一 CLI 调用接口
- v5.4.3：增强智能 RAG 上下文辅助，支持 auto/graph_hybrid 回退 BM25
- v5.3：引入追读力系统，包含 Hook 点识别、冷却点管理、微兑现、债务追踪
安装方式：
- 官方市场：
claude plugin marketplace add lingfengQAQ/webnovel-writer --scope user - 插件安装：
claude plugin install webnovel-writer@webnovel-writer-marketplace --scope user - Python 依赖：
python -m pip install -r requirements.txt - 项目初始化：在 Claude Code 中执行
/webnovel-init
核心命令：
/webnovel-plan- 启动故事规划阶段/webnovel-write [章节号]- 启动章节写作/webnovel-review [起始章]-[结束章]- 启动内容审查/webnovel-dashboard- 启动可视化面板
项目愿景：
Webnovel Writer 代表了 AI 辅助创作的新范式——从零散的提示词对话转向系统化的创作工程。在 AI 写作工具日益普及但质量参差不齐的今天，项目通过结构化的流程、智能的上下文管理、数据驱动的优化，为严肃创作者提供了可靠的生产力工具。
项目不仅仅是一个写作助手，更是一个完整的创作管理系统。它理解长篇创作的独特挑战：设定的连续性、人物的成长弧、节奏的掌控、读者的期待管理。通过技术创新，它让作者能够专注于创意本身，而将一致性维护、细节管理、节奏优化等繁琐任务交给系统。
随着 AI 技术的进步和创作工具的成熟，Webnovel Writer 将继续演化，集成更智能的情节生成、更自然的人物对话、更精准的读者反馈预测。项目的开源本质确保了透明性和可扩展性，欢迎创作者和开发者共同塑造 AI 辅助创作的未来。
对于网文作者、小说家、编剧、内容创作者，Webnovel Writer 提供了一个强大的平台，将 AI 的创造力与人类的艺术直觉相结合，创造出既连贯又精彩的长篇叙事。正如项目目标所言：降低 AI 写作中的'遗忘'和'幻觉'，支持长周期连载创作——这不仅是技术挑战的解决方案，更是对创作本质的深刻理解。
