文档库
这里按文档类型组织项目知识：当前状态、设计、技术、AI 工程实验、决策记录和事故复盘。标签只用于检索，不承担栏目职责。
项目状态
当前阶段、路线图和版本记录。
游戏设计
机制、叙事、架构和设计判断。
- 音效系统第一版开发规格 LoopTrain 音效系统第一版开发规格：AudioManager、事件映射层、静音开关、音频 manifest、占位音效和验收标准。
- 文档治理设计 LoopTrain 文档治理的正式设计说明：TBD 保留为讨论稿区，devlog 成为正式长期文档中心，根目录只保留入口职责。
技术实现
运行时、部署、测试和内容模型。
- 项目长期记忆与知识图谱 LoopTrain 当前项目事实、架构边界、文档治理规则、部署保护和后续迁移路线的长期记忆索引，用于后续迭代快速查找。
- 文档治理检查器 记录 scripts/check_docs_governance.py 的职责、检查范围和使用方式。该脚本是 LoopTrain 文档治理的轻量自动化入口。
AI 工程实验
AI Coding、Agent 协作和 Prompt / Runtime 实验。
- LoopTrain 长期规划：游戏只是实验对象 LoopTrain 的长期方向不是单纯做完一个互动叙事游戏，而是把游戏作为实验对象，探索 AI Native Software Engineering：故事演进、事件溯源、Agent Runtime、Prompt Builder、知识图谱、自动测试和可回放协作协议。
- 今天，我第一次在 AI Coding 中感受到"失控"的瞬间 两件小事让我重新思考 AI Coding 最大的风险：不是代码错误，不是幻觉——而是 AI 在没有获得授权的情况下，自行做出决策。Runtime 不只是游戏需要，AI Coding 同样需要。
- 解决项目代码与 Devlog 网站内容脱节 LoopTrain 完成 ST 剥离后，Devlog 网站多个页面的内容仍停留在迁移前的旧状态。本文记录这个典型的信息漂移问题及我们的解决方案：将 Devlog 从手写博客改造为数据驱动的项目仪表盘。
决策记录
重要选择的背景、替代方案和后果。
- 0001: Devlog 作为正式长期文档中心 记录 LoopTrain 文档治理的关键决策：保留 TBD 作为讨论稿区，使用 devlog/src/content 作为正式长期文档中心，根目录只保留入口职责。
事故复盘
部署、AI 协作和项目治理中的真实事故记录。
- 一次 Devlog 文章丢失事故：本地分支落后远端时不要部署 记录一次真实的 Devlog 文章丢失事故：Narrative State Runtime 文章存在于远端分支和旧线上 release，但本地未同步远端更新，后续部署时被 rsync --delete 从当前线上版本中移除。
Legacy
旧 ST / SillyTavern 阶段资料。仅作历史参考，不代表当前事实。
- 早期 Devlog Spec 保留在仓库 devlog/docs/spec.md 中，不作为线上正式事实源。
- 早期内容模型 保留在仓库 devlog/docs/content-model.md 中，已被当前 content.config.ts 和正式 collections 取代。