前言¶

在 DeepSeek Harness（DSH）里跑智能体时，主窗口往往被终端、编辑器或浏览器挡住，很难一眼看出当前项目是否在跑、是否在等审批。社区里也有在 DSH 窗口内嵌桌宠的做法，但会占用界面空间。下面介绍维护者 7AAAAAH 发布的 dsh-pet-gujiguji：一只只在桌面上浮动的鸟形桌宠，随 Host 写入的状态显示任务气泡，且不在 dsh 窗口内再渲染第二只宠物。

这是什么¶

GujiGuji 是面向 DSH 的轻量桌面伴侣，README 描述为「a lightweight Codex-style desktop pet for DeepSeek Harness」。插件分类在社区目录中为「趣味换装」；核心用途是：跨显示器悬浮、仅在 agent 工作时展示当前项目与活动，并与 DSH 的 running / waiting / failed / idle 信号对齐。

核心功能¶

状态与任务气泡¶

Host 根据会话与事件映射桌宠行与标签（资料中的 Status mapping）：

空闲时不显示气泡，也不显示 “idle” 文案。Codex 风格的任务气泡固定为 284×65，长活动文本横向滚动。

交互与物理¶

• 可在 Windows 虚拟桌面上拖动到各显示器；松手后自然下落，快速甩动可在有界速度、重力、撞墙、地面摩擦与短暂着地 squash 下投掷。
• 超过点击阈值拖动会进入可见的起飞周期；空中时任务气泡暂时隐藏，落地后恢复。
• 空闲时每 30–75 秒随机手势（可调 15–150 秒），且避免连续重复同一手势。
• 单击：随机 head tilt、head stretch、spread wings 或 side-wing wave，起止均为站立姿。
• 双击：切换 dsh 窗口显隐；若任务气泡已最小化，同一双击可恢复；并播放随机 head tilt 或 head stretch。
• 右键：设置或隐藏桌宠。
• dsh 一轮 成功结束 后桌宠轻跳两下；失败、中断、token 上限结束不触发。

显示与设置¶

• 宠物与气泡按显示器工作区避让边缘，不跨双屏边界；边距随当前姿势而非始终按最宽翼展预留。
• 设置项包括：大小、透明度、投掷力度、空闲间隔、位置锁定、减少动效；行为页可恢复默认右下角位置。
• 精灵帧对齐统一脚线；翼展手势使用完整源图，生成器不单独裁切或旋转单翼。

架构要点¶

• DSH Host 写入 desktop/state.json；desktop/pet-window.pyw 轮询并用 tkinter + Pillow 渲染独立桌面窗口。
• Host 可启动桌宠，但桌宠进程可在 Host 重启后仍存活；desktop/setup-startup.ps1 可安装登录快捷方式独立启动。
• 启动器优先使用最新的打包 desktop/dsh-pet-gujiguji-<version>.exe，Windows 用户可无 Python 运行；若无 exe，需 Pillow 与 tkinter，Python 解析顺序为 DSH_PET_PYTHON、pyw.exe、pythonw.exe、py.exe、python.exe。
• 用户设置从 desktop/default-settings.json 种子化到 AppData，升级插件不覆盖个人偏好。
• client.js 为兼容垫片，有意不在 dsh 窗口内注册宠物。

从较早版本升级时，会自动从 dsh-light-feather 或 dsh-mint-budgie 迁移位置与设置。

安装与启用¶

DSH 生态里插件通过社区目录或 npm 包安装；当前仅支持 Windows。

1、在 DSH 插件市场搜索 dsh-pet-gujiguji 安装，然后重启 dsh。

2、或安装公开 npm 包（desktop profile）：

dsh plugin --profile desktop add dsh-pet-gujiguji

安装后重启 dsh。

若走 Python 路径而非 exe，需安装 Pillow：

py -m pip install Pillow

资料中 package.json 标明插件版本 0.8.6、许可证 MIT、Node >=20。

典型用法¶

安装并重启 dsh 后，Host 会桥接桌面进程；桌宠浮在其它窗口之上，agent 工作时看气泡即可知 Running / Waiting / Failed。日常操作：

• 拖动摆放位置；需要专注时可右键隐藏。
• 双击快速显隐 DSH 主窗口。
• 右键打开设置，按显示器与动效偏好调节大小、透明度、投掷与空闲间隔。

禁用方式：从当前 profile 的 package.json 里 dsh.profile.bundles 移除 dsh-pet-gujiguji，再重启 dsh。

适用场景与注意¶

适合在 Windows 上长期使用 DSH、希望桌面层反馈 agent 状态、又不想让 dsh 窗口内再嵌一层宠物的开发者。

安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。插件随当前 dsh 进程权限运行，桌面 overlay 与开机脚本会启动独立进程，使用前请确认环境与安全策略。社区插件目录 SkillHub 条目 与 GitHub 无 DeepSeek / 幻方官方从属关系，仅为社区分发渠道。

物理拖拽/投掷与后续规划见仓库内中文文档 docs/DEVELOPMENT-PLAN.zh.md。

结尾¶

dsh-pet-gujiguji 把 Codex 式桌面桌宠接到 DSH Host 状态上：独立窗口、任务气泡与手势反馈，而不占用 dsh 内嵌 UI。需要安装命令与行为细节时，以 README 为准。

• 社区目录：https://www.skillhub.cn/plugins/7AAAAAH/dsh-pet-gujiguji
• GitHub：https://github.com/7AAAAAH/dsh-pet-gujiguji