QtDesktopPet 文档索引
本文档用于区分当前有效文档和历史归档文档，避免后续开发继续引用过时路线。
当前有效文档
| 文档 | 用途 |
|---|---|
QtDesktopPet_后续功能规划与结构审查.md |
当前功能状态、下一阶段路线和结构边界 |
QtDesktopPet_测试清单与验收标准.md |
功能测试清单、回归验收标准和静态推演记录 |
performance_stability_check.md |
性能采样、稳定性检查和发布验证入口 |
agent/DesktopPet_本地工作区Agent_施工计划.md |
本地工作区 Agent 的正式施工计划 |
归档文档
历史文档统一放在 docs/archive/。这些文档保留为开发上下文，不再作为当前施工依据。
| 文档 | 归档原因 |
|---|---|
archive/implementation_plan.md |
早期分阶段实施计划，当前大部分阶段已完成或被后续模块替代 |
archive/Qt_DesktopPet_开发文档.md |
初版开发总纲，当前产品能力已超出第一版范围 |
archive/QtDesktopPet_后续功能规划与结构审查_旧版.md |
旧后续规划过长，包含大量已完成阶段和旧文件操作路线 |
archive/DesktopPet 本地工作区 Agent 开发文档_草案.md |
本地工作区 Agent 初稿，已整理为正式施工计划 |
维护规则
- 新功能进入开发前，先更新当前路线文档和对应测试清单。
- 功能完成后，同步更新 README、测试清单和性能检查项。
- 历史文档不再直接修改，除非补充归档说明。
- GitHub 公开导出不包含
docs/；开发仓库保留完整文档。 - 在构建卡住问题解决前，文档中的验证步骤仍以用户手动构建为准，不由 Codex 调用 CMake 或构建命令。