前言¶

DeepSeek Harness (DSH) 采用插件化架构，允许开发者扩展 Web 界面功能。在使用 DeepSeek API 进行开发或日常对话时，查看账户余额、当日累计消费以及当前是否处于高峰计价时段往往需要切换页面或刷新。dsh-balance-chart 是一个 DSH Web GUI 插件，它将账户余额、当日消费和峰谷时段计价绘制在会话标题栏上的双层图表，提供零依赖的实时监控。

插件定位¶

名称：dsh-balance-chart
维护者：fqsklm
协议：MIT
定位：DSH Web GUI 插件，用于在会话标题栏展示余额、当日消费和峰谷时段计价的双层图表。采用零依赖设计，并以余额差值优先记账，更贴近真实扣费。

核心功能¶

• 余额进度条：在标题栏显示账户余额，满格金额可在设置中修改。
• 峰谷时段条：显示 24 小时峰谷时段，支持点击跳转 DeepSeek 平台用量页。
• 每轮消耗柱状图：显示每轮对话的余额消耗，按当时计价时段着色。
• 当日累计折线：叠加在柱状图上，显示今日累计消耗。
• 悬停详情：鼠标悬停可查看某轮的详细消耗数据（含时间、轮次、累计、tokens 拆分等）。
• 全屏视图：点击全屏图标查看全天账单明细表和每轮详情。
• 折叠：点击折叠成摘要条，节省空间，状态会自动保存。
• 设置：支持修改价卡、峰谷时段、周末规则等，不涉及代码修改。
• 自动贴到最新：卡片和全屏视图自动滚动到最新数据，避免停留在历史数据。

安装与启用¶

1. 克隆仓库到本地目录：

    git clone https://github.com/fqsklm/dsh-balance-chart.git
    cd dsh-balance-chart

2. 将插件添加到 DSH Web profile：

    dsh plugin --profile web add link:$PWD

3. 手动编辑配置文件以挂载插件。编辑 $DSH_HOME/profiles/web/cordis.patch.yml，在文件末尾添加以下内容：

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

4. 回浏览器按 F5 刷新页面，标题栏将显示图表。

使用方法¶

• 看一眼：标题栏展开时，第一行显示峰谷条和今日消耗，下方是柱状图和余额条。
• 悬停：鼠标移到柱状图上，查看某轮的详细消耗数据。
• 跳转平台：点击峰谷条任意位置，新标签页打开 DeepSeek 平台用量页。
• 折叠：点击 ▴ 折叠成一行摘要，状态会自动保存。
• 全屏：点击 ⛶ 查看全天账单明细表和每轮详情。
• 设置：点击 ⚙ 修改价卡或规则。

配置与数据¶

• 前置条件：DSH 凭据中必须包含 DEEPSEEK_API_KEY，否则余额层将显示不可用，但消耗换算仍可正常工作。
• 配置文件：位于 $DSH_HOME/.dsh-balance-chart.（需手动编辑 cordis.patch.yml 以挂载插件，数据文件默认保存在 DSH_HOME 目录）。
• 记账方式：默认采用余额差值优先记账，更贴近真实扣费。

结语¶

该插件通过零依赖的设计，解决了在 DSH 界面中无法直观查看余额、消费和峰谷计价的问题。安装后，图表会自动跟随对话更新，无需切换窗口。

• GitHub 仓库
• 插件目录