薄荷桌宠 7AAAAAH/dsh-mint-budgie

DSH Mint Budgie 桌宠

给 DeepSeek Harness（DSH）桌面端使用的悬浮桌宠。它不会在 DSH 窗口里再显示一只，只在 Windows 桌面悬浮，展示当前项目名和正在执行的工作内容。

功能

- 工作状态浮窗固定在宠物旁，深灰半透明、圆角，项目名在上，当前工作内容在下。
- 长工作内容自动横向循环滚动；空闲时不显示“空闲”或任务浮窗。
- 空闲时每隔 30–75 秒随机播放一次动作，间隔和动作都会变化。
- 单击会随机播放歪头、伸头、展翅或挥翅，每个动作都从站立开始并回到站立。
- 每个动作的头部视觉尺度保持一致，位置可按姿势不同；切换时不跳大小。
- 宠物和状态浮窗都会识别每块显示器的工作区：宠物本体不会被双屏分界切割，浮窗靠近边缘时自动避让。
- 双击会打开或收起 DSH 窗口；如果任务浮窗此前被最小化且任务仍在进行，也会同时恢复。
- 右键打开设置或隐藏宠物。
- 设置支持宠物大小、透明度、滑杆和数值输入，窗口本身可调整大小。
- 支持双屏及不同缩放比例的 Windows 虚拟桌面，宠物可以拖到另一块屏幕。
- 拖动后松手会自然下落；快速甩动会带速度飞出，并受重力、空气阻力、墙面反弹和地面摩擦影响。
- 宠物飞行时任务浮窗暂时隐藏，停止并落地后自动恢复。
- 所有精灵帧共用同一条脚底线，落地不会悬空，也不会裁掉低姿态帧。
- 展翅和挥翅直接使用完整原图，不裁切、不旋转翅膀，脸和身体不会混帧。

开发计划

拖动、甩出、落地回弹、状态互动和轻量化路线见 开发计划。

安装

从 DSH 插件市场

在 DSH 中打开 插件 → 发现，搜索 dsh-mint-budgie，安装后重启 DSH。安装包已带版本化的 desktop/mint-budgie-<版本>.exe，通常不需要额外安装 Python。

从 npm 安装

dsh plugin --profile desktop add dsh-mint-budgie

安装后重启 DSH。插件 Host 会自动启动 desktop/pet-window.pyw。

可选：Python 运行方式

插件会优先运行版本号最高的 desktop/mint-budgie-<版本>.exe。带版本号的文件名允许新版与正在运行的旧版共存，因此更新时不会强制关闭桌宠。只有删除这些 EXE、改用源码模式时，才需要：

py -m pip install Pillow

如果 Python 不在 PATH 中，可以设置 DSH_PET_PYTHON 为 pythonw.exe 的完整路径。

使用

- 拖动宠物可跨屏移动。
- 轻拖后松手会自然落下；快速甩出会飞出、撞墙反弹，并在落地时短暂压缩回弹。
- 宠物飞行期间任务浮窗会自动收起，停稳后恢复。
- 空闲时宠物会以随机间隔自动播放随机动作。
- 单击随机切换歪头、伸头、展翅或挥翅动作。
- 双击打开或收起 DSH；任务进行中且浮窗已最小化时，同时恢复浮窗。
- 右键选择“设置”调整大小与透明度，或选择“隐藏宠物”。

说明

- 当前仅支持 Windows。
- 桌宠进程会读取 DSH Host 写入的 desktop/state.json，因此 DSH 与桌宠必须使用同一个插件安装目录。
- 隐藏宠物后，DSH Host 不会自动重新启动它；再次双击 DSH 中的桌宠入口或重新启用插件即可恢复。

许可证

MIT