Merge pull request #105 from half-nothing/v4.x-vcs

VCS phase merge III
isHarryh · Feb 18, 2025 · 9b1e6aa · 9b1e6aa
2 parents 6f27246 + 9becded
commit 9b1e6aa
Show file tree

Hide file tree

Showing 105 changed files with 4,752 additions and 1,349 deletions.
diff --git a/.gitignore b/.gitignore
@@ -18,7 +18,6 @@ gradle-*-bin/
 out/
 tmp*/
 temp*/
-test*/
 
 # Exclude runtime files
 /ArkPetsConfig.json

diff --git a/.idea/.gitignore b/.idea/.gitignore
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,45 @@
 # 更新日志 / CHANGELOG
 
+## v3.6
+| **新增**                            |                                                       |
+|:----------------------------------|:------------------------------------------------------|
+| [`#20`]<br>[`aebb7f7`]            | 新增了对干员基建模型**躺下动作**的支持。<br>新增了可以开启或关闭躺下动作和基建特殊动作的行为选项。 |
+| [`#88`]<br>[`#99`]<br>[`a43d795`] | 新增了依据**角色名称的汉语拼音**的全拼或首字母来搜索模型的功能。                    |
+| [`#99`]<br>[`ce3051d`]            | 新增了中文简体与繁体互通搜索的功能。                                    |
+| [`#99`]<br>[`90f0660`]            | 新增了依据**时装品牌名称**来搜索模型的功能。                              |
+| [`e06dc6d`]                       | 新增了可以渲染桌宠**阴影**的功能，并可以自定义阴影的强度。                       |
+
+| **修复**                 |                               |
+|:-----------------------|:------------------------------|
+| [`c95768a`]            | 修复了部分角色在进行坐下动作时，窗口上边界表现异常的问题。 |
+
+| **优化**                 |                                                     |
+|:-----------------------|:----------------------------------------------------|
+| [`35d4d74`]            | 优化了缓动函数设置的选项显示，并增加了相关说明。                            |
+| [`#99`]<br>[`a43d795`] | 优化了搜索模型时的搜索结果排序规则。                                  |
+| [`c277dae`]            | 优化了桌宠的渲染偏移（OffsetY）参数，使得某些额外内容得以正常显示（例如对角色脚底的高亮描边）。 |
+
+## v3.5
+| **新增**                                |                                         |
+|:--------------------------------------|:----------------------------------------|
+| [`#86`]<br>[`e998e4a`]<br>[`7042699`] | 新增了**收藏模型**的功能，现在可以对模型进行收藏并在列表中单独显示它们。  |
+| [`88ffa1e`]                           | 新增了启动器界面的**窗口圆角和窗口阴影**，使得启动器的外观更加现代。    |                                      
+| [`#90`]<br>[`8183242`]<br>[`a38e737`] | 新增了命令行选项 `--load-lib` 用于载入外部库。          |
+| [`#93`]<br>[`16b34aa`]                | 新增了命令行选项 `--enable-snapshot` 用于启用调试性截图。 |
+| [`c36ec5e`]<br>[`f5c09bd`]            | 新增了可以调节桌宠的动画交叉过渡时长等过渡设置的功能。             |
+| [`97095c9`]                           | 新增了启动器模型页面的列表中“没有符合条件的模型”时的一个提示。        |
+
+| **修复**                            |                                           |
+|:----------------------------------|:------------------------------------------|
+| [`#91`]<br>[`#92`]<br>[`dadba6d`] | 修复了特定运行环境下由 Java Access Bridge 导致的软件崩溃问题。 |
+| [`aeed07c`]                       | 修复了特定情况下因物理解算溢出而导致的桌宠异常浮空或位置卡死的问题。        |
+| [`47798fe`]                       | 修复了个别敌方角色因预渲染检查未通过而无法启动的问题。               |
+
+| **优化**      |                         |
+|:------------|:------------------------|
+| [`1072550`] | 优化了缓动函数的代码逻辑。           |
+| [`82a5cee`] | 优化了高亮描边的过渡方式，使之表现得更加自然。 |
+
 ## v3.4
 | **新增**                 |                                       |
 |:-----------------------|:--------------------------------------|
@@ -399,6 +439,7 @@
 [`5e15d00`]: https://github.com/isHarryh/Ark-Pets/commit/5e15d000bd77006da596696de2e41024fb4183d4
 
 <!-- Links to v3.x References -->
