v3.1.0

6/5/2026, 2:45:20 PM


3.1 更新内容

主要内容:prg:// 协议链接

https://github.com/user-attachments/assets/7038a2bd-af27-4ae5-9d00-c0cc0f3720b3

URL 格式

prg://<file-path>?param1=value1&param2=value2

参数说明

参数类型必需说明
pathstring要打开的 .prg 文件路径。若不传此参数,则从 URL 的 host + pathname 推断
targetstring实体 UUID,打开文件后自动将相机聚焦到该实体
locationx,y相机位置,两个逗号分隔的浮点数
zoomnumber相机缩放级别

注意targetlocation 是互斥关系。若同时指定了 target,会忽略 location

文件路径解析规则

  1. 绝对路径:以 /(Unix)或盘符(Windows,如 D:/)开头,直接检查文件是否存在。
  2. 相对路径/文件名:不带路径分隔符且非绝对路径时,会在"最近打开文件"列表中搜索匹配的文件名(自动补全 .prg 后缀)。
  3. Windows 兼容:自动处理 /D:/pathD:/path 以及 D/pathD:/path 等格式转换。
  4. 路径会自动做 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键上一个