Ark-Pets

KO | EN

gitlite — search

#javascript #react #llm #golang #rust #docker #macos #windows #awesome #cli #vue #awesome-list #pytorch #open-source

(★ 1,051)

Arknights Desktop Pets | 明日方舟桌宠 (ArkPets)

Ark-Pets Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center" style="text-align:center">
   <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 | 明日方舟桌宠 (ArkPets) <br>
      <code><b> v3.12 </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>
      <i> This project only supports Chinese docs. If you are an English user, feel free to contact us. </i>
   </sub>
</div>

## 介 绍 <sub>Intro</sub>

### 实现的功能

1. **支持将《明日方舟》角色模型作为桌宠启动。**<details><summary>查看详情</summary>
    现已支持的模型类型包括：
    1. 干员基建小人（含时装）；
    2. 干员动态立绘（含时装）；
    3. 敌方战斗小人。
2. **启动器提供图形用户界面以便浏览模型和调整各种设置。** <details><summary>查看详情</summary>
    1. 可以按名称、拼音、时装品牌搜索，或按类别筛选以查找模型；
    2. 可以从互联网中下载由社区维护的模型库；
    3. 可以自定义桌宠的动作交互、部署位置和物理参数等行为设置；
    4. 可以自定义桌宠的图像缩放、最大帧率和窗口边界等显示设置。
3. **支持模拟游戏内干员基建小人的行为。** <details><summary>查看详情</summary>
    1. 支持行走、坐下和躺下的动作；
    2. 能够被鼠标交互以执行戳一戳动作；
    3. 拥有特殊基建动作的干员，有概率触发这类动作。
4. **支持模拟游戏内敌方小人的行为。** <details><summary>查看详情</summary>
    1. 拥有行走动作的敌人能够行走；
    2. 拥有攻击动作的敌人能够被鼠标交互。
5. **实现了模拟平面重力场** <details><summary>查看详情</summary>
    1. 桌宠支持自由落体等物理现象；
    2. 桌宠可以被拖拽到扩展显示屏上；
    3. 桌宠可以站立在打开的窗口的边缘上。
6. **实现了系统托盘的菜单** <details><summary>查看详情</summary>
    1. 右键托盘图标或者桌宠本体均可弹出菜单；
    2. 菜单可用于开启手动模式和启用透明模式；
    3. 菜单可用于切换多形态角色的形态；
    4. 菜单可用于退出启动器或单个桌宠；
    5. 启动器运行时，已启动的桌宠将被整合到一个托盘中；
    6. 启动器若没有运行，每个桌宠将分别创建自己的托盘。
