前言¶
DeepSeek Harness (DSH) 支持插件化扩展。除了网页端的配置与监控，在桌面端保留一个可视化的状态指示器能帮助开发者更直观地追踪当前会话（如空闲、工作中、等待、失败或完成）。dsh-pet-desktop-linux 插件通过一个悬浮在桌面之上的透明窗口实现这一功能。
环境要求¶
安装前请确认以下条件满足：
- 平台：Linux，且仅支持 X11 或 XWayland（原生 Wayland 会话不支持）。
- DSH：任意包含
webServer和settings.section槽位的 DSH 版本。 - Node.js：版本需 >= 22。
- 系统依赖：Python 3, PyGObject, GTK3, GdkPixbuf, xdotool。
- 额外依赖：
@michengai/dsh-codex-pet（仅用于读取图片素材）。
安装¶
通过 DSH 的插件管理器安装。
dsh plugin --profile web add github:Wlaeg/dsh-pet-desktop-linux
安装完成后，需要刷新 DSH 的 Web UI 页面，Settings 面板才会注册该插件。DSH 启动时会自动启动宠物窗口（autostart 默认为 true）。
如果需要替换已安装的插件（例如修改源码后），必须重启 DSH 的宿主进程，单纯刷新页面是不够的。
功能说明¶
该插件包含三个部分：桌面程序 (desktop/pet.py)、宿主端 (lib/index.js) 和浏览器端 (client.js)。
- 窗口特性：
- 无边框、透明的 GTK3 窗口，背景壁纸透出。
- 窗口常驻顶层（
_NET_WM_STATE_ABOVE）并跟随工作区（_NET_WM_STATE_STICKY，通过xdotool实现）。
- 状态动画：
- 根据当前 DSH 会话状态切换动作：空闲、工作中、等待回答、失败、待审核。
- 交互：
- 支持右键菜单。
- 提供工作状态对话框。
注意事项¶
- 兼容性：不支持 Windows、macOS 或原生 Wayland。
- 依赖检查：Settings 面板会自动探测 GTK3、GdkPixbuf 和 xdotool。如果 WebP 图片无法显示，可能需要安装
webp-pixbuf-loader。 - 权限与安全：插件以 DSH 进程的权限运行，请从可信来源安装并检查源码与许可证（MIT）。
