CHANGELOG.md

更新日志 / CHANGELOG

v3.11

新增
#152 ce00662	新增了可以通过命令行选项 --config 来载入特定的配置文件的功能。
#142 92ce842 669f3b1	新增了基于马尔可夫矩阵的动作行为机制，现在动作的切换将更加自然。
0408a2b	新增了可以调节桌宠的交互式朝向翻转的触发条件的功能，现在可以让桌宠在拖拽时或光标掠过时翻转朝向。

修复
55b30b8	修复了使用 Windows 安装包更新软件后存在残留文件的问题。
2edb6f9	修复了在特定的窗口边界计算方式下，部分模型无法正常启动的问题。

优化
25f3ff7	优化了调试性截图的绘制与保存逻辑。
#158 14f007f	优化了启动器界面中列表视图（ListView）的交互体验。
604ff70 3a7ddb2	升级了 fastjson2 和 opencc4j 依赖库的版本，并移除了某些残留的依赖库。
#159 a8829c4 823b904	将 Gradle 版本从 8.1 升级到 8.14，并移除了过时的 Gradle 脚本语法。
1c7200d	优化了 GitHub Actions 的 build 工作流脚本，并升级了其依赖项版本。

补丁
v3.11.1 deedced	修复了此版本引入的由阶段过滤问题导致的个别多阶段的敌方模型无法正常启动的问题。
v3.11.1 69ef274	修复了之前版本中的阶段名称前导零适配问题导致的个别多阶段的敌方模型无法正常启动的问题。

v3.10

新增
#131 9488a85	新增了可以在导出日志对话框中选取 JVM 崩溃日志的功能。
#136 93d4ff8	新增了可以通过 JVM 选项 -Darkpets.usesystemfont 来控制是否在启动器中使用系统字体的功能。
#117 19d5fd7	新增了允许播放具有多阶段的敌方模型的攻击动作的功能（开放性测试）。
796167b	新增了默认启用 Angle 原生渲染模式的功能（开放性测试）。
4d4b10d	新增了可以在模型详情区域点击 Wiki 按钮快速跳转到对应角色的 Wiki 网页的功能。

修复
1b73f80	修复了在 Mirror 酱 CDK 失效时，下载模型库的逻辑不正确的问题。
6bd28d3	修复了当模型骨骼的 MeshAttachment 路径名称包含尾随空格时，无法加载模型的问题。

优化
#133 22cf0ca	优化了桌宠鼠标穿透的实现方式，现在采用 GLFW 提供的原生穿透。
#133 3fdad5d	优化了设置桌宠窗口位置的调用逻辑，减少了桌宠静止时的性能开销。
ae17135	将 JavaFX 库升级到了 17.0.15。
#139 86c0189 36ffc79	优化了启动器界面中列表组件（例如模型列表和公告列表）的性能开销。
#141 df89573	优化了启动器界面中滚动面板（ScrollPane）的交互体验。
#140 272e821	优化了启动器界面的渲染缓存，缓解了界面卡顿问题。
#146 17d406a	优化了隐藏系统托盘图标的实现方式，现在采用 ITaskbarList 提供的底层实现。
60be366 59469b8	优化了加载骨骼文件的实现方式。

v3.9

新增
#109 #113 4d35feb	新增了手动模式，可在托盘菜单中开启，允许用户使用键盘来手动控制桌宠的移动和动作。 移除了原先的保持动作功能（已被取代）。
fd45fe6 8e729ad	新增了在长时间未操作时自动降低桌宠帧率的可选功能。
#123 677cd4f	新增了专门的日志对话框，用于快捷地选取日志进行导出。
#124 0ab4a0a	新增了可以选择下载策略的功能，用户可以从公共源和 Mirror 酱之间进行下载源切换。 新增了可以利用 Mirror 酱进行模型库下载和检查更新的功能。
#126 b874313	新增了可以调整桌宠的行走速度的功能。
#67 ec1f6dd	新增了可以在启动器内直接更新软件的功能。

修复
#126 51b7806	修复了在特定情况下，桌宠在被鼠标拖拽后会原地消失的问题。

