dsh-desktop-pet DSH 插件

dsh-desktop-pet 是一个 DeepSeek Harness 插件，在桌面上显示一只小动画宠物。宠物会响应 Harness 的状态：空闲时放松，推理时“思考”，工具运行时“工作”，任务完成时庆祝或皱眉。它不是聊天界面或任务管理器，而是一个纯粹的状态指示器。

ui-productivity

如何安装 dsh-desktop-pet DSH 插件

dsh plugin --profile <name> add dsh-desktop-pet

来源命令需要人工核对。复制不会执行命令。

dsh-desktop-pet DSH 插件数据来源

dsh-desktop-pet DSH 插件快照日期：2026年8月16日

discovered

dsh-desktop-pet DSH 插件能做什么

显示动画宠物，反映 Harness 状态（空闲、思考、工作、等待、成功、错误、睡眠）
零网络：所有资源打包，无遥测或 CDN
零额外 LLM 成本：状态转换完全确定，无需调用模型
运行时发现宠物：将文件夹放入 assets/pets/ 即可添加新宠物，无需重新构建
可通过设置卡片配置：启用/禁用、缩放、宠物选择、空闲时隐藏、动画速度等
支持 Windows 11（首选）和 Linux X11（需搭配合成器）；macOS 未实现
开发者模式：通过 /pet 命令模拟状态，无需 LLM

dsh-desktop-pet DSH 插件适合哪些场景

当 Harness 处理任务时提供视觉反馈，例如推理时宠物“思考”
无需查看终端或浏览器即可感知 Harness 的活动状态
有趣的桌面伴侣，响应不同工具执行阶段
通过将文件夹放入 assets 目录添加自定义宠物
使用开发者命令隔离测试状态转换

dsh-desktop-pet DSH 插件适合谁

希望桌面视觉指示器显示 Harness 活动状态的 DeepSeek Harness 用户
喜欢桌面个性化、想要动画宠物作为状态灯的用户

dsh-desktop-pet DSH 插件的限制

Linux 上需要合成器（如 picom）才能实现透明效果；在 Wayland 上，宠物作为 XWayland 客户端运行，而非原生 wlr-layer-shell
macOS 未实现
仅捆绑了基于文本的测试宠物，不包含官方角色美术资源
原生窗口渲染（无边框、透明、置顶、拖拽）未经过 CI 自动化测试，需要在真实桌面手动验证

dsh-desktop-pet DSH 插件的仓库 README 摘录

以下文字摘自 dsh-desktop-pet DSH 插件的上游仓库 sereinmono/dsh-desktop-pet 的 README，版权归原作者，仅作引用。

English | [中文](README.zh.md) An **optional desktop companion** for [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness). It shows a small animated pet as an ambient status indicator: the pet relaxes when the harness is idle, "thinks" while the model reasons, "works" while tools run, waits when the harness needs input, and celebrates (or frowns) when a turn finishes. It is **not** a second chat UI, a task manager, or a full desktop app. It is a status indicator. - **Plugin-first**: a normal deepseek-harness plugin — no separately launched daemon, browser, or desktop app. - **Zero network**: all assets ship with the plugin; no telemetry, CDN, or remote service. - **Zero added LLM cost**: event → state resolution is fully deterministic. - **Runtime-discovered pets**: pets under `assets/pets/` are discovered at startup, so adding a pet is dropping a folder in — no rebuild. --- ## Installation The plugin is a Cordis **bundle** that ships both a host half (the pet window) and a client half (the settings card). `dsh plugin add` installs it and, because the manifest declares `dsh.bundle`, adds it to the profile's bundle list automatically. ### From npm ```sh dsh plug

阅读完整 README仓库未声明许可，使用前请先与作者确认。

dsh-desktop-pet DSH 插件常见问题

如何安装 dsh-desktop-pet？

运行 `dsh plugin --profile <名称> add dsh-desktop-pet` 从 npm 安装，或使用本地路径、压缩包或 Git 仓库。安装后启动 Harness（`dsh --profile <名称>`），宠物就会出现在桌面上。

宠物需要联网吗？

不需要。所有资源都已打包在插件中，没有遥测、CDN 或远程服务。宠物完全离线工作。

我可以添加自己的自定义宠物吗？

可以。在插件目录的 `assets/pets/` 下放置一个包含 `pet.json` 和 `spritesheet.webp` 的文件夹即可。插件在启动时会自动发现宠物。你也可以使用 `hatch-pet` 技能或从 Petdex 社区下载宠物。

为什么在 macOS 上看不到宠物？

macOS 暂不支持。该插件仅为 Windows 11 和 Linux（带合成器的 X11）实现了原生覆盖窗口。macOS 的后端接口已预留，但尚未实现。

如何启用开发者模式来测试宠物状态？

如果 `ctx.commands` 服务存在（通常来自核心 Harness），你可以在聊天区域使用 `/pet` 命令。例如 `/pet thinking` 或 `/pet working`。这会模拟状态，无需 LLM 参与。