feat:增加文件写入安全约束

2026-05-15 10:09:39 +08:00
parent 26ad1d1a7c
commit 7afa40e39f
3 changed files with 98 additions and 14 deletions
@@ -1,4 +1,4 @@
-<!-- Last updated: 2026-05-14 | Commit: 3e29c5e -->
+<!-- Last updated: 2026-05-15 | Commit: 26ad1d1 -->

 # 项目约束

@@ -31,6 +31,16 @@
 - 新增原型页面时，必须同步在 `index.html` 的 `SITE_MAP` 中添加对应条目
 - PRD 文档生成后需要在导航页对应的一级菜单卡片左下角加上 PRD 文档的跳转逻辑

+## 文件写入安全（严重事故教训 2026-05-15）
+
+> **绝对禁止**：批量操作时覆盖已完成的文件修改。
+
+- 对文件执行写入/编辑前，**必须先读取该文件当前最新内容**，禁止使用内存中缓存的旧版本写入
+- 批量处理多文件时，每个文件独立「读取→修改→写入」，不得跨文件复用旧内容
+- 同一会话中若一个文件被多次修改，后续修改必须基于前次修改后的最新状态
+- **提交前必须执行 `git diff --staged` 审查**，确认所有变更符合预期、无意外回退
+- 若发现 diff 中出现非预期的删除或回退，必须立即中止提交并向用户报告
+
 ## 记忆体系（会话启动必读）

 > **强制规则**：每次新会话启动时，必须先读取本项目的记忆体系索引，再按需加载关键记忆文件，然后才能开始处理用户请求。长会话中若上下文被压缩，同样需要重新加载。