前言¶

日常使用 DeepSeek Harness（DSH）的 Web 界面时，经常需要查看 DeepSeek 账号余额，但不一定想反复切出当前窗口、打开别的页面查询。Ho11ow8/deepseek-harness-balance-pet 是一个 DSH 插件：打开 DSH Web 界面时，在屏幕右下角显示一个 Deepseek 娘，并用对话框实时显示 DeepSeek 账号余额，默认每 20 秒刷新一次。

下面介绍这个插件做什么、怎么安装、怎么配置，以及排障时看哪些日志。

这是什么¶

• 仓库/插件 ID：Ho11ow8/deepseek-harness-balance-pet
• package.json 包名：deepseek-balance-pet
• 维护者：Ho11ow8
• 许可证：MIT

它的作用是把 DeepSeek 账号余额挂到 DSH Web 浏览器窗口旁。桌宠默认出现在屏幕右下角，对话框内显示类似 余额：¥xx.xx 的单行文字，并自动缩放字号防止溢出。

该插件面向 Windows 10/11。桌宠是编译好的原生 WPF 程序，需要 .NET Framework 4.8，资料中标明系统自带。插件端需要 Node.js ≥ 18，并已安装 DeepSeek Harness 的 web profile。

核心功能¶

只跟随 DSH Web 浏览器窗口¶

启动 dsh web 时，桌宠会自动出现，并且只挂在 DeepSeek Harness 界面对应的浏览器窗口上。

当发生以下情况时，桌宠会隐藏：

• 切换到别的应用
• 最小化浏览器窗口
• 关闭浏览器窗口

恢复 DSH Web 浏览器窗口后，桌宠会重新显示。

它还会跟随浏览器所在显示器，并出现在该显示器的右下角，边距为 14px。

实时显示 DeepSeek 账号余额¶

桌宠对话框内显示：

余额：¥xx.xx

余额实时刷新，调用接口为：

GET /user/balance

默认刷新间隔为 20 秒，可通过 pollSeconds 配置项覆盖。

窗口大小与基本操作¶

桌宠默认大小为 220×209px，大小可配置。

日常操作包括：

• 按住左键拖动桌宠；同一显示器内的拖动位置会保留
• 右键菜单中选择刷新余额或退出
• 双击桌宠也能刷新余额

关闭 DSH 时，桌宠会自动退出。如果服务失联约 2 分钟，桌宠也会自动消失。

本地运行与密钥边界¶

插件端仅使用 Node 内置模块。桌宠端是编译好的原生 WPF 小程序。

余额代理只监听：

127.0.0.1

资料中明确说明：API Key 不会进入浏览器。

安装与启用¶

环境要求¶

安装前确认以下环境：

1. Windows 10/11
2. .NET Framework 4.8
3. Node.js ≥ 18
4. 已安装 DeepSeek Harness，并启用 web profile

从 GitHub 安装¶

执行：

dsh plugin --profile web add github:Ho11ow8/deepseek-harness-balance-pet

该命令会把插件加入 web profile。

然后重启 dsh web。可以关掉再重新打开，也可以双击桌面的 DeepSeek Harness 快捷方式。重启后，桌宠会自动出现。

从本地目录安装¶

开发或调试时，可以从本地目录安装：

dsh plugin --profile web add file:D:\DeepseekHarness\DeepseekBalance\deepseek-balance-pet

如果之前用 file: 安装过，现在想改用 github:，先移除旧依赖，再重新添加，避免同一包名出现两个来源。

典型用法¶

覆盖配置项¶

在 profile 的 cordis.patch.yml 中覆盖配置项。示例如下：

- id: balance-pet
  config:
    port: 41999
    pollSeconds: 20
    petWidth: 220
    shadow: true

这些示例值来自已提供的用法说明：

• pollSeconds: 20：对应默认每 20 秒刷新一次
• petWidth: 220：对应默认宽度 220
• port: 41999：本地余额代理使用
• shadow: true：覆盖桌宠显示相关配置

API Key 读取位置¶

插件读取 DeepSeek API Key 的顺序是：

1. 环境变量 DEEPSEEK_API_KEY
2. ~/.dsh/.credentials.yaml 中的 DEEPSEEK_API_KEY 行

如果余额获取失败，优先检查这里的 Key 是否有效、账号是否欠费。

重新生成形象¶

如果有原始图片，可以重新生成桌宠形象：

node tools/make-pet-image.mjs <原图.jpg> pet.png

这一步用于把原始图片处理成插件使用的 pet.png。

重新编译桌宠¶

需要重新编译 WPF 桌宠时，执行：

pwsh -File src\build.ps1

这一步会重新生成桌宠可执行文件。

排障¶

桌宠没出现¶

先确认两点：

1. deepseek-balance-pet 已加入 web profile 的 bundles
2. 安装后已经重启 dsh web

显示“获取失败”¶

检查 ~/.dsh/.credentials.yaml 中的：

DEEPSEEK_API_KEY

确认 Key 是否有效、账号是否欠费。余额接口返回 is_available: false 时也会报错。

查看日志¶

桌宠端日志位于：

%LOCALAPPDATA%\DeepseekBalancePet\pet.log

插件端日志在 dsh web 控制台中查看，带有 [balance-pet] 前缀。

适用场景与注意¶

这个插件适合在 Windows 下长期使用 DSH Web 界面的开发者。如果你的工作流经常需要确认 DeepSeek 账号余额，把余额挂在浏览器窗口旁可以减少来回切换。

使用前建议注意：

• 插件会随当前 dsh 进程权限运行
• 安装前应检查源码、依赖和许可证
• 余额代理只监听 127.0.0.1，但仍应避免把 API Key 暴露给不可信环境
• 如果从 file: 切到 github:，先移除旧依赖再添加

结尾¶

这个插件做的事情比较具体：打开 DSH Web 界面时，在屏幕右下角显示一个 Deepseek 娘，并在对话框里持续显示 DeepSeek 账号余额。它使用本地余额代理，API Key 不会进入浏览器，安装和配置路径也比较直接。

仓库地址：

https://github.com/Ho11ow8/deepseek-harness-balance-pet

目录页线索未确认，本文不把未核实地址列为事实。