# 豆皮独立桌面宠物 App 2.8.2

这是一个可在 Windows 10/11 本地独立运行的桌面宠物，不依赖 ChatGPT，也不需要联网。

## 最简单的使用方法

1. 先完整解压 ZIP，不要直接在压缩包预览窗口里运行。
2. 双击 `install-and-run.cmd`。
3. 安装程序会把应用放到当前用户的 `%LOCALAPPDATA%\DoupiPet2`，并在桌面和开始菜单创建豆皮快捷方式。
4. 以后直接双击快捷方式即可。换电脑时，把整份 ZIP 复制过去再执行一次安装即可。

如果不想安装，也可以在解压后的文件夹中双击 `launch-doupi-2.cmd` 临时运行。

## 怎么和豆皮互动

- 鼠标移到豆皮身上：不触发任何动作，豆皮继续保持当前待机或自动动作，符合它高冷、爱答不理的性格。
- 左键单击豆皮：只会随机玩球或挠一挠，不再触发左右摆头/打招呼动作。
- 按住豆皮拖动：移动到任意位置；松手后会按方向跑几步。
- 右键豆皮：打开完整菜单，可立即指定动作，也可调整自动动作的间隔。
- 右键菜单 → “待机姿态”：可以手动选择“立即坐下并保持”“立即趴卧并保持”“立即团起来并保持”，或切回自动轮换；自动轮换间隔可选 5/10/20 分钟。
- 右键菜单中的“趴下休息”：保留原先的乌龟趴/趴卧动作；它与排便动作完全分开。
- 挠一挠：每次随机抓挠 2–5 下，后腿抬起后连续保持，不会每一下都把脚放下再抬起；挠完后自然收腿并回到坐姿。舔脚动作暂时移除，待有可靠的动作素材后再重新设计。
- 待机：豆皮会在坐着、趴卧和团睡之间慢慢切换，每种姿态约保持 20 分钟；团睡时身体团成紧凑的一团，大尾巴贴着小脑袋，像小狐狸一样。挠头、玩玩具和踱步会自然穿插，不会改变这三个长期待机姿态。
- 便便：会固定出现在尾巴外侧并与身体留出间距，豆皮会向另一侧挪开，不会坐在便便上；可直接单击清理，也会在 25 秒后自动消失。

## 默认自动节奏

- 挠头：默认每 120 秒，可选 120/240/300 秒。
- 玩玩具：默认每 60 秒，可选 60/120/240 秒。
- 小范围奔跑：默认每 90 秒，可选 60/120/240 秒；单次先向左或向右移动约 70–110 像素，再跑回本次出发点，方向会交替，不会持续向一侧漂移。
- 排便：默认每 1 小时，可选 1/1.5/2 小时，采用豆皮真实照片中的后腿张开、身体前倾、尾巴上卷的自然蹲姿。

排便可在右键菜单中切换为“每 1 小时”“每 1.5 小时”“每 2 小时”或“关闭”。其他自动动作也都能独立关闭或调节。动作发生时间相撞时会排队执行，不会叠在一起。

## 2.8.2 的重点改进

- 沿用豆皮 v8 的稳定单帧待机，避免待机动画过快、一直抖动。
- 新增坐姿/趴卧/团睡的长期待机轮换：每种姿态按 5/10/20 分钟设置保持；团睡姿态参考豆皮真实照片，身体团成紧凑的一团，大尾巴贴着小脑袋。
- 使用统一动作调度器，解决多个定时动作互相打断的问题。
- 新增玩球动作：豆皮会追随弹跳的小球玩耍。
- 左键点击改为在玩球和挠一挠之间随机选择，移除不符合性格的左右摆头/打招呼。
- 修正挠一挠：保留后腿连续抓挠和自然收腿，暂时移除不够可靠的舔脚收尾，避免换脸、换肢体和边缘不自然。
- 新增小范围自动奔跑：有方向、有移动过程，并限制在当前屏幕工作区。
- 新增左右交替、原地往返的小跑，每次动作结束都会回到动作开始的位置。
- 重做排便动作：从嗅闻、下蹲、保持到起身，和原来的乌龟趴/趴卧动作分开。
- 调整便便落点到尾巴外侧，生成后豆皮会主动避开，避免后续待机坐到便便上。
- 新增 1/1.5/2 小时可选排便，以及点击/自动清理。
- 移除悬停招呼动作，避免低流畅度动画打扰自然待机。
- 保留透明区域穿透式点击体验：只有豆皮有毛发的像素会响应。
- 保留单实例保护，重复启动不会出现多个豆皮。
- 增加主循环和 WPF 调度异常隔离：单个自动动作出错时会记录调试信息并回到安全待机，避免主窗口直接退出。
- 设置会保存在安装目录的 `settings.json` 中，升级安装时会尽量保留已有设置。

## 文件说明

- `DoupiPet2.ps1`：程序主体。
- `DoupiPet2.vbs`：无黑色命令窗口启动器。
- `assets`：豆皮动画图集与 Codex v2 资源描述。
- `assets/poop-strip.png`：根据豆皮照片制作的独立排便动作条；原 v2 图集中的趴卧行仍保留给“趴下休息”。
- `assets/curled.png`：根据豆皮真实照片制作的团睡待机姿态，尺寸保持为 192×208，并使用透明背景。
- `validate_atlas.py`：不启动程序即可检查主图集、排便条、团睡资源和 v2 资源契约。
- `install-and-run.cmd`：英文安装入口。
- `launch-doupi-2.cmd`：免安装运行入口。
- `debug-doupi-2.cmd`：出现问题时使用，会在当前文件夹生成 `DoupiPet2-debug.log`。
- `CHECKSUMS-SHA256.txt`：文件完整性校验值。

## 说明

“便便”是纯本地的卡通互动效果，不代表健康提醒，也不会产生或上传任何数据。程序不会访问网络，不会读取聊天记录或照片，只会读取本文件夹内的资源和设置。
