Viết truyện dài với AI khó nhất không phải tạo ra chương đầu, mà là giữ cho nhân vật, timeline, thế giới, sức mạnh và tình tiết cài cắm (foreshadowing) không “lệch” sau hàng chục hoặc hàng trăm chương. Webnovel Writer là một plugin dành cho Claude Code, được thiết kế để biến quá trình viết truyện dài thành workflow có cấu trúc: khởi tạo thế giới, lập dàn ý, viết chương, review, lưu facts, tạo chỉ mục tìm kiếm và xem dashboard.
Repo chính thức là lingfengQAQ/webnovel-writer. Dự án dùng GPL-3.0, chủ yếu viết bằng Python, tương thích Claude Code. Tại thời điểm kiểm tra 21/07/2026, repo có khoảng 6K stars; đây chỉ là chỉ báo cộng đồng và thay đổi theo thời gian.
Webnovel Writer là gì?
Đây không phải một website nhập prompt rồi xuất ra truyện. Theo README, Webnovel Writer là plugin chạy trên Claude Code, liên kết các bước từ thiết lập sách, quy hoạch volume, viết chapter, review, ghi nhận facts, nhớ lâu dài, tra cứu trạng thái đến dashboard chỉ đọc.
Mục tiêu của dự án là xử lý hai vấn đề quen thuộc khi dùng AI viết dài kỳ: quên ngữ cảnh và hallucination/mâu thuẫn nội bộ. Repo mô tả quy mô hướng tới serial khoảng 2 triệu chữ, nhưng đây nên được hiểu là mục tiêu thiết kế của tác giả, không phải cam kết chất lượng tự động cho mọi tác phẩm hay mọi model.
Điểm cốt lõi: tách “viết hay” và “facts của truyện”
Webnovel Writer dùng Story System làm luồng dữ liệu chính. Trước khi viết, hệ thống chuẩn bị context và runtime contract; sau khi viết, chương được review và facts được đưa vào một CHAPTER_COMMIT đã chấp nhận. Các file trạng thái, index, summary, memory và vector index được cập nhật từ commit này.
Nhờ vậy, việc “AI vừa viết xong lại quên nhân vật đã biết gì” được giảm bớt bằng quy trình lưu dữ kiện. Tuy nhiên, tác giả vẫn phải đọc, duyệt và quyết định các facts quan trọng: AI có workflow tốt hơn không có nghĩa là AI luôn đúng.
Các lệnh chính
| Lệnh | Dùng để làm gì? |
|---|---|
/webnovel-init | Khởi tạo một book project: setting, dàn ý tổng, trạng thái ban đầu. |
/webnovel-plan 1 | Lập kế hoạch volume 1, timeline và chapter outline. |
/webnovel-write 1 | Viết và đưa chapter 1 qua workflow context, review, facts và backup. |
/webnovel-review 1-5 | Review một dải chương theo consistency, pacing, OOC, continuity và các tiêu chí của dự án. |
/webnovel-query | Tra cứu nhân vật, tình tiết cài cắm (foreshadowing), nhịp truyện, quan hệ thực thể và trạng thái. |
/webnovel-learn | Lưu kinh nghiệm/cách viết hiệu quả vào long-term memory của chính project. |
/webnovel-dashboard | Mở dashboard chỉ đọc để xem project, entity, chapters, tình tiết cài cắm (foreshadowing) và dữ liệu pacing. |
/webnovel-doctor | Kiểm tra sức khỏe project, database, RAG, dependency và output dashboard. |
Cài đặt Webnovel Writer
README hiện hướng dẫn cài bằng Claude Code Marketplace. Máy cần có Claude Code và Python 3.10+ theo badge/yêu cầu dự án.
claude plugin marketplace add lingfengQAQ/webnovel-writer --scope user
claude plugin install webnovel-writer@webnovel-writer-marketplace --scope userNếu chỉ muốn plugin hoạt động trong project hiện tại, README hướng dẫn đổi --scope user thành --scope project. Tiếp theo cài dependency Python:
python -m pip install -r https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/requirements.txtChỉ nên cài từ repository chính thức. Claude Code là môi trường chính được dự án công bố; không nên mặc định các lệnh slash này hoạt động nguyên vẹn trên Codex hoặc một agent khác.
Bắt đầu một truyện mới
- Mở Claude Code tại thư mục nơi anh muốn lưu project truyện.
- Gõ
/webnovel-init, trả lời theo từng bước về thể loại, thế giới, nhân vật, tổng cốt truyện và quy tắc. - Kiểm tra lại các tài liệu tạo ra trước khi viết chương: tổng dàn ý, timeline, setting và character rules.
- Dùng
/webnovel-plan 1để có plan cho volume đầu tiên; không nên bỏ qua bước này nếu truyện cần nhất quán dài kỳ. - Viết thử chapter đầu bằng
/webnovel-write 1, sau đó đọc bản thảo và report thay vì đăng ngay. - Chỉ khi cấu trúc và giọng truyện ổn mới mở rộng thành nhiều chương; chạy review định kỳ và sao lưu bằng Git hoặc backup riêng.
Cấu trúc project được tạo ra
project-root/
├── .story-system/ # contracts, chapter commits, event audit
├── .webnovel/ # state, index, summaries, backup, memory
├── 正文/ # nội dung các chương
├── 大纲/ # tổng outline, volume outline, timeline
├── 设定集/ # world, character, power system...
└── 审查报告/ # báo cáo review chươngTên thư mục mặc định trong ví dụ của repo dùng tiếng Trung. Khi dùng cho truyện tiếng Việt, anh nên kiểm tra repo có hỗ trợ đổi naming convention ở mức nào; trước hết hãy giữ cấu trúc project mà plugin tạo để tránh làm script không tìm được file.
RAG: hữu ích nhưng không bắt buộc để khởi động
README hướng dẫn cấu hình embedding và rerank qua file .env ở root project. Những endpoint này có thể thay thế bằng API tương thích OpenAI format. Nếu chưa có Embedding key, dự án nói rằng nó sẽ fallback về BM25 keyword retrieval — vẫn dùng được, nhưng khả năng recall theo ngữ nghĩa yếu hơn.
Không đưa API key vào Git, ảnh screenshot hay file chia sẻ. Với bản thảo chưa công bố, cũng cần đọc điều khoản của model/API anh chọn vì nội dung có thể được gửi đến nhà cung cấp để xử lý.
Ưu điểm
- Không chỉ generate text một lần; có planning, context, review, facts, summary, memory và backup trong một workflow.
- Có dashboard chỉ đọc để quan sát trạng thái project, entity, chapters, tình tiết cài cắm (foreshadowing) và pacing.
- Có command doctor/preflight để phát hiện vấn đề cấu trúc, RAG hoặc dependency.
- Có 37 template thể loại webnovel theo README, đồng thời hỗ trợ phối nhiều thể loại.
- Mã nguồn mở GPL-3.0, có issue/PR và release notes công khai.
Hạn chế và lưu ý trước khi dùng
- Đây là tool thiên về Claude Code, không phải app viết truyện GUI đơn giản cho mọi người mới.
- Setup có Python, plugin, project files và tùy chọn RAG/API; cần chịu khó làm quen terminal.
- Chất lượng văn phong vẫn phụ thuộc model, prompt, outline và năng lực biên tập của tác giả.
- Review tự động chỉ là lớp hỗ trợ; tác giả cần kiểm duyệt continuity, đạo đức, bản quyền và chất lượng cuối cùng.
- Không nên dùng bản thảo production duy nhất để thử lần đầu. Hãy tạo project thử và backup trước mọi thao tác ghi hàng loạt.
- Release mới nhất v6.2.1 (07/07/2026) xử lý lỗi Windows WinError 5 khi file state bị VSCode, antivirus hoặc sync tool chiếm dụng; release note cũng khuyên hạn chế đặt project trong thư mục sync như OneDrive.
Có nên dùng?
Nên thử nếu anh đang viết truyện dài theo serial, đã dùng Claude Code và quan tâm tính nhất quán qua nhiều chương. Điểm mạnh thật sự của Webnovel Writer nằm ở “hệ thống quản lý ký ức và facts”, không phải lời hứa AI tự viết thay tác giả. Người viết vẫn là người quyết định giọng, cảm xúc, hướng cốt truyện và bản thảo cuối.
Nguồn chính thức
Thông tin kiểm tra ngày 21/07/2026 từ repository chính thức, README, release v6.2.1 và GPL-3.0 license.
