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

This commit is contained in:
2026-08-23 11:26:21 +08:00
parent 4b3ea03dc2
commit b11bea1962
4 changed files with 194 additions and 15 deletions
+29 -10
View File
@@ -1,11 +1,16 @@
# 智慧农业大数据可视化控制中心 项目需求文档
> 文档版本:2.02026-08-23 重写
> 文档版本:3.02026-08-23 更新
> 对应实现版本:v0.1.0Electron 重写版)
>
> 更新说明:本版根据项目当前实现阶段全面重写。原文档基于旧 WinForm 版(v1.0)撰写,
> 技术架构、界面结构、功能划分均已按 Electron + React 重写版实际状态更新;
> 更新说明:
> - v2.02026-08-23):根据项目当前实现阶段全面重写。原文档基于旧 WinForm 版(v1.0)撰写,
> 技术架构、界面结构、功能划分均已按 Electron + React 重写版实际状态更新。
> - v3.02026-08-23):补充绿色版打包、应用图标、打包瘦身等已完成事项(见 §5);
> 更新待办与后续规划(§7);需求来源对照补充最新阶段(§8)。
>
> 已实现需求标注 ✅,规划中需求标注 ⏳。
> 项目完整开发进度与快速启动指南见根目录 `开发进度存档` 文档。
---
@@ -230,8 +235,18 @@
- 主进程通过 `app.getVersion()` 读取
- 标题栏、任务栏/Alt+Tab 标题均显示版本号
- 升级时仅需修改 `package.json` 一处
2. **绿色版打包**`npm run dist` 生成免安装 zip 压缩包(x64,解压即用),输出到 `release/`
2. **绿色版打包**`npm run dist` 生成免安装 zip 压缩包(x64,解压即用),输出到 `release/`
- 配置:`SmartAgriCenter/electron-builder.yml`electron-builder@26.15.3
- 产物:`release\智慧农业大数据可视化控制中心-0.1.0-win.zip`(当前约 **128.9MB**+ `release\win-unpacked\`(绿色目录)
- 应用图标 ✅:`build/icon.ico`(≥256x256 多帧,任务栏/快捷方式/exe 均使用)
- **打包瘦身** ✅:`compression: maximum`7z 极限压缩)+ `afterPack` 脚本 `scripts/afterPack.js` 裁剪语言包(locales 55 → 3zh-CN/zh-TW/zh-HK/en-US
- 体积对比:zip 139.7MB → 128.9MBwin-unpacked 364.9MB → 319.8MB
- `LICENSES.chromium.html`(约 19MB)为开源许可证合规文件,**必须保留**`dxcompiler.dll`WebGPU 着色器编译器,约 24MB)默认保留,删除可再省约 22MB`scripts/afterPack.js` 有开关)
3. **运行时信息**:可通过主窗口「关于」查看 Electron / Chromium / Node 版本
4. **打包注意事项**(见 `开发进度存档`):
- 打包前需先删除旧 `release/` 目录(用 .NET API `[System.IO.Directory]::Delete`,规避 CodeBuddy 注入的删除守卫报错)
- 打包前设 `$env:ELECTRON_BUILDER_BINARIES_MIRROR="https://npmmirror.com/mirrors/electron-builder-binaries/"`(网络受限时)
- `npm run pack` = 只出 win-unpacked 目录;`npm run dist` = 打 zip 包
---
@@ -247,12 +262,15 @@
## 7. 待办与后续规划 ⏳
| 待办 | 说明 |
|---|---|
| 项目导入 / 导出 | 编辑 Tab 项目操作补齐 |
| 代码视图 / 页面视图切换 | 编辑页面双视图 |
| 遥控器硬件对接 | 对接实体遥控器硬件操作大屏(当前为键盘模拟方案) |
| 帮助文档入口 | 「关于」中提供外部帮助文档链接 |
| 待办 | 说明 | 状态 |
|---|---|---|
| 绿色版打包与分发 | electron-builder 打包、应用图标、打包瘦身 | ✅ 已完成(见 §5) |
| 页面预览图截图流程实测 | `page:snapshot` 依赖页面 URL 可加载,需用真实可访问 URL 实测截图 | ⏳ 候选 |
| 遥控器模拟界面视觉美化 | 配置页「遥控设置」的遥控器模拟器视觉优化 | ⏳ 候选 |
| 项目导入 / 导出 | 编辑 Tab 项目操作补齐 | ⏳ 候选 |
| 代码视图 / 页面视图切换 | 编辑页面双视图 | ⏳ 候选 |
| 遥控器硬件对接 | 对接实体遥控器硬件操作大屏(当前为键盘模拟方案) | ⏳ 候选 |
| 帮助文档入口 | 「关于」中提供外部帮助文档链接 | ⏳ 候选 |
---
@@ -262,3 +280,4 @@
|---|---|
| 原 WinForm 版需求(v1.0 文档) | 已在 Electron 重写版中落地,本文档为当前实现版 |
| 界面/功能调整清单(指令清单) | 发布按钮组 6 按钮、配置页 6 菜单、遥控阈值、快捷方式×3、发布默认值、设备测试、关于、记住最后文件夹、轮播选项、页面重排 —— **已全部实现** ✅ |
| 打包分发阶段(v3.0 起) | 绿色版打包、应用图标、压缩与语言包瘦身 —— **已完成** ✅;分发体积已从 139.7MB 降至 128.9MB |