Verified project record

lingfengQAQ/webnovel-writer

webnovel-writer is an AI-assisted tool that maintains plot, setting, and character consistency across long-form serialized fiction spanning millions of words. It uses a structured commit and review pipeline to prevent the narrative drift that typically occurs when generating web novels at scale.

Project overview

It directly addresses a structural weakness in AI-generated fiction—context loss over hundreds of chapters—by codifying story rules into an automated commit and validation system, providing a structured approach to sustained automated serialization.

Project type: AI Agent · RAG
Deployment: Refer to project documentation
License: GPL-3.0

Best for

Creators who require an automated, heavily structured pipeline to maintain narrative consistency across extensive serialized fiction.

Key capabilities

Defines contracts and commits for chapters, serving as the single source of truth for facts before writing and after committing.
Prepares context, drafts text, runs multi-dimensional reviews, polishes, extracts facts, and drives state/index/memory projections for a completed chapter.
Automatically synchronizes newly committed facts into queryable state, indices, chapter summaries, long-term memory, and vectors.
Reviews written chapters across consistency, pacing, out-of-character detection, and engagement metrics.
A pre-packaged dashboard to browse project status, entity graphs, chapter contents, and engagement data without running npm build.
Manages vector indices and retrieval status, falling back to BM25 keyword search if embedding API keys are not provided.
Includes 37 built-in Chinese web novel genre templates, with support for combining multiple genres.
Checks directories, files, databases, RAG, dependencies, and dashboard artifacts to provide stage-aware status and repair suggestions.

Limitations and risks

Relies on the Claude Code environment to run skill commands and execute its automated pipeline.
Achieving optimal semantic recall requires external paid API keys for embeddings and reranking.

Getting started

Install the plugin via the Claude Code Marketplace, install Python dependencies, initialize a book via /webnovel-init, and configure RAG by copying .env.example to .env.

Evidence and sources

GitHub project description: 基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级连载创作。
README: 这套系统做的事，就是把上面这些“必须记住、不能写崩”的约束，变成 Claude Code 会自动执行的步骤：动笔前先查资料，写完后把新发生的事实记下来、做一致性审查，再把最新状态同步进检索索引、章节摘要、长期记忆和 Dashboard。它不只是“会写”，而是边写边攒。
README: 一个跑在 Claude Code 上的长篇网文创作插件。从初始化设定、规划卷纲，到写章、审查、沉淀记忆、查询状态，再到一个只读的可视化面板——整条创作流程都给你串好了。
README: | 能力 | 命令 | 说明 | |------|------|------| | 深度初始化 | `/webnovel-init` | 分阶段问答，帮你把书的骨架、设定集、总纲和初始状态搭起来 | | 卷纲规划 | `/webnovel-plan` | 基于总纲拆卷、拆章、补时间线，并写回新增设定 | | 章节创作 | `/webnovel-write`…
README: - `.story-system/`：唯一的事实源头，动笔前的“合同”和写完后的“提交”都存在这里 - accepted 的 `CHAPTER_COMMIT`：一章写完，新事实从这里入账

Reviewed at: 2026-07-16T16:26:21Z