跳到主内容

dsh-balance-plugin 使用指南

DeepSeek Harness 的余额与用量可视化插件：监控多账户余额、低余额告警、一键充值，复刻 Miyu 风格用量统计，并提供三方插件管理面板。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-balance-plugin

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-balance-plugin

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 已安装并运行 DeepSeek Harness
  • （可选）DeepSeek API Key —— 可在 platform.deepseek.com 获取；若本机已配置 DEEPSEEK_API_KEY 凭据，插件启动时自动读取，无需手动输入
    • id: dsh-balance-plugin

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

重启 DSH 后插件还在吗？

在。静态插件持久安装，重启后仍然生效；通过面板手动配置的账户 Key 会重置，自动读取的 DEEPSEEK_API_KEY 账户会在启动时自动恢复（lib/index.js:144 discoverAutoKeys）。

入口按钮为什么不在侧边栏底部？

DSH 侧边栏底部槽位被官方 Cordis 面板插件独占；本插件入口固定在输入框工具行右侧（💰 钱包 / 📊 用量 / 🧩 三方插件）以及输入框下方的常驻余额条（lib/client.js:799-816）。

API Key 会泄露吗？

不会。Key 只保存在本机插件进程的内存对象里，UI 上仅显示掩码（…后 4 位），源码与文档中不含任何凭据；curl 调用通过 Host shell 转发，不落盘日志（lib/index.js:33-53 authHeaderFor / keySourceOf）。

余额查询失败怎么办？

看面板里的错误提示：未配置 Key 显示「未配置 API Key」；用 $env: 引用但变量缺失显示「环境变量名 xxx 未设置」；Key 无效会透出 DeepSeek 返回的 401 信息（lib/index.js:43-91）。

为什么用量统计没有更早的历史数据？

插件启动时会扫描近 90 天的会话事件并按 seq 去重聚合，但单次最多读取 60 个会话（lib/index.js:345），更早或超出数量的会话不会进入统计；「首 token 平均延迟」仅统计插件运行后实时捕获的流式数据。

为什么不直接用 dsh plugin add dsh-balance-plugin？

npm 上存在他人同名包（[email protected]），裸包名会装错。安装命令必须用 github: 源指向本仓库（README.md:163 / install.sh:43-65）。

怎么卸载？

一键卸载：curl 跑 uninstall.sh；或手动执行 dsh plugin --profile web rm dsh-balance-plugin，并清理 ~/.dsh/cordis.patch.yml 里本插件的 - insert 块（uninstall.sh:13-51）。

三方插件面板里点「打开目录」在 Windows 上能用吗？

不能。该功能通过 Host shell 执行 open -R <路径>（lib/index.js:535），这是 macOS Finder 专属命令；Windows / Linux 上没有 open，点击会得到「打开失败」错误，列表展示本身仍可正常用。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明
  • Node: 未声明
  • Platforms: 跨平台, macOS

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则

dsh-balance-plugin 使用指南