前言¶
在 Windows 上使用 DeepSeek Harness（DSH）Desktop 跑 Agent 时，进程往往在后台长时间工作：等待审批、执行工具、失败重试。界面以日志和会话为主，缺少一种轻量、常驻桌面、又能反映当前任务状态的反馈方式。社区里已有桌宠类插件思路；dsh-kurowhale-pet（KuroWhale）把角色视觉对齐 DSH 官方图标里的鲸鱼娘意象，做成透明悬浮窗，并根据 Agent 活动切换动画。下面介绍它是什么、能做什么，以及如何在 Desktop 里安装启用。
这是什么¶
dsh-kurowhale-pet 是维护者 lemonxiny55 发布的非官方社区插件，npm 包名与插件 ID 均为 dsh-kurowhale-pet，当前资料中的版本为 0.1.4。简介为：参考 DeepSeek Harness 官方图标设计的鲸鱼娘桌宠，在 Windows 桌面上陪伴用户，并响应 DSH Agent 的工作状态。
在 SkillHub 等社区目录中，该插件归类为 趣味换装。仓库说明明确：免费、非官方，与 DeepSeek 官方及相关创作者无关联，也未获得背书。
- 目录页：https://www.skillhub.cn/plugins/lemonxiny55/dsh-kurowhale-pet
- GitHub：https://github.com/lemonxiny55/dsh-kurowhale-pet
核心功能¶
以下能力均来自仓库 README 与 package 元数据，未在资料中出现的配置项不写进正文。
动画与 Agent 状态¶
插件提供 九种动画，对应待机、左右移动、挥手、跳跃、失败、等待审批、工作中和完成回顾等状态，随 DSH Agent 活动切换。动画帧来自既有 pet.json 所指向的 spritesheet.webp 的提取与排版，资料说明未重绘角色或修改动画逻辑。
桌面展示与交互¶
- 桌面悬浮：透明窗口，支持拖动、缩放、隐藏、置顶，并记忆位置。
- 菜单与托盘：右键管理桌宠；通过系统托盘可恢复显示。
运行环境¶
package.json 中声明：
- DSH：
0.2.1-rc.3或0.2.1-rc.5 - Node（包构建/引擎约束）：
>=22.18.0 - 安装说明要求：Windows x64、WebView2，以及 DSH Desktop 0.2.1-rc.3 或 rc.5。
首次启动会优先使用包内素材；缺失的素材和官方 Neutralino 6.9.0 运行时会从固定来源联网获取并校验 SHA-256。已有自定义路径、显示偏好和位置会保留。下载或校验失败会记录错误，DSH 仍可使用。
安装与启用¶
推荐在 DSH Desktop 中通过 npm 官方源 安装固定版本，不要凭仓库名自行拼接未在资料中出现的 CLI 命令。
- 打开 DSH Desktop 的 插件管理 → 添加插件。
- 输入下面包标识，选择 npm 官方源，点击 安装。
- 安装完成后点击 立即启用，再 重启 DSH。
dsh-kurowhale-pet@0.1.4
注意： 同名插件已安装时，Desktop 要求先卸载再安装，请先备份配置。资料另列 GitHub 仓库 URL 作为添加插件入口的历史方式；0.1.4 推荐入口为上述 npm 版本。DSH Market 搜索 KuroWhale 的索引同步在发布说明中仍待上游确认，当前请以 npm 固定版本为准。
典型用法¶
安装并重启后，桌宠以悬浮窗形式出现在桌面，无需额外配置文件即可随 Agent 状态播放对应动画。日常操作包括：
- 拖动窗口调整位置（位置会被记忆）。
- 右键打开管理菜单，或使用系统托盘恢复被隐藏的桌宠。
- 在 DSH 中触发 Agent 工作流（等待审批、执行、失败、完成等），观察桌宠是否切换到 README 所列九种状态之一。
具体动画与静态帧说明见仓库 docs/images/ 及 README 中的「九种状态」折叠说明。
适用场景与注意¶
适合谁： 在 Windows 上使用 DSH Desktop 0.2.1-rc.3 或 rc.5、希望桌面有轻量视觉反馈的开发者或长期跑 Agent 的用户。
验证范围（资料原文）： 已在 Windows x64 的 DSH Desktop 0.2.1-rc.3 验证安装及桌宠交互，并在 rc.5 验证安装和针对性稳定性回归。其他 DSH 版本、混合 DPI 和长期运行尚未充分验证。
权限与信任： 插件随当前 DSH 进程权限运行。安装前应阅读仓库源码与许可证，自行判断是否满足环境与安全要求。
许可： 代码采用 MIT；项目有权授权的新增美术贡献采用 CC BY-NC-SA 4.0（署名、注明修改、非商业、相同方式共享）。角色来源涉及 AI 辅助创作及社区桌宠 lineage，详细署名见仓库 NOTICE-ARTWORK.md。
结尾¶
dsh-kurowhale-pet 把 DSH 官方图标语境下的鲸鱼娘做成 Windows 桌宠，用九种动画对接 Agent 生命周期，并提供透明悬浮与托盘管理。若你已在 Desktop 满足 WebView2 与 rc.3/rc.5 要求，可按 dsh-kurowhale-pet@0.1.4 安装启用。
- SkillHub 目录：https://www.skillhub.cn/plugins/lemonxiny55/dsh-kurowhale-pet
- GitHub：https://github.com/lemonxiny55/dsh-kurowhale-pet
- npm 0.1.4：https://www.npmjs.com/package/dsh-kurowhale-pet/v/0.1.4
