用途：为编码智能体安装一个持久化的世界模型，用 SQLite 记录代码库中的实体（符号、文件、模块、现实指代物）、它们之间的交互以及应成立的约束，并跟踪每条交互/约束的观察置信度、规范置信度、是否已验证及证据。核心不变量：代码观察不能提升规范置信度，只有测试、CI、文档或人工等 oracle 证据才能将状态翻转为已验证。
主要能力：四个生命周期钩子自动维护模型——PreToolUse 在编辑前检索并注入相关条目；PostToolUse 观察每次工具调用，登记文件、执行、URL 等实体与边；Stop 每回合汇总、重算置信度、评估约束并刷新 digest；SessionStart 首次运行自动引导并注入摘要。支持多语言结构边与依赖清单解析，可检测矛盾并给出可读的修复建议。
使用方式：先检测安装状态（~/.claude/world-model-ledger/wm.py 为全局，./wm.py 为项目）。首次安装选择范围：scripts/install.sh /path/to/project 或 scripts/install.sh --global，可加 --with-constraints、--seed。已安装后可用 scripts/install.sh --seed 或 --prune 重建/修剪模型。需 Python 3.10+（仅标准库），jq 用于合并设置。安装后需重启 Claude Code 以加载钩子。可用 python3 wm.py stats、cat .world-model/digest.md 查看状态，python3 test_world_model.py 运行 116 项安装门禁测试。
适用场景：需要让编码智能体长期记住代码库结构、依赖与约束，并区分“见过”与“已验证”的项目。
限制：钩子只捕获可信通道中可确定性解析的内容，不采信工具输出；WM-VALIDATED/WM-REFUTES 仅接受用户消息；证据只软失效不硬删除；三元组须通过本体校验。与 context-hygiene-kit 同装时需先读互操作文档。其余细节暂未提供。