前言¶
如果你在使用 dsh 的 Web 侧栏工作，经常需要确认某个 AI 平台的余额、今日消费和今日 Token，手动查看平台后台会比较分散。dsh-deepseek-balance-widget 解决的问题比较具体：把 DeepSeek 和可添加的 MiMo（小米）余额信息放到 dsh Web 侧边栏，并每 30 秒自动刷新。
下面按功能、安装、配置、更新的顺序介绍这个插件。
这是什么¶
dsh-deepseek-balance-widget 是 crazy-L118 维护的一个 dsh 插件，用于在 dsh Web 侧边栏显示 AI 余额。它内置 DeepSeek，可添加 MiMo（小米），许可证为 MIT。
从 package.json 可以看到：
- 要求 Node.js
>=18 - 声明 dsh client platform 为
web - 注入
@deepseek-ai/dsh-client-runtime - 可选 peerDependency 为
@deepseek-ai/cordis ^4.0.1
核心功能¶
侧边栏入口¶
侧边栏入口会实时显示当前平台的信息：
- 余额
- 今日消费
- 今日 Token
数值会随详情弹窗内切换的平台联动，并且每 30 秒自动刷新。
详情弹窗¶
详情弹窗可以管理已添加的平台：
- 显示当前平台
- 支持更换已添加平台
- 支持移除已添加平台
- 支持添加 MiMo 或 DeepSeek
DeepSeek 详情¶
DeepSeek 详情会显示：
- 余额
- 累计消费
- 今日消费
- 今日 Token
- 本月消耗
- 时段徽章：GMT+8 工作日 09-12 / 14-18 为繁忙时段，周末全天空闲
MiMo 详情¶
MiMo 详情会显示：
- 余额
- 累计消费
- 今日消费 / 今日 Token
- 本月消耗
- 每日消耗表
用量统计¶
DeepSeek 的用量统计可以配置 DEEPSEEK_PLATFORM_TOKEN。未配置时，仅显示余额。
MiMo 的余额与用量使用登录 Cookie 查询，并按官方单价自动推算消费金额。
AI 引导配置¶
弹窗内提供「AI 帮我配置」入口，可以一键复制提示语，由 AI 引导获取凭证并写入插件。
MiMo 支持两种方式：
- AI 引导向导
- 手动粘贴 Cookie / cURL，并自动提取 Cookie
数据存储¶
凭据保存在本机：
~/.dsh/ai-balances.json
数据仅存本机，不随插件分发、不上传。
版本与更新¶
弹窗底部显示当前版本，支持一键自动更新。更新失败时会显示错误详情面板，并引导前往 GitHub 自行安装。
界面语言随 dsh 设置自动切换中 / EN。
安装与启用¶
先确认已安装 dsh，并且 dsh web 可用。插件要求 Node.js >=18。
执行下面命令安装：
dsh plugin --profile web add dsh-deepseek-balance-widget@2.4.2
这条命令会从 npm 拉取安装，dsh 会自动注册到 dsh.profile.bundles。
安装完成后，需要彻底重启 dsh web。仅刷新浏览器页面无效。
安装命令中建议写死版本号 @2.4.2，不要使用 @latest，避免本地 pnpm/npm 缓存或镜像源解析成旧版本。
典型用法¶
使用内置 DeepSeek¶
插件首次使用会自动创建 DeepSeek 条目，并读取本机的 DEEPSEEK_API_KEY。
添加 MiMo¶
打开余额弹窗，点「+ 添加」，再点「AI 帮我配置」，把提示语发给智能体。
也可以直接对 AI 说：
帮我配置 dsh-deepseek-balance-widget
MiMo 也可以手动粘贴 Cookie / cURL，插件会自动提取 Cookie。
配置 DeepSeek 用量统计¶
DeepSeek 用量统计可配置 DEEPSEEK_PLATFORM_TOKEN。未配置时，仅显示余额。
也可以对 AI 说：
帮我配置用量统计
更新插件¶
已安装用户可以在余额弹窗底部点击「更新」，插件会自动从 npm 拉取并安装最高版本。弹窗更新会跳过 latest tag，直接安装 npm 上 semver 最高版本。
命令行强制更新可执行：
dsh plugin --profile web add dsh-deepseek-balance-widget@2.4.2
手动更新可进入插件目录：
cd ~/.dsh/profiles/web
npm install dsh-deepseek-balance-widget@2.4.2
如果环境提示使用 pnpm，可按提示执行 pnpm add。
若 Agent 主机通过 NODE_OPTIONS 注入文件删除拦截导致更新失败，可在普通终端执行更新命令，或先执行：
set NODE_OPTIONS=
再重试。
卸载插件¶
dsh plugin --profile web rm dsh-deepseek-balance-widget
适用场景与注意¶
这个插件适合已经使用 dsh 和 dsh web，并且需要查看 DeepSeek 或 MiMo（小米）余额、消费、Token 的场景。
使用前需要注意：
- DeepSeek 必填凭据为
DEEPSEEK_API_KEY - DeepSeek 用量统计可选配置
DEEPSEEK_PLATFORM_TOKEN - MiMo 需要登录 Cookie，可由 AI 引导获取
- 凭据保存在本机
~/.dsh/ai-balances.json，不随插件分发、不上传 - 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证
- 安装或更新后必须彻底重启
dsh web，仅刷新浏览器页面无效 - 目录页是独立站点，不代表 DeepSeek / 幻方官方应用商店
链接¶
- 目录页：https://www.skillhub.cn/plugins/crazy-L118/dsh-deepseek-balance-widget
- GitHub：https://github.com/crazy-L118/dsh-deepseek-balance-widget
