v3.1.0
6/5/2026, 2:45:20 PM
macOS
Note
If 'App is damaged' appears, right-click the dmg file in Finder and select 'Open'.Disk Image (.dmg)
13.9 MBHaving issues? Check FAQ3.1 更新内容
主要内容:prg:// 协议链接
https://github.com/user-attachments/assets/7038a2bd-af27-4ae5-9d00-c0cc0f3720b3
URL 格式
prg://<file-path>?param1=value1¶m2=value2
参数说明
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
path | string | 否 | 要打开的 .prg 文件路径。若不传此参数,则从 URL 的 host + pathname 推断 |
target | string | 否 | 实体 UUID,打开文件后自动将相机聚焦到该实体 |
location | x,y | 否 | 相机位置,两个逗号分隔的浮点数 |
zoom | number | 否 | 相机缩放级别 |
注意:
target和location是互斥关系。若同时指定了target,会忽略location。
文件路径解析规则
- 绝对路径:以
/(Unix)或盘符(Windows,如D:/)开头,直接检查文件是否存在。 - 相对路径/文件名:不带路径分隔符且非绝对路径时,会在"最近打开文件"列表中搜索匹配的文件名(自动补全
.prg后缀)。 - Windows 兼容:自动处理
/D:/path→D:/path以及D/path→D:/path等格式转换。 - 路径会自动做 URL 解码(
decodeURIComponent)并去除末尾的/、\。
相机导航行为
- 指定
target:找到目标实体后,调用camera.resetByRectangle()自动适配视口到实体的包围盒。若未找到对应 UUID,弹出警告提示。 - 仅指定
location:将相机移动到指定坐标,缩放重置为1。 - 同时指定
location+zoom:移动到指定坐标并缩放到指定级别。 - 均未指定:保持文件打开的默认相机位置。
图片优化
- feat: 增加图片压缩的设置项
- feat: 优化设置项默认参数
- feat: 增加图片节点生成时,黑白压缩的功能
Linux优化
- feat: 添加Linux运行时设置页面
- feat: 支持在Linux上调整UI缩放
- fix: 修复Linux环境下给Tauri命令传入过大的Uint8Array会报错的问题
- feat: add support for binary data transfer via Latin-1 encoding in IPC
其他优化
- feat: 给Tab组件添加动画
- feat: 增加qf快捷键,让摄像机定位到选中物体但不改变缩放
- fix: 当按键序列中出现后缀相同前缀不同的两个快捷键时,优先触发长度更长的快捷键
- fix: 当出现两个完全一样的快捷键的时候,一起执行。
- fix: 视野缩放过小时,url节点内不渲染文字以提高性能
- fix: 优化整数化渲染文字大小设置开启时的体验
- feat: 添加更完善的手写笔支持
- refactor: 优化右键菜单编辑页面
- feat: ctrl+F搜索框中,按Esc键关闭,enter键下一个,shift+enter键上一个