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* 临时目录；配置、日志与功能缓存仍会正常写入数据目录。
- 各版本摘要与历史见 版本与变更历史。
目录
下载与版本选择
正式发布时请以 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-<webm-chat|webm>-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）
- 下载：选择
dsh-pet-standalone-webm-chat-setup.exe（或无 Chat 版）放到任意位置。
- 双击运行：如果出现 Windows SmartScreen 提示，点「更多信息 → 仍要运行」（软件尚未购买代码签名证书）。
- 选择语言：向导默认简体中文，也可切换 English，点「下一步」。
- 选择安装目录：
- 默认目录为
%LOCALAPPDATA%\Programs\dsh-pet-standalone-webm-chat（当前用户目录，不需要管理员权限）；
- 想装到其他盘符（如
D:\、E:\），点「浏览」自己选一个目录即可。
- 附加任务：可勾选「创建桌面快捷方式」（默认不勾选）。
- 完成：勾选「运行 dsh-pet-standalone-webm-chat」会立即启动桌宠。
- 首次启动：桌宠出现在屏幕右下角；系统托盘出现常驻图标（右键托盘可打开菜单）。
常见问题
- 找不到桌宠了？ 看系统托盘（可能收在「显示隐藏的图标」里），双击托盘图标可显示/隐藏桌宠。
- 想开机自启？ 右键托盘 → 勾选「开机自启」即可（写入当前用户注册表 Run 键，无需管理员）；也可以在「桌宠设置」中开启。
- 自启不生效怎么办：① 安全软件/系统优化工具（360、电脑管家、Defender 等）可能拦截或清理未签名程序的自启项——请到其"开机加速/启动项管理"中恢复；② 程序每次启动会自检：若发现"之前开启过但已被清理"，桌宠会气泡提醒；③ macOS 新版系统需在「系统设置 → 通用 → 登录项」中允许桌宠（勾选时也有气泡提示）。
Windows：绿色版（zip 免安装）
- 下载
dsh-pet-standalone-webm-chat-portable.zip。
- 解压到任意可写目录（例如
E:\dsh-pet\），保持文件夹内结构完整。
- 双击文件夹里的
dsh-pet-standalone-webm-chat.exe 即可运行。
- 删除整个文件夹即完成卸载，不残留任何运行缓存。
绿色版与安装版是同一套 onedir 产物，运行行为完全一致；区别只是安装版多了快捷方式与卸载器。
macOS（Apple Silicon）
- 获取：到 Releases 页面，在对应版本的 Assets 里下载
dsh-pet-standalone-webm-chat-macos-arm64.zip（或无 Chat 版 dsh-pet-standalone-webm-macos-arm64.zip）。若你手上的版本没有附 macOS 产物，请到 Issues 反馈——不要自己去 Actions 页面点构建，那是维护者发布流程的一部分。
- 解压：得到
dsh-pet-standalone-webm-chat.app，可拖入「应用程序」文件夹。
- 首次打开：应用未签名（ad-hoc codesign），Gatekeeper 会拦截——右键 .app → 打开，或终端执行：
xattr -dr com.apple.quarantine dsh-pet-standalone-webm-chat.app
- 数据目录：
~/Library/Application Support/dsh-pet-standalone-<变体>/（各变体相互独立，与 Windows 行为一致）。
- 开机自启：托盘/右键菜单勾选「开机自启」（按变体生成独立 LaunchAgent）。
- 启动 DeepSeek Harness：右键菜单的 DeepSeek Harness 子菜单与托盘菜单的两个启动项都提供「启动 dsh web 界面 / 启动桌面端界面」（桌面端当前仅 Windows 支持，macOS 上点它只会如实提示不支持，不会静默改开网页）。需安装 Node.js（
brew install node）；启动器会自动探测 Homebrew/nvm 等路径并回退 npx @deepseek-ai/dsh。
- 关闭 Dock 图标：在「桌宠设置 → 常规 → 显示 Dock 图标」取消勾选后，Dock 隐藏会彻底生效——隐藏桌宠也不会把 Dock 图标临时唤回；恢复入口是菜单栏托盘图标（显示 / 隐藏、鼠标穿透、桌宠设置）。开启鼠标穿透或关闭 Dock 图标时，桌宠会气泡提示恢复位置。
Intel Mac：当前 CI 只构建 arm64；Intel 用户请从源码运行（见下），或在 Intel 机器上自行构建。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
