docs: 椤圭洰闇€姹傚崌绾?v3.0 + 鏂板寮€鍙戣繘搴﹀瓨妗o紙璺ㄤ細璇濇仮澶嶅叆鍙o級
This commit is contained in:
@@ -1,11 +1,12 @@
|
||||
# MEMORY.md — SmartAgriCenter 智慧农业大数据可视化控制中心
|
||||
|
||||
> 维护说明:本文件为跨会话长期记忆,记录项目稳定事实与约定。每日详细变更见 `YYYY-MM-DD.md`。
|
||||
> **⚠️ 换环境/重装/新开会话时,先读根目录 `开发进度存档`**(目录结构+启动打包手册+代码地图+踩坑实录),可省大量探索。
|
||||
|
||||
## 项目定位
|
||||
- Electron + React 19 + TypeScript + Vite 7 + electron-vite@5 + zustand 重写版(替代旧 WinForm 版 SmartAgriDataCenter)。
|
||||
- 角色:软件本身只是**编辑器/调度器/发布器**,大屏业务内容是 HTML 网页,不做图表绘制。
|
||||
- 工作区:`c:/Users/范先生/CodeBuddy/DataViewCenter`,项目在 `SmartAgriCenter/`。原型参考在 `prototype/`(index.html、sample-screen.html)。
|
||||
- 工作区:仓库根目录(当前为 `c:/Users/范先生/CodeBuddy/DataViewCenter`,**路径可迁移**,文档内的绝对路径以克隆后实际位置为准),项目在 `SmartAgriCenter/`。原型参考在 `prototype/`(index.html、sample-screen.html)。
|
||||
|
||||
## 依赖与运行(重要!)
|
||||
- 依赖固定 `electron-vite@5 vite@7 @vitejs/plugin-react@5`(避免 vite8 与 electron-vite peer 冲突);Electron ^43。
|
||||
@@ -34,13 +35,14 @@
|
||||
|
||||
## 版本号与打包(2026-08-23 新增)
|
||||
- 版本号单一来源 = `package.json version`(当前 0.1.0);主进程 `app.getVersion()`;标题栏显示「系统版本号 vX.Y.Z」;任务栏标题由 `did-finish-load` 时 `setTitle` 兜底(页面 `<title>` 会覆盖构造标题)。
|
||||
- 项目需求文档:根目录 `项目需求`(无扩展名)2026-08-23 重写为 v2.0(Electron 重写版当前阶段,✅/⏳ 标注);根目录 `指令清单` 为历史补充需求清单(需求已全部实现)。另有 UI 速览图 `SmartAgriCenter/docs/ui-screenshots/`(若有)。
|
||||
- 文档三件套(均在根目录,无扩展名):`项目需求`(v3.0,✅/⏳ 标注)、`开发进度存档`(**跨会话恢复入口**)、`指令清单`(历史,已全部实现)。
|
||||
- 已实现功能全景(v0.1.0):Ribbon 三组(项目/页面/发布)、发布 6 按钮(预览本页/单屏发布[可轮播]/多屏发布[alsoMain]/停止轮播/关闭所有/检测屏幕)、配置 6 菜单(项目信息/遥控设置[阈值+锁定键]/快捷方式×3/发布设置/设备测试[键/音/麦/屏]/关于)、快捷键(1-9 长按>阈值、↑↓、Esc、F5、锁定键)、AES-256-GCM 密码加密、标题栏版本号(package.json 单一来源)。
|
||||
- **未实现/规划**:项目导入/导出、代码视图/页面视图切换、遥控器硬件对接、帮助文档入口。
|
||||
- 绿色版打包已完成(2026-08-23,electron-builder@26.15.3 已装):`npm run dist` → `release\智慧农业大数据可视化控制中心-0.1.0-win.zip`(绿色免安装)+ `release\win-unpacked\`。打包前设 `$env:ELECTRON_BUILDER_BINARIES_MIRROR="https://npmmirror.com/mirrors/electron-builder-binaries/"`。应用图标未配置(默认 Electron 图标),需要时加 build/icon.ico。
|
||||
- 绿色版打包已完成(2026-08-23,electron-builder@26.15.3 已装):`npm run dist` → `release\智慧农业大数据可视化控制中心-0.1.0-win.zip`(绿色免安装,当前 **128.9MB**)+ `release\win-unpacked\`。应用图标 `build/icon.ico` 已配置。瘦身:`compression: maximum` + `scripts/afterPack.js` 裁剪 locales(55→3),zip 139.7→128.9MB。
|
||||
- **⚠️ 打包必读**:每次 `npm run dist` 前必须用 `[System.IO.Directory]::Delete(...,$true)` 删掉旧 `release/`(SafeDelete 守卫会拦批量删除并导致打包卡死);打包前设 `$env:ELECTRON_BUILDER_BINARIES_MIRROR="https://npmmirror.com/mirrors/electron-builder-binaries/"`。详见根目录 `开发进度存档` §4。
|
||||
|
||||
## 待办/候选开发点(截至 2026-08-23)
|
||||
1. 页面预览图实际截图流程实测(page:snapshot 依赖 URL 可加载)。
|
||||
2. 遥控器模拟界面视觉美化。
|
||||
3. 打包分发(electron-builder 等)。
|
||||
4. 项目 JSON 导入/导出。
|
||||
3. 项目 JSON 导入/导出。
|
||||
4. 代码视图/页面视图切换、遥控器硬件对接、帮助文档入口。
|
||||
|
||||
Reference in New Issue
Block a user