> ## Documentation Index
> Fetch the complete documentation index at: https://openfic.syrizelink.top/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 桌面应用

<Note>
  在 [GitHub Releases](https://github.com/syrizelink/OpenFic/releases/latest) 下载适合你的操作系统和 CPU 架构的安装包
</Note>

## 选择安装包

| 系统 | Intel/AMD 64 位 | ARM 64 位 | 推荐格式 |
| - | - | - | - |
| Windows | `win-x86_64` | `win-aarch64` | `-setup.exe` 安装包或 `.zip` 便携版 |
| macOS | `mac-x86_64` | `mac-aarch64` | `.dmg` 安装包或 `.zip` |
| Linux | `linux-x86_64` | `linux-aarch64` | `.AppImage` 或 `.tar.gz` |

你应该根据系统实际架构选择安装包类型，如果不清楚设备的系统架构，可以按照以下步骤查看：

<Tabs>
  <Tab title="Windows">
    按`win+R`后打`运行`窗口，输入`msinfo32`并回车。

    在打开的系统信息窗口中，左侧点选`系统摘要`后，在右侧找到`系统类型`字段：

    * 基于 x64 ... → 选择`win-x86_64`
    * 基于 ARM ... → 选择`win-aarch64`
  </Tab>

  <Tab title="Linux" />

  <Tab title="MacOS" />
</Tabs>

## 数据和备份

默认情况下，桌面版将项目数据保存在系统用户数据目录，而不是应用安装目录；在安装并使用本地实例时，也可以指定自定义数据目录。

| 系统 | 默认数据目录 |
| - | - |
| Windows | `%APPDATA%\OpenFic` |
| macOS | `~/Library/Application Support/OpenFic` |
| Linux | `~/.config/OpenFic` |

你也可以在桌面端的数据管理页面中迁移、备份或还原数据。

<Warning>
  对于 Windows 版本，建议不要将 **数据/实例目录** 设置在应用安装目录下，否则在执行自动更新时，可能会误清除安装目录下的实例和数据，导致数据丢失。
</Warning>

## 更新

为了确保数据安全，务必在更新前备份数据，以免造成不必要的麻烦。

### 自动更新

<Note>
  仅支持 Windows 版本
</Note>

你可以在页面右上角找`检查更新`按钮，点击后会自动检测是否存在可更新的包体。

在下载完成后，点`重启并更新`后，应用会自动关闭并在后台完成所有更新操作，完成后，窗口会自动打开。

如果使用的是本地实例，那么在启动实例时，会自动识别并更新本地实例至相匹配的版本。

### 手动更新

<Steps>
  <Step title="下载新版本">
    前往 [Github Release](https://github.com/syrizelink/OpenFic/releases/latest) 下载最新与你的系统架构相匹配的安装包
  </Step>

  <Step title="安装">
    完全关闭旧版桌面应用，然后安装或解压新版本至原路径
  </Step>

  <Step title="启动">
    启动应用，等待本地实例完成更新即可
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.