dsh-balance：在 dsh Web 底部显示 DeepSeek 账户余额

在 DeepSeek Harness (DSH) 的开发流程中，频繁查看账户余额是常态。这通常需要切换标签页或打开官方面板，打断工作流。dsh-balance 将这一数据直接嵌入 Web 界面。

插件简介¶

dsh-balance 是一个由 ywleeo 维护的客户端插件，用于在 dsh Web 对话底部显示 DeepSeek 账户余额。它不依赖复杂的构建过程，直接读取环境变量中的 API Key 并获取余额数据。

核心功能¶

位置与样式：显示在 token 统计行前面（conversation.composer.dock，order: -1）。样式与 token 统计保持一致（12px / label-tertiary / 居中）。
数据刷新：页面加载时自动获取，之后每 5 分钟轮询一次。点击数字旁的 ⟳ 图标可手动刷新。
时段着色：根据北京时间实时判定计费时段。周一至周五 09:00–12:00 / 14:00–18:00 为高峰时段，余额显示橙色；其余时间为空闲时段，显示正常色。悬停可查看当前时段说明。
交互：点击余额数字，会在新标签页打开官方余额/用量面板。
安全与架构：API Key 不离开本地 host，仅通过 fetch 请求同源 JSON 接口。不写入会话日志，不注册投影，无污染风险。采用纯 ESM，零构建。

安装与启用¶

    cd ~/.dsh/profiles/web

使用 pnpm 安装插件（支持本地路径或 GitHub 仓库）：

    pnpm add file:/path/to/dsh-balance   # 或 pnpm add github:ywleeo/dsh-balance

在 ~/.dsh/profiles/web/cordis.patch.yml 文件中追加以下配置：

    - insert:
        - id: dsh-balance
          name: dsh-balance

重启 dsh web 并刷新浏览器页面。

工作原理¶

插件采用“Host 壳”机制防止崩溃。index.js 作为壳，不直接依赖 dsh 核心模块，确保 boot 审计通过。它运行时动态加载 host.js，host.js 负责解析 DEEPSEEK_API_KEY 并调用官方 API。client.js 负责在界面展示。如果 host.js 加载失败，插件会停用但不会导致 dsh 进程退出。

适用场景与注意¶

适合需要实时监控 DeepSeek 账户成本的开发者。插件遵循 MIT 许可证。安装前建议检查源码。插件以当前 dsh 进程的权限运行，API Key 仅在本地传输。

总结¶

dsh-balance 解决了在开发过程中频繁切换窗口查看余额的痛点，将关键信息通过精简的小字直接展示在对话底部，并提供了基于时段的视觉提示。更多细节可参考 GitHub 仓库：https://github.com/ywleeo/dsh-balance。