# 桌面版指南

桌面版不需要安装 DSH，玩法和插件版相同，但不会读取真实工作量。

## 安装

在 [GitHub Releases](https://github.com/CLICGGER-TYPES/dsh-piggy/releases/latest) 下载：

- Windows 安装版：运行 `dsh-piggy-setup-*.exe`。升级时可直接覆盖安装。
- Windows 便携版：运行 `dsh-piggy-portable-*.exe`。升级外壳时替换旧 EXE。
- Linux：给 AppImage 执行权限后运行；升级外壳时替换旧 AppImage。
- macOS：按芯片选 arm64 或 x64 DMG，拖入“应用程序”。未签名版本第一次需右键选择“打开”。

Linux GNOME 默认可能不显示托盘图标，可安装 AppIndicator 扩展，也可从主菜单点击“退出”。

## 拖动小猪

按住小猪即可在桌面上拖动，一直拖到屏幕边上都跟着鼠标走。面板是单独一个窗口（桌面外壳 0.6.0 起），贴在小猪上方或下方——哪边放得下就开在哪边；面板展开时也能拖，面板会跟着小猪移动，松开后按新位置重新选打开方向。开关面板、切 App、冒气泡都不会挪动小猪。点到桌面别处时面板自动收起（可在设置里关掉）。

每次启动时小猪停在上次的位置，面板是收起的，右键小猪打开。面板最高 520px，内容多时在面板里滚动。游戏里的 emoji 用内置的 Noto Color Emoji 显示，Windows 10 上也不会出现方框。

## 全屏时

「设置 → 全屏时（玩游戏、看视频）」默认**隐藏小猪**：小猪所在的屏幕上有程序全屏时，猪和面板先收起来，退出全屏再回来；改成**照常显示**则猪压在全屏画面上面（独占全屏的游戏任何窗口都盖不上去）。需要桌面外壳 0.6.5。Windows 靠系统自带的 PowerShell 检测（被禁用时猪照常显示，设置里会写原因）；Linux 需要 xprop，Wayland 下只认得 X11 程序的全屏；macOS 的全屏程序在单独的桌面空间里，选「照常显示」猪才跟进去。猪的置顶被别的程序清掉时，外壳会在 3 秒内抢回来。

在主菜单「设置 → 小猪大小」可选小、标准、大、特大，按当前成长阶段原有大小的 ×0.85、×1、×1.3、×1.7 显示。换档时脚底中心留在原处；选择只存这台设备，不写进猪的存档。

## 存档与 DSH 导入

桌面版和 DSH 插件各自保存一只猪。桌面托盘菜单的“从 DSH 导入猪…”可以选择 DSH 的 `state.json`。该旧入口仅导入 JSON，不包含扩展程序或自定义皮肤文件。更新游戏包和覆盖安装桌面外壳会保留存档。

`0.37.1-rc.2` 预发布新增「设置 → 存档」：导出完整 ZIP，再在另一份 DSH 或桌面存档中选择「导入存档」，检查预览后点击「备份并导入」。它会替换当前猪，原档 ZIP 自动保存在当前存档目录的 `backups` 中；取消预览不会导入。不合并金币、奖励或两只猪，也不自动同步。兼容旧 `state.json`，缺失的资源会在预览中提示。

备份包含养成进度、已验证的官方扩展、已登记自定义皮肤和工作去重收据，不包含日志、接入令牌、代理凭据、窗口位置或本机缩放。ZIP 最多 32 MiB；导入预览最多返回 50 条具体提示，自定义皮肤记录最多 128 个；自定义 `statePath` 时每只猪应使用单独目录，文件名不能叫 `skins`、`extensions` 或 `backups`。

## 更新

主菜单的“更新”App 会检查 GitHub Releases。有新版本时，主菜单显示红色感叹号，小猪也会提示一次。打开更新 App 后，本次提醒立即标为已读；即使暂时不安装，也不会一直显示。同一个版本不会反复冒泡，之后发布更新版本才会再次提醒。

更新 App 会分别显示游戏版本和桌面外壳版本。游戏包可以在 App 内下载、校验、备份存档并切换，也可以回退。外壳 v0.2.0 起，Windows 安装版和 Linux AppImage 可在 App 内下载新外壳并重启安装；Windows 便携版、未签名 macOS 版仍需到发布页下载替换。已安装的 v0.1.x 外壳需要手动升级一次，才能获得外壳自动更新能力。外壳 v0.3.0 起窗口相关的修复都跟着游戏包更新，外壳很少需要再升级。设置 → Emoji 样式可以在内置 Noto 和系统自带之间切换。详情见[更新机制](updates.md)。