前言¶

DSH 的理念是「一切皆插件」。对 DSH 用户来说，API 费用统计可以做成一个独立插件：在会话底部显示当前会话费用，在设置页显示全局累计费用。

下面介绍 fflow2023/dsh-usage-cost。它是一个轻量的 DeepSeek Harness 插件，用于会话级与全局的 API 费用统计。

这是什么¶

dsh-usage-cost 由 fflow2023 维护，许可证为 MIT。它把“当前会话累计花了多少钱”并入会话底部统计行，并在设置页提供“费用统计”面板。

它是一个只读费用估算插件：数字基于持久会话日志重放得出，重启、冷读可恢复。插件不向模型注入提示、schema、工具或消息，零直接 token 影响，不影响 KV Cache。

核心功能¶

启用后，可见的功能包括：

1、会话底部与 token 统计同一行显示费用，并包含高峰/闲时价格。

2、设置 → 费用统计：展示全局累计费用、高峰/闲时拆分、按模型拆分（V4 Pro / V4 Flash），以及按会话降序列表。

计费范围只覆盖 deepseek-v4-pro 与 deepseek-v4-flash。其它模型计入 unpricedTokens，不静默按错价。

实现上，插件为纯 JS、零构建、零运行时依赖；Host 侧为 1 个 projection 单元，每个事件 O(1)。

计费口径¶

费用单位为元 / 百万 tokens。插件按 2026-08-17 00:00 北京时间生效的峰谷价计费。

高峰时段为北京时间 9:00–12:00、14:00–18:00；其余为空闲时段，价格按高峰的一半计算。

价格相关配置集中在 index.js 的 PRICES。价格变动时，只改 index.js 并 bump 版本号即可。

安装与启用¶

从 GitHub 安装：

dsh plugin --profile web add github:fflow2023/dsh-usage-cost

使用包名安装：

dsh plugin --profile web add @fflow2023/dsh-usage-cost

源码 checkout 环境中，将上述 dsh 安装命令替换为 pnpm dsh plugin --profile web add ... 的对应命令。

第一次从 git 安装时，pnpm 会提示把生成的 allowBuilds 键复制进该 profile 的 pnpm-workspace.yaml，然后重跑一次。从 GitHub 安装需要为构建授权一次。

插件的 peer dependencies 为：

{
  "@deepseek-ai/cordis": "^4.0.1-rc.1",
  "react": "^18.2.0"
}

典型用法¶

安装并启用后，按界面查看：

1、在会话底部，和 token 统计同一行查看当前会话费用，以及高峰/闲时价格。

2、在“设置 → 费用统计”中查看全局累计费用、高峰/闲时拆分、按模型拆分和按会话降序列表。

它不向模型注入提示、schema、工具或消息。

适用场景与注意¶

适合在 DSH web profile 中查看 deepseek-v4-pro 与 deepseek-v4-flash 会话级、全局 API 费用的使用场景。

使用注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码、MIT 许可证和依赖。
• 它是只读投影，不改变模型输入，不影响 KV Cache。
• 非计费模型会进入 unpricedTokens，不要将其误读为已计价费用。
• 价格规则基于 2026-08-17 00:00 北京时间峰谷价；若价格更新，需要同步更新插件版本。

链接¶

GitHub：https://github.com/fflow2023/dsh-usage-cost