前言¶
在 DeepSeek Harness（DSH）里使用智能体时，agent 当前处于哪个阶段、正在调用哪个工具、跑了多久，以及 DeepSeek API 余额还剩多少，通常会分散在日志、终端输出或不同面板里。dsh-desktop-pet 把这些信息放到同一个桌面宠物 widget 中：官方鲸鱼在 web UI 的 shell overlay 里活动，圆形海平面的高度对应 API 余额，状态条则显示当前 agent 的阶段、工具和耗时。
这是什么¶
dsh-desktop-pet 是一个 DeepSeek Harness 插件，由 FenyxHuang 维护，采用 MIT 许可证。它用于在 DSH web profile 中提供一个常驻桌面宠物，集中展示 agent 运行状态和 DeepSeek API 余额。
这个插件的打包产物是预构建的，声明零运行时依赖；安装时依赖 Harness 本身提供的 @deepseek-ai/* 服务，因此不需要额外 build step，也不需要 build authorization。
核心功能¶
实时 agent 状态¶
鲸鱼会按照 agent 状态切换显示，包括 resting、thinking、working 和 cries。
状态条会展示当前阶段、当前工具以及耗时。
余额作为海平面¶
圆形海面按 balance / balanceScale 填充，计算结果会被限制在最大 1。默认 balanceScale 为 100，也就是 ¥100 为满格。
水面会显示滚动波浪和慢潮效果，金额显示在水面上。余额较低时，鲸鱼会下垂并显示抱怨状态。
可交互桌面宠物¶
点击鲸鱼可以触发交互：多数情况下弹跳，约 40% 概率触发一次带 360° 旋转的蓄力潜水，并伴随溅水效果。
插件还包含随机中英文台词、爱心、思考气泡、可拖拽和最小化为点等表现。
零运行时依赖¶
打包产物预构建后分发。@deepseek-ai/* 相关服务由已有 Harness 安装提供，安装过程不需要构建步骤，也不需要构建授权。
安装与启用¶
前置条件：已经安装 DeepSeek Harness，推荐使用 web profile。
从 GitHub 直接安装：
dsh plugin --profile web add github:FenyxHuang/dsh-desktop-pet
从本地 checkout 安装时，将路径替换为实际目录：
dsh plugin --profile web add link:/path/to/dsh-desktop-pet
也可以先打包成 tarball，再安装：
pnpm pack
dsh plugin --profile web add ./dsh-desktop-pet-0.1.0.tgz
安装完成后，需要重启 dsh，因为 bundle layers 在启动时组合。重启后，鲸鱼会出现在 web UI 的右下角。
典型用法¶
查看 agent 状态和余额¶
安装并重启后，web UI 右下角会出现鲸鱼 widget。
agent 运行期间，可以观察鲸鱼状态、状态条中的阶段、当前工具和耗时。圆形海面则根据 DeepSeek API 余额显示水位。
宿主端配置行会通过 Harness 的正常凭据读取 DEEPSEEK_API_KEY，并最多每 15 秒重新获取一次余额接口：
https://api.deepseek.com/user/balance
覆盖配置¶
默认情况下，pet-status 的配置为 balanceScale: 100。如果你希望更高余额才显示为满格，可以在自己的 profile 的 cordis.patch.yml 中覆盖配置：
- update:
- id: pet-status
config:
balanceScale: 500
balanceRefetchMs: 60000
上面的示例将满格阈值调整为 500，并将余额重新获取间隔调整为 60000 毫秒。
适用场景与注意¶
适合已经使用 DeepSeek Harness web profile，并且希望在一个常驻 widget 里同时看到 agent 状态和 API 余额的使用者。
使用前需要注意：
- 该插件依赖已有的 DeepSeek Harness 安装环境。
- 安装后需要重启
dsh，widget 才会在 web UI 右下角出现。 - 插件会读取
DEEPSEEK_API_KEY，并访问 DeepSeek balance API，频率最多每 15 秒一次。 - 该插件以当前
dsh进程权限运行，安装前应检查源码、依赖范围和许可证。 - 许可证为 MIT；插件源自 DeepSeek Harness codebase（MIT，© 2026 DeepSeek）。鲸鱼标志是 DeepSeek 官方品牌图案，用于 widget 自身显示。
- 仓库开发测试记录为 34 pass；其中 7 个 jsdom widget tests 需要 Node
^22.19 || >=24。
相关链接¶
- GitHub：https://github.com/FenyxHuang/dsh-desktop-pet
- 社区目录页：https://www.skillhub.cn/plugins/FenyxHuang/dsh-desktop-pet
