Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级 连载创作。
| Date | Stars |
|---|---|
| 2026-07-31 | 6202 |
| 2026-08-02 | 6202 |
| 2026-08-04 | 6312 |
| 2026-08-06 | 6312 |
Today
— stars today
This week
— stars this week
This month
— stars this month
Momentum
15.0
growth rate 0.00%/day
# Webnovel Writer
[](LICENSE)
[](.claude-plugin/marketplace.json)
[](https://www.python.org/)
[](https://claude.ai/claude-code)
[](.claude-plugin/marketplace.json)
<a href="https://trendshift.io/repositories/22487" target="_blank"><img src="https://trendshift.io/api/badge/repositories/22487" alt="lingfengQAQ%2Fwebnovel-writer | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
一个跑在 Claude Code 上的长篇网文创作插件。从初始化设定、规划卷纲，到写章、审查、沉淀记忆、查询状态，再到一个只读的可视化面板——整条创作流程都给你串好了。
它想解决的其实就一件事：**让 AI 写到几百章，依然记得住设定、接得住伏笔、守得住大纲。**
一句话定位：这是一套面向长篇连载的一致性系统，不是写完就忘的一次性生成器。
> **v7 重构 RFC 公示中**
>
> 下一代 v7 设计已经进入公开意见征集期，欢迎阅读 [Discussions #118：v7 设计公示](https://github.com/lingfengQAQ/webnovel-writer/discussions/118) 并留下反馈。只看 Issue 区的用户也可以从 [Issue #119：v7 公示指引帖](https://github.com/lingfengQAQ/webnovel-writer/issues/119) 进入；原“下一步方向投票”已结束，后续优先级将以 RFC 反馈和实施计划为准。
## 为什么需要它
长篇创作最难的不是写出第一章，而是写到第 80 章、第 200 章以后仍然保持：
- 角色动机不漂移
- 战力、时间线、地点和世界规则不互相打架
- 伏笔有登记、有推进、有回收
- 爽点、感情线、世界观扩展保持节奏
- 每章写完后事实会沉淀到可检索的状态系统
这套系统做的事，就是把上面这些“必须记住、不能写崩”的约束，变成 Claude Code 会自动执行的步骤：动笔前先查资料，写完后把新发生的事实记下来、做一致性审查，再把最新状态同步进检索索引、章节摘要、长期记忆和 Dashboard。它不只是“会写”，而是边写边攒。
## 核心能力
| 能力 | 命令 | 说明 |
|------|------|------|
| 深度初始化 | `/webnovel-init` | 分阶段问答，帮你把书的骨架、设定集、总纲和初始状态搭起来 |
| 卷纲规划 | `/webnovel-plan` | 基于总纲拆卷、拆章、补时间线，并写回新增设定 |
| 章节创作 | `/webnovel-write` | 一条龙写完一章：备上下文、起草、审查、润色、记录事实、自动备份 |
| 质量审查 | `/webnovel-review` | 从爽点、一致性、节奏、OOC、连贯性、追读力等维度审查章节 |
| 状态查询 | `/webnovel-query` | 查询角色、伏笔、节奏、实体关系和运行时信息 |
| 项目学习 | `/webnovel-learn` | 把这本书里好用的写法记下来，存进项目长期记忆 |
| 可视化面板 | `/webnovel-dashboard` | 只读浏览项目状态、实体图谱、章节内容和追读力数据 |
| 项目体检 | `/webnovel-doctor` | 阶段感知检查目录、文件、数据库、RAG、依赖和 Dashboard 产物 |
## 系统长什么样
```mermaid
flowchart LR
User[作者 / Claude Code] --> Skills[8 个 Skill 命令]
Skills --> Agents[Context / Reviewer / Data / Deconstruction Agent]
Agents --> Story[.story-system 合同与提交链]
Story --> Commit[accepted CHAPTER_COMMIT]
Commit --> State[.webnovel/state.json]
Commit --> Index[index.db / vectors.db]
Commit --> Summary[summaries / memory_scratchpad]
State --> Dashboard[只读 Dashboard]
Index --> Dashboard
Summary --> Dashboard
```
v6.0.0 的默认主链叫 **Story System**，几个关键角色：
- `.story-system/`：唯一的事实源头，动笔前的“合同”和写完后的“提交”都存在这里
- accepted 的 `CHAPTER_COMMIT`：一章写完，新事实从这里入账
- `.webnovel/state.json`、`index.db`、`summaries/`、`memory_scratchpad.json`：都是从主链派生出来的只读视图，供查询和展示用
- `.webnovel/projection_log.jsonl`：投影执行日志，用来定位 state/index/summary/memory/vector 哪一路没同步
- `project-status`、`doctor`、`preflight` 和 Dashboard 会把主链与运行状态直接摆出来，哪里不对一眼就能看到
## 快速开始
### 1. 安装插件
通过 Claude Code Marketplace 安装：
```bash
claude plugin marketplace add lingfengQAQ/webnovel-writer --scope user
claude plugin install webnovel-writer@webnovel-writer-marketplace --scope user
```
只想在当前项目生效时，把 `--scope user` 改成 `--scope project`。
> 插件的安装、启用与日常管理等更多用法，见 Claude Code 官方文档：[插件](https://docs.claude.com/en/docs/claude-code/plugins) · [插件市场](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces)。
### 2. 安装 Python 依赖
```bash
python -m pip install -r https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/requirements.txt
```
### 3. 初始化一本书
在 Claude Code 中输入：
```bash
/webnovel-init
```
初始化完成后会创建书项目目录，包含：
```text
project-root/
├── .story-system/ # 合同、章节提交和事件审计
├── .webnovel/ # 状态、索引、摘要、备份和长期记忆
├── 正文/ # 章节正文
├── 大纲/ # 总纲、卷纲、时间线和章纲
├── 设定集/ # 世界观、角色、力量体系等设定
└── 审查报告/ # 章节审查报告
```
### 4. 配置 RAG
进入书项目根目录，把 `.env.example` 复制为 `.env` 并填写 API Key：
```bash
cp .env.example .env
```
最小配置：
```bash
EMBED_BASE_URL=https://api-inference.modelscopExcerpt of 9,940 characters
Read on GitHub
338
2
Would you bet a product on this? Bounded 0–100 and slow moving.
matched fp:f9a613f9d93470e0, llm:Description: '基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级 连载创作.' (built on Claude Code to assist long-form web novel writing, addressing forgetting and hallucination).
matched fp:f9a613f9d93470e0, llm:Description: '基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级 连载创作.' (built on Claude Code to assist long-form web novel writing, addressing forgetting and hallucination).
matched fp:f9a613f9d93470e0, llm:Description: '基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级 连载创作.' (built on Claude Code to assist long-form web novel writing, addressing forgetting and hallucination).