前言¶

在 DSH Web 里跑 DeepSeek 模型时，费用不是一个简单数字：输入、输出和缓存命中都会影响成本，高峰/空闲时段也会变化。如果只在事后翻日志估算，容易漏项，也不方便导出。

dsh-token-billing 是一个 DSH 插件，把实时费用、价格来源、历史账本、统计和导出放进同一个设置入口。DSH 的插件生态以“一切皆插件”为组织方式；这个插件是第三方扩展，与 DeepSeek/幻方没有官方从属关系，也不是 DeepSeek 官方应用商店。

这是什么¶

2006spy/dsh-token-billing 是 DeepSeek Harness（dsh）实时 token 计费插件，许可证为 MIT，资料中的分类为联网工具。

它面向 DSH Web，解决的是会话内费用不直观、历史费用难查询、多 Provider 成本难分类的问题。

核心功能¶

下面介绍资料中列出的主要能力：

• DeepSeek 官网人民币价直接计费：价格来源默认 DeepSeek 官网中文页，英文页兜底；外币价可自动折算人民币。
• 价格实时跟随官网：价格表可随官网变化更新，减少手工维护固定价格。
• 高峰/错峰自动切换：插件会按官方计费规则区分高峰和空闲时段。
• 可视化自定义模型价格：在插件配置中维护模型价格覆盖；模型价格覆盖优先级最高，不参与高峰/错峰。
• 多币种兜底：外币价格可折算，避免单一币种显示不完整。
• 持久化历史账本 + 多维统计：把结算结果保存为历史账本，并用于后续统计。
• 账户余额查询：需要 DEEPSEEK_API_KEY；资料说明 key 不下发浏览器。
• CSV / JSON 导出：支持把账本导出为 CSV 或 JSON。
• 本地模型节省统计：用于把本地模型调用与 API 名义价格对照，统计节省额度。
• Provider 收费形式分类：支持订阅、免费、本地等收费形式，用于区分实际花费与名义价值。
• Token 用量与缓存命中统计：可查看 Token 用量与缓存命中情况。
• 统计页仪表盘：提供仪表盘式统计页，用于概览费用与用量。

安装与启用¶

安装前先确认你是在 DSH 的 web profile 下操作。资料给出的安装方式包括插件市场、pnpm 依赖和本地源码链接。

插件市场（资料标注为待上架）¶

资料给出的入口是：

1、打开 DSH
2、进入 设置 → 插件 → 市场
3、搜索 dsh-token-billing
4、点击安装

需要注意：资料中把该方式标注为推荐但待上架，实际是否已上架未在已核实资料中确认。如果搜索不到，可改用下面的依赖安装方式。

在 web profile 目录安装依赖¶

这一步把插件作为依赖加入 DSH web profile。在 web profile 目录下执行：

pnpm add github:2006spy/dsh-token-billing#main

然后挂载插件。在 ~/.dsh/profiles/web/cordis.patch.yml 追加：

- insert:
    - id: token-billing
      name: dsh-token-billing

完成后重启 DSH，使插件加载生效。

本地源码链接¶

如果你要读源码或改配置，可以先克隆仓库：

git clone https://github.com/2006spy/dsh-token-billing.git

然后以 link 依赖方式接入 web profile。资料没有给出更具体的本地链接字段示例，实际以 DSH 的依赖配置方式为准。

启用后的基本用法¶

1、打开 设置 → 插件 → Web UI 插件 → Token 计费，保存配置即时生效。
2、在 DSH Web 会话中发起一次 DeepSeek 请求，查看费用行是否出现。
3、进入统计页，查看历史账本、Token 用量与缓存命中、余额和导出入口。
4、如需调整价格，维护模型价格覆盖；该配置优先级最高，不参与高峰/错峰。
5、如使用本地或订阅 Provider，配置 Provider 收费形式分类，以便区分实际花费与名义价值。

DSH 桌面端 2.0.2（核心 0.1.1-rc.1+）下，资料要求把插件更新到 v0.7.1 并重启 DSH，否则费用行不显示、账本冻结。

适用场景与注意¶

适合以下使用方式：

• 在 DSH Web 中调用 DeepSeek 模型，希望实时看到会话费用。
• 需要查看历史账本，并导出 CSV / JSON。
• 使用本地模型、订阅 Provider 或免费 Provider，希望区分“实际花费”和“名义价值”。
• 需要账户余额查询，并能接受 DEEPSEEK_API_KEY 用于余额查询。

使用前注意：

• 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。本插件许可证为 MIT。
• 资料中的目录页、GitHub 页和插件线索来自第三方仓库，不能替代 DeepSeek 官方价格页。费用核算应以你实际使用的价格源、配置和官方规则为准。
• 账户余额查询依赖 DEEPSEEK_API_KEY；资料说明 key 不下发浏览器。
• 官方高峰/周末空闲规则自北京时间 2026-08-23 00:00 生效；生效前周末仍按高峰价，历史回看不减半。
• 插件市场入口是否可用尚未确认，资料标注为待上架。

链接¶

• 目录页：https://www.skillhub.cn/plugins/2006spy/dsh-token-billing
• GitHub：https://github.com/2006spy/dsh-token-billing