MerZlin / dsh-pet-indesktop

# dsh-pet-indesktop
一个基于 **Python + PySide6** 的独立桌面宠物。项目脱离 DSH 运行时，提供透明无边框、置顶、可拖动、角色切换、动画播放、系统托盘和可选 AI 对话能力。
> **发布状态**
>
> - **最近正式发布：v4.3.4（2026-10-19）**。Release 永久地址：`releases/tag/v4.3.4`，产物清单与校验值以该页面为准；说明文档见 `docs/RELEASE-v4.3.4.md`。
> - **v4.3.4 换回了「每块屏一张合成窗」**：条件是多块屏**且任一块屏的缩放不是 100%**（并且开着「允许桌宠跨屏」）。原因是 v4.3.3 那张铺满整个虚拟桌面的合成窗只能有一个 DPR：混合缩放下 Windows 按「窗口大部分落在哪块屏」定倍率，必有一侧被按错倍率画到可见区外（#307）；两块屏缩放相同但不是 100% 时，Qt 又对**负原点屏**报「原生原点 + 逻辑宽高」的混合坐标，单窗把这份错位当真，屏与屏之间凭空多出空洞（#310）。每张窗只落在自己那块屏上，这两个坐标问题都不再参与运算。**多块屏缩放全是 100% 时仍是单窗**，行为与 v4.3.3 一致。
> - **v4.3.4 同时修的同类缺陷**（按模式收口，不是单点补丁）：点击台词不朗读（三个读配置的地方都读了主配置，每宠键取不到）、换音色/语速后旧句子永不重合成（缓存键不是实际合成输入的指纹）、待办与报时提醒「气泡没送出却已盖戳」（之后不再补）、帧率采集攒满自己的 ETW 会话（`error 1450`）、跨屏拖过去的位置不落盘（v4.3.3 回归）、每日待办跨午夜漏提醒、副屏右键菜单写主窗控制器等。**新增**：三个动作的**全局快捷键**（设置 → 互动 → 快捷键，默认不绑）与设置页 **Ctrl+F** 直接搜。
> - **跨屏能力已在真双屏上验证**：本机主屏 2560×1440@170Hz + 左侧副屏 1920×1080@60Hz（负坐标）实测跨屏拖拽、边缘探头、设置说明均正常；**混合缩放本机验到 125%**（副屏改 125% 时窗口数翻转、坐标探针对得上），**100% + 150% 这类组合仍未实机验证**——本版按每屏一窗处理，但那条路上的另一个未结案项见下一条。
> - **仍未结案**：issue #286 报告的 Windows 11 + 150% DPI 下桌宠不可见、鼠标整屏失效，原因**仍未定性**，本版不含其修复。
> - 发布形态为 **onedir 目录打包**，Windows 提供 Inno Setup 安装包（`.exe`）与便携 zip：启动时不再像 onefile 那样解包到 `_MEI*` 临时目录；配置、日志与功能缓存仍会正常写入数据目录。
> - 各版本摘要与历史见 版本与变更历史。
## 目录
- 下载与版本选择
- 安装、升级与卸载
- 快速开始
- 功能概览
- 使用教程
- AI 对话使用教程（Chat 版）
- 动画素材与自定义角色
- 配置、隐私与安全
- 已知限制
- 反馈与求助
- 项目来源与素材声明
- 许可证与致谢
- 版本与变更历史
- 开发者与贡献
---
## 下载与版本选择
正式发布时请以 Releases 页面实际上传的文件为准。当前推荐下载的 Windows 产物如下：
| 版本 | 安装包（setup.exe） | 绿色版（zip） | 适合场景 |
|---|---|---|---|
| Chat WebM | `dsh-pet-standalone-webm-chat-setup.exe` | `dsh-pet-standalone-webm-chat-portable.zip` | WebM 高清播放 + AI 对话，功能完整 |
| 无 Chat WebM | `dsh-pet-standalone-webm-setup.exe` | `dsh-pet-standalone-webm-portable.zip` | 只想要桌宠本体，不接入 AI |
选择建议：
- **想体验完整功能（含 AI 对话）**：装 Chat 版。
- **只需要桌宠陪伴**：装无 Chat 版，包体更小、启动更轻。
- **不想安装、追求便携**：用绿色版 zip，解压到任意目录双击即用。
> 两个版本使用同一套高清 WebM 素材（106 段动画），只是入口不同：Chat 版会加载聊天子系统，无 Chat 版完全不携带 AI 对话依赖。
>
> **macOS（Apple Silicon）**：产物为 `dsh-pet-standalone- -macos-arm64.zip`（onedir .app），随 Releases 一同发布，从该页面下载即可；首次打开步骤见下文「macOS（Apple Silicon）」。
>
> **Linux（x86_64）**：产物为 `dsh-pet-standalone-*-linux-x86_64.zip`（onedir 目录，解压即用），同样随 Releases 发布，见下文「Linux（x86_64）」。
>
> **GIF 变体**（旧版那个约 800 MB 的超大单文件，运行时会在 C 盘临时目录解压并可能残留缓存）自 v4.0.0 起不再默认发布；确有需要可按 `docs/ONEDIR_PACKAGING.md` 的说明自行构建。
## 安装、升级与卸载
Android 原生悬浮桌宠已提供本地测试版构建入口，支持 Android 8.0 及以上。
安装、功能边界和构建步骤见 Android 说明，实际验证范围见
Android 交付报告。测试 APK 不作为正式发布附件。
### Windows：安装包（setup.exe）
1. **下载**：选择 `dsh-pet-standalone-webm-chat-setup.exe`（或无 Chat 版）放到任意位置。
2. **双击运行**：如果出现 Windows SmartScreen 提示，点「更多信息 → 仍要运行」（软件尚未购买代码签名证书）。
3. **选择语言**：向导默认简体中文，也可切换 English，点「下一步」。
4. **选择安装目录**：
 - 默认目录为 `%LOCALAPPDATA%\Programs\dsh-pet-standalone-webm-chat`（当前用户目录，**不需要管理员权限**）；
 - 想装到其他盘符（如 `D:\`、`E:\`），点「浏览」自己选一个目录即可。
5. **附加任务**：可勾选「创建桌面快捷方式」（默认不勾选）。
6. **完成**：勾选「运行 dsh-pet-standalone-webm-chat」会立即启动桌宠。
7. **首次启动**：桌宠出现在屏幕右下角；系统托盘出现常驻图标（右键托盘可打开菜单）。
**常见问题**
- **找不到桌宠了？** 看系统托盘（可能收在「显示隐藏的图标」里），双击托盘图标可显示/隐藏桌宠。
- **想开机自启？** 右键托盘 → 勾选