TL;DR

InkOS là open-source AI agent viết tiểu thuyết tự động, ra mắt ngày 12/03/2026 bởi developer Narcooo. Chỉ trong 3 ngày đã đạt 697 stars, hiện đang ở mức 6.100+ stars và 1.100+ forks trên GitHub. Điểm khác biệt cốt lõi: thay vì single-pass generation, InkOS dùng pipeline 10 agent chuyên biệt cùng 7 "truth files" làm source of truth - giải quyết tận gốc vấn đề "hallucination drift" khiến AI thường viết sai continuity trong truyện dài.

Phần mềm miễn phí (AGPL-3.0), chi phí vận hành chỉ là tiền LLM API của bạn.

Vấn đề mà AI writing tool thông thường chưa giải quyết được

Thử viết tiểu thuyết dài với ChatGPT hay Claude trực tiếp, bạn sẽ gặp ngay vấn đề kinh điển: chương 15, nhân vật rút ra thanh kiếm đã bị mất từ chương 8. Chương 20, kẻ phản diện biết thông tin mà chưa ai nói với hắn. Chương 30, văn phong bắt đầu ngập từ "delve", "tapestry", "intricate" - những cụm từ đặc trưng của LLM khiến text đọc như robot viết.

Đây là "hallucination drift" - LLM không có memory về những gì đã xảy ra, sinh text mà không reference lịch sử câu chuyện. Hầu hết AI writing tool hiện tại giải quyết bằng cách nhét toàn bộ context vào prompt, nhưng khi truyện dài vài trăm chương, cách này nhanh chóng bị giới hạn bởi context window và chi phí API.

InkOS giải quyết theo hướng hoàn toàn khác.

Kiến trúc pipeline 10 agent

InkOS Agent Pipeline - 10 agents từ Radar đến Reviser
InkOS Agent Pipeline - mỗi chương đi qua 10 agent chuyên biệt tự động

Mỗi chương được xử lý bởi chuỗi 10 agent làm việc tuần tự:

  • Radar - quét trend nền tảng và preference đọc giả để định hướng câu chuyện
  • Planner - đọc author intent + current focus, sinh chapter intent (must-keep / must-avoid)
  • Composer - chọn lọc context từ truth files theo độ liên quan, compile rule stack
  • Architect - lên cấu trúc chương: outline, scene beats, pacing targets
  • Writer - viết văn xuôi dựa trên context đã compile, có length governance
  • Observer - extract 9 loại fact từ văn bản (nhân vật, địa điểm, tài nguyên, quan hệ, cảm xúc, thông tin, hooks, thời gian, trạng thái vật lý)
  • Reflector - output JSON delta, code layer apply Zod schema validation rồi immutable write
  • Normalizer - single-pass nén/mở rộng để chapter đạt target word count
  • Continuity Auditor - kiểm tra draft theo 33 chiều đối chiếu 7 truth files
  • Reviser - fix lỗi audit tìm thấy; critical issues tự động sửa, còn lại flag cho người review

Nếu audit fail, pipeline tự động vào vòng lặp revise → re-audit cho đến khi tất cả critical issues được giải quyết - trước khi bất kỳ human nào nhìn vào.

7 truth files - nguồn sự thật duy nhất

InkOS truth files directory structure
Cấu trúc truth files và snapshot trong một project InkOS

Thay vì dump toàn bộ lịch sử vào prompt, InkOS duy trì 7 file làm single source of truth cho mỗi cuốn sách:

  • current_state.md - vị trí nhân vật, mạng lưới quan hệ, thông tin đã biết, emotional arcs
  • particle_ledger.md - tài khoản tài nguyên: vật phẩm, tiền, vật tư cùng số lượng và decay tracking
  • pending_hooks.md - các plot thread chưa đóng: foreshadowing, lời hứa với đọc giả, conflict chưa giải quyết
  • chapter_summaries.md - tóm tắt từng chương: nhân vật, sự kiện chính, thay đổi state
  • subplot_board.md - tiến độ subplot A/B/C
  • emotional_arcs.md - theo dõi cảm xúc và tăng trưởng của từng nhân vật
  • character_matrix.md - ma trận tương tác nhân vật, ranh giới thông tin

