PetPal：DeepSeek Harness 的桌面宠物插件

前言¶

使用 DeepSeek Harness 时，Agent 在后台运行，你很难感知当前进度。PetPal 是一个桌面宠物插件，把 petdex.dev 的宠物展示在桌面上，并通过企业微信把关键状态推到手机。它不抢焦点、不占 Dock，适合在浏览器、IDE 或其他应用中作为常驻提示。

是什么¶

PetPal（dsh-petpal）由维护者 flowers-59f 开发，归类为「趣味换装」类插件。它把 petdex.dev 的宠物下载到 DSH 自己的宠物目录，再由插件自带的原生桌面小应用在桌面上渲染。宠物会根据 Agent 的状态移动和显示气泡，需要你确认或一轮工作结束时，通过企业微信机器人推送消息。

核心功能¶

宠物库：按宠物页面链接或标识（slug）从 petdex.dev 下载，直接落到 ~/.dsh/pets，可切换、可删除。
桌面常驻：原生桌面端（macOS Swift + WKWebView / Windows C# WPF），透明置顶、不抢焦点、不进任务栏。
外观自定义：大小 50–200%、气泡字号/宽度/停留、背景色、文字色、整体不透明度、点击穿透。
会话气泡：每个会话一个气泡，实时显示「正在分析请求 / 正在运行命令 / 正在生成回复」，与 dsh 摘要显示一致，点击可回到 Harness。
状态联动：开始任务、工具调用、等待确认、完成任务、任务失败均能正确映射动作。
主动通知：Agent 需要确认、一轮工作完成或出错时，通过企业微信机器人推送消息，可一键开关。
失败自愈：设置页加载失败自动退避重试，仍失败则给出「重试」按钮，不会卡在「加载中…」。
宠物交互：拖动换位置并写回配置，拖动时按方向播放奔跑动画，点一下会挥手。
跨平台：同一套宠物文件在 macOS 与 Windows 通用，桌面端随包分发，无需装 Xcode / .NET SDK。

安装与启用¶

需要 DSH 0.2.1+，以及 macOS 12+ 或 Windows 10 1903+ / Windows 11。

dsh plugin --profile <profile> add github:flowers-59f/dsh-petpal

安装后重启 DSH，打开 设置 → 宠物。插件市场收录后也可以从 插件 → 发现 安装。

安装包里已带编译好的桌面端，不需要 Xcode、Swift、.NET SDK 或 Python。

典型用法¶

下载宠物¶

打开 petdex.dev 找到喜欢的宠物，复制地址栏链接（或链接最后一段的标识），粘贴到「下载宠物」输入框，点「查找」，确认预览后点「下载并使用」。

宠物页面：https://petdex.dev/pets/yinyue-2
宠物标识：yinyue-2

已经装过的宠物会显示「使用」或「使用中」，不会重复下载。插件读取 petdex.dev 的安装脚本，把 pet.json 和雪碧图写进 ~/.dsh/pets/<slug> 并切换过去，不需要安装 Codex。

调整外观¶

同一页面往下就是外观设置：拖动即时生效（桌面端每 0.35 秒读一次配置），顶部「预览」跟着当前宠物、字号、宽度、配色实时变化；再往下是通知设置。

配置企业微信通知¶

创建机器人：企业微信 -> 通讯录 -> 点击最上方的智能机器人 -> 创建 -> 创建一个普通模式的机器人、可见范围勾选上自己，名称简介等其他设置随意。
拉群：右上角 “+” 号 -> 发起群聊并勾选上创建的机器人，进入群里中点击右上角 “···” 下滑至消息推送 -> 添加一个消息推送。
复制它的 Webhook 地址（形如 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx）。
回到 设置 → 宠物 → 通知，打开「启用通知」，把地址粘进输入框，点「保存」或按回车。
出现绿色「✓ 已保存，配置即刻生效」就生效了。

之后 Agent 需要你确认、或一轮工作结束时，群里就会收到消息：

✅ DeepSeek Harness 通知

会话：<会话标题>
状态：已完成
输出token：xxxx

时间：2026/10/24 09:52:18

地址必须以 https:// 开头，格式不对会标红且无法保存；关掉开关只会暂停发送，已填的地址会保留。

适用场景与注意¶

适合需要在开发或工作过程中保持 Agent 进度可见的开发者或团队。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。

桌面端只读写本地文件，不联网、不开端口，因此没有常驻后台服务，也不会和 Harness 抢资源。

小结¶

PetPal 把 petdex.dev 的宠物接入 DeepSeek Harness，提供桌面常驻气泡和手机通知，在不干扰工作流的情况下保持任务可见。更多细节见 GitHub 仓库：https://github.com/flowers-59f/dsh-petpal