优化
#113 8ccef37	移除了 --enable-snapshot 命令行参数，现在使用 --debug 替代。
#113 4d35feb f6a9c64	优化了桌宠输入控制模块的代码逻辑。
f5b0d9e 601f522	优化了网络模块的代码逻辑。
#125 e0f2dce	优化了日志模块的安全性，现在采用的是 reload4j 日志库。

补丁
v3.9.1 76464f9	修复了桌宠在行走到屏幕边缘时会频繁翻转的问题。
v3.9.1 e7e0ac3 c4e0f40	修复了桌宠所处的显示器断开连接时，桌宠会消失的问题。
v3.9.2 cd34faa	修复了软件内更新可以被 zip 版本用户触发的问题。
v3.9.2 5294d91	修复了软件内更新完成后，程序未重启的问题。

v3.8

新增
#110 aae19a7	新增了可选的 Angle 原生渲染模式（默认禁用）。 新增了对于 OpenGL ES 着色器的支持。
#110 a1150e4	新增了可选的 MipMap 抗锯齿功能（默认启用），用于消除桌宠在小分辨率渲染时产生的锯齿。
#112 1a45efc	新增了启动器界面的 Toast 组件。
#112 026a8b5	新增了启动器中导出最近日志的一个便捷按钮。

优化
a41e489	优化了启动器中的渲染设置的排列方式，现在采用 TabPane 进行标签页分组式的展示。
#116 49d13b6	优化了桌宠的窗口边界计算方法，显著提升了窗口边界的准确度。
0b2d11e	优化了某些设置项的默认值。FPS 默认值从 30 修改为 60，动作活跃度默认值从 8 修改为 4。

v3.7

新增
#106 aebb7f7 8f138cc	新增了公告栏功能，可以从服务器获取公告信息并显示。 新增了适用于 JavaFX 的 Markdown 文档渲染支持。
c797fb0 83979e6	新增了公告的已读状态记录功能。 新增了在重要公告未读时会强制弹出公告栏的特性。

修复
#76 08b1bdb	彻底修复了部分桌宠的缝合线问题（必须同时更新模型库才能应用修复）。
3f43cac	修复了在系统屏幕缩放不为 1.0 时，滚动面板（ScrollPane）中的内容显示不清晰的问题。
51b04c7	修复了个别具有多形态的敌方角色无法切换形态的问题。

优化
1b3d05d	优化了临时文件的占用开销，现在会在启动器退出时主动删除较旧的临时文件。
344713c	优化了着色器的少许计算性能开销。
60e330b	优化了单选框和下拉框组件的鼠标指针表现。

补丁
v3.7.1 3d4fd7d	修复了公告 Markdown 渲染发生乱码的问题。 修复了不带显式对齐属性的 Markdown 表格列无法被解析的问题。
v3.7.1 00a6f0a	修复了特殊情况下公告栏无法被正常关闭的问题。

v3.6

新增
#20 aebb7f7	新增了对干员基建模型躺下动作的支持。 新增了可以开启或关闭躺下动作和基建特殊动作的行为选项。
#88 #99 a43d795	新增了依据角色名称的汉语拼音的全拼或首字母来搜索模型的功能。
#99 ce3051d	新增了中文简体与繁体互通搜索的功能。
#99 90f0660	新增了依据时装品牌名称来搜索模型的功能。
e06dc6d	新增了可以渲染桌宠阴影的功能，并可以自定义阴影的强度。

修复
c95768a	修复了部分角色在进行坐下动作时，窗口上边界表现异常的问题。

优化
35d4d74	优化了缓动函数设置的选项显示，并增加了相关说明。
#99 a43d795	优化了搜索模型时的搜索结果排序规则。
c277dae	优化了桌宠的渲染偏移（OffsetY）参数，使得某些额外内容得以正常显示（例如对角色脚底的高亮描边）。

v3.5

新增
#86 e998e4a 7042699	新增了收藏模型的功能，现在可以对模型进行收藏并在列表中单独显示它们。
88ffa1e	新增了启动器界面的窗口圆角和窗口阴影，使得启动器的外观更加现代。
#90 8183242 a38e737	新增了命令行选项 --load-lib 用于载入外部库。
#93 16b34aa	新增了命令行选项 --enable-snapshot 用于启用调试性截图。
c36ec5e f5c09bd	新增了可以调节桌宠的动画交叉过渡时长等过渡设置的功能。
97095c9	新增了启动器模型页面的列表中“没有符合条件的模型”时的一个提示。