7. **支持开机自启动等[更多特性](#更多特性)**

### 效果预览图

### 下一步计划

以下内容可能在遥远的将来被实现：

- 国际化与响应布局
- 支持按需下载资源
- 支持干员语音功能
- 全面更新依赖库的版本
- 支持透明模式等配置的记忆

### 相关文档

- 门户网站 > [点击访问](https://arkpets.harryh.cn)
- 更新日志 > [点击查看](CHANGELOG.md)
- 常见问题解答 > [点击查看](docs/FAQ.md)

## 使用方法 <sub>Usage</sub>

|                                                                                             **目前最新版本**                                                                                              |                                  **支持的操作系统**                                  |
|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------:|
| [![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) |

### 快速上手

1. 请[**前往此页面**](https://github.com/isHarryh/Ark-Pets/releases)下载最新的 **ArkPets-Setup.exe** 安装包。
2. 运行安装包并进行软件的安装。安装完成后，打开 ArkPets 启动器。
3. 首次使用时需要**下载模型文件**。请在启动器 “模型” 页面中的 “模型库管理” 面板点击 “下载模型” 按钮。
4. 在启动器 “模型” 页面中检索并选中想要作为桌宠启动的角色，最后点击左下角 “启动” 按钮即可生成桌宠。

> 提示：
> - 如需关闭已启动的桌宠，请右键单击桌宠或系统托盘中的 ArkPets 图标，然后选择 “退出”。
> - 若无法在软件内下载模型，可以访问 [ArkModels 模型仓库](https://github.com/isHarryh/Ark-Models) 页面，手动下载模型压缩包后，在 “模型库管理” 面板点击 “导入压缩包” 按钮后导入模型。
> - 如需将软件从 v2.x 或 v3.x 更新到更高版本，无需预先手动卸载，直接运行新版安装包即可。

### 更多特性

以下列出了 ArkPets 的一些精彩特性，更多内容请在启动器中自行探索。

#### 桌宠相关

- **开机自启动** ：在启动器 “选项” 中可以设置开机自启动，设置后下一次电脑开机会自动生成最后一次启动的桌宠。
- **手动模式** ：托盘菜单中可以开启 “手动模式”，允许用户使用左右方向键来控制桌宠移动，或使用上下方向键来切换桌宠的动作。
- **透明模式** ：为防止用户在游戏、观看视频等情景下误触到桌宠，只需在托盘菜单中打开 “透明模式”，即可屏蔽桌宠和鼠标的一切交互（鼠标操作将穿透到下层窗口）。
- **下边界距离** ：桌宠在部分用户的电脑上无法正常检测任务栏位置（桌宠会沉入任务栏），此时您可以在 “行为” 页面手动设置任务栏高度。
- **高亮描边与阴影** ：高亮描边效果旨在复现游戏中基建系统的角色选中特效，阴影效果则提供了更加立体的视觉体验。在启动器 “选项” 中禁用这两种渲染特效可以降低性能消耗。

#### 启动器相关

- **公告栏** ：点击侧边栏中的 “公告” 按钮即可打开公告栏，用于显示更新日志等帮助信息。每次启动器启动时，如果发现有未读的重要公告，公告栏会自动弹出。
- **模型库联网下载与更新** ：在启动器 “模型” - “模型库管理” 面板中，您可以下载模型库和检查模型库更新。
- **软件更新** ：在启动器 “选项” 页面中，您可以检查软件更新并安装更新。
- **Mirror 酱接入** ：我们从 v3.9 版本开始接入了 [Mirror 酱](https://mirrorchyan.com/)，以提供高速的内容下载体验。

### 高级用法

在[快速上手](#快速上手)中介绍的是最简单和普遍的使用方法。除此之外：

- 您还可以下载 `zip` 版的程序压缩包解压，实现免安装使用。
- 如果您的电脑上存在 `JDK17` 的 [Java](https://www.java.com) 运行环境，您还可以下载 `jar` 版的程序文件直接运行（但无法使用开机自启动功能）。
- 如果您想用命令行启动桌宠，[点击查看](docs/CmdLine.md)说明。
- 如果您想添加自定义的模型，[点击查看](docs/CustomModel.md)说明。
- 如果您想使用直播流软件捕捉桌宠窗口，可以在启动器 “选项” 页面禁用 “桌宠作为后台程序启动”。

目前本程序不支持在其他操作系统运行。好消息是，对于 MacOS 和 Linux 的支持已处于开发阶段，敬请期待。

## 关 于 <sub>About</sub>

### 鸣谢

感谢所有曾经为 ArkPets 的开发提供过各种形式的帮助的个人和组织。

- 另见 [鸣谢和第三方库说明](docs/Credits.md)

### 许可证

### 参与贡献

您可以通过提交 [Issues](https://github.com/isHarryh/Ark-Pets/issues) 等各种方式参与本项目的贡献。 提交 Issues 前，请确认您的议题与已有的议题不重复。提交 Issues 时，请您完整地填写议题模板。

- 另见 ~~很久没更新的~~ [开发者 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">
    <p><i>GitHub 历史星标图</i></p>
    <a href="https://starchart.cc/isHarryh/Ark-Pets">
       <img alt="Stars Chart" src="https://starchart.cc/isHarryh/Ark-Pets.svg?variant=adaptive">
    </a>
</div>

Ark-Pets

Ark-Pets Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Ark-Pets

Ark-Pets Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README