docs: 项目需求升级 v3.0 + 新增开发进度存档（跨会话恢复入口）

2026-08-23 11:26:21 +08:00
parent 4b3ea03dc2
commit b11bea1962
4 changed files with 194 additions and 15 deletions
@@ -194,3 +194,10 @@
 - **⚠️ 打包环境大坑（重要）**：CodeBuddy CN 注入的 `node-safe-delete-shim` 把 Node 的 `fs.rm`/PowerShell `Remove-Item` 劫持为"回收站批量删除守卫"，删除大量文件时报错（中文用户名 `范先生` 路径乱码致守卫脚本 MODULE_NOT_FOUND）。**electron-builder 解压前必须删旧 win-unpacked → 必触发 → 打包失败**。而且失败后 `npm run dist` 的 node/electron-builder 进程**会挂死不退出、占用 release 文件**。
  - **解法**：① 打包前用 `[System.IO.Directory]::Delete(...,$true)` 删掉整个 `release` 目录（.NET API 绕过钩子）；② 若报"文件被占用"，先 `Get-CimInstance Win32_Process | Where CommandLine -like '*SmartAgriCenter*'` 找到挂死的 npm/electron-builder 进程 `Stop-Process -Force`；③ 再删 release 重跑 `npm run dist`。
  - 首次打包成功是因为 release 当时不存在；此后只要 release 存在就会触发删除陷阱。**记住：每次打包前先 .NET 删 release**。
+
+## 2026-08-23 文档三件套 + 开发进度存档（跨会话恢复入口）
+
+- 「项目需求」升级 **v3.0**：§5 补充绿色版打包✅/图标✅/瘦身方案（zip 139.7→128.9MB）；§7 待办更新（打包分发标✅，新增截图实测/遥控美化候选）；§8 补打包阶段对照。
+- **新增根目录 `开发进度存档`（无扩展名）**：作为跨会话上下文恢复入口，含目录结构/快速启动/打包手册（含所有坑）/代码结构地图/功能清单/待办/Git 信息/踩坑实录表。
+- MEMORY.md 更新：顶部加「换环境先读 `开发进度存档`」指引；文档三件套说明；打包章节更新（128.9MB、build/icon.ico、SafeDelete 坑）。
+- 目的：用户重装 CodeBuddy/换文件夹路径后，新会话读 `开发进度存档` 即可省积分快速恢复上下文。