# QtDesktopPet 文档索引

本文档用于区分当前有效文档和历史归档文档，避免后续开发继续引用过时路线。

## 当前有效文档

| 文档 | 用途 |
| --- | --- |
| `QtDesktopPet_后续功能规划与结构审查.md` | 当前功能状态、下一阶段路线和结构边界 |
| `QtDesktopPet_测试清单与验收标准.md` | 功能测试清单、回归验收标准和静态推演记录 |
| `performance_stability_check.md` | 性能采样、稳定性检查和发布验证入口 |
| `test-records/` | 每次回归、性能和候选发布的长期测试记录 |

## 归档文档

历史文档统一放在 `docs/archive/`。这些文档保留为开发上下文，不再作为当前施工依据。

| 文档 | 归档原因 |
| --- | --- |
| `archive/implementation_plan.md` | 早期分阶段实施计划，当前大部分阶段已完成或被后续模块替代 |
| `archive/Qt_DesktopPet_开发文档.md` | 初版开发总纲，当前产品能力已超出第一版范围 |
| `archive/QtDesktopPet_后续功能规划与结构审查_旧版.md` | 旧后续规划过长，包含大量已完成阶段和旧文件操作路线 |
| `archive/DesktopPet 本地工作区 Agent 开发文档_草案.md` | 已终止的本地工作区 Agent 初稿 |
| `archive/DesktopPet_本地工作区Agent_施工计划_已终止.md` | 工作区 Agent 路线已从当前产品移除 |
| `archive/QtDesktopPet_本地工作区Agent_独立窗口化施工文档_已终止.md` | 独立 Agent 窗口路线已从当前产品移除 |

## 维护规则

- 新功能进入开发前，先更新当前路线文档和对应测试清单。
- 功能完成后，同步更新 README、测试清单和性能检查项。
- 历史文档不再直接修改，除非补充归档说明。
- GitHub 公开导出不包含 `docs/`；开发仓库保留完整文档。
- 内部自动化测试位于 `internal/qa/`，只进入开发仓库，不进入 GitHub 公开导出和发布包。
- 在构建卡住问题解决前，文档中的验证步骤仍以用户手动构建为准，不由 Codex 调用 CMake 或构建命令。