repository-cleanup.md 3.4 KB
工程清理记录（2026-10-29）
当前保留结构
backend/、web-admin/、miniprogram/：运行源码、构建工具与实际回归测试保留，运行代码内容未改。docs/：现行工程/UI 规范、业务要求、部署说明、SQL 与仍有依赖的迁移输入，见 索引。openspec/：正式规范和变更状态保留；删除历史辅助文档不等于验收或归档。resources/reference/certificates/：购买证、运输证参考图片保留。local-data/：生产数据库快照、Redis 快照、本机凭据保留且忽略 Git；加油导入资料已删除。生产环境部署/：发布、备份、代理配置及已有发布包保留；生产凭据的根目录兼容链接仍有效。
已完成清理
第一轮卸载 graphify 的两份全局技能和两套 CLI，移除六处图谱目录、MCP/插件注册及自动更新工具。pnpm 缓存、Python 虚拟环境和会话产物退出版本跟踪，本地环境仍保留。根 AGENTS 从 256 行精简到 94 行，各端规则分层，子数据十条规则原文完整保留。
用户随后明确要求直接删除不用的开发辅助文件，本轮删除：
产品数据刷新/：两个一次性导入脚本、原始输入及临时说明。- 加油汇总表目录、两份表格、161 张附件、旧路径链接，以及独立加油资料导入脚本。
- docs 根目录临时 HTML、docs/demos、resources/examples、Web 根目录独立原型；仅保留现行规范引用的
fresh-mint-green.html。 - docs/superpowers 的旧设计/计划、docs/testing 的截图/日志/调试证据、旧功能迁移指南、业务盘点、旧交接稿与临时导出。
- 数据迁移历史说明、阶段执行日志；保留 mappings 和实际 SQL，因为迁移工具仍有读取依赖。
- 无构建/测试调用的一次性页面批量改写脚本、菜单调试模拟器和旧类型错误输出。
- 两套旧 Agent 计划目录和本轮已结束的临时整理计划；不再为清理过程另建计划档案。
没有删除应用内的 Demo 页面、实际测试、部署工具、数据库迁移或生产快照。保留的历史迁移工具有 CLI 或回归依赖，不因名称带 migrate 就删除。
核验
删除前登记精确清单，核对运行/测试依赖，再删除文件并清理版本索引；没有执行任何导入、发布或数据库操作。现行规范中的旧设计引用已替换为当前章节及真实组件，业务代码注释中的历史文件名不改写。最终核验结果见下方。
- 删除清单覆盖 1,988 份旧文件内容，其中 1 个数据迁移 README 改写为现行输入说明，其余 1,987 个文件/链接已移除；包含 82 份 HTML 演示稿。
- docs 当前保留 88 个文件；正式规范、SQL、迁移映射与运维资料均在。
- 2,769 个受保护的非 Markdown 文件哈希与删除前一致，没有修改业务实现、测试、部署或被依赖的迁移脚本。
- 66 处现行文档相对链接有效；运行代码未引用本轮删除的一次性工具。
- 迁移工具离线回归：
PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 backend/venv/bin/python -m pytest backend/tests/test_migration_clear_modes_disabled.py -q -p no:cacheprovider，30 项通过；该测试使用 AST 抽取和假数据库，不运行迁移入口。 - 暂存差异空白检查通过；工作区差异检查按现有 CRLF 文档格式通过。未执行全量构建、真实数据库操作、提交或推送。