前言¶

在 DeepSeek Harness（dsh）里跑对话时，token 数能说明调用量，但不一定能直接回答“这一步花了多少钱”“今天花了多少钱”“余额还剩多少”。如果希望这些数字在 dsh web 界面里直接可见，而不需要额外去其他页面查，就需要一个能读取会话日志、本地计算费用、并展示余额与成本分布的插件。

下面介绍 suanzhang-dsh，一个 DeepSeek Harness 计费插件：侧边栏显示余额和今日消费，算账页签按步骤列出费用，官方价自动同步，并支持跨会话、跨天汇总。

这是什么¶

suanzhang-dsh 是一个 DeepSeek Harness 计费插件，仓库地址为：

https://github.com/CZ1900/suanzhang-dsh

许可证为 MIT。

它面向已经能打开 dsh web、并希望在本机查看 DeepSeek 调用费用的场景。插件本身不调用模型，主要做本地费用计算、余额展示、官方价同步和成本汇总。

核心功能¶

suanshang-dsh 提供下面这些已核实的展示与计算能力：

• 侧边栏常驻显示当前余额和今日消费。
• 算账页签按步骤列出费用明细。
• 按模型、工具、天、会话可视化成本。
• 成本预测：平均每步 × 步数。
• 官方价自动同步；抓取失败时回退到内置价。
• 点击任意步骤行可跳到「轨迹」页签，并高亮对应步骤。
• 支持 DeepSeek V4-Flash / V4-Pro，含峰谷计价；也支持 deepseek-chat / deepseek-reasoner。
• 其他模型会显示「未计价」。
• 支持跨会话、跨天汇总。
• 插件不调用模型，不消耗 token；主要是本地计算，外加两个用于余额查询和官方价获取的 HTTP 请求。

前置条件¶

安装前建议先确认几项条件：

1. 本机已有可打开的 DeepSeek Harness 环境，即 dsh web 能正常打开。
2. Node 版本不低于 22。

可用下面命令确认 Node 版本：

node -v

如果选择从 GitHub 安装，还需要本机 Git 可用，并且能访问 github.com。公司网络、代理或防火墙可能会拦截 GitHub 访问，这时可以改用本地复制方式安装。

DeepSeek API Key 用于余额查询。插件默认读取：

DEEPSEEK_API_KEY

如果没有配置 API Key，余额栏会提示未配置，但费用汇总和计价仍可使用。

API Key 的使用范围比较明确：它只用于一次余额查询请求，不落地、不打印、不进日志、不进截图；返回前端的信息会先剔除 Key。

安装与启用¶

方式一：从 GitHub 安装¶

先执行安装命令：

pnpm add https://github.com/CZ1900/suanzhang-dsh.git

这一步会把插件仓库加入当前项目依赖。

然后编辑 Harness profile 下的 cordis.patch.yml，在顶部加上：

- insert:
    - id: suanzhang
      name: suanzhang-dsh

保存后重启：

dsh web

重启后刷新页面，可以看到侧边栏余额和「算账」页签。

方式二：本地复制安装¶

如果 GitHub 访问受限，可以把仓库放到 DSH profile 的 node_modules 目录下。

在 DSH profile 目录，例如：

~/.dsh/profiles/web

执行：

cp -r /path/to/suanzhang-dsh node_modules/

其中 /path/to/suanzhang-dsh 替换为本机上的插件目录。

然后同样在 cordis.patch.yml 里加上：

- insert:
    - id: suanzhang
      name: suanzhang-dsh

重启 dsh web 后刷新页面即可。

典型用法¶

安装并重启后，常见操作路径如下：

1. 打开 dsh web。
2. 在侧边栏查看当前余额和今日消费。
3. 点击侧边栏余额，直接跳进「算账」页。
4. 在「算账」页查看按步骤列出的费用明细。
5. 查看按模型、工具、天、会话划分的成本分布。
6. 使用成本预测，用「平均每步 × 步数」估算后续费用。
7. 点击任意步骤行，自动跳到「轨迹」页签，并高亮那一步。

如果只是想确认环境是否满足要求，可以先把 Node 版本查清楚：

node -v

价格与数据边界¶

suanshang-dsh 的计价和数据来源可以分成几类。

余额查询¶

余额查询会访问 DeepSeek 官方接口。默认 baseURL 为：

https://api.deepseek.com

API Key 仅用于这次余额查询请求，不用于本地费用计算。

官方价同步¶

官方价同步会访问 DeepSeek 公开文档页面：

https://api-docs.deepseek.com

该请求无鉴权，只读。

如果抓取失败，插件会回退到内置价，不影响费用汇总和展示。

本地费用汇总¶

费用计算和本地汇总会读取本机会话日志。显示、排序、图表等计算在浏览器本地完成，不出本机。

适配模型与关键参数¶

支持的模型¶

已核实支持：

• DeepSeek V4-Flash
• DeepSeek V4-Pro
• deepseek-chat
• deepseek-reasoner

其中 DeepSeek V4-Flash / V4-Pro 支持峰谷计价。

其他模型会显示「未计价」。

默认关键参数¶

以下参数来自已核实资料，默认值硬编码在插件中：

轮询频率可在 lib/client.js 中的 60000 毫秒处调整；如果希望降低刷新频率，可以把这个毫秒值改大。

代码入口¶

已核实的代码结构如下：

• lib/index.js：Host 端，包含余额、计价、汇总、今日相关能力。
• lib/client.js：浏览器端 UI。

适用场景与注意¶

suanshang-dsh 适合这类场景：

• 已经在 DSH 中使用 DeepSeek。
• 不想手动换算 token 价格。
• 希望侧边栏直接看到余额和今日消费。
• 希望把一次对话里的每一步费用拆出来看。
• 希望按模型、工具、天、会话汇总成本。
• 希望点击某一步费用时，能跳到对应轨迹步骤。

需要注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 插件本身不消耗 token；真正消耗 token 的是 dsh 对话。
• API Key 只用于余额查询，不参与本地费用计算。
• 如果侧边栏或「算账」页签没有出现，先确认 cordis.patch.yml 中已加入 id: suanzhang 和 name: suanzhang-dsh，然后重启 dsh web 并刷新页面。
• 如果余额显示「未配置 API Key」或查询失败，先到 Harness 设置里确认 DeepSeek API Key 已配置。
• 如果 pnpm add 安装失败，优先检查本机 Git、网络、代理或防火墙；无法访问 GitHub 时改用本地复制安装。

结尾¶

suanshang-dsh 的价值比较直接：把余额、今日消费、步骤费用、成本分布和成本预测放进 DeepSeek Harness 的界面里，并且主要依靠本地会话日志完成计算。

GitHub 仓库地址：

https://github.com/CZ1900/suanzhang-dsh