前言¶

在 DeepSeek Harness（DSH）里用 Web GUI 对话时，官方 usage 行会汇报 token 用量，但不会按 DeepSeek 公布的 Peak/Off-Peak 时段和区域价目表，把「当前属于哪个计费窗口、本会话大概花了多少钱」摆在 composer 下方。若你关心官方 Flash/Pro 在 USD 或 CNY 表下的分时单价，或者想在不离开界面时核对 cache hit/miss 与 output 是否分开计价，单靠 Harness 自带 UI 往往不够直观。

下面介绍社区插件 dsh-token-pricing（维护者 kachanov-e-v，分类：模型推理）。它在 composer dock 增加一行摘要，并在点击后展开明细；不替代 Harness 自带的 usage 行，也不改动其逻辑。

这是什么¶

dsh-token-pricing 是面向 DeepSeek Harness Web GUI 的 bundle 插件（MIT，当前资料中的版本 1.0.4）。它在 composer 下方显示：

• 当前 Peak 或 Off-Peak 模式（颜色与文案）；
• 浏览器识别的本地时间与 IANA 时区；
• 按官方区域价目表估算的当前会话 token 费用。

点击该行可打开 popover：下一次模式切换时间、区域/货币、Peak/Off-Peak 与 Flash/Pro 拆分、未计费 token 说明，以及文档链接。Popover 可用 ×、点击面板外或 Escape 关闭，焦点会回到该行。

插件仅在客户端根据已有 session 事件与 provider 上报的 usage 做投影计算，不发起网络请求、不读取 credentials、不向外发送 usage。

核心功能¶

界面与交互¶

收拢时一行大致形如（时区因环境而异）：

● OFF-PEAK · 19:44 GMT+3 · Расход сессии: $0.0123 · ▾

（界面文案随 locale 资源变化；逻辑相同。）

计费与数据范围¶

• Peak / Off-Peak：按 UTC 窗口、工作日/周末及中国法定节假日判断；当地时区只用于显示时间与「下次切换」，不改变模式判定。
• 区域与货币：由浏览器 IANA 时区与 locale 推断；大陆常用时区走 CNY 表，其余走 USD 表；不做汇率换算，两表独立。
• 价目来源：DeepSeek 官方文档（USD 与 CNY 各一页）；插件内费率在资料中标注为截至 2026-11-05。
• 用量粒度：每个 usage 样本单独计价，绑定 step 开始时间；区分 cache miss、cache hit、output；Flash、Pro 与未计费 token 不混算。
• 会话范围：只统计当前会话且 provider 上报的 usage；不含 Search/Fetch、子会话等；这是估算，不是 DeepSeek 账单。

自动隐藏¶

在以下情况插件故意不显示该行：

• 会话尚未有确定的模型选择（modelSelection.next 为空）；
• 非支持的模型或第三方 provider；
• 模型无官方公开价目。

不支持模型的费用不会被猜测或填充。

架构概要¶

Session log
   │  existing events only
   ▼
tokenPricing projection (Host)
   │  buckets + costs.intl + costs.cn + schedule + supportedModels
   ▼
Client dock row
   │  modelSelection.next → gating
   │  timezone/locale → region + local time
   ▼
Row + click popover

Host 侧通过 ctx.sessionProjections.register() 注册投影；客户端注入 Web 对话 UI，无需单独构建步骤（ESM/JS）。

环境与兼容性¶

• 需要带 Web GUI 的 DeepSeek Harness；资料记载在 0.2.2-rc.1 上验证过。
• Profile 需具备 sessionProjections、conversation.composer.dock 及标准 projection modelSelection。
• Node.js 仅用于本地测试与开发；安装 bundle 本身不要求构建。
• 依赖 zod（install_bundle 时会安装）。

安装与启用¶

插件通过 profile 的 plugin_manager 从 GitHub 安装，无需 clone 仓库或本地打包。

最新 main（指向仓库默认分支最新提交）：

plugin_manager install_bundle target=https://github.com/kachanov-e-v/dsh-token-pricing

固定发行版本（资料中的示例为 v1.0.4）：

plugin_manager install_bundle target=https://github.com/kachanov-e-v/dsh-token-pricing/archive/refs/tags/v1.0.4.tar.gz

安装后 profile 中会保留依赖项 github:kachanov-e-v/dsh-token-pricing 并绑定到对应 commit。重复安装同一版本或同一链接会被拒绝为 already-installed。

本地开发目录安装（将路径换成你的绝对路径）：

plugin_manager install_bundle target=<绝对路径到插件目录>

更新时先移除再安装：

plugin_manager remove_bundle target=@local/dsh-token-pricing
plugin_manager install_bundle target=https://github.com/kachanov-e-v/dsh-token-pricing

更新客户端部分后需刷新 Web GUI 页面。

DSH 生态理念是「一切皆插件」；SkillHub 目录页为社区收录站点，与 DeepSeek / 幻方无官方从属关系。安装前请自行审阅仓库源码与 MIT 许可证——插件以当前 DSH 进程权限运行。

典型用法¶

1. 在 composer 中选择支持的官方 DeepSeek 模型，例如：
   - deepseek-flash；
   - 旧版 deepseek-v4-flash、deepseek-v4-flash-vision-exp；
   - deepseek-v4-pro。
2. Provider 须为 deepseek-account 或 deepseek-official。
3. composer 下方出现模式、时间与会话费用摘要。
4. 点击该行查看 popover 明细。

尚无 usage 时显示「无数据」而非 $0；全部 token 未计价时显示「无费率」；部分未计价时会显示合计与警告。

Peak/Off-Peak 窗口（判定规则）¶

Peak：UTC 01:00–04:00 与 06:00–10:00，周一至周五，且非中国法定节假日。其余时间（含周末与节假日）为 Off-Peak。Off-Peak 单价在官方表上为 Peak 的一半（插件内对 USD/CNY 两表均有测试校验）。

节假日按 Asia/Shanghai 日历与国务院公布的 2026 年安排计算；资料中列出具体日期区间及来源链接。模式判定使用绝对 UTC 区间，与用户显示的本地时区无关。

价目表示例（资料摘录）¶

以下为 README 中的公开单价（每 1M tokens）：

完整说明与链接见仓库 README 中的「Тарифы」一节。

适用场景与注意¶

适合谁：在 DSH Web GUI 里长期使用官方 DeepSeek Flash/Pro，希望在对话界面实时对照 Peak/Off-Peak 与区域官方价目、并复盘当前会话 token 花费的开发者。

需要注意：

• 费用估计依赖 session 内已有事件与 provider usage；日志被截断或缺少 step 时会回退到 event.time，可能与账单有偏差。
• 同一 turn/step 上较新的 usage 会覆盖较早记录；llm/retry-started 后的重试单独累加。
• 插件不覆盖 RUB 等其他货币，也不使用第三方汇率。
• 仅当模型与 provider 匹配且存在公开费率时才展示；第三方模型或无费率模型不会出现「假零元」。

结尾¶

经过上面的步骤，你可以在 DSH Web GUI 的 composer 旁获得 Peak/Off-Peak 状态、本地时间与基于官方 USD/CNY 表的会话 token 费用摘要，并在 popover 中查看拆分细节——全程不额外联网、不碰凭证。

• 目录页：https://www.skillhub.cn/plugins/kachanov-e-v/dsh-token-pricing
• 源码与安装说明：https://github.com/kachanov-e-v/dsh-token-pricing