前言¶

在 DeepSeek Harness（DSH）里长时间用 Web 界面调模型、跑任务时，账户余额往往要另开页面或控制台去查。把「还剩多少钱」放在侧边栏底部，和当前工作区同屏可见，能减少切换；若还能区分峰谷计价时段，对控制调用成本也有直接帮助。下面介绍社区维护的客户端插件 dsh-minimal-balance（维护者 camik86），它在 DSH Web 侧边栏底部、「设置」按钮正上方显示 DeepSeek 账户余额，并附带峰谷价指示与低余额提示。插件为只读展示，无遥测；API key 仅存在于 Host 进程，不下发浏览器。

这是什么¶

dsh-minimal-balance 是面向 DSH Web 客户端的社区插件（分类：客户端），不是 DeepSeek 官方产品。Host 侧请求上游余额接口，浏览器通过同源路由只拿到金额字符串；侧边栏用一行「余额 ¥xx.xx」展示，侧栏收起为 56px 窄栏时仍可显示。

核心功能¶

余额展示与刷新¶

• 挂载时、每 60 秒、标签页重新变为可见时各刷新一次；点击徽章可立即刷新。
• 未配置有效 API key 时显示 --。
• 余额低于阈值时金额变暖色警示：CNY 2 / USD 1（以资料说明为准）。

峰谷指示线¶

金额下方约 2px 的短线表示当前计价时段（按北京时间）：

• 蓝色：谷价
• 棕色：峰价
• 红色：欠费或不可用

规则概要：工作日 09:00–12:00、14:00–18:00 为峰时；周末与中国法定节假日全天为谷价。2026 年节假日表内置在插件中，需按年更新。

安全与请求边界¶

• 浏览器只调用同源路由 /dsh-minimal-balance，不接触 API key。
• 无第三方请求、无遥测。
• 默认仅允许私有网段客户端读取（loopback、10/8、172.16/12、192.168/16、link-local、IPv6 ULA、CGNAT/Tailscale 100.64/10）；公网地址返回 403，除非在受信反向代理后显式放开（见配置项）。

安装与启用¶

任选 README 中的一种方式安装（命令须与资料一致）：

# 插件管理器（推荐，npm 发布后）
plugin_manager install_bundle dsh-minimal-balance

# 直接从 GitHub（无需 npm）
plugin_manager install_bundle github:camik86/dsh-minimal-balance

# 或 CLI
dsh plugin --profile web add dsh-minimal-balance

安装后启动 dsh web，在侧边栏底部应能看到徽章。修改部分配置后可能需要重启一次 dsh web。

运行环境（来自 package.json）：Node >= 22，DSH >= 0.2.0。许可证：MIT。

配置 API key¶

插件通过 DSH 凭据服务解析 DEEPSEEK_API_KEY，逐次解析，更换 key 一般无需重启。任选其一：

1. 在 DSH 设置中将 DEEPSEEK_API_KEY 写入凭据（推荐）
2. 进程环境变量：DEEPSEEK_API_KEY=sk-...
3. 在 $DSH_HOME/.credentials.yaml 中写入：DEEPSEEK_API_KEY: sk-...

插件配置项¶

在 profile 的 cordis.patch.yml 中覆盖 dsh-minimal-balance 对应条目：

- id: dsh-minimal-balance
  name: dsh-minimal-balance
  config:
    enabled: true                  # 总开关
    baseURL: https://api.deepseek.com
    apiKeyEnv: DEEPSEEK_API_KEY    # 凭据名 / 环境变量名
    cacheSeconds: 30               # 上游结果缓存秒数
    timeoutMs: 10000
    allowPublicClients: false      # 仅当 DSH 前有可信认证代理时才设为 true

allowPublicClients 默认保持 false；仅在 DSH 置于自有、已做连接的认证反向代理之后，再考虑设为 true。

典型用法与可选组件¶

日常使用无需额外操作：配好 DEEPSEEK_API_KEY 并启用插件后，在 Web 侧边栏查看余额与峰谷色线即可；需要最新数字时点一下徽章。

若上游路由只接受 loopback，而需要在手机等局域网设备上看徽章，可加装可选的局域网桥组件（独立包 dsh-minimal-balance-lan，说明见仓库 lan/README.md）。主插件客户端会先走原生路径，失败时自动回退到桥；装或卸桥不必改客户端配置。

仓库主要文件分工：

适用场景与注意¶

适合谁： 经常在 DSH Web 里开发、调试智能体或对话流，希望侧边栏一眼看到 DeepSeek 余额，并留意峰谷计价时段的开发者。

安装前请注意：

• 插件以当前 DSH 进程的权限运行，安装前应自行查看 GitHub 源码 与 MIT 许可证，确认符合你的安全策略。
• 社区插件目录 SkillHub 条目 与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，目录站为社区独立维护，并非官方应用商店。
• 认证仍由 DSH 自身的连接校验与启动 token 负责，本插件不新增鉴权层；公网暴露务必结合代理与 allowPublicClients 谨慎配置。

结尾¶

dsh-minimal-balance 在 DSH Web 侧边栏底部提供极简、只读的 DeepSeek 余额与峰谷价提示，并把 key 留在 Host。需要安装命令、配置字段与安全说明时，以仓库 README 为准。

• 社区目录：https://www.skillhub.cn/plugins/camik86/dsh-minimal-balance
• 源码与文档：https://github.com/camik86/dsh-minimal-balance