QCode 文档

根目录的 README.zh-CN.md 用于快速了解产品。本目录记录当前有效的架构、实现方案和路线；日期化的维护决策放在 .agents/notes/implemented/ 中，用于解释为什么这样设计，不替代当前文档。

从这里开始

文档	内容
总体架构	跨领域通用契约：职责、生命周期、持久化、接口、事件与隔离
官方桌面接入施工	固定官方版本、资源与协议兼容核验、迁移阶段及验收限制
教程与自由创作架构	教学专项契约：学习聚合、状态转换、验收、检查时序与恢复；继承总架构
首次 Vibe Coding 教程施工	首课流程、阿澜文件夹引导、需求续接、施工阶段与验收
角色定义	Coder、File Keeper、Teacher 和 Coordinator
网页定制	DSH Web profile 的定制方式
世界网页方案	Godot 世界与 Harness Web 的组合方案
岛屿接入契约	新增岛屿必须遵守的宿主边界、对象映射、桥接协议与验收条件
岛屿与插件开发指南	新增岛屿、Host / Client 插件的开发路径与最小交付物
文档维护指南	文档分类、状态标记、证据位置与更新规则
QCode 重命名施工	产品、内部标识、兼容迁移、仓库与发布入口的分阶段重命名方案
网页优先 MVP	当前最小业务闭环
施工记录	工作闭环的实际交付、验证与后续施工顺序
居民工作闭环	项目恢复、居民任务入口与存储边界
居民工作闭环契约	居民任务生命周期、入口、结果与状态约束
项目与 Workspace 契约	项目归属、文件边界、创建与恢复规则
运行恢复契约	刷新、断线、Host 重启和超时恢复行为
居民对话系统	世界交互、统一居民面板与输入焦点规则

已采用但尚未实施的长期产品边界，也会记录在 .agents/notes/implemented/；“已采用”表示方向已经确定，不表示功能已经完成。