Context weaver

Context Weaver — 上下文编织器

Iron Law

• 写前必须编织上下文：每章写作前必须执行 /mindmap-read，不可跳过
• 写后必须更新思维导图：每章完成后必须依次执行 update → scan → diff → check
• 思维导图是唯一事实来源：所有角色状态、伏笔、规则以 .mindmap/ 为准

命令入口

命令	说明	触发时机
/mindmap-init	初始化思维导图数据层	开书时（一次）
/mindmap-read	读思维导图，编织写前上下文摘要	写前（自动）
/mindmap-update	扫描章节，更新思维导图	写后（自动）
/foreshadow-scan	扫描章节中的伏笔（新埋/回收/过期）	写后（自动）
/snapshot-save	保存角色状态快照	写后（自动）
/snapshot-diff	角色状态快照对比，检测异常变化	写后（自动）
/rule-check	检测本章是否违反世界观硬规则	写后（自动）

工作流

开书 → /mindmap-init（一次性）
     ↓
每章循环:
  /mindmap-read → [写作] → /mindmap-update → /foreshadow-scan → /snapshot-save → /snapshot-diff → /rule-check

工具脚本

所有工具位于 tools/ 目录，Python 3 标准库，零外部依赖。

# 初始化思维导图
python tools/mindmap_write.py init --project-root <项目目录>

# 写前编织上下文
python tools/mindmap_read.py weave --project-root <项目目录> --chapter <N> --characters <角色列表>

# 写后更新思维导图
python tools/mindmap_write.py update --project-root <项目目录> --chapter-file <章节文件>

# 伏笔扫描
python tools/foreshadow_scan.py --project-root <项目目录> --chapter-file <章节文件>

# 角色快照
python tools/snapshot_diff.py save --project-root <项目目录> --chapter <N> --characters <角色列表>
python tools/snapshot_diff.py diff --project-root <项目目录> --chapter <N>

# 规则检查
python tools/rule_check.py --project-root <项目目录> --chapter-file <章节文件>

思维导图结构 (.mindmap/)

.mindmap/
├── index.json              # 总索引（标题、题材、章节数）
├── timeline.json           # 时间线（每章：标题、地点、摘要）
├── characters/
│   ├── index.json          # 角色列表
│   └── <角色名>.json       # 角色详情（状态、关系、DNA、成长弧）
├── events.json             # 关键事件（含伏笔状态）
└── world-rules.json        # 世界观硬规则

状态文件 (.context-weaver/)

.context-weaver/
├── weaver-state.json         # 编织器状态
├── foreshadows/
│   ├── active/               # 进行中的伏笔
│   ├── resolved/             # 已回收的伏笔
│   └── abandoned/            # 废弃的伏笔
├── chapter-summaries/        # 章节摘要
└── character-snapshots/      # 角色快照