Từ v0.6.0, truth files chuyển từ Markdown sang story/state/*.json với Zod schema validation. Mọi update là immutable JSON delta - dữ liệu xấu bị reject ngay, không lan rộng. Markdown files vẫn giữ lại làm human-readable projection.

Trên Node.js 22+, SQLite temporal memory database (story/memory.db) được kích hoạt tự động - hỗ trợ relevance-based retrieval thay vì full-context injection, tránh context bloat sau 20+ chương.

Con số thực chiến

InkOS đã được test bằng cách viết một cuốn tiểu thuyết huyễn huyễn hoàn chỉnh tự động:

  • 31 chương hoàn chỉnh
  • 452.191 từ tổng cộng (~14.500 từ/chương)
  • 100% audit pass rate
  • 48 resource items được theo dõi
  • 20 active plot hooks, 10 hooks đã resolved

Về genre support: 10 genre profile tiếng Anh (LitRPG, Progression Fantasy, Isekai, Cultivation, System Apocalypse, Dungeon Core, Romantasy, Sci-Fi, Tower Climber, Cozy Fantasy) và 5 genre tiếng Trung (huyễn huyễn, tiên hiệp, đô thị, kinh dị). Mỗi genre có riêng pacing rules, audit dimensions và fatigue word list - ví dụ LitRPG tự động flag các từ như "delve", "tapestry", "intricate", "pivotal".

Writer agent tích hợp ~25 universal writing rules (character craft, narrative technique, de-AI-ification). Post-write validator có 11 hard rules với auto spot-fix.

Ai nên dùng InkOS

InkOS CLI - quản lý nhiều sách đồng thời
InkOS CLI cho thấy nhiều project sách đang chạy song song

Nhà văn và người sáng tác muốn AI làm co-author thực sự - không phải thay thế, mà là đội ngũ làm việc 24/7. Daemon mode (inkos up) tự viết chương khi bạn ngủ, dừng để human review khi gặp critical issue. Notification qua Telegram, Feishu, WeChat hoặc Webhook.

Fanfic writer: inkos fanfic init --from source.txt --mode canon tạo fanfic từ nguyên tác với 4 mode - canon (tiếp nối chính thống), AU (alternate universe), OOC (tái thiết nhân vật), CP (ship-focused). Canon importer, fanfic-specific audit dimensions và information boundary controls đảm bảo setting không mâu thuẫn.

Developer muốn integrate vào external agent workflow: InkOS được publish làm OpenClaw Skill, callable bởi bất kỳ compatible agent nào (Claude Code, OpenClaw). Atomic commands (plan, compose, draft, audit, revise) hoạt động độc lập, có --json output cho script integration.

Multi-model routing: dùng Claude cho creative writing (mạnh về sáng tạo), GPT-4o-mini cho auditing (rẻ + nhanh), local model qua Ollama cho market radar (zero cost). Từng agent có thể configure riêng, agent chưa configure tự fall back về global model.

Kết - và những gì đang đến

InkOS là minh chứng rõ ràng rằng vấn đề của AI writing không nằm ở model yếu, mà nằm ở kiến trúc. Pipeline 10 agent + 7 truth files + 33-dimension audit - đây là cách tiếp cận đúng hướng cho long-form creative generation.

Roadmap tiếp theo đang phát triển: interactive fiction (branching narrative + reader choices), partial chapter intervention (rewrite nửa chương + cascade cập nhật truth files), custom agent plugin system, và platform format export cho Qidian, Tomato.

Nếu bạn muốn thử: npm i -g @actalk/inkos → inkos init my-novel → inkos (mở Studio 2.0). Mang theo API key của model bạn đang dùng.

via GitHub - Narcooo/inkos | SimpleNews.ai