前言¶
DeepSeek Harness（DSH）的桌面侧边栏和插件系统让智能体运行在浏览器环境中，但桌面窗口的渲染受限于浏览器权限。dsh-pet 插件依赖原生窗口才能在桌面上显示桌宠，这导致它被限制在 Harness 进程内部。想关掉桌宠，得翻设置、找插件、点开关；想在桌面重新打开，又得先确保 Harness 是开的。
dsh-pet-button 插件解决的是这个问题：它提供一个桌面小部件，把“开/关桌宠”这个动作变成桌面上的一个原生按钮。
是什么¶
dsh-pet-button 是一个 DeepSeek Harness 插件，维护者 kongbaiming5。它本身不提供桌宠形象，只是给 dsh-pet 插件加一个桌面开关。小部件是一个 macOS arm64 原生 app，首次启用时会自动安装到 ~/Applications，占用内存极小。
插件负责“控制桌宠的启停和生命周期”，小部件负责“长什么样、点下去做什么”。
核心功能¶
- 左键单击：切换桌宠的开/关状态
- 按住拖动：移动位置，位置会自动保存
- 右键菜单：贴在桌面 / 始终置顶 / 回到右下角 / 退出
- Harness 未运行时：卡片显示“启动”，点一下拉起 Harness
卡片有三种状态：
- 桌宠 · 开（青色描边）
- 桌宠 · 关（暗色）
- 启动（Harness 未运行）
安装与启用¶
先确保 dsh-pet 插件已安装：
dsh plugin --profile web add dsh-pet
再安装 dsh-pet-button：
dsh plugin --profile web add github:kongbaiming5/dsh-pet-button
首次启用时，插件会自动把 ~/Applications/桌宠开关.app 安装到本地，无需手动拷贝。
典型用法¶
- 打开插件开关：在插件市场里打开 dsh-pet-button，桌面上会出现小卡片
- 左键单击：桌宠出现或消失
- 按住拖动：把卡片放到顺手的位置
- 右键：选择“贴在桌面”“始终置顶”等
- 关闭 Harness 后：卡片显示“启动”，点一下可重新拉起 Harness
生命周期与卸载¶
插件市场里的开关直接控制卡片出现/隐藏：
- 打开插件 → 卡片出现
- 关闭插件 → 卡片隐藏（app 留在本地，下次还能开）
- 退出 Harness → 卡片保留，可以继续用它启动 Harness
- 卸载插件 → 杀掉进程，并删除 ~/Applications/桌宠开关.app、偏好设置、日志、LaunchAgent，不留任何残留
平台与依赖¶
小部件是 macOS arm64 原生二进制，仅在该平台运行。其他平台安装插件不会报错，只是不会弹出卡片。
插件完全通过 GitHub 分发，不发布到 npm，不需要任何账号。
适用场景¶
适合已经在使用 dsh-pet 插件的用户，希望把桌宠的开关从 Harness 内部移到桌面，减少查找成本。如果你使用的是非 macOS arm64 平台，或者没有安装 dsh-pet，这个插件不会带来额外价值。
插件以当前 Harness 进程的权限运行，安装前建议查看源码与许可证（MIT）。
小结¶
dsh-pet-button 把“控制桌宠”这个操作从设置页面移到了桌面，用原生小部件实现了轻量、即开即用的开关体验。它不依赖外部服务，完全在本地运行，卸载时也会清理所有痕迹。
- 插件目录：https://www.skillhub.cn/plugins/kongbaiming5/dsh-pet-button
- GitHub：https://github.com/kongbaiming5/dsh-pet-button
