前言¶
在 DeepSeek Harness（DSH）里跑智能体时，主窗口往往堆着日志和会话，很难一眼看出「当前有没有 agent 在跑、在等什么」。有的做法是在 DSH 窗口里再嵌一层宠物 UI，但会占界面、和主流程抢注意力。Mint Budgie 走另一条路：只在 Windows 桌面上浮一层独立窗口，agent 工作时才显示项目和活动气泡，且不在 dsh 窗口里再画第二只宠物。
下面介绍插件定位、能力与安装方式，事实均来自 GitHub 仓库 README 与 package.json（当前包版本 0.6.0）。
这是什么¶
dsh-mint-budgie 是维护者 7AAAAAH 发布的 DSH 插件，分类为社区目录中的「趣味换装」。一句话：基于精灵图的桌面伴侣，随活跃 agent 状态变化，设计思路对标 Codex 桌面宠物。
- 目录页：https://www.skillhub.cn/plugins/7AAAAAH/dsh-mint-budgie
- 源码：https://github.com/7AAAAAH/dsh-mint-budgie
- 许可证：MIT
目前 仅支持 Windows。
核心功能¶
桌面浮层与交互¶
- 宠物浮于其它窗口之上；可在 Windows 虚拟桌面上跨显示器拖动。
- 松手后带重力、边界反弹、地面摩擦和短暂落地挤压；快速甩动有速度上限。空中时任务气泡临时隐藏，落地后再出现。
- 单击随机播放一种手势（歪头、伸头、展翼、侧翼挥动等），每种手势起止均为站立姿势。
- 空闲时每 30–75 秒随机 idle 手势，且不连续重复同一手势。
- 双击打开或隐藏 dsh 窗口；若任务气泡已最小化，同一双击可恢复。
- 右键打开设置或隐藏宠物；大小、透明度支持滑块、数值输入与重置，并持久化。
任务气泡与状态¶
气泡固定 284×65，长活动文案横向滚动。空闲时不显示气泡，也不显示 “idle” 文案。
Host 侧状态写入 desktop/state.json，桌面进程轮询渲染。状态映射如下：
| 来源信号 | 宠物行 | 标签 |
|---|---|---|
任意 agent 为 running 或会话有未关闭 turn |
running |
Running |
存在打开的 approval/request |
waiting |
Waiting |
4 秒内出现 agent/error |
failed |
Failed |
| 其它 | idle |
无气泡 |
Agent.status 本身只有 idle | running；Waiting、Failed 来自上述两类 transient Host 事件。
多显示器与渲染¶
宠物与任务气泡按各显示器工作区定位，避开屏幕边缘，不跨双屏边界。进程在多显示器混合 DPI 下保持精灵与窗口坐标一致。精灵帧对齐统一脚线，避免低帧裁切；展翼手势使用完整源图，生成器不单独裁切或旋转翅膀。
架构要点¶
index.js：Host 状态轮询、持久化与桌面进程桥接。client.js：兼容垫片，故意不在 dsh 窗口内注册宠物。desktop/pet-window.pyw：独立桌面 overlay（tkinter + Pillow）。desktop/pet_physics.py：无第三方依赖的拖拽、投掷与碰撞。- 启动优先使用打包好的
desktop/mint-budgie-<version>.exe；无 exe 时需 Pillow、tkinter，Python 解析顺序为DSH_PET_PYTHON，再pyw.exe、pythonw.exe、py.exe、python.exe。 - 用户设置从
desktop/default-settings.json种子化到 AppData，右键面板写入用户副本，插件升级不覆盖偏好。 - Host 可拉起宠物进程；Host 重启后宠物进程仍可存活。
desktop/setup-startup.ps1可安装登录快捷方式独立启动宠物。
更完整的物理交互与后续规划见仓库内 docs/DEVELOPMENT-PLAN.zh.md（中文）。
安装与启用¶
DSH 生态是「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装前建议浏览源码与 MIT 许可证；插件随当前 dsh 进程权限运行。
方式一： 在 DSH 插件市场搜索 dsh-mint-budgie 安装，然后重启 dsh。
方式二： 安装公开发布的 npm 包（README 原文命令）：
dsh plugin --profile desktop add dsh-mint-budgie
安装后重启 dsh。Python 依赖：
py -m pip install Pillow
要求 Node >= 20（见 package.json 的 engines）。
典型用法¶
- 按上一节完成安装并重启 dsh，确认 Windows 桌面上出现薄荷鹦鹉。
- 启动或继续一次 agent 任务，观察 Running 气泡中的项目与活动文案。
- 需要审批时，气泡应切到 Waiting；若短时间内 agent 报错，可短暂显示 Failed。
- 拖动宠物跨屏测试工作区避让；单击看随机手势，双击切换 dsh 主窗口显示。
- 右键调整大小与透明度，确认重启 dsh 或升级插件后偏好仍保留。
若希望登录后自动有桌宠，可按仓库说明使用 desktop/setup-startup.ps1（需自行阅读脚本内容后再执行）。
停用与注意¶
从当前 profile 的 package.json 里 dsh.profile.bundles 移除 dsh-mint-budgie，重启 dsh 即可停用。
适用人群：在 Windows 上长期使用 DSH、希望用桌面宠物感知 agent 状态、又不想让主窗口再嵌一层 UI 的开发者。不适用非 Windows 环境。无 exe 时需本机 Python 与 Pillow；混合 DPI 多屏场景以官方 README 描述的行为为准。
结尾¶
dsh-mint-budgie 把 agent 运行、等待审批与失败信号映射到桌面精灵与 Codex 风格任务气泡，交互与物理细节在 README 中写得很具体。想从市场安装或看实现细节，可打开 SkillHub 目录页 与 GitHub 仓库。
