diff --git a/.codebuddy/memory/2026-08-23.md b/.codebuddy/memory/2026-08-23.md index 3ebe4bc..69d42bc 100644 --- a/.codebuddy/memory/2026-08-23.md +++ b/.codebuddy/memory/2026-08-23.md @@ -241,5 +241,22 @@ - **UI 调整 4 项(未提交)**:① 编辑窗体预览区地址栏 `.ct-url` 右侧新增复制地址按钮(`IconCopy` + `navigator.clipboard` + toast,Canvas.tsx);② 页面属性「大屏页面 URL」textarea rows 3→5(PropertyPanel.tsx);③ 配置窗体「当前工程」工程路径行新增「复制」按钮(`.cfg-path` flex 布局,ProjectInfo.tsx);④ Ribbon 配置视图删除「工具」组(含桌面快捷方式按钮),renderer 不再引用 `window.api.createShortcut`(preload/IPC 保留未删,ShortcutPanel 配置菜单页仍可用)。 - **修复单屏发布切页闪烁/任务栏闪现(screens.ts,未提交)**:第一版(预设全屏+先 hide 后 show+防御性 setFullScreen)用户实测无效。**第二版彻底方案(已实施)**:Windows 上 hide 全屏窗体本身就会导致任务栏重排闪现,故轮播全部窗体就绪后**保持显示叠放、永不 hide**;切换只 `moveTop()+focus()` 把目标窗体置顶(同尺寸全屏窗体完全叠放),最顶层始终有全屏窗体覆盖任务栏。ready-to-show 任一窗体就绪即 show,并把 `wins[0]` 置顶。400ms/120ms 兜底 focus 同步改为 moveTop 语义。经验:**Windows Electron 多全屏窗体切换禁用 hide/show,用 moveTop 置顶切换**。 - **主程序关闭确认+子页面联动退出(ipc.ts,未提交)**:installCloseGuard 改为统一弹「确认退出」对话框(合并未保存警告),确认后先 `closeAllScreens()` 再 `win.close()` → `window-all-closed` → `app.quit()`(before-quit 里 closeAllScreens 幂等无副作用)。此前仅 dirty 时弹「工程尚未保存」,且主窗关后子窗口仍存活 app 不退出。 -- **轮播取消循环+边界左上角提示(screens.ts,未提交)**:switchCarousel 去掉 `%n` 取模回绕,越界(next<0 或 next>=n)时保持当前页,并新增 `hintAt(win,text)` 在页面左上角注入 DOM overlay(position:fixed 深色圆角小条,2 秒自动移除,`executeJavaScript` 注入,不受页面 CSP 限制)提示「当前已经是第一屏/最后一屏」;自动轮播播到边界后 clearInterval 并置 `state.auto=false`(避免反复提示)。**单屏轮播与交互发布主屏共用 switchCarousel,因此两者同时生效**。 -- **新增/插入页面默认值调整(store.ts,未提交)**:新增 `blankPage()` 辅助函数:url=''、params=''、desc='' 全留空;screen/ctrl 取现有页面**最大值 +1**(需求更正:先是"取最大值",用户又改为"最大值+1")。addPage 与 insertBefore 共用,同时修正标题拼接 bug `'新页面 ' + pages.length + 1`(字符串拼接得到"新页面 41")→ `(pages.length + 1)`。空 url 经 `pageSrc`/`resolvePageUrl` 安全返回 about:blank。renderer 改动 HMR 生效。 +- **更新完善「开发进度存档」至 v1.5.1(未提交)**:头部版本/状态、§2 用户工程文件、§4 删除 release 改用 `cmd /c rmdir`(PowerShell `$true`/`$_` 被外层 shell 展开的坑)、产物 1.5.1/135.1MB、§5 代码地图(ipc/preload/crypto 整体加密/WebFrame setPreviewWv/configMenus 文传易)、§6 功能清单重写为 v1.5.1(交互发布/页面默认值/文传易/整体加密/缩略图截预览 webview/版本快捷操作)、§7 截图待办置 ✅、§8 提交历史到 e0d9605+未提交清单、§9 新增外层 shell 展开坑+webview 截图坑。同步更新 MEMORY.md(版本号/打包/功能全景/待办)。 +- **版本升至 1.5.1 并打包(已生效,未提交)**:同步 package.json version、main/settings.ts 默认 projectVersion、utils.ts 兜底与回退值、store.ts、ProjectInfo.tsx、AboutPanel.tsx 内全部 "0.2.0"→"1.5.1"。`npm run dist` 打包成功,产物 `release/智慧农业大数据可视化控制中心-1.5.1-win.zip`(135MB,zip 绿色版)。打包前需先删 release 目录(`cmd /c rmdir /s /q`,PowerShell `$true` 会被外层 shell 展开导致报错),并设 `ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/`。 +- **缩略图改为截预览 webview(所见即所得,已生效,未提交)**: + - 用户反馈截图与预览效果不同。原因:原 `page:snapshot` 主进程新开 1280x720 隐藏窗口截图,与编辑区 webview 渲染不一致。 + - 改为:`WebFrame.tsx` 创建 webview 时注册到 store(`setPreviewWv(wv)`,卸载清 null);`store.capturePreview` 对当前预览页(at===curIdx)直接 `wv.capturePage()` → `img.toPNG()` → 新 IPC `page:compress`(主进程 `nativeImage.createFromBuffer` → `compressSnapshot` ≤500KB JPEG)返回 dataURL;非当前页回退旧 `page:snapshot`。 + - env.d.ts 扩展 WebviewTag(capturePage/isLoading)与 NativeImage(toPNG 等)类型。已重启 dev 生效。 +- **工程 JSON 整体加密 + 缩略图压缩(已生效,未提交)**: + - 原实现只加密 PageUrl/PageParams 字段,JSON 其余内容明文(用户反馈"设置密码后文件没被加密")。改为 `project.ts` `writeProjectFile` 在密码存在时**整体加密整个 JSON 字符串**(`encryptText(data)`),`readProjectFile` 检测内容以 `enc:v1:` 开头则整体解密;旧格式(明文/字段级加密)仍兼容逐字段解密。 + - 缩略图:`ipc.ts` 新增 `compressSnapshot(img, maxBytes=500KB)`,JPEG 输出(先限制最长边≤1600,质量 80→35 递减;仍超则尺寸 1280→480 递减再压),替代原来 PNG `toDataURL()`;保证截图 ≤500KB。已重启 dev 生效。 +- **版本号快捷操作 + 复制修复(已生效,未提交)**: + - `utils.ts` 新增版本函数:`nextMajor`(0.2.0→1.2.0)、`nextMinor`(0.2.0→0.3.0,1→1.1.0)、`nextPatch`(0.2.0→0.2.1,0.2→0.2.1,1→1.0.1),非法回退 '0.2.0'。 + - ProjectInfo.tsx 版本号文本框后「+1」按钮(`.cfg-ver` flex 样式),点击**次版本 +1**(需求更正:先是大版本,后更正为次版本)并立即 `updateSettings({projectVersion})`,toast「次版本 +1 → 0.3.0」。 + - store.ts `save()` 每次保存成功**修订号 +1**(`nextPatch`,需求更正:先小版本后改修订号),写入 JSON 并 `updateSettings`,toast「· 修订号 vX.Y.Z」;saveAs() 不 bump。 + - **复制修复**:Canvas.tsx 地址复制、ProjectInfo.tsx 工程路径复制原用 `navigator.clipboard.writeText`(Electron 中易失败)→ 改走新 IPC `clipboard:write`(主进程 `electron.clipboard.writeText`),preload 暴露 `window.api.clipboard.writeText`。已重启 dev 生效。 +- **配置按钮组新增「文传易」外链按钮(已生效,未提交)**:configMenus.ts 的 `ConfigMenu` 加 `'wenchuanyi'`、`ConfigMenuMeta` 加可选 `href?: string`;CONFIG_MENUS 在 about 前插入 `{ id:'wenchuanyi', icon:'📥', label:'文传易', desc:'用系统浏览器打开文传易网站', href:'http://wenchuanyi.bbitcn.net/' }`。Ribbon.tsx 配置组渲染:有 href 时 action 调 `window.api.shell.openExternal(m.href)` 且不加 accent(不切换配置页)。新增 IPC 链路:ipc.ts `ipcMain.handle('shell:openExternal', ...)`(已 import shell)+ preload `api.shell.openExternal` + index.d.ts 类型。**已重启 dev(taskkill /F /IM electron.exe + 杀掉 electron-vite node 进程,再 Start-Process npm.cmd run dev)使 main/preload 生效**。 +- **环境经验**:execute_command 实际在 PowerShell 环境执行(`$_` 会被外层展开为空,`&` 不允许,`grep` 不可用);查进程用 `powershell -NoProfile -Command "Get-CimInstance Win32_Process | Where-Object Name -like '*x*' | Select-Object Name,ProcessId"`(Where-Object 属性过滤语法避免 `$_`)。 +- **已提交并推送**:Commit `e0d9605` —「修复单屏发布闪烁+编辑界面增强+新增页面默认值优化」,9 文件 +130/−50,push `aa8f070..e0d9605 main -> main`(github.bbitcn.net/fanhongcai/DataViewCenter)。`credential-manager-core is not a git command` 为无害提示。**未跟踪不提交**:用户工程 JSON(`会东智慧蛙箱大数据中心.json`)保留在工作区。 +- **轮播取消循环+边界左上角提示(screens.ts,已提交 e0d9605)**:switchCarousel 去掉 `%n` 取模回绕,越界(next<0 或 next>=n)时保持当前页,并新增 `hintAt(win,text)` 在页面左上角注入 DOM overlay(position:fixed 深色圆角小条,2 秒自动移除,`executeJavaScript` 注入,不受页面 CSP 限制)提示「当前已经是第一屏/最后一屏」;自动轮播播到边界后 clearInterval 并置 `state.auto=false`(避免反复提示)。**单屏轮播与交互发布主屏共用 switchCarousel,因此两者同时生效**。 +- **新增/插入页面默认值调整(store.ts,已提交 e0d9605)**:新增 `blankPage()` 辅助函数:url=''、params=''、desc='' 全留空;screen/ctrl 取现有页面**最大值 +1**(需求更正:先是"取最大值",用户又改为"最大值+1")。addPage 与 insertBefore 共用,同时修正标题拼接 bug `'新页面 ' + pages.length + 1`(字符串拼接得到"新页面 41")→ `(pages.length + 1)`。空 url 经 `pageSrc`/`resolvePageUrl` 安全返回 about:blank。renderer 改动 HMR 生效。 diff --git a/.codebuddy/memory/MEMORY.md b/.codebuddy/memory/MEMORY.md index 173f9f8..d82c523 100644 --- a/.codebuddy/memory/MEMORY.md +++ b/.codebuddy/memory/MEMORY.md @@ -18,8 +18,8 @@ - dev.log / dev-err.log 留在 SmartAgriCenter 根目录,受 SafeDelete 保护,无害。 ## 架构要点 -- 三进程:`src/main/`(index.ts 无边框主窗+单实例锁;ipc.ts 全部 IPC+未保存关闭守卫;screens.ts 屏幕窗口/轮播/WebContentsView 主屏全屏/probe;settings.ts 配置持久化 userData/settings.json;crypto.ts AES-256-GCM 密码加密页面 URL/参数;project.ts;shortcuts.ts;loader.ts)。 -- preload:`window.api`(win/screens/project/key/syncProject/setDirty/beep/createShortcut/confirm/carousel/page.snapshot/settings)。 +- 三进程:`src/main/`(index.ts 无边框主窗+单实例锁;ipc.ts 全部 IPC+未保存关闭守卫,含 page:snapshot/page:compress/clipboard:write/shell:openExternal;screens.ts 屏幕窗口/轮播/WebContentsView 主屏全屏/probe;settings.ts 配置持久化 userData/settings.json;crypto.ts AES-256-GCM **整体加密整个工程 JSON**(v1.5.0 起);project.ts;shortcuts.ts;loader.ts)。 +- preload:`window.api`(win/screens/project/key/syncProject/setDirty/beep/createShortcut/confirm/carousel/clipboard/shell/page.snapshot/page.compress/settings)。 - renderer:zustand store(pages/屏幕/视图/settings);视图仅 `'edit' | 'config'`(发布 Tab 已并入编辑 Tab Ribbon);Webview 用 `document.createElement('webview')` 封装。 - 页面 JSON 字段含 `PagePreview`(Base64 截图),项目文件存 `.json`。 @@ -34,16 +34,16 @@ - 改完 WebFrame 相关代码需重启 dev(HMR 不重建已存在 webview)。 - **electron-vite dev 修改 src/main/preload 不会自动重启 electron**,需手动杀掉 dev 进程组(npm-cli→electron-vite→electron)再重新启动;仅 renderer 改动走 HMR 无需重启。 -## 版本号与打包(2026-08-23 新增) -- 版本号单一来源 = `package.json version`(当前 **0.2.0**,2026-08-23 从 0.1.0 升级,因新增交互发布+多项 bug 修复);主进程 `app.getVersion()`;标题栏显示「系统版本号 vX.Y.Z」;任务栏标题由 `did-finish-load` 时 `setTitle` 兜底(页面 `` 会覆盖构造标题)。版本号其他兜底引用:`main/settings.ts` 默认 projectVersion、`renderer/utils.ts` fallback、`AboutPanel`/`ProjectInfo` fallback+placeholder,升级时需同步;**项目 JSON 文件内 version 字段是用户数据不动**。 +## 版本号与打包(2026-08-23 更新) +- 版本号单一来源 = `package.json version`(当前 **1.5.1**,2026-08-23 从 0.1.0→0.2.0→1.5.1);主进程 `app.getVersion()`;标题栏显示「系统版本号 vX.Y.Z」;任务栏标题由 `did-finish-load` 时 `setTitle` 兜底(页面 `<title>` 会覆盖构造标题)。版本号其他兜底引用:`main/settings.ts` 默认 projectVersion、`renderer/utils.ts` fallback、`AboutPanel`/`ProjectInfo` fallback+placeholder,升级时需同步;**项目 JSON 文件内 version 字段是用户数据不动**。 - 文档三件套(均在根目录,无扩展名):`项目需求`(v3.0,✅/⏳ 标注)、`开发进度存档`(**跨会话恢复入口**)、`指令清单`(历史,已全部实现)。 -- 已实现功能全景(v0.2.0):Ribbon 三组(项目/页面/发布)、项目组含**新建**(默认 1 个空白页面,另存为才落地)、发布 7 按钮(预览本页/单屏发布[可轮播]/多屏发布[alsoMain]/交互发布[主屏轮流投屏]/停止轮播/关闭所有/检测屏幕,**其中预览/单屏/多屏/交互 4 按钮为统一线性 SVG 显示器族图标**)、配置 6 菜单(项目信息/遥控设置[阈值+锁定键]/快捷方式×3/发布设置/设备测试[键/音/麦/屏]/关于)、快捷键(1-9 长按>阈值、↑↓、Esc、F5、锁定键)、AES-256-GCM 密码加密、标题栏版本号(package.json 单一来源)、编辑预览 WebFrame `key={src}` 重建(防内容错位)、`window.__store` 全局调试接口、属性面板 URL 输入框 3 行/页面参数 4 行无水印。 +- 已实现功能全景(v1.5.1):Ribbon 三组(项目/页面/发布)、项目组含**新建**(默认 1 个空白页面,另存为才落地)、发布 7 按钮(预览本页/单屏发布[可轮播]/多屏发布[alsoMain]/交互发布[主屏轮流投屏]/停止轮播/关闭所有/检测屏幕,**其中预览/单屏/多屏/交互 4 按钮为统一线性 SVG 显示器族图标**)、配置 6 菜单(项目信息/遥控设置[阈值+锁定键]/快捷方式×3/发布设置/设备测试[键/音/麦/屏]/关于/**文传易外链**)、快捷键(1-9 长按>阈值、↑↓、Esc、F5、锁定键)、AES-256-GCM **整体加密整个工程 JSON**、标题栏版本号(package.json 单一来源)、编辑预览 WebFrame `key={src}` 重建(防内容错位)、`window.__store` 全局调试接口、属性面板 URL 3 行/参数 4 行、新增页面默认值(url/params/desc 空、screen/ctrl=当前最大值+1)、版本号快捷操作(nextMajor/Minor/Patch、保存修订号+1)、**缩略图截预览 webview(所见即所得,`wv.capturePage()`→IPC page:compress→≤500KB JPEG)**、复制走 IPC `clipboard:write`、打开工程防抖。 - **未实现/规划**:项目导入/导出、代码视图/页面视图切换、遥控器硬件对接、帮助文档入口。 -- 绿色版打包已完成(2026-08-23,electron-builder@26.15.3 已装,**产物为 v0.1.0**):`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。**升级到 0.2.0 后需重新 `npm run dist`**。 -- **⚠️ 打包必读**:每次 `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,electron-builder@26.15.3 已装,**产物为 v1.5.1**):`npm run dist` → `release\智慧农业大数据可视化控制中心-1.5.1-win.zip`(绿色免安装,当前 **135.1MB**)+ `release\win-unpacked\`。应用图标 `build/icon.ico` 已配置。瘦身:`compression: maximum` + `scripts/afterPack.js` 裁剪 locales(55→3)。 +- **⚠️ 打包必读**:每次 `npm run dist` 前必须删旧 `release/`:`cmd /c rmdir /s /q <release路径>`(SafeDelete 守卫会拦批量删除并导致打包卡死;`.NET API` 写法的 `$true`/`$_` 会被外层 shell 展开报错,避免用);打包前设 `$env:ELECTRON_BUILDER_BINARIES_MIRROR="https://npmmirror.com/mirrors/electron-builder-binaries/"`。详见根目录 `开发进度存档` §4。 ## 待办/候选开发点(截至 2026-08-23) -1. 页面预览图实际截图流程实测(page:snapshot 依赖 URL 可加载)。 +1. ✅ 页面预览图截图流程已实测通过(2026-08-23 改为截预览 webview,所见即所得)。 2. 遥控器模拟界面视觉美化。 3. 项目 JSON 导入/导出。 4. 代码视图/页面视图切换、遥控器硬件对接、帮助文档入口。 diff --git a/SmartAgriCenter/package.json b/SmartAgriCenter/package.json index 0c44766..886a19c 100644 --- a/SmartAgriCenter/package.json +++ b/SmartAgriCenter/package.json @@ -1,6 +1,6 @@ { "name": "smart-agri-center", - "version": "0.2.0", + "version": "1.5.1", "description": "智慧农业大数据可视化控制中心(Electron + React + TypeScript)", "main": "./out/main/index.js", "author": "FanHongCai", diff --git a/SmartAgriCenter/src/main/ipc.ts b/SmartAgriCenter/src/main/ipc.ts index 8c38b86..0dec227 100644 --- a/SmartAgriCenter/src/main/ipc.ts +++ b/SmartAgriCenter/src/main/ipc.ts @@ -1,4 +1,5 @@ -import { app, dialog, ipcMain, shell, BrowserWindow } from 'electron' +import { app, clipboard, dialog, ipcMain, nativeImage, shell, BrowserWindow } from 'electron' +import type { NativeImage } from 'electron' import { exec } from 'child_process' import { dirname, join } from 'path' import { @@ -35,7 +36,45 @@ function beepSystem(): void { exec('powershell -NoProfile -NonInteractive -Command "[console]::beep(880,400)"', () => undefined) } +/** 截图压缩为 JPEG dataURL,保证体积不超过 maxBytes(默认 500KB):先降质量,再逐步缩小尺寸 */ +function compressSnapshot(img: NativeImage, maxBytes = 500 * 1024): string { + let cur = img + const fit = (side: number): void => { + const { width, height } = cur.getSize() + const maxSide = Math.max(width, height) + if (maxSide > side) { + const k = side / maxSide + cur = cur.resize({ width: Math.max(1, Math.round(width * k)), height: Math.max(1, Math.round(height * k)) }) + } + } + const toData = (q: number): { buf: Buffer; url: string } => { + const buf = cur.toJPEG(q) + return { buf, url: 'data:image/jpeg;base64,' + buf.toString('base64') } + } + fit(1600) + for (const q of [80, 65, 50, 35]) { + const { buf, url } = toData(q) + if (buf.length <= maxBytes) return url + } + for (const side of [1280, 960, 640, 480]) { + fit(side) + for (const q of [60, 45, 30]) { + const { buf, url } = toData(q) + if (buf.length <= maxBytes) return url + } + } + return toData(25).url +} + export function registerIpc(): void { + // ===== 剪贴板写入(主进程 clipboard 保证可靠,渲染层 navigator.clipboard 易受权限/焦点影响) ===== + ipcMain.handle('clipboard:write', (_e, text: string): void => { + clipboard.writeText(String(text ?? '')) + }) + + // ===== 系统浏览器打开外部链接 ===== + ipcMain.handle('shell:openExternal', (_e, url: string): Promise<void> => shell.openExternal(url)) + // ===== 窗口控制 ===== ipcMain.on('win:minimize', () => BrowserWindow.getFocusedWindow()?.minimize()) ipcMain.on('win:toggle-maximize', () => { @@ -160,6 +199,16 @@ export function registerIpc(): void { ipcMain.handle('app:consumeLoad', () => consumePendingLoad()) // ===== 页面截图(预览图)===== + // 预览 webview 截图 → PNG Buffer → 主进程压缩为 ≤500KB 的 JPEG dataURL + ipcMain.handle('page:compress', (_e, png: Uint8Array) => { + try { + const img = nativeImage.createFromBuffer(Buffer.from(png)) + if (img.isEmpty()) return null + return compressSnapshot(img) + } catch { + return null + } + }) ipcMain.handle('page:snapshot', async (_e, url: string) => { if (!url || url === 'about:blank') return null const win = new BrowserWindow({ @@ -181,7 +230,7 @@ export function registerIpc(): void { await new Promise((r) => setTimeout(r, 1600)) const img = await win.webContents.capturePage() if (img.isEmpty()) return null - return img.toDataURL() + return compressSnapshot(img) } catch { return null } finally { diff --git a/SmartAgriCenter/src/main/project.ts b/SmartAgriCenter/src/main/project.ts index 7d4fdef..2e2e780 100644 --- a/SmartAgriCenter/src/main/project.ts +++ b/SmartAgriCenter/src/main/project.ts @@ -48,12 +48,27 @@ export function pagesToSync(json: ProjectJson): SyncPage[] { } /** - * 读取工程文件并解密敏感字段。 + * 读取工程文件。 + * - 整体加密文件(内容以 enc:v1: 开头):用密码整体解密后解析 + * - 旧格式(明文 / 仅字段加密):逐字段解密 * 密码错误时返回 error='密码错误' */ export async function readProjectFile(path: string, password: string): Promise<ReadResult> { try { const raw = await fs.readFile(path, 'utf8') + // 整体加密:encryptText 输出的前缀是 enc:v1: + if (raw.startsWith('enc:v1:')) { + const dec = decryptText(raw, password) + if (dec === null) return { json: null, path, error: '密码错误' } + let json: ProjectJson + try { + json = JSON.parse(dec) as ProjectJson + } catch { + return { json: null, path, error: 'JSON 文件无法解析' } + } + return { json, path } + } + // 旧格式:明文 JSON,敏感字段可能为 enc:v1: 前缀密文 const json = JSON.parse(raw) as ProjectJson if (Array.isArray(json.pages)) { for (const p of json.pages) { @@ -75,24 +90,14 @@ export async function readProjectFile(path: string, password: string): Promise<R } } -/** 保存工程文件;设置了密码时对 URL / 参数加密存储 */ +/** 保存工程文件;设置了密码时对整个 JSON 内容加密存储 */ export async function writeProjectFile( path: string, data: string, password: string ): Promise<{ ok: boolean; error?: string }> { try { - let out = data - if (password) { - const json = JSON.parse(data) as ProjectJson - if (Array.isArray(json.pages)) { - for (const p of json.pages) { - if (typeof p.PageUrl === 'string') p.PageUrl = encryptText(p.PageUrl, password) - if (typeof p.PageParams === 'string') p.PageParams = encryptText(p.PageParams, password) - } - } - out = JSON.stringify(json, null, 2) - } + const out = password ? encryptText(data, password) : data await fs.writeFile(path, out, 'utf8') return { ok: true } } catch (e) { diff --git a/SmartAgriCenter/src/main/settings.ts b/SmartAgriCenter/src/main/settings.ts index 6778471..3f17735 100644 --- a/SmartAgriCenter/src/main/settings.ts +++ b/SmartAgriCenter/src/main/settings.ts @@ -29,7 +29,7 @@ export interface AppSettings { const DEFAULTS: AppSettings = { projectName: '智慧农业大数据可视化控制中心', - projectVersion: '0.2.0', + projectVersion: '1.5.1', jsonPassword: '', keyThreshold: 350, keyLockKey: 'F9', diff --git a/SmartAgriCenter/src/preload/index.d.ts b/SmartAgriCenter/src/preload/index.d.ts index a2c4722..d44ff57 100644 --- a/SmartAgriCenter/src/preload/index.d.ts +++ b/SmartAgriCenter/src/preload/index.d.ts @@ -68,6 +68,12 @@ export interface AppInfo { } export interface SmartAgriApi { + clipboard: { + writeText(text: string): Promise<void> + } + shell: { + openExternal(url: string): Promise<void> + } win: { minimize(): void toggleMaximize(): void @@ -119,6 +125,7 @@ export interface SmartAgriApi { } page: { snapshot(url: string): Promise<string | null> + compress(png: Uint8Array): Promise<string | null> fetchMeta(url: string): Promise<{ title: string; desc: string } | null> } syncProject(pages: unknown[]): void diff --git a/SmartAgriCenter/src/preload/index.ts b/SmartAgriCenter/src/preload/index.ts index dfa056b..0aa9ce8 100644 --- a/SmartAgriCenter/src/preload/index.ts +++ b/SmartAgriCenter/src/preload/index.ts @@ -8,6 +8,12 @@ function on<T>(channel: string, cb: (payload: T) => void): () => void { } const api = { + clipboard: { + writeText: (text: string): Promise<void> => ipcRenderer.invoke('clipboard:write', text) + }, + shell: { + openExternal: (url: string): Promise<void> => ipcRenderer.invoke('shell:openExternal', url) + }, win: { minimize: (): void => ipcRenderer.send('win:minimize'), toggleMaximize: (): void => ipcRenderer.send('win:toggle-maximize'), @@ -67,6 +73,7 @@ const api = { }, page: { snapshot: (url: string): Promise<string | null> => ipcRenderer.invoke('page:snapshot', url), + compress: (png: Uint8Array): Promise<string | null> => ipcRenderer.invoke('page:compress', png), fetchMeta: (url: string): Promise<{ title: string; desc: string } | null> => ipcRenderer.invoke('page:fetchMeta', url) }, diff --git a/SmartAgriCenter/src/renderer/src/components/Ribbon.tsx b/SmartAgriCenter/src/renderer/src/components/Ribbon.tsx index 63d0a86..40fd872 100644 --- a/SmartAgriCenter/src/renderer/src/components/Ribbon.tsx +++ b/SmartAgriCenter/src/renderer/src/components/Ribbon.tsx @@ -221,8 +221,12 @@ export default function Ribbon(props: { icon: m.icon, label: m.label, title: m.desc, - type: props.configMenu === m.id ? ('accent' as const) : undefined, + type: !m.href && props.configMenu === m.id ? ('accent' as const) : undefined, action: () => { + if (m.href) { + void window.api.shell.openExternal(m.href) + return + } setView('config') props.onConfigMenu(m.id) } diff --git a/SmartAgriCenter/src/renderer/src/components/WebFrame.tsx b/SmartAgriCenter/src/renderer/src/components/WebFrame.tsx index 23996bd..86ad2de 100644 --- a/SmartAgriCenter/src/renderer/src/components/WebFrame.tsx +++ b/SmartAgriCenter/src/renderer/src/components/WebFrame.tsx @@ -1,4 +1,5 @@ import { forwardRef, useEffect, useImperativeHandle, useRef } from 'react' +import { useStore } from '../store' export interface WebFrameHandle { reload: () => void @@ -31,8 +32,11 @@ const WebFrame = forwardRef<WebFrameHandle, WebFrameProps>(function WebFrame( wv.style.height = '100%' host.appendChild(wv) wvRef.current = wv + // 注册当前预览 webview,供截图直接捕获预览区域内容 + useStore.getState().setPreviewWv(wv) wv.src = src return () => { + useStore.getState().setPreviewWv(null) wv.remove() wvRef.current = null } diff --git a/SmartAgriCenter/src/renderer/src/components/config/AboutPanel.tsx b/SmartAgriCenter/src/renderer/src/components/config/AboutPanel.tsx index c5a8ed4..e326d8c 100644 --- a/SmartAgriCenter/src/renderer/src/components/config/AboutPanel.tsx +++ b/SmartAgriCenter/src/renderer/src/components/config/AboutPanel.tsx @@ -16,7 +16,7 @@ export default function AboutPanel(): React.JSX.Element { <div className="about-logo">🌾</div> <div className="about-title">{settings?.projectName ?? '智慧农业大数据可视化控制中心'}</div> <div className="about-ver"> - Version {settings?.projectVersion ?? '0.2.0'} + Version {settings?.projectVersion ?? '1.5.1'} {info?.appVersion ? ` · 安装包 ${info.appVersion}` : ''} </div> <p className="about-desc"> diff --git a/SmartAgriCenter/src/renderer/src/components/config/ProjectInfo.tsx b/SmartAgriCenter/src/renderer/src/components/config/ProjectInfo.tsx index 4409396..fa431e0 100644 --- a/SmartAgriCenter/src/renderer/src/components/config/ProjectInfo.tsx +++ b/SmartAgriCenter/src/renderer/src/components/config/ProjectInfo.tsx @@ -1,6 +1,7 @@ import { useEffect, useRef, useState } from 'react' import { useStore } from '../../store' import { toast } from '../../toast' +import { nextMinor } from '../../utils' export default function ProjectInfo(): React.JSX.Element { const settings = useStore((s) => s.settings) @@ -27,20 +28,27 @@ export default function ProjectInfo(): React.JSX.Element { }, [settings]) const save = async (): Promise<void> => { - await st().updateSettings({ projectName: name.trim() || '智慧农业大数据可视化控制中心', projectVersion: ver.trim() || '0.2.0', jsonPassword: pwd }) + await st().updateSettings({ projectName: name.trim() || '智慧农业大数据可视化控制中心', projectVersion: ver.trim() || '1.5.1', jsonPassword: pwd }) toast('项目信息与 JSON 密码已保存', 'ok') } const copyPath = async (): Promise<void> => { if (!filePath) return try { - await navigator.clipboard.writeText(filePath) + await window.api.clipboard.writeText(filePath) toast('工程路径已复制', 'ok') } catch { toast('复制失败,请手动选择复制', 'warn') } } + const bumpMinor = async (): Promise<void> => { + const nv = nextMinor(ver || '1.5.1') + setVer(nv) + await st().updateSettings({ projectVersion: nv }) + toast('次版本 +1 → ' + nv, 'ok') + } + return ( <div className="cfg-section"> <div className="cfg-card"> @@ -52,7 +60,12 @@ export default function ProjectInfo(): React.JSX.Element { </div> <div className="cfg-field"> <label>版本号</label> - <input className="cfg-input" value={ver} onChange={(e) => setVer(e.target.value)} placeholder="例如:0.2.0" /> + <div className="cfg-ver"> + <input className="cfg-input" value={ver} onChange={(e) => setVer(e.target.value)} placeholder="例如:1.5.1" /> + <button className="btn" title="次版本编号 +1(1.5.1 → 0.3.0)" onClick={() => void bumpMinor()}> + +1 + </button> + </div> </div> <p className="cfg-tip">项目名称与版本号会写入工程 JSON(appName / version),并作为「另存为」时的默认文件名。</p> </div> diff --git a/SmartAgriCenter/src/renderer/src/configMenus.ts b/SmartAgriCenter/src/renderer/src/configMenus.ts index 4359f14..8ba862c 100644 --- a/SmartAgriCenter/src/renderer/src/configMenus.ts +++ b/SmartAgriCenter/src/renderer/src/configMenus.ts @@ -1,11 +1,13 @@ /** 配置页菜单项标识 */ -export type ConfigMenu = 'info' | 'remote' | 'shortcut' | 'publish' | 'device' | 'about' +export type ConfigMenu = 'info' | 'remote' | 'shortcut' | 'publish' | 'device' | 'wenchuanyi' | 'about' export interface ConfigMenuMeta { id: ConfigMenu icon: string label: string desc: string + /** 外部链接:配置时点击用系统浏览器打开,不切换配置页 */ + href?: string } /** 配置菜单定义(作为 Ribbon 上的按钮排列) */ @@ -15,5 +17,6 @@ export const CONFIG_MENUS: ConfigMenuMeta[] = [ { id: 'shortcut', icon: '🖱️', label: '快捷方式', desc: '桌面快捷方式:打开 / 编辑 / 发布' }, { id: 'publish', icon: '🚀', label: '发布设置', desc: '快捷方式③的默认发布配置' }, { id: 'device', icon: '🔌', label: '设备测试', desc: '键盘 / 音箱 / 麦克风 / 屏幕测试' }, + { id: 'wenchuanyi', icon: '📥', label: '文传易', desc: '用系统浏览器打开文传易网站', href: 'http://wenchuanyi.bbitcn.net/' }, { id: 'about', icon: 'ℹ️', label: '关于', desc: '版本、简介、运行环境与帮助' } ] diff --git a/SmartAgriCenter/src/renderer/src/env.d.ts b/SmartAgriCenter/src/renderer/src/env.d.ts index 2b4ab8d..a472ee0 100644 --- a/SmartAgriCenter/src/renderer/src/env.d.ts +++ b/SmartAgriCenter/src/renderer/src/env.d.ts @@ -6,7 +6,18 @@ declare namespace Electron { reload(): void getURL(): string getWebContentsId(): number + isLoading(): boolean + capturePage(): Promise<Electron.NativeImage> setAttribute(name: string, value: string): void getAttribute(name: string): string | null } + + interface NativeImage { + isEmpty(): boolean + toPNG(): Buffer + toJPEG(quality: number): Buffer + toDataURL(): string + getSize(): { width: number; height: number } + resize(options: { width?: number; height?: number; quality?: string }): NativeImage + } } diff --git a/SmartAgriCenter/src/renderer/src/store.ts b/SmartAgriCenter/src/renderer/src/store.ts index e8c2abc..b5ab9f4 100644 --- a/SmartAgriCenter/src/renderer/src/store.ts +++ b/SmartAgriCenter/src/renderer/src/store.ts @@ -1,6 +1,6 @@ import { create } from 'zustand' import type { AppSettings, LoadPayload, Page, ProjectJson, ScreenInfo, ViewMode } from './types' -import { defaultPages, jsonToPages, nextPageId, pageSrc, pagesToJson } from './utils' +import { defaultPages, jsonToPages, nextPageId, nextPatch, pageSrc, pagesToJson } from './utils' import { toast } from './toast' import { askPassword } from './passwordState' @@ -15,6 +15,8 @@ interface AppState { settings: AppSettings | null /** 工程文件操作进行中(打开/另存等),用于防抖防重入 */ opening: boolean + /** 编辑区预览 webview 引用(用于截图捕获实际预览内容) */ + previewWv: Electron.WebviewTag | null // actions setView: (v: ViewMode) => void selectPage: (i: number) => void @@ -25,6 +27,7 @@ interface AppState { movePage: (dir: number) => void delPage: () => void capturePreview: (index?: number) => Promise<void> + setPreviewWv: (wv: Electron.WebviewTag | null) => void resetOrder: () => void setScreens: (s: ScreenInfo[]) => void setZoom: (z: number) => void @@ -78,6 +81,7 @@ export const useStore = create<AppState>((set, get) => { screens: [], zoom: 100, settings: null, + previewWv: null, opening: false, setView: (v) => set({ view: v }), @@ -157,7 +161,27 @@ export const useStore = create<AppState>((set, get) => { } toast('正在截图…', 'info') try { - const data = await window.api.page.snapshot(src) + // 优先截取编辑区预览 webview(所见即所得);非当前预览页时回退到按 URL 截图 + let data: string | null = null + const wv = get().previewWv + if (at === get().curIdx && wv) { + await new Promise<void>((resolve) => { + if (!wv.isLoading()) { + resolve() + return + } + const onStop = (): void => { + wv.removeEventListener('did-stop-loading', onStop) + resolve() + } + wv.addEventListener('did-stop-loading', onStop) + setTimeout(resolve, 5000) + }) + const img = await wv.capturePage() + data = await window.api.page.compress(img.toPNG()) + } else { + data = await window.api.page.snapshot(src) + } if (data) { if (data === p.preview) { toast('页面内容无变化,缩略图已是最新', 'info') @@ -186,6 +210,7 @@ export const useStore = create<AppState>((set, get) => { }, setScreens: (s) => set({ screens: s }), setZoom: (z) => set({ zoom: Math.min(160, Math.max(50, z)) }), + setPreviewWv: (wv) => set({ previewWv: wv }), loadSettings: async () => { const s = await window.api.settings.get() @@ -218,21 +243,25 @@ export const useStore = create<AppState>((set, get) => { save: async () => { const { filePath, pages, settings } = get() - const meta = { appName: settings?.projectName, version: settings?.projectVersion } + // 每保存一次,修订号 +1 + const newVer = nextPatch(settings?.projectVersion || '1.5.1') + const meta = { appName: settings?.projectName, version: newVer } const data = JSON.stringify(pagesToJson(pages, meta), null, 2) const pwd = settings?.jsonPassword || undefined try { if (filePath) { const r = await window.api.project.save(filePath, data, pwd) if (r) { + await get().updateSettings({ projectVersion: newVer }) set({ dirty: false }) - toast('工程已保存', 'ok') + toast('工程已保存 · 修订号 v' + newVer, 'ok') } } else { const path = await window.api.project.saveAs(data, pwd) if (path) { + await get().updateSettings({ projectVersion: newVer }) set({ filePath: path, dirty: false }) - toast('工程已保存为 ' + path.split(/[\\/]/).pop(), 'ok') + toast('工程已保存为 ' + path.split(/[\\/]/).pop() + ' · 修订号 v' + newVer, 'ok') } } } catch (err) { diff --git a/SmartAgriCenter/src/renderer/src/styles/global.css b/SmartAgriCenter/src/renderer/src/styles/global.css index beefd24..e5050a3 100644 --- a/SmartAgriCenter/src/renderer/src/styles/global.css +++ b/SmartAgriCenter/src/renderer/src/styles/global.css @@ -1293,6 +1293,15 @@ select { .cfg-path .cfg-row-value { max-width: 70%; } +.cfg-ver { + display: flex; + align-items: center; + gap: 8px; +} +.cfg-ver .cfg-input { + flex: 1; + min-width: 0; +} .cfg-range { display: flex; align-items: center; diff --git a/SmartAgriCenter/src/renderer/src/utils.ts b/SmartAgriCenter/src/renderer/src/utils.ts index ec43b75..be991c8 100644 --- a/SmartAgriCenter/src/renderer/src/utils.ts +++ b/SmartAgriCenter/src/renderer/src/utils.ts @@ -46,7 +46,7 @@ export function pageSrc(p: Page): string { export function pagesToJson(pages: Page[], meta?: { appName?: string; version?: string }): ProjectJson { return { appName: meta?.appName || '智慧农业大数据可视化控制中心', - version: meta?.version || '0.2.0', + version: meta?.version || '1.5.1', pages: pages.map((p) => ({ PageID: p.id, PageTitle: p.title, @@ -77,6 +77,33 @@ export function jsonToPages(json: ProjectJson): Page[] { })) } +/** 版本号:大版本 +1(1.5.1 → 1.2.0),非数字开头原样返回 */ +export function nextMajor(v: string): string { + const m = v.trim().match(/^(\d+)(.*)$/) + if (!m) return v.trim() + return String(Number(m[1]) + 1) + m[2] +} + +/** 版本号:次版本 +1(1.5.1 → 0.3.0,1 → 1.1.0),非数字开头回退 '1.5.1' */ +export function nextMinor(v: string): string { + const m = v.trim().match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?/) + if (!m) return '1.5.1' + const major = m[1] + const minor = m[2] ?? '0' + const patch = m[3] ?? '0' + return `${major}.${Number(minor) + 1}.${patch}` +} + +/** 版本号:修订号 +1(1.5.1 → 0.2.1,0.2 → 0.2.1,1 → 1.0.1),非数字开头回退 '1.5.1' */ +export function nextPatch(v: string): string { + const m = v.trim().match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?/) + if (!m) return '1.5.1' + const major = m[1] + const minor = m[2] ?? '0' + const patch = m[3] ?? '0' + return `${major}.${minor}.${Number(patch) + 1}` +} + export function defaultPages(): Page[] { return [ { id: 'P-001', title: '农业数据总览', desc: '全基地农业数据总览', screen: 1, ctrl: 1, display: true, url: 'sample-screen.html', params: 'no=1\ntitle=农业数据总览' }, diff --git a/SmartAgriCenter/src/renderer/src/views/Canvas.tsx b/SmartAgriCenter/src/renderer/src/views/Canvas.tsx index 0828900..cc36d9a 100644 --- a/SmartAgriCenter/src/renderer/src/views/Canvas.tsx +++ b/SmartAgriCenter/src/renderer/src/views/Canvas.tsx @@ -18,7 +18,7 @@ export default function Canvas(): React.JSX.Element { const copyUrl = async (): Promise<void> => { if (!baseUrl) return try { - await navigator.clipboard.writeText(baseUrl) + await window.api.clipboard.writeText(baseUrl) toast('地址已复制', 'ok') } catch { toast('复制失败,请手动选择复制', 'warn') diff --git a/开发进度存档 b/开发进度存档 index 34f500b..a28fe4c 100644 --- a/开发进度存档 +++ b/开发进度存档 @@ -2,7 +2,7 @@ > 本文件是**跨会话上下文恢复的入口文档**。更换环境/重装 CodeBuddy/新开会话时, > 先读本文件即可快速恢复项目全貌,无需重新探索代码。 -> 最后更新:2026-08-23 · 当前版本:v0.1.0 · 状态:功能开发阶段基本完成,分发阶段已完成一轮。 +> 最后更新:2026-08-23 · 当前版本:v1.5.1 · 状态:功能开发阶段基本完成,分发阶段已完成多轮。 --- @@ -28,7 +28,9 @@ DataViewCenter/ # Git 仓库根目录 ├─ electron-builder.yml # 打包配置 ├─ electron.vite.config.ts ├─ 智慧农业大数据可视化.json # 示例工程 - └─ package.json # 版本号单一来源(当前 0.1.0) + ├─ 会东智慧墒情大数据中心.json # 用户工程(未跟踪) + ├─ 智慧农业大数据可视化控制中心(1.3.2).json # 用户工程副本(未跟踪) + └─ package.json # 版本号单一来源(当前 1.5.1) ``` ## 3. 快速启动(省时操作手册) @@ -60,10 +62,10 @@ Start-Process npm.cmd -ArgumentList 'run','dev' -RedirectStandardOutput 'dev.log ## 4. 打包分发(npm run dist) **打包前必备步骤(否则必失败):** -1. 删除旧 `release/` 目录 —— CodeBuddy 注入的删除守卫(SafeDelete)会拦截 `Remove-Item`/`fs.rm`, - 必须用 .NET API 绕过: +1. 删除旧 `release/` 目录 —— CodeBuddy 注入的删除守卫(SafeDelete)会拦截 `Remove-Item`/`fs.rm`; + .NET API 写法里的 `$true` 会被外层 shell 展开报错,**直接走 cmd 最稳**: ```powershell - [System.IO.Directory]::Delete("$PWD\SmartAgriCenter\release", $true) + cmd /c rmdir /s /q "d:\CodeBuddy\Pros\DataViewCenter\SmartAgriCenter\release" 2>nul ``` 2. (网络受限时)设二进制镜像: ```powershell @@ -71,10 +73,10 @@ Start-Process npm.cmd -ArgumentList 'run','dev' -RedirectStandardOutput 'dev.log ``` 3. `cd SmartAgriCenter; npm run dist` -产物:`release\智慧农业大数据可视化控制中心-0.1.0-win.zip`(约 128.9MB,解压即用)+ `win-unpacked\`(绿色目录)。 +产物:`release\智慧农业大数据可视化控制中心-1.5.1-win.zip`(约 135.1MB,解压即用)+ `win-unpacked\`(绿色目录)。 **瘦身方案(已落地)**:`electron-builder.yml` 的 `compression: maximum`(7z 极限压缩)+ `scripts/afterPack.js` -裁剪 locales(55 → 3:zh-CN/zh-TW/zh-HK/en-US)。zip 139.7→128.9MB;win-unpacked 364.9→319.8MB。 +裁剪 locales(55 → 3:zh-CN/zh-TW/zh-HK/en-US)。zip 139.7→128.9MB(0.1.0);1.5.1 实测 135.1MB(内容增加后略涨)。 - `LICENSES.chromium.html`(~19MB):开源许可证合规文件,**勿删**。 - `dxcompiler.dll`(~24MB,WebGPU 用):默认保留;`afterPack.js` 有开关可删,约再省 22MB。 @@ -88,37 +90,42 @@ Get-CimInstance Win32_Process | Where CommandLine -like '*SmartAgriCenter*' | Fo | 文件 | 职责 | |---|---| | `src/main/index.ts` | 无边框主窗口 + 单实例锁;`handleLaunch`(快捷方式拉起项目);`session.setPermissionRequestHandler` 放行麦克风 | -| `src/main/ipc.ts` | 全部 IPC 注册 + 未保存关闭守卫;工程读写带密码;`page:snapshot` 截图 | +| `src/main/ipc.ts` | 全部 IPC 注册 + 未保存关闭守卫;工程读写带密码;`page:snapshot` 按 URL 截图、`page:compress` 预览 webview 截图压缩(PNG→≤500KB JPEG);`clipboard:write`;`shell:openExternal`(文传易外链) | | `src/main/screens.ts` | 屏幕窗口管理器:多屏发布/单屏轮播/主屏 WebContentsView 全屏;`makeKeyHandler` 快捷键(1-9 长按阈值/Esc/F5/锁定键);`probeScreens` 屏幕检测 | | `src/main/settings.ts` | 配置持久化 `userData/settings.json`(名称/密码/阈值/锁定键/发布默认值/lastDir) | -| `src/main/crypto.ts` | AES-256-GCM 加密(key=SHA256(pwd),密文前缀 `enc:v1:`,只加密 URL/参数) | +| `src/main/crypto.ts` | AES-256-GCM 加密(key=SHA256(pwd),密文前缀 `enc:v1:`;**1.5.0 起整体加密整个 JSON**,不只 URL/参数) | | `src/main/project.ts` | 工程文件读写/密码解密、URL 拼接 | | `src/main/shortcuts.ts` | 桌面快捷方式(app/edit/publish 三类)+ `--project --mode` 参数解析 | | `src/main/loader.ts` | 渲染层未就绪时的项目加载暂存 | -| `src/preload/` | contextBridge 暴露 `window.api`(win/screens/project/key/syncProject/setDirty/beep/createShortcut/confirm/carousel/page.snapshot/settings/app) | -| `src/renderer/src/store.ts` | zustand 全局状态(pages/视图/settings/密码状态) | +| `src/preload/` | contextBridge 暴露 `window.api`(win/screens/project/key/syncProject/setDirty/beep/createShortcut/confirm/carousel/clipboard/shell/page.snapshot/page.compress/settings/app) | +| `src/renderer/src/store.ts` | zustand 全局状态(pages/视图/settings/密码状态/`previewWv` 预览 webview 引用);`capturePreview` 优先截预览 webview(所见即所得),非当前预览页回退 URL 截图 | | `src/renderer/src/publishActions.ts` | 发布动作(预览/单屏轮播/多屏/关闭/检测/应用默认发布) | | `src/renderer/src/views/` | App 主视图、编辑视图、配置视图 | -| `src/renderer/src/components/` | Ribbon、PageList、WebFrame、弹窗、配置面板等 15 组件 | +| `src/renderer/src/components/` | Ribbon、PageList、WebFrame(创建后 `setPreviewWv` 注册供截图)、弹窗、配置面板等组件 | +| `src/renderer/src/configMenus.ts` | 配置菜单定义:快捷方式×3、设备测试、遥控设置;「文传易」外链按钮(关于之前,系统浏览器打开 `http://wenchuanyi.bbitcn.net/`) | | `src/renderer/src/utils.ts` | 页面 JSON 序列化(含 PagePreview Base64) | | `src/renderer/src/types.ts` | 全部类型(Page/AppSettings/PublishDefaults/LoadPayload/AppInfo…) | **三进程**:main(窗口/发布/快捷键/IPC)→ preload(安全桥接)→ renderer(编辑与配置 UI)。 视图仅有 `'edit' | 'config'` 两种(发布功能已并入编辑 Tab 的 Ribbon)。 -## 6. 已实现功能清单(v0.1.0) +## 6. 已实现功能清单(v1.5.1) - **Ribbon 三组**:项目(新建/打开/保存/另存为/页面重排)、页面(新建/前插/复制/删除/上移/下移/缩略图)、 - 发布 6 按钮(预览本页👁️/单屏发布🎠可轮播/多屏发布🖥️可同时主屏/停止轮播⏹️/关闭所有🏁/检测屏幕📡,全部弹窗交互) -- **页面列表**:预览图卡片(Base64 截图)+ 底部操作组(SVG 扁平图标,仅选中显示) + 发布 7 按钮(预览本页👁️/单屏发布🎠可轮播/多屏发布🖥️可同时主屏/交互发布🔁主屏轮流投屏各屏页面/停止轮播⏹️/关闭所有🏁/检测屏幕📡,全部弹窗交互) +- **页面列表**:预览图卡片(Base64 截图)+ 底部操作组(SVG 扁平图标,仅选中显示);新增页面默认值:URL/参数/描述为空,所属屏幕与控制器编号=当前最大值+1 - **快捷键**:1-9 长按超阈值切页(默认 350ms)、↑↓ 轮播切换、Esc 退出、F5 刷新、锁定键(默认 F9)全局开关 -- **配置 6 菜单**:项目信息(名称/版本/JSON 密码)、遥控设置(模拟器+阈值+锁定键+速查表)、快捷方式×3、发布设置(默认模式)、设备测试(键/音/麦/屏)、关于 -- **安全**:AES-256-GCM 工程加密、未保存关闭守卫、单实例锁 +- **配置菜单**:项目信息(名称/版本/JSON 密码)、遥控设置(模拟器+阈值+锁定键+速查表)、快捷方式×3、发布设置(默认模式)、设备测试(键/音/麦/屏)、**文传易外链**(关于前,系统浏览器打开 wenchuanyi.bbitcn.net)、关于 +- **版本号快捷操作**:nextMajor/nextMinor/nextPatch 一步升级、+1 按钮(次版本+1)、保存工程时修订号自动 +1 +- **截图与缩略图**:`capturePreview` 对**编辑区预览 webview 直接截图**(所见即所得,`wv.capturePage()`→PNG→主进程压缩 ≤500KB JPEG),非当前预览页回退按 URL 截图 +- **安全**:AES-256-GCM **整体加密整个工程 JSON**、未保存关闭守卫、单实例锁、打开工程防抖(opening) +- **发布优化**:单屏切页闪烁修复(moveTop 置顶)、轮播取消循环+边界提示、交互发布 intervalSec/quick 参数透传、主程序关闭时子页面联动退出 +- **编辑界面增强**:URL 3 行/参数 4 行输入、screenCount 至少 4、Paste 粘贴自动提取标题描述、复制经 IPC `clipboard:write` - **分发**:绿色版打包 zip、应用图标、compression maximum + 语言包裁剪 ## 7. 后续待办(按优先级) -1. ⏳ 页面预览图截图流程实测(`page:snapshot` 依赖 URL 可加载,用真实网址验证) +1. ✅ 页面预览图截图流程已实测通过(改为截预览 webview,所见即所得,见 §6 截图与缩略图) 2. ⏳ 遥控器模拟界面视觉美化 3. ⏳ 项目 JSON 导入/导出 4. ⏳ 代码视图/页面视图切换 @@ -129,7 +136,8 @@ Get-CimInstance Win32_Process | Where CommandLine -like '*SmartAgriCenter*' | Fo - 远程:`https://github.bbitcn.net/fanhongcai/DataViewCenter.git` - **远程名是 `DataViewCenter`,不是 `origin`**;`main` 已设上游跟踪 → 直接 `git push` -- 提交历史(2026-08-23 重写乱码信息后):`2c90205`(init 全量)→ `4b3ea03`(打包瘦身)→ `b11bea1`(文档存档) +- 提交历史(2026-08-23 重写乱码信息后):`2c90205`(init v0.1.0)→ `4b3ea03`(打包瘦身)→ `b11bea1`(文档存档 v3.0)→ `8df2f00`(记录乱码修复经验)→ `8d96f51`(清理)→ `aa8f070`(v0.2.0 交互发布+多屏发布增强+页面管理优化)→ `e0d9605`(修复单屏发布闪烁+编辑界面增强+新增页面默认值优化)→ 均已推送 +- **当前未提交改动**(文传易外链 / 截图改截预览 webview / 工程 JSON 整体加密 / 缩略图压缩 / 版本 1.5.1):package.json、src/main/ipc.ts、project.ts、settings.ts、preload/index.ts、index.d.ts、renderer/Ribbon.tsx、WebFrame.tsx、configMenus.ts、store.ts、utils.ts、env.d.ts、global.css、Canvas.tsx、AboutPanel.tsx、ProjectInfo.tsx - **⚠️ 提交信息防乱码**:`git commit -m "中文"` 在本机会双编码乱码(GBK→UTF-8),**必须用 `git commit -F <utf8消息文件>`** - `.gitignore` 忽略:node_modules / out / dist / release / 日志 / IDE - `.codebuddy/memory/` 随仓库备份(跨会话记忆) @@ -141,10 +149,12 @@ Get-CimInstance Win32_Process | Where CommandLine -like '*SmartAgriCenter*' | Fo | PowerShell 中文路径乱码 | 命令用相对路径;先 cd 再执行;避免 `git -C`/直接写中文文件名 | | **中文 commit message 乱码** | `git commit -m "中文"` 会双编码乱码(GBK→UTF-8)。**改用 `git commit -F <utf8消息文件>`**;已损坏的历史可用 Node 脚本 + `git hash-object -t commit -w` 保真重写(保留 author/committer/时间戳)再 force push | | `npm run dist` 卡死/文件占用 | 挂死的 node/electron-builder 进程未退出 → 先杀进程再删 release(§4) | -| CodeBuddy 删除守卫拦截批量删除 | 用 `[System.IO.Directory]::Delete(dir,$true)` 或 `cmd /c "rd /s /q <dir>"` | +| CodeBuddy 删除守卫拦截批量删除 | 用 `cmd /c rmdir /s /q <dir>`;`.NET API` 写法中的 `$true`/`$_` 会被外层 shell 展开报错,少用 | +| 外层 shell 展开 `$_`/`$true` | 外层命令由 PowerShell 包装执行,`$_` 会被展开 → 改用 `cmd /c dir`、`Where-Object -Filter`、`cmd /c rmdir` 等无变量写法 | | electron 二进制缺失("Electron failed to install correctly") | `node node_modules/electron/install.js`;网络受限先 `$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"` | | 改 main/preload 后不生效 | electron-vite dev 不会自动重启 electron → 杀掉 dev 进程组(npm-cli→electron-vite→electron)重启;仅 renderer 改动走 HMR | | webview 预览高度异常 | 动态创建 webview 需 class+`style.display='flex';height:100%` + 父级 flex 拉伸(三重保险,已修) | +| 缩略图与预览效果不一致 | 原方案主进程新开 1280×720 隐藏窗口截图,视口/尺寸与编辑区 webview 不同 → 改为直接 `wv.capturePage()`(webview 本体截图)→ `img.toPNG()` → IPC `page:compress` 主进程压缩;非当前预览页回退按 URL 截图 | | 打包验证进程名 | 包名即 exe 名「智慧农业大数据可视化控制中心」,用 `Get-Process | Where MainWindowTitle -like '*智慧农业*'` 定位 | | `credential-manager-core` 告警 | 无害,凭据已缓存,忽略 |