+[`#20`]: https://github.com/isHarryh/Ark-Pets/issues/20
 [`#28`]: https://github.com/isHarryh/Ark-Pets/issues/28
 [`#37`]: https://github.com/isHarryh/Ark-Pets/issues/37
 [`#40`]: https://github.com/isHarryh/Ark-Pets/issues/40
@@ -417,7 +458,14 @@
 [`#81`]: https://github.com/isHarryh/Ark-Pets/issues/81
 [`#82`]: https://github.com/isHarryh/Ark-Pets/pull/82
 [`#83`]: https://github.com/isHarryh/Ark-Pets/pull/83
+[`#86`]: https://github.com/isHarryh/Ark-Pets/pull/86
+[`#88`]: https://github.com/isHarryh/Ark-Pets/issues/88
 [`#89`]: https://github.com/isHarryh/Ark-Pets/pull/89
+[`#90`]: https://github.com/isHarryh/Ark-Pets/pull/90
+[`#91`]: https://github.com/isHarryh/Ark-Pets/issues/91
+[`#92`]: https://github.com/isHarryh/Ark-Pets/pull/92
+[`#93`]: https://github.com/isHarryh/Ark-Pets/pull/93
+[`#99`]:https://github.com/isHarryh/Ark-Pets/pull/99
 [`3253706`]: https://github.com/isHarryh/Ark-Pets/commit/3253706fde859a316b3e08362dd57adb98c1df8c
 [`7b2e856`]: https://github.com/isHarryh/Ark-Pets/commit/7b2e8562579ebabbb102b40122cf3130463f03bc
 [`ff82a1e`]: https://github.com/isHarryh/Ark-Pets/commit/ff82a1e21ce396c345038b4cb340f10eeca89cf2
@@ -469,3 +517,25 @@
 [`a7db4b0`]: https://github.com/isHarryh/Ark-Pets/commit/a7db4b0e9252e4d08ff1e6e9d4d8b8967ace36bb
 [`71b525c`]: https://github.com/isHarryh/Ark-Pets/commit/71b525c77003175f05dc1805f19d038872846acf
 [`0d2e6b6`]: https://github.com/isHarryh/Ark-Pets/commit/0d2e6b645717707a2c302ae844614c867fce74bc
+[`e998e4a`]: https://github.com/isHarryh/Ark-Pets/commit/e998e4a374ab39424492ce9b1986f0eb35d6e568
+[`7042699`]: https://github.com/isHarryh/Ark-Pets/commit/70426997992a969ae59bb05122d6ca2683d2186e
+[`88ffa1e`]: https://github.com/isHarryh/Ark-Pets/commit/88ffa1eee50531da4427a4e14c55fa315a7e7743
+[`8183242`]: https://github.com/isHarryh/Ark-Pets/commit/8183242e92cafd4fb3b8002f692fc84bb6f529db
+[`a38e737`]: https://github.com/isHarryh/Ark-Pets/commit/a38e737b1911c24fe4ebef46f56c28e0c948e0c3
+[`1072550`]: https://github.com/isHarryh/Ark-Pets/commit/10725500e19a86d902f192b9607cc3f7ef114e4a
+[`16b34aa`]: https://github.com/isHarryh/Ark-Pets/commit/16b34aa38046199ff1c461e5d5f8f2760e311a95
+[`dadba6d`]: https://github.com/isHarryh/Ark-Pets/commit/dadba6da2b1aad68e5937bb6bd739db58c97be56
+[`aeed07c`]: https://github.com/isHarryh/Ark-Pets/commit/aeed07caebf11568cab09691dcfb8a2a7ad09ae2
+[`c36ec5e`]: https://github.com/isHarryh/Ark-Pets/commit/c36ec5e8d65c42a3d07ae8f9957a29bea7d399f8
+[`f5c09bd`]: https://github.com/isHarryh/Ark-Pets/commit/f5c09bdda535c75cdba9039d3d38f7cfba1da1df
+[`97095c9`]: https://github.com/isHarryh/Ark-Pets/commit/97095c9f27505d556d7cacaafb2092e3766552c9
+[`47798fe`]: https://github.com/isHarryh/Ark-Pets/commit/47798fecd17623a18d48c5b92b7246fd02e0b43a
+[`82a5cee`]: https://github.com/isHarryh/Ark-Pets/commit/82a5ceedd48c83ee699a036d316f0e44dee39a77
+[`aebb7f7`]: https://github.com/isHarryh/Ark-Pets/commit/aebb7f7ef035d7800f607ac43346a9af26c5caf9
+[`35d4d74`]: https://github.com/isHarryh/Ark-Pets/commit/35d4d74f6b30140bd8957dcfb679166c3dd78523
+[`a43d795`]: https://github.com/isHarryh/Ark-Pets/commit/a43d7956d2d4ec22418bf38639da38248bfe7d39
+[`ce3051d`]: https://github.com/isHarryh/Ark-Pets/commit/ce3051d78707293a9aad7d6b30ef9fcb68c66519
+[`90f0660`]: https://github.com/isHarryh/Ark-Pets/commit/90f066032122b39619466d8eb98233de44674d73
+[`e06dc6d`]: https://github.com/isHarryh/Ark-Pets/commit/e06dc6db09c8d17a63fc85ebe47ba41b0cabf91b
+[`c95768a`]: https://github.com/isHarryh/Ark-Pets/commit/c95768aa6200b4bf480519d5b467757277d1b122
+[`c277dae`]: https://github.com/isHarryh/Ark-Pets/commit/c277dae858b1e27aeb38712d6e3d090420de3846
diff --git a/README.md b/README.md
@@ -6,12 +6,13 @@
    <h1> Ark-Pets </h1>
    <img alt="ArkPets icon" width="64" src="https://raw.githubusercontent.com/isHarryh/Ark-Pets/v3.x/assets/icons/icon.png">
    <p>
