Webnovel Writer

这是什么？

Webnovel Writer 是一个基于 Claude Code 的长篇网文创作系统。

它的目标很简单：让 AI 在写长篇小说时不乱编、不忘事。

系统会自动管理角色设定、剧情伏笔、世界观规则，让你可以安心连载几百章而不用担心前后矛盾。

📖 详细文档在 docs/ 目录：

• 架构与模块 — 系统怎么工作的
• 命令详解 — 所有可用命令
• RAG 与配置 — 检索和环境变量配置
• 题材模板 — 37 个内置网文题材
• 运维与恢复 — 项目结构与日常运维
• 插件发版 — 发版流程
• 文档导航 — 所有文档索引

快速开始

1) 安装插件

通过 Claude Code 官方 Marketplace 安装：

claude plugin marketplace add lingfengQAQ/webnovel-writer --scope user
claude plugin install webnovel-writer@webnovel-writer-marketplace --scope user

如果只想在当前项目生效，把 --scope user 改成 --scope project。

2) 安装 Python 依赖

python -m pip install -r https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/requirements.txt

3) 初始化小说项目

在 Claude Code 中输入：

/webnovel-init

系统会引导你填写书名、题材、主角等信息，然后在当前工作区下创建项目目录。

4) 配置 RAG（必做）

进入书项目根目录，把配置模板复制为 .env 并填写 API Key：

cp .env.example .env

最小配置：

EMBED_BASE_URL=https://api-inference.modelscope.cn/v1
EMBED_MODEL=Qwen/Qwen3-Embedding-8B
EMBED_API_KEY=your_embed_api_key

RERANK_BASE_URL=https://api.jina.ai/v1
RERANK_MODEL=jina-reranker-v3
RERANK_API_KEY=your_rerank_api_key

5) 开始写作

/webnovel-plan 1      # 规划第 1 卷大纲
/webnovel-write 1     # 写第 1 章
/webnovel-review 1-5  # 审查第 1-5 章

6) 可视化面板（可选）

/webnovel-dashboard

只读面板，可以浏览项目状态、实体图谱、章节内容和追读力数据。前端已随插件预构建，不需要本地 npm build。

Story System 主链（Phase 5）

当前默认链路已经切到：

1. 写前读取 .story-system/MASTER_SETTING.json、volumes/、chapters/、reviews/
2. 写后提交 accepted CHAPTER_COMMIT
3. 由 commit projection writers 更新 .webnovel/state.json、index.db、summaries/、memory_scratchpad.json

这意味着：

• .story-system/ 是主链真源
• .webnovel/* 是投影 / read-model
• references/genre-profiles.md 只在合同缺失时作为 fallback
• preflight --format json 和 dashboard 会直接暴露 story_runtime 健康状态

7) Agent 模型设置（可选）

所有内置 Agent 默认继承当前会话模型：

model: inherit

如需单独指定，编辑对应 agents/*.md 的 frontmatter：

---
model: sonnet  # 可选：inherit / sonnet / opus / haiku
---

更新简介

版本	主要变化
v6.0.0 (当前)	Story System 全链路上线（合同种子 + 运行时合同 + 章节提交 + 事件审计），补齐集成测试
v5.5.5	长期记忆闭环：写前注入 + 写后沉淀，新增 memory 运维命令
v5.5.4	写作链提示词强约束，统一中文化审查和报告文案
v5.5.3	统一 preflight 预检命令，修复 Windows 终端编码问题
v5.5.2	大纲章节名同步到正文文件名
v5.5.1	修复卷级大纲上下文提取，补齐 Dashboard 和 Learn 命令文档
v5.5.0	新增只读可视化 Dashboard，支持实时刷新
v5.4.4	接入 Plugin Marketplace 安装机制
v5.4.3	增强 RAG 智能上下文（auto/graph_hybrid 回退 BM25）
v5.3	引入追读力系统（Hook / Cool-point / 微兑现 / 债务追踪）

开源协议

本项目使用 GPL v3 协议，详见 LICENSE。

Star 历史

致谢

本项目使用 Claude Code + Gemini CLI + Codex 配合 Vibe Coding 方式开发。
灵感来源：Linux.do 帖子

贡献

欢迎提交 Issue 和 PR：

git checkout -b feature/your-feature
git commit -m "feat: add your feature"
git push origin feature/your-feature