ns-canon
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseNS Canon
NS Canon
只维护事实源和进度,不新写正文,不创造未要求的新设定。
读取 memory-schema.md 获取完整结构。
Only maintains fact sources and progress; does not write new text or create unrequested new settings.
Read memory-schema.md for the complete structure.
职责
Responsibilities
- :项目身份。
project.yaml - :全书规模、卷、章节、番外、下一步。
plan.yaml - :人物、世界、关系、伏笔、类型模块。
memory.yaml - :当前状态、事件、未收束线、修订影响。
continuity.yaml - :正文条目路径、状态、字数、排序。
index.yaml - :文风和章节契约。
style.yaml - :来源和事实边界。
research.yaml - :正文根目录和发布规则。
publish.yaml - :完稿状态和输出索引。
finish.yaml - :视觉一致性和文件索引。
art.yaml
- : Project identity.
project.yaml - : Overall book scale, volumes, chapters, side stories, next steps.
plan.yaml - : Characters, world, relationships, foreshadowing, genre modules.
memory.yaml - : Current status, events, unresolved plot threads, revision impacts.
continuity.yaml - : Text entry paths, status, word count, sorting.
index.yaml - : Writing style and chapter contracts.
style.yaml - : Sources and fact boundaries.
research.yaml - : Root directory of text and publishing rules.
publish.yaml - : Completion status and output index.
finish.yaml - : Visual consistency and file indexes.
art.yaml
YAML/Markdown 协作
YAML/Markdown Collaboration
- 章节和卷的 Markdown frontmatter 是 YAML 记忆与正文文件的连接层。
- frontmatter 只放身份、排序、状态、时间、字数和标签;长说明写 Markdown 正文区或 。
notes/*.md - 必须能从章节 frontmatter 和审计字数重建。
index.yaml.entries - 卷 维护卷简介、卷承诺和章节目录;
_index.md维护计划,不互相复制长文本。plan.yaml - 章节 是可选 Markdown;没有章末笔记时,直接从正文和上下文更新 canon。
## 章末笔记 - 总卷数、总章数、番外数和总字数目标只写在 。
plan.yaml.scale
- The Markdown frontmatter of chapters and volumes serves as the connection layer between YAML memory and text files.
- Frontmatter only includes identity, sorting, status, time, word count, and tags; long descriptions should be written in the Markdown text section or .
notes/*.md - must be reconstructible from chapter frontmatter and audited word counts.
index.yaml.entries - Volume maintains volume introductions, volume commitments, and chapter directories;
_index.mdmaintains plans, and long texts should not be duplicated between them.plan.yaml - The optional section in chapters is Markdown; if there are no end-of-chapter notes, update the canon directly from the text and context.
## End-of-Chapter Notes - The total number of volumes, total chapters, number of side stories, and total word count target are only written in .
plan.yaml.scale
规则
Rules
- 新事实只写一个主 YAML 字段,避免重复记录。
- 不确定内容写入 或
continuity.yaml.loose_threads。research.yaml.open_questions - 写完章节后,优先读可选的 ,再更新
## 章末笔记、index.yaml、continuity.yaml。memory.yaml - 只有分卷完成、全书完稿或交付物变化时更新 。
finish.yaml - YAML 是事实源;Markdown 是长文说明或展示面板。
- 调整规模时先改 和
plan.yaml.scale,再同步卷plan.yaml.volumes/extras的目录说明。_index.md
- New facts should only be written in one primary YAML field to avoid duplicate records.
- Uncertain content should be written to or
continuity.yaml.loose_threads.research.yaml.open_questions - After finishing a chapter, prioritize reading the optional before updating
## End-of-Chapter Notes,index.yaml, andcontinuity.yaml.memory.yaml - Update only when a volume is completed, the entire book is finished, or deliverables change.
finish.yaml - YAML is the source of facts; Markdown is for long-form explanations or display panels.
- When adjusting the scale, first modify and
plan.yaml.scale, then synchronize the directory description in the volumeplan.yaml.volumes/extras._index.md
工具
Tools
- 结构体检:。
python skills/ns-canon/scripts/schema_doctor.py <novel-root> - 连续性检查:。
python skills/ns-canon/scripts/continuity_check.py <novel-root> - 需要机器读结果时加 ;需要把未收束线索作为失败条件时,连续性检查加
--json。--strict
- Structure check: .
python skills/ns-canon/scripts/schema_doctor.py <novel-root> - Continuity check: .
python skills/ns-canon/scripts/continuity_check.py <novel-root> - Add when machine-readable results are needed; add
--jsonto continuity checks if unresolved plot threads should be treated as failure conditions.--strict