修复
#91 #92 dadba6d	修复了特定运行环境下由 Java Access Bridge 导致的软件崩溃问题。
aeed07c	修复了特定情况下因物理解算溢出而导致的桌宠异常浮空或位置卡死的问题。
47798fe	修复了个别敌方角色因预渲染检查未通过而无法启动的问题。

优化
1072550	优化了缓动函数的代码逻辑。
82a5cee	优化了高亮描边的过渡方式，使之表现得更加自然。

v3.4

新增
#83 c235a25	新增了基于 LNK 的自启动，取代了原来的基于 VBS 的自启动。
f89be4b	新增了当缩放倍率的设置值较大时的提示。
2a4de72	新增了“图标-弹窗”样式的选项警告提示，取代了原来的常驻式的选项警告提示。

修复
#81 #82 adb1b02	修复了特定情况下由于骨骼未重置导致的动画错位或扭曲的问题。
40a1d1f	修复了在较大缩放倍率下桌宠尺寸会被强制裁切的问题。

优化
a7db4b0	优化了高亮描边特效在锐利边缘处的表现，现在采用了新的边缘检测滤波器。
71b525c	优化了透明缝合线填充在较大缩放倍率下的表现。

补丁
v3.4.1 #89 0d2e6b6	修复了透明缝合线填充生效异常的问题。 修复了在 NVIDIA 显卡下角色发生白色线条闪烁的问题。

v3.3

新增
b34592f 91919e5 b8fbef1	新增了可以渲染桌宠高亮描边的功能，并可以自定义开启条件、描边颜色和描边宽度。
#78 44401ff	新增了可以渲染桌宠背景颜色的功能，以满足绿幕等特殊需求。
#71 cdb6a6f	新增了可以自定义角色在正常模式和透明模式下的不透明度的功能。

修复
#75 fb4fd87	修复了不支持 JSON 格式的骨骼文件的问题。
14ceaa6	修复了启动器在提示框弹出时无法与标题栏交互的问题。
#76 62f0012	缓解了角色的 Spine 组件拼合部位的透明缝合线现象。
#79 50467bf	修复了在特定情况下由于第三方程序干扰端口握手而导致的桌宠异常退出的问题。

优化
3399c76	优化了渲染时图像缩放的处理方法，现在采用骨骼缩放，而不是视窗缩放。
#78 444e720	优化了渲染时不透明度的处理方法，现在由着色器实现，而不是窗口系统实现。

v3.2

新增
#63 #70 6cbf7b2	新增了在启动器抛出错误时的导出日志按钮。
1bef435	新增了可以设置桌宠的初始部署位置的功能。
#68 1af28e6	新增了可以选择禁用将桌宠作为后台程序启动的功能。
c7591f2	新增了可以选择禁用将桌宠作为置顶窗口启动的功能。

优化
#62 0f48bc0	优化了部分显示设置项，已额外支持 2.5/3.0 倍的图像缩放和 120 帧的最大帧率，并且当设置的帧率高于显示器刷新率时会显示提示。
fd880ee	优化了 GitHub Actions 脚本的依赖项版本。
5117eca 9cf0b76	优化了线程池和窗口标题相关的代码逻辑，避免了某些潜在的鲁棒性问题。
fcb5111	优化了配置文件相关的代码逻辑，避免了在字段值缺失时默认填入空值或零值导致的鲁棒性问题。

v3.1

新增
cccb494	新增了启动器在被最小化、呼出或关闭时的窗口级别的动画效果。
#37 6c4665b	新增了可以设置桌宠窗口边界的相对大小的功能。

修复
#4 93d6975 c0c6333	缓解了部分多形态敌人的窗口边界过大的问题，现在会在阶段形态切换时自动调整窗口边界。 缓解了角色的渲染超出窗口边界的问题，现在已增加预渲染采样时所用的帧数量。
762970f	修复了在特定情况下交互动画会被其他动画提前覆盖的问题。
0ec49d5	修复了在特定情况下鼠标右键的竞态操作导致的桌宠程序忙等待（无响应）的问题。
686b2b8	修复了某些操作发起的集成托盘通信会发生重复的问题。

