lingfengQAQ/webnovel-writer

What it solves

It addresses the difficulty of maintaining consistency in long-form web novel writing. Specifically, it prevents common AI issues where characters' motivations drift, power levels or timelines conflict, and plot foreshadowing is forgotten or left unresolved over hundreds of chapters.

How it works

The project operates as a plugin for Claude Code, implementing a "Story System" that treats writing as a structured pipeline rather than a single generation. It uses a combination of agents (Context, Reviewer, Data, and Deconstruction) to manage a chain of "contracts" and "commits."

When writing a chapter, the system follows a strict workflow: it pre-checks project health, generates a task brief, drafts the text, performs a multi-dimensional quality review, extracts facts from the finished chapter, and then "commits" those facts to a permanent state. These facts are then projected into a searchable RAG (Retrieval-Augmented Generation) index, summaries, and a long-term memory scratchpad to ensure the AI remembers everything for future chapters.

Who it’s for

Web novel authors who use AI to assist in long-term serialized storytelling and need a system to ensure plot and character consistency across a massive volume of text.

Highlights

• End-to-End Workflow: Integrated commands for initialization, volume planning, chapter writing, and quality review.
• Consistency Engine: A commit-based system that records facts and updates a global state to prevent contradictions.
• RAG Integration: Supports Embedding and Rerank APIs (compatible with OpenAI format) to retrieve relevant settings and plot points.
• Visual Dashboard: A read-only panel to browse project status, entity relationship graphs, and reader-retention data.
• Genre Templates: Includes 37 built-in Chinese web novel genre templates (e.g., Xianxia, Urban, Romance, Cthulhu).
• Quality Guardrails: A reviewer agent that blocks chapters with "blocking issues" related to pacing, OOC (out-of-character) behavior, or consistency.