lingfengQAQ/webnovel-writer

What it solves

Webnovel Writer is designed to solve the problem of consistency in long-form web novel writing. It prevents AI from forgetting character motivations, world rules, plot points (foreshadowing), and timelines as a story progresses over hundreds of chapters, ensuring the narrative remains coherent and logically sound.

How it works

The project operates as a plugin for Claude Code, implementing a "Story System" that separates the act of writing from the act of recording facts. It uses a pipeline of specialized agents (Context, Reviewer, and Data agents) to manage the creative process:

1. Planning & Initialization: Sets up the story skeleton, world-building settings, and overall outline.
2. Writing Pipeline: Before writing a chapter, it retrieves necessary context; after writing, it extracts new facts and commits them to a permanent record.
3. Consistency Management: It uses a RAG (Retrieval-Augmented Generation) system with optional embedding and reranking to query character states and plot points.
4. State Projection: Facts are projected into read-only views like a state JSON, summaries, and a long-term memory scratchpad.
5. Visualization: A read-only dashboard allows authors to browse entity relationship graphs and project status.

Who it’s for

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

Highlights

• End-to-End Workflow: Integrated commands for initialization, planning, writing, reviewing, and querying.
• Fact-Based Commits: Uses a CHAPTER_COMMIT system to ensure every new plot point is formally recorded and indexed.
• Multidimensional Review: Reviews chapters based on pacing, consistency, OOC (out-of-character) behavior, and "cool-points" (reader satisfaction).
• RAG Integration: Supports semantic search via OpenAI-compatible embedding and reranking APIs, with a fallback to BM25 keyword search.
• Genre Templates: Includes 37 built-in Chinese web novel genre templates.
• Visual Dashboard: Provides a read-only interface for tracking entity graphs and story progress.