38 lines
3.4 KiB
Markdown
38 lines
3.4 KiB
Markdown
# 工程清理记录（2026-10-29）
|
||
|
||
## 当前保留结构
|
||
|
||
- `backend/`、`web-admin/`、`miniprogram/`：运行源码、构建工具与实际回归测试保留，运行代码内容未改。
|
||
- `docs/`：现行工程/UI 规范、业务要求、部署说明、SQL 与仍有依赖的迁移输入，见 [索引](../README.md)。
|
||
- `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 文档格式通过。未执行全量构建、真实数据库操作、提交或推送。
|