-      Arknights Desktop Pets | 明日方舟桌宠 <br>
-      <code><b> v3.5 </b></code>
+      Arknights Desktop Pets | 明日方舟桌宠 (ArkPets) <br>
+      <code><b> v3.6 </b></code>
    </p>
    <p>
       <img alt="GitHub Top Language" src="https://img.shields.io/github/languages/top/isHarryh/Ark-Pets?label=Java">
       <img alt="GitHub License" src="https://img.shields.io/github/license/isHarryh/Ark-Pets?label=License">
+      <img alt="Code Factor Grade" src="https://img.shields.io/codefactor/grade/github/isHarryh/Ark-Pets?label=CodeFactor">
       <img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/isHarryh/Ark-Pets/build.yml?label=Build">
    </p>
    <sub>
@@ -29,17 +30,17 @@
     2. 干员动态立绘（含时装）；
     3. 敌方战斗小人。
 2. **启动器提供图形用户界面以便浏览模型和调整桌宠设置。** <details><summary>查看详情</summary>
-    1. 可以按名称搜索或按类别筛选以查找模型；
+    1. 可以按名称、拼音、时装品牌搜索，或按类别筛选以查找模型；
     2. 可以从互联网中下载由社区维护的模型库；
     3. 可以自定义桌宠的动作交互、部署位置和物理参数等行为设置；
     4. 可以自定义桌宠的图像缩放、最大帧率和窗口边界等显示设置。
 3. **支持模拟游戏内干员基建小人的行为。** <details><summary>查看详情</summary>
-    1. 能够执行行走和坐下的动作；
-    2. 能够被鼠标交互以执行戳一戳动作；
-    3. 拥有特殊基建动作的干员，有概率执行特殊基建动作。
+    1. 支持行走、坐下和躺下的动作；
+    2. 能够被鼠标交互以执行戳一戳或攻击动作；
+    3. 拥有特殊基建动作的干员，有小概率触发这类动作。
 4. **支持模拟游戏内敌方小人的行为。** <details><summary>查看详情</summary>
-    1. 拥有行走动作的敌人，能够执行行走动作；
-    2. 拥有攻击动作的敌人，能够被鼠标交互。
+    1. 拥有行走动作的敌人能够行走；
+    2. 拥有攻击动作的敌人能够被鼠标交互。
 5. **实现了模拟平面重力场** <details><summary>查看详情</summary>
     1. 桌宠支持自由落体等物理现象；
     2. 桌宠可以被拖拽到扩展显示屏上；
@@ -68,7 +69,8 @@
 
 以下内容可能在遥远的将来被实现：
 
-- 国际化
+- 国际化与响应布局
+- 支持按需下载资源
 - 支持干员语音功能
 - 全面更新依赖库的版本
 - 支持透明模式等配置的记忆
@@ -81,9 +83,9 @@
 
 ## 使用方法 <sub>Usage</sub>
 