优化
93d6975 c0c6333	优化了窗口边界计算和摄像机配置的代码逻辑，扩增了窗口边界的最大尺寸。
850f40d	优化了启动器中部分下拉框设置项的显示逻辑。
d3a6ae5	优化了启动器模型页面的性能消耗。

v3.0

新增
#40 #59 #60 3253706 7b2e856	新增了集成托盘功能和 Socket C/S 通信架构，现在可以通过一个集成托盘来管理已启动的桌宠。 新增了启动器单实例化的特性。
#28 ff82a1e 17ceb23	新增了标签筛选功能，现在可以通过选择角色标签来筛选模型列表。
ff82a1e	新增了可以导出模型仓库的压缩包的功能。 重构了模型页面，并将模型下载等功能集成为了模型库管理面板。
ff82a1e	新增了内置的启动器窗口标题栏，取代了默认的系统标题栏，以使观感更加统一。 新增了启动和退出启动器的闪屏画面。
938ecbb 903fb96	新增了鼠标点击透明区域后，鼠标事件可以传递到某些下层窗口的功能。
741cf00	新增了关闭启动器界面时的确认弹窗。 新增了支持设置是否在退出启动器的同时退出已启动的桌宠的功能。
#57 741cf00	新增了模型库管理中的一个帮助链接。
0672739	新增了应用于桌宠位置和图形变换的三次缓入（EaseOutCubic），取代了原来的线性缓动（Linear），以使观感更加丝滑。
72784a6	新增了对包含动态立绘的模型库的兼容性支持。

优化
d47e424 e1e5439 12742d9	优化了启动器界面的样式表，统一了复选框和滑动条组件的配色，微调了部分配色的颜色值。
3d86cf6	微调了网络连接超时的时间阈值。
f261c35	优化了数据集不兼容的提示的显示逻辑和位置。

v2.4

新增
4754554	新增了在下载对话框中显示下载速率的功能。
1eb6c08	新增了模型库下载源 ghproxy.harryh.cn，取代了原来的 ghproxy.com。
a5c7b9a	新增了可以导入模型仓库的压缩包以加载模型的功能。 新增了一些启动器页面跳转逻辑。
727a34e	新增了启动器的网络代理设置项。

修复
cb06cba	修复了启动器内弹出的对话框在关闭时未播放关闭动画的问题。

优化
cb06cba	重构了启动器前台任务的代码逻辑。
1eb6c08	优化了控制台日志，输出流与错误流相分离。
#52 #55	优化了自动化构建，在 GitHub Actions 新增了 build 工作流。
3b8f5fc abc4743	修订并公布了代码检查规则。
f6139c3	重构了模型资源的代码逻辑。
#47 7db99c3	优化了 Windows 安装程序的默认安装目录和在控制面板卸载页面中的表现。

补丁
v2.4.1 f2683f9	修复了首次启动桌宠后的提示弹窗未生效的问题。
v2.4.2 5e15d00	修复了渲染《明日方舟》2.1.41 及以后的新模型时 Alpha 图层表现异常的问题。

v2.3

新增
a31afcf	新增了右键桌宠本体即可弹出菜单的功能。
17d3fde	新增了可以在菜单中切换桌宠形态的功能，现在可以切换拥有多个形态的敌方领袖的形态。

修复
#39 87c2263	进一步修复了有概率出现桌宠本体程序在任务栏中无法隐藏的问题。
17d3fde	进一步修复了个别敌方角色的部分动作的选择逻辑异常的问题。 重构了动画名识别和行为控制系统。
#48 b72421a	修复了桌宠在保持坐下动作时拖动会导致异常浮动的问题。 重构了缓动控制系统。

优化
0fb103c	优化了 Windows 安装程序的语言本地化（修订了简体中文，新增了繁体中文）。
a31afcf	优化了托盘菜单的外观表现。
e046e1c	优化了动画队列的代码逻辑。

补丁
v2.3.1 7a161d3	修复了桌宠的行走动作表现异常的问题。

v2.2

新增
225463d	新增了验证模型资源完整性的功能。
39c89a8	新增了物理引擎参数调整的功能，现在可以自定义环境加速度、最移速等参数。
8de6ff2	新增了提示条组件，用于软件更新提示、数据集不兼容提示、存储空间不足提示。

修复
#39 e54c6ed	修复了有概率出现桌宠本体程序在任务栏中无法隐藏的问题。

优化
557c09a	优化了模型资源列表的代码逻辑，移除了不安全的泛型用法。
39c89a8	优化了滑动条的外观和代码逻辑，添加了数值后单位的显示。
3f713ae 7da5bbf	优化了模型资源管理的代码逻辑，适配了新版的模型库格式。 变更了配置文件中的部分字段。

补丁
v2.2.1 2d76421	修复了个别敌方角色的部分动作的选择逻辑异常的问题。
v2.2.1 9c0edf9	优化了提示条组件的外观和鼠标指针表现。
v2.2.1 6fbcac2	优化了按钮和侧边滚动条的鼠标指针表现。

v2.1

新增
#4 5d024f9	新增了对多显示屏的支持，现在可以将桌宠拖拽到扩展显示屏上。 重构了重力场系统。
627d16d	新增了首次启动桌宠后的一个提示弹窗。
04a459c	新增了思源黑体作为启动器界面的字体，不再使用系统默认字体，解决了部分设备上的字体渲染问题。
2aef47e	新增了当软件有可用更新时，自动高亮显示“检查更新”按钮的特性。

修复
352eca6	修复了在特定情况下打开启动器卡在 Loading 界面的问题。
86d7227	修复了个别敌方角色的部分动作的选择逻辑异常的问题。

优化
86a5450	将 Java 版本从 JDK20 降级到 JDK17，以防止在特定情况下发生 JVM crash。
352eca6	优化了模型下载源选择的逻辑，现在会将发生过错误的下载源列入低优先级。

补丁
v2.1.1 f35f678	移除了配置文件中的无用字段。
v2.1.1 da9e067	修复了进行“检查模型库更新”操作时，所有已启动的桌宠会异常退出的问题。 启动器中以“GitHub 仓库”替换掉了“开源信息”超链接。
v2.1.1 #34 1e231c9	修复了在多显示器的屏幕边缘未对齐的情况下，桌宠可以异常进入非屏幕区域的问题。

v2.0

新增
95e6a1a 2471d2a 95186b6 f92eb75	新增了全新的启动器界面，使用 JavaFX 重构了所有的 UI 。 新增了按照关键字搜索模型、随机选取模型的功能。 新增了联网检查模型库更新、联网下载模型的功能。
fd185fe	新增了由 @Auroal-dawn 绘制的全新的软件图标。
99af0a7	新增了命令行日志等级可选参数 。
#4 #12 b6ef359	新增了可重复启动桌宠的特性，现在启动器不会在启动单个桌宠后立即关闭，可以多次启动桌宠。
bdea621	新增了将绝大多数敌方模型作为桌宠启动的功能。
a6be480 8860930	新增了自动选择模型库下载源的功能。
01e962e 23dc3cc	新增了在桌宠启动失败后弹出错误提示的功能。
c0c3c33 5b5970c	新增了按照角色类型筛选模型的功能。
#4 23dc3cc	新增了开机自启动的功能，现在可以在开机时自动生成上一次启动的桌宠。 新增了加载中页面，UI操作更加舒适。

修复
#4 4aa567b 99423d4	缓解了角色的渲染超出窗口边界的问题。

优化
2bc0079 48ef339	优化了 Spine 运行时库的引入方式，从源码内置更改为 Gradle 引入。 优化了开发所用的 IDE ，从 VScode 更改为 IntelliJ 。
afa9b03 a134dd4 abc3cad	优化了软件分发与自动化构建，现在分发的二进制文件包括 exe zip jar 。运行时映像的打包方式从 exe4j 更改为 jlink+jpackage。
fa866d1 8860930	优化了日志系统，现在会自动写入日志到文件中，并且可记录日志等级。
bf904b7	微调了干员基建小人和敌方小人切换动作的随机触发权重。
c9866a1	将 Java 版本从 JDK18 升级到 JDK20 ； 将 Gradle 版本从 7.5 升级到 8.1 。

补丁
v2.0.1 21f2eba	进一步缓解了角色的渲染超出窗口边界的问题。 修复了特定情况下日志系统逻辑不正确的问题。
v2.0.1 f6e87f9	优化了托盘图标标题，现在标题包含角色名称。 变更了配置文件中的部分字段。

---

v1.6

新增

1. a4267c6 新增了重力场系统对于点电荷静电斥力的支持。
2. #19/a4267c6 由上一条实现：新增了多个小人重叠时可以被排斥开的特性。
3. 40a57e7 新增了可操作的任务栏托盘图标。
4. #9/40a57e7 新增了右键托盘图标可锁定小人当前动作的功能。

修复

1. 4954639 修复了在小人靠近屏幕左侧时无法站立在窗口上的问题。

优化

1. 3fd0d36 启动器中以“帮助”按钮替换掉了原来的“使用手册”按钮。
2. #3/4954639 任务栏常驻程序窗口现在可以隐藏；桌宠可以跨桌面显示。
3. 优化了悬空状态和落地状态触发相关动作的判定阈值。

---

v1.5

修复

1. #15/afa7bb9 修复了小人在窗口上缘与屏幕上缘距离小于应用高度时显示异常的问题。
2. #13/61908a0 修复了在部分设备上由内存抖动引发的卡顿问题，大幅度降低了性能消耗。

优化

1. 67a0c66 不再以较高频率获取窗口句柄，一定程度降低了性能消耗。
2. 67a0c66 不再在非必要时重设窗口的位置，一定程度降低了性能消耗。
3. 优化了小人的缩放相关常量，略微缓解了小人图像超出窗口边界的问题。
4. 优化了小人的自定义缩放设置项，已额外支持 0.75/1.25/1.5 倍的图像缩放。

补丁

1. v1.5.1/#12/d5f0bf0 新增了命令行启动参数 --direct-start 用于直接启动桌宠而不打开启动器。
2. v1.5.1/c996b38 修复了不支持一星小车的基建小人模型的问题。
3. v1.5.2/#19/76e6883 新增了小人自动行走至窗口边缘后翻转朝向的特性。
4. v1.5.2/#19/a7eba09 新增了抛出小人后，使小人立即面向抛掷方向的特性。

---

v1.4

新增

1. ae979eb 新增了重力场系统对于一维障碍物的支持。
2. d31f49b 由上一条实现：新增了小人可以站立在打开的窗口的顶部的特性。

修复

1. aeed29a 修复了基建小人的 Sit 动作的渲染偏移受图像缩放的影响被放大的问题。
2. #10/aeed29a 修复了基建小人的 Sit 动作的窗口垂直位置不能低于屏幕下边界，导致在某些情况下浮空的问题。

优化

1. 不再使用 EVB 封装 exe 版的Release，现在采用 InnoSetup 来封装 exe。
2. 微调了重力场系统的质点最大速度限制。
3. 微调了重力场系统的质点完全失重判定规则。

---

v1.3

修复

1. #3/9648fe3 修复了模型在空中自由落体时开始行走会使其做匀速直线运动的问题。
2. #5/9648fe3 修复了小人在空中被右键后不会落下的问题。
3. #2/feaa6fa 修复了基建小人在 Sit 和不可打断动作 (例如 Special ) 同时进行时，窗口的垂直位置表现不正常的问题。
4. feaa6fa 修复了基建小人的 Sit 动作的窗口垂直偏移值不受图像缩放影响的问题。
5. #3/bcbe4cb 修复了多个模型堆叠时持续闪烁的问题。

---

v1.2

新增

1. ff15314 新增了摔落动作，以搭配平面重力场使用，同时也移除了拖拽结束动作。
2. 11b0977 新增了平面重力场系统的模拟实现。
3. 11b0977 新增了主页面的“下边界距离”调节滑块。

---

v1.1

新增

1. 4603ab0 新增了主界面的“使用手册”按钮，点击后可跳转到 GitHub 仓库主页。

修复

1. ff79dbd 修复了基建小人在 Interact 和 Sit 同时进行时，窗口的垂直位置表现不正常的问题。
2. ff79dbd 修复了窗口可以离开屏幕右下边界的问题，现在窗口将被严格限制在屏幕内。