前言¶
在使用 DeepSeek Harness（dsh web）进行智能体开发或长期对话时，经常会遇到一个具体问题：无法直观看到当前会话消耗了多少 token，也不知道不同供应商、不同时段的价格差异。这会导致成本控制不透明，甚至难以判断是否需要切换模型或供应商。
这是什么¶
dsh-token-fee 是为 DeepSeek Harness 网页端提供会话实时花费显示的插件，由 lantiosity 维护。它会在输入框下方展示费用胶囊，精确到分，并可按供应商、模型、缓存命中/未命中、输出等维度展开明细。支持按供应商区分价格，以及峰谷分时定价。
核心功能¶
- 会话实时花费：输入框下方显示费用胶囊，默认以人民币显示当前会话花费，精确到分。支持切换展示币种。
- 用量与费用明细：点击胶囊展开面板，按供应商/模型分组，列出缓存未命中、缓存命中、缓存写入、输出四类 token 的数量与金额。
- 按供应商区分价格：同一个模型在不同供应商下可有不同单价。
- 峰谷分时定价：支持高峰/空闲两档单价，可自行设置时区、高峰星期、高峰时段。胶囊上实时显示当前时段与到下一次切换的剩余时间。
- 价格配置面板：插件设置中有独立页面，也能从费用面板直接打开。
- 价目表文件：价目表存储在
<DSH_HOME>/token-fee.json，手工编辑后即时生效，无需重启。 - 界面中英双语。
安装与启用¶
装完都重启 dsh web，再硬刷新浏览器。
插件管理器（DSH 0.1.6-alpha.2 起）：
侧栏 → 插件 → 添加插件，在「包名或地址」里填下面任一种：
- npm 包名：
@lantiosity/dsh-token-fee - GitHub 简写：
github:lantiosity/dsh-token-fee - 仓库地址：
https://github.com/lantiosity/dsh-token-fee - 本地检出：本仓库目录的绝对路径
点安装：Host 会先读出这个 spec 指向什么，确认是带 dsh.bundle.patch 的插件后才开始装；装完点立即启用。
命令行：
# 从 npm 安装
dsh plugin --profile web add "@lantiosity/dsh-token-fee"
# 从 GitHub 安装
dsh plugin --profile web add "github:lantiosity/dsh-token-fee"
# 或从本地检出安装（把路径换成本仓库所在目录）
dsh plugin --profile web add "/path/to/dsh-token-fee"
备选安装器（无法使用 dsh plugin 时）：
node scripts/install.mjs # 复制文件并幂等写入 profile patch
node scripts/install.mjs --dry-run # 只打印将写入的路径
node scripts/install.mjs --check # 校验既有安装
典型用法¶
安装完成后，费用胶囊会出现在输入框下方，与内置的「轮次 / 速度」和「token 用量」胶囊并排。默认显示 ¥0.12 这样的金额；会话中还有未配置价格的模型时，会额外标注未定价数量。
点击胶囊展开面板，顶部是合计金额，下面按供应商分组；每个模型默认只显示总 token 数与费用，点它展开才是四个计费桶各自的 token 数与金额。区分峰谷的条目会标注「区分峰谷」。
在面板内的第二个标签页，或在 dsh 设置中打开「Token 费用」页，可以配置价目表。
适用场景与注意¶
本插件适用于需要精细控制 token 成本、使用多供应商或需要区分峰谷定价的场景。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证（MIT）。
已知限制包括：远程访问时端点不可用（价目表端点只接受回环来源）；节假日数据需逐年更新；跨币种需要手动配置汇率；倒计时的小时不进位到天。
短结尾¶
dsh-token-fee 为 DeepSeek Harness 提供了透明的会话计费能力，适合需要精细成本控制的开发者。详见：https://www.skillhub.cn/plugins/lantiosity/dsh-token-fee，https://github.com/lantiosity/dsh-token-fee
