Canon file-first: disk thắng chat
Canon file-first: nguyên tắc disk beats chat — nền tảng sáng tác tiểu thuyết AI bền vững trên NovelKit/Hermes.
Canon file-first nghĩa là mọi quyết định sự thật (nhân vật, timeline, world rule, cultivation state) lưu trên disk trong novel workspace — không nằm trong “trí nhớ” chat của model. NovelKit khẳng định: disk beats chat, canon beats index (RUNBOOK P5).
Vì sao file-first cho truyện dài?
Chat thread không audit được, không diff được, không resume an toàn. File có owner (agent contract), provenance sau sync, doctor kiểm coherence. Publisher thẩm định được trước khi mua catalog.
Những file canon chính
- PROJECT_DNA.md
- database/characters, worldbuilding, plot_threads, timeline
- outlines/, chapters/, reviews/
- memory/Memory.md (sau sync duyệt)
Story bible: Story bible AI.
RAG và vector không lật canon
Plugin novelkit-context retrieve để inject context — nhưng khi conflict, file thắng. Memory layer: 5 lớp. Hệ thống: Sáng tác tiểu thuyết AI.
Conflict resolution: ai thắng khi mâu thuẫn
Thứ tự authority: (1) PROJECT_DNA + database canon của truyện, (2) genre consistency rules, (3) retrieved memory/index, (4) model suggestion. Agent báo CANON_CONFLICT thay vì tự chọn bừa. Human owner resolve và ghi vào file.
Versioning và diff
Chapter và review files có provenance sau sync. Publisher audit diff giữa các bản review — minh bạch sửa chữa trước publish.
Trích dẫn RUNBOOK
Disk beats chat, canon beats index. File canon là nguồn sự thật; retrieval/index/memory là trạng thái phái sinh, không bao giờ lật canon (P5). Đây là nguyên tắc nền mọi bài blog kỹ thuật NovelKit.
Canon file-first: disk beats chat, canon beats index
Nguyên tắc canon file-first (P5 NovelKit) đặt file trên disk là nguồn sự thật tuyệt đối — không phải chat history, không phải RAG snippet, không phải vector similarity cao nhưng sai canon. RUNBOOK: Disk beats chat, canon beats index. Retrieval/index/memory là trạng thái phái sinh; agent báo CANON_CONFLICT thay vì tự merge mâu thuẫn.
Workspace novel chứa PROJECT_DNA, database/* (character, world, timeline, plot_threads), outlines/, chapters/, reviews/, memory/Memory.md. Mọi mutate canon đi qua sync commit sau PASS ≥85 — write stage alone không đủ.
Thứ tự authority khi mâu thuẫn
- PROJECT_DNA + database canon của truyện
- Genre consistency rules (Meta Genre, Xianxia, romance…)
- Retrieved memory/index (layers B–E novelkit_memory + novelkit-context)
- Model suggestion — thấp nhất, không override 1–3
Conflict resolution workflow
Agent phát hiện conflict → flag trong review → HARD-FAIL hoặc blocked task → human owner sửa file canon → doctor → resume pipeline. Không “chọn bản model thích hơn” im lặng.
Versioning, provenance và Publisher audit
Chapter và review files có provenance sau sync: ai viết, ai review, score, commit id. Publisher diff review giữa các vòng SOFT-FAIL — minh bạch sửa chữa trước publish sàn. Plugin novelkit-context reindex sau sync — index luôn derivative của canon mới nhất.
Workspace layout và file owner
Canon file-first workspace: PROJECT_DNA.md, database/characters, database/world, database/plot_threads, master timeline, Cultivation Clock (tiên hiệp), outlines/master, chapters/draft, reviews/chapter_*, memory/Memory.md. Mỗi loại state có file owner — agent mutate đúng path sau sync, không ghi đè im lặng. RUNBOOK: Disk beats chat, canon beats index.
Conflict resolution cho studio
Agent phát hiện conflict → flag review HARD-FAIL hoặc CANON_CONFLICT → human owner sửa file canon → doctor health-check → resume pipeline plan_next. Không chọn “bản model thích hơn” — mất provenance, ô nhiễm memory 5 lớp. Thứ tự authority: (1) DNA + database, (2) genre rules, (3) retrieved B–E, (4) model suggestion thấp nhất.
| Thư mục canon | Owner agent | Mutate khi |
|---|---|---|
| PROJECT_DNA.md | novelkit_dna / human | Bootstrap, amend có review |
| database/* | Architect / Weaver | Sync sau PASS ≥85 |
| chapters/ | Prose Writer | Write stage; sync commit final |
| reviews/ | Quality Auditor | novelkit_gate mỗi chương |
Lãng Khách dispatch qua delegate_tool hub-and-spoke — mỗi mutate có audit trail. Publisher B2B pilot: yêu cầu diff canon giữa chương versions + review scores — không mua black box generation.
Đọc thêm: story bible, Project DNA, memory layer, pipeline, quality gate.
FAQ canon file-first
- Chat history có thể làm canon?
- Không — RUNBOOK: disk beats chat; PROJECT_DNA + database/* là authority.
- Vector similarity cao nhưng sai?
- Canon beats index (P5) — agent CANON_CONFLICT, không chọn snippet.
- Write stage đã mutate memory?
- Không — chỉ novelkit_sync commit sau PASS ≥85 mới upsert layers B–E.
Publisher diff review giữa vòng SOFT-FAIL — minh bạch sửa chữa trước publish sàn. Lãng Khách enforce file owner; human sửa canon → doctor → resume pipeline plan_next.
Canon file-first là nền tảng NovelKit: PROJECT_DNA, database, outlines, chapters, reviews, memory — disk beats chat, canon beats index (P5). Sync gate PASS ≥85 trước mutate memory.
Canon file-first bảo vệ Publisher khỏi RAG snippet sai và chat history làm nguồn sự thật.
Conflict resolution: human sửa file canon → doctor → resume — không merge im lặng theo model suggestion.
novelkit_sync commit là điểm duy nhất mutate canon và memory layers B–E.
Provenance và diff sau mỗi sync
File-first không chỉ “lưu ra đĩa” — mỗi chương sync kèm provenance: agent viết, agent review, score, timestamp. Publisher diff chapter N vs N-1 để audit thay đổi canon. Khi doctor báo canon_index_incoherent, pipeline pause cho đến khi reconcile — không generate tiếp trên nền lỗi.
So sánh với Lorebook / custom instructions
Lorebook chat giới hạn entry và không có DAG. Canon NovelKit có owner agent, dependency graph, và gate: outline phải trỏ tới character ID đã tồn tại trong database. Thiếu file → task blocked, không “bịa tiếp”.
Checklist Publisher thẩm định canon
- PROJECT_DNA đủ genre, tone, hook
- database/characters có want/need/lie
- plot_threads có status open/resolved
- timeline khớp chương đã publish
- reviews/ có score ≥85 cho chương production
Cluster: story bible, Project DNA, memory, pipeline.
P5 trong RUNBOOK: canon beats index
RAG chunk stale không được override character file. Vector search trả về đoạn cũ — agent phải reconcile với database/characters trước khi write. Doctor flag rag_index_stale và canon_index_incoherent là blocking.
Git-friendly workflow (studio)
Workspace novel có thể version control — diff chapter, blame review. Publisher technical team audit như code review. Không có equivalent trong chat thread.