dsh-pet-indesktop

项目概述

dsh-pet 是一款跑在桌面上的透明桌宠应用，脱离 DSH 运行时独立运行：无边框置顶、可拖动、多角色 WebM 动画（106 段高清素材）、系统托盘，Chat 版还带 AI 对话。它跨 Windows、macOS（Apple Silicon）与 Linux（x86_64），当前版本 v4.3.4，Windows 提供安装包与绿色 zip 两种形态。

项目	内容
平台	Windows、macOS arm64、Linux x86_64（另有 Android 本地测试版）
技术	Python 3.10+、PySide6
版本	v4.3.4（2026-10-19）
素材	106 段 WebM 动画

一只养在屏幕右下角的桌宠，托盘叫回、开机自启、还能陪你聊天。

主要功能

• 桌宠本体：透明无边框置顶窗，可拖动，支持跨屏拖拽与边缘探头
• 动画播放：106 段高清 WebM 素材，动画随互动切换
• 角色切换：多角色自由切换，动画素材按角色组织
• AI 对话（Chat 版）：Chat 版加载聊天子系统，无 Chat 版不携带 AI 依赖包体更小
• 系统托盘：托盘图标常驻，双击显示/隐藏，右键菜单管理设置与开机自启
• 全局快捷键：三个动作可绑全局快捷键（默认不绑），设置页支持 Ctrl+F 搜索
• 开机自启：Windows 写注册表 Run 键，macOS 生成 LaunchAgent，Linux 写 autostart
• 鼠标穿透：可开启穿透模式，桌宠不挡桌面操作

快速上手

1. Windows 从 Releases 下载 setup.exe 双击安装（默认装到 %LOCALAPPDATA%，无需管理员），或下载绿色 zip 解压即用
2. macOS 下载 arm64 zip，解压后右键 .app 选「打开」绕过 Gatekeeper，或执行 xattr -dr com.apple.quarantine
3. Linux 解压 zip 后运行二进制，Debian 系先装 libxcb-cursor0、fonts-noto-cjk 等依赖
4. 找不到桌宠时看系统托盘，双击图标即可显示或隐藏

系统要求

项目	要求
Windows	安装包与便携 zip，用户目录安装无需管理员
macOS	Apple Silicon（arm64），Intel 需从源码运行
Linux	x86_64，建议 X11 桌面，Wayland 可试 QT_QPA_PLATFORM=xcb
源码运行	Python 3.10+，pip install -r requirements.txt 后执行 python -m pet

注意事项

• 两个版本怎么选：要 AI 对话装 Chat 版，只要桌宠装无 Chat 版，两者用同一套 WebM 素材
• 自启被清理：安全软件可能清掉未签名程序的自启项，程序会自检并在下次启动时气泡提醒
• DPI 已知问题：Windows 11 加 150% DPI 下桌宠不可见的问题（issue #286）尚未定性修复
• GIF 变体停发：约 800 MB 的旧 GIF 单文件版不再默认发布，需要可按 docs/ONEDIR_PACKAGING.md 自行构建