企业官网建设流程全解析

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个标准化步骤，每个步骤对应一个专用命令：

1. 深度初始化(/webnovel-init)：通过分阶段问答建立书籍骨架，包括世界观、角色设定、力量体系等基础元素。这个阶段生成的设定集会作为后续创作的"宪法"，所有内容都必须与之保持一致。

2. 卷纲规划(/webnovel-plan)：基于总纲拆解为卷、章结构，补充时间线和关键事件节点。系统会确保新增内容与已有设定不冲突，避免后期出现"吃书"情况。

3. 章节创作(/webnovel-write)：完整的章节生产流水线，包括：

   • 上下文准备（检索相关记忆和设定）
   • 初稿生成
   • 多维审查（一致性、节奏、OOC等）
   • 润色排版
   • 事实提取与记录

4. 质量审查(/webnovel-review)：从爽点设计、角色一致性、剧情连贯性等维度进行专业评估，类似网文编辑的"审读"功能。

2.2 状态维护系统

项目的核心技术突破在于其状态维护机制，通过.story-system目录实现：

• 运行时合同：每章写作前生成的"创作约束"，明确本章必须遵守的设定和待解决的伏笔
• 章节提交：完成后的章节事实会被结构化记录，形成不可篡改的创作历史
• 状态投影：将提交内容同步到四个只读视图：
  • state.json（当前状态快照）
  • index.db（向量检索库）
  • summaries（章节摘要）
  • memory_scratchpad.json（临时记忆）

这种设计确保了无论写到第几章，系统都能准确知道"之前发生过什么"，从根本上解决了AI写作的遗忘问题。

2.3 可视化监控

/webnovel-dashboard命令会启动一个本地可视化面板，实时展示：

• 角色关系图谱
• 未回收伏笔
• 战力变化曲线
• 章节热度预测
• 世界规则一致性检查

这个面板对长篇创作尤其重要，相当于给作者提供了一个"上帝视角"的创作控制台。

3. 技术架构深度解析

3.1 核心组件设计

系统采用多Agent协作架构：

1. Context Agent：负责写作前的上下文准备，从记忆库和设定集中检索相关信息，确保生成的章节建立在正确的基础上。

2. Reviewer Agent：质量审查专家，包含多个专业评估模块：

   • 一致性检查（角色行为是否符合设定）
   • 节奏分析（爽点分布是否合理）
   • 伏笔追踪（是否有未回收的线索）
   • 防AI检测（避免生成明显机械化的文本）

3. Data Agent：事实提取引擎，从完成的章节中结构化抽取出：

   • 新出现的人物/地点/物品
   • 发生的重大事件
   • 变化的角色关系
   • 设定的新增或修改

4. Deconstruction Agent：负责将复杂设定拆解为可执行的创作约束，比如把"元婴期修士可御剑飞行"转化为具体的行为规则。

3.2 记忆管理系统

项目通过三层结构实现长期记忆：

1. 短期记忆：存放最近3-5章的细节信息，保证上下文连贯
2. 中期记忆：保存卷级的重要事件和设定变化
3. 长期记忆：存储全书核心设定和关键伏笔

记忆检索采用混合策略（RAG+关键词），优先使用语义搜索，当API不可用时自动回退到BM25算法。实测显示，这种设计在保持检索准确率的同时，大幅提高了系统鲁棒性。

3.3 防幻觉机制

针对AI写作常见的"胡编乱造"问题，系统实现了多重防护：

1. 合同约束：每章写作前必须签署"运行时合同"，明确创作边界
2. 事实锚定：新内容必须引用已有设定或合理扩展
3. 双校验机制：生成的内容要经过模型自检和专门的事实核查
4. 追溯审计：所有设定变更都有完整的历史记录

4. 安装与配置指南

4.1 基础环境准备

1. 安装Python 3.8+（推荐3.10）
2. 准备Claude Code运行环境
3. 获取必要的API Key：
   • Embedding服务（如Modelscope）
   • Rerank服务（如Jina AI）

4.2 项目安装步骤

# 通过Claude插件市场安装 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 https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/requirements.txt

4.3 项目初始化

在Claude Code中执行：

/webnovel-init

初始化过程会引导用户完成：

1. 基础信息设置（书名、作者、题材）
2. 世界观构建（时代背景、力量体系）
3. 主要角色设定
4. 故事主线规划

完成后会自动生成标准化的项目目录结构。

4.4 RAG配置

复制并修改.env文件：

cp .env.example .env

关键配置项：

EMBED_BASE_URL=https://api-inference.modelscope.cn/v1 EMBED_MODEL=Qwen/Qwen3-Embedding-8B EMBED_API_KEY=your_key_here RERANK_BASE_URL=https://api.jina.ai/v1 RERANK_MODEL=jina-reranker-v3 RERANK_API_KEY=your_key_here

5. 实战创作流程

5.1 从零开始创作示例

1. 初始化新书：

   /webnovel-init

   选择"玄幻修仙"题材，设置世界观为"末法时代灵气复苏"，主角为"重生仙尊"。

2. 规划第一卷：

   /webnovel-plan 1

   系统会引导拆解为8-10章，包括：

   • 重生觉醒（1-3章）
   • 初入修真界（4-6章）
   • 首个秘境副本（7-10章）

3. 写作第一章：

   /webnovel-write 1

   系统会自动：

   • 准备重生场景的常见写法
   • 检查主角行为是否符合"仙尊重生"设定
   • 记录觉醒的特殊能力

4. 审查章节：

   /webnovel-review 1

   会收到包括以下维度的反馈：

   • 节奏：重生后的第一个冲突是否够早
   • 伏笔：是否设置了足够的后续线索
   • 战力：主角表现是否与设定匹配

5.2 长篇维护技巧

写到50章后，可以使用：

/webnovel-query 未回收伏笔

查看所有待解决的线索，避免"挖坑不填"。

当需要调整大设定时，使用：

/webnovel-doctor --world-rules

系统会评估修改对所有已写章节的影响。

6. 常见问题排查

6.1 写作中断处理

当/webnovel-write意外中断时：

1. 检查项目状态：

   python -X utf8 "scripts/webnovel.py" --project-root "." project-status

2. 从断点恢复：

   /webnovel-write 15 --resume

6.2 记忆检索失败

如果发现AI不记得前期设定：

1. 重建检索索引：

   python -X utf8 "scripts/webnovel.py" --project-root "." rag --rebuild

2. 检查记忆投影：

   python -X utf8 "scripts/webnovel.py" --project-root "." memory --validate

6.3 性能优化建议

当项目超过50万字时：

1. 启用分卷存储：

   [state] volume_based_storage=true

2. 调整记忆策略：

   [memory] active_volume_only=true

7. 高阶使用技巧

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 团队协作模式

1. 设置共享存储：

   [collab] shared_storage=/mnt/nfs/webnovel

2. 启用变更通知：

   /webnovel-doctor --watch

8. 项目演进方向

根据项目RFC讨论，v7版本将重点改进：

1. 角色弧光系统：量化角色成长曲线，防止性格突变
2. 多线叙事支持：完善支线剧情管理功能
3. 读者反馈集成：对接常见网文平台API，融入真实读者评价
4. 影视化适配：增加分镜脚本和场景描述生成

对于想要参与贡献的开发者，推荐从以下方向入手：

• 新增题材模板
• 增强Dashboard可视化
• 优化RAG检索效率
• 改进Windows平台兼容性