-|                                            **[目前最新版本](https://github.com/isHarryh/Ark-Pets/releases)**                                             |                                  **支持的操作系统**                                  |
-|:--------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------:|
-| ![GitHub Latest Release](https://img.shields.io/github/v/release/isHarryh/Ark-Pets?display_name=tag&label=Release&sort=semver&include_prereleases) | ![Windows](https://img.shields.io/badge/7%2B-blue?logo=Windows&label=Windows) |
+|                                                                                             **目前最新版本**                                                                                              |                                  **支持的操作系统**                                  |
+|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------:|
+| [![GitHub Latest Release](https://img.shields.io/github/v/release/isHarryh/Ark-Pets?display_name=tag&label=Release&sort=semver&include_prereleases)](https://github.com/isHarryh/Ark-Pets/releases) | ![Windows](https://img.shields.io/badge/7%2B-blue?logo=Windows&label=Windows) |
 
 ### 快速上手
 
@@ -99,10 +101,13 @@
 
 ### 其他特性
 
+以下列出了一部分额外的功能，更多内容请在启动器中自行探索。
+
 - **检查模型库更新** ：我们的模型库不定期更新，如果您想体验新实装进游戏的模型，可以在 “模型库管理” 面板点击 “检查更新” 按钮。如果提示有更新，则可点击 “重新下载” 按钮来下载模型。
 - **开机自启动** ：进入启动器 “选项” 页面可以设置开机自启动，设置后下一次电脑开机会自动生成最后一次启动的桌宠。
 - **透明模式** ：为防止用户在游戏、观看视频等情景下误触到桌宠，特增加了此模式。在托盘菜单中打开 “透明模式”，即可屏蔽桌宠和鼠标的一切交互（点击、拖动操作都将穿透到下层窗口），并且桌宠会变得透明。
 - **下边界距离** ：桌宠在部分用户的电脑上无法正常检测任务栏位置（桌宠会沉入任务栏），此时您可以手动设置任务栏高度。进入启动器 “行为” 页面可以调整下边界距离，通常会将其设置为15的正整数倍。
+- **高亮描边与阴影** ：高亮描边效果旨在复现游戏中基建系统的角色选中特效，阴影效果则提供了更加立体的视觉体验。在启动器 “选项” 中禁用这两种渲染特效可以降低性能消耗。
 
 ### 高级用法
 
@@ -114,7 +119,7 @@
 - 如果您想添加自定义的模型，[点击查看](docs/CustomModel.md)说明。
 - 如果您想使用直播流软件捕捉桌宠窗口，可以在启动器 “选项” 页面禁用 “桌宠作为后台程序启动”。
 
-由于需要调用 Win32 特有的 API，目前本程序不支持在其他操作系统运行。
+目前本程序不支持在其他操作系统运行。好消息是，对于 MacOS 和 Linux 的支持已处于开发阶段，敬请期待。
 
 ## 关 于 <sub>About</sub>
 
@@ -134,6 +139,16 @@
 
 - 另见 ~~很久没更新的~~ [开发者 Wiki](https://github.com/isHarryh/Ark-Pets/wiki)
 
+### 友情链接
+
+以下项目是 ArkPets 的关联或衍生项目：
+
+- [isHarryh / Ark-Models](https://github.com/isHarryh/Ark-Models)：明日方舟 Spine 模型库
+- [litwak913 / Ark-Pets-Integration](https://github.com/litwak913/Ark-Pets-Integration)：ArkPets 针对其他桌面系统的集成库
+- [fuyufjh / ArkPets-Web](https://github.com/fuyufjh/ArkPets-Web)：ArkPets 在网页渲染器上的独立实现
+- [isHarryh / Ark-Unpacker](https://github.com/isHarryh/Ark-Unpacker)：用于解包游戏资源的实用工具
+- [Aloento / SuperSpineViewer](https://github.com/Aloento/SuperSpineViewer)：用于查看 Spine 模型的实用工具
+
 -----
 
 <div align="center">

diff --git a/assets/ArkPetsConfigDefault.json b/assets/ArkPetsConfigDefault.json
@@ -2,6 +2,8 @@
     "behavior_ai_activation":8,
     "behavior_allow_interact":true,
     "behavior_allow_sit":true,
+    "behavior_allow_sleep":false,
+    "behavior_allow_special":true,
     "behavior_allow_walk":true,
     "behavior_do_peer_repulsion":true,
     "canvas_color":"#00000000",
@@ -24,9 +26,14 @@
     "physic_speed_limit_x":1000.0,
     "physic_speed_limit_y":1000.0,
     "physic_static_friction_acc":500.0,
+    "render_animation_mixture":0.3,
     "render_outline":1,
     "render_outline_color":"#FFFF00FF",
     "render_outline_width":2.0,
+    "render_shadow_color":"#000000BB",
+    "transition_duration":0.3,
+    "transition_type":"EASE_OUT_CUBIC",
     "window_style_toolwindow":true,
-    "window_style_topmost":true
+    "window_style_topmost":true,
+    "window_system":"AUTO"
 }
diff --git a/assets/UI/BehaviorModule.fxml b/assets/UI/BehaviorModule.fxml
@@ -24,6 +24,10 @@
                     <JFXCheckBox fx:id="configBehaviorAllowWalk" mnemonicParsing="false" text="允许行走"/>
                     <JFXCheckBox fx:id="configBehaviorAllowSit" mnemonicParsing="false" text="允许坐下"/>
                 </HBox>
+                <HBox>
+                    <JFXCheckBox fx:id="configBehaviorAllowSleep" mnemonicParsing="false" text="允许躺下"/>
+                    <JFXCheckBox fx:id="configBehaviorAllowSpecial" mnemonicParsing="false" text="允许特殊动作"/>
+                </HBox>
                 <HBox>
                     <Label text="动作活跃度"/>
                     <JFXSlider fx:id="configBehaviorAiActivation"/>
@@ -69,6 +73,23 @@
                     <Canvas fx:id="configDeployPosition" height="150.0" width="150.0"/>
                 </HBox>
                 <Separator/>
+                <Label styleClass="config-group-title" text="过渡"/>
+                <HBox>
+                    <Label fx:id="configTransitionAnimationLabel" text="动画交叉过渡"/>
+                    <JFXComboBox fx:id="configTransitionAnimation" prefWidth="120.0"/>
+                    <JFXButton fx:id="configTransitionAnimationHelp"/>
+                </HBox>
+                <HBox>
+                    <Label fx:id="configTransitionDurationLabel" text="常规属性过渡"/>
+                    <JFXComboBox fx:id="configTransitionDuration" prefWidth="120.0"/>
+                    <JFXButton fx:id="configTransitionDurationHelp"/>
+                </HBox>
+                <HBox>
+                    <Label fx:id="configTransitionFunctionLabel" text="缓动函数"/>
+                    <JFXComboBox fx:id="configTransitionFunction" prefWidth="120.0"/>
+                    <JFXButton fx:id="configTransitionFunctionHelp"/>
+                </HBox>
+                <Separator/>
                 <Label styleClass="config-group-title" text="物理"/>
                 <HBox>
                     <Label text="重力加速度"/>

diff --git a/assets/UI/Main.css b/assets/UI/Main.css
@@ -388,8 +388,6 @@ JFXSlider {
     -fx-border-color: -theme-color;
 }
 
-.config-field {}
-
 .config-field JFXComboBox {
     -fx-font-size: 12px;
     -fx-text-fill: -text-normal;
@@ -477,7 +475,7 @@ ProgressBar:indeterminate>.bar {
 
 #Loading-failure-tip,
 #Loading-waiting-tip {
-    -fx-background-color: #F4F4F4D0;
+    -fx-background-color: #F4F4F4;
 }
 
 #Loading-failure-tip-text {
@@ -493,6 +491,10 @@ ProgressBar:indeterminate>.bar {
     -fx-font-weight: bold;
 }
 
+#Loading-empty-tip>* {
+    -fx-fill: dimgray;
+}
+
 #Title-bar {
     -fx-background-color: -theme-color;
     -fx-background-radius: 8px 8px 0 0;
@@ -521,6 +523,15 @@ ProgressBar:indeterminate>.bar {
     -fx-background-color: #305890;
 }
 
+#Title-minimize-btn-mac,
+#Title-close-btn-mac {
+    -fx-fill: inherit;
+}
+
+#Title-close-btn-mac {
+    -fx-background-radius: 8px 0 0 0;
+}
+
 #Title-close-btn:hover,
 #Title-close-btn:focused {
     -fx-background-color: #CC2211;
-Original file line number
+Diff line change
@@ Expand Up / @@ -18,7 +18,6 @@ gradle-*-bin/ @@
     out/
     tmp*/
     temp*/
-    test*/
     # Exclude runtime files
     /ArkPetsConfig.json
@@ Expand Down @@