前言¶
在使用 DeepSeek Harness（DSH）Web 界面进行开发或调试时，直观查看单次交互的 Token 消耗和累计费用有助于控制成本。arthur20150522/dsh-token-usage-cost 插件提供纯 UI 展示，不进入模型上下文，不影响会话与 token 统计。
功能概览¶
该插件在 DSH Web 界面提供以下能力：
- 每轮费用 chip：在每轮（提问 → 回答 + 工具调用）结束后，在复制/反馈操作栏中常驻显示本轮费用、输入输出 token 数及模型短名。支持按模型着色，悬浮可查看明细。
- 会话累计行：在输入条上方状态行下方，显示整场会话累计费用与 token。切换模型时会显示“多模型”。
- 自动拉取价格表：从 LiteLLM 社区表、OpenRouter、models.dev 等权威源并发拉取价格，自动识别格式并合并成表，Host 侧支持磁盘缓存。
- 一键对账同步：通过点会话累计行末尾的 ⚙，进入配置界面。使用 ⟳ 同步按钮可拉取全部价格源并枚举已配置模型，自动匹配后写回
modelMap配置。 - 多维度费用配置：支持按模型配置费用、币种与汇率换算、峰谷/时段价配置、历史模型归因。
- REST API：提供配置读写、价格查询、强制刷新和对账接口。
安装与启用¶
通过官方 CLI 安装：
dsh plugin --profile web add github:arthur20150522/dsh-token-usage-cost
# 然后重启 dsh web
安装包自带 dsh.bundle 和 cordis.patch.yml，会自动挂载，无需手动修改 profile 的 patch 文件。
使用方法¶
- 查看每轮费用：每轮交互结束后，观察复制/反馈操作栏中的 chip，显示格式为
本轮 · 费用 · ↑输入 ↓输出 · 模型短名。 - 编辑配置：点击会话累计行末尾的 ⚙，进入页面内置的迷你编辑器。在这里可以修改币种/汇率、峰谷时段规则、模型映射或手动覆盖价格。
- 对账同步：在配置界面点击 ⟳ 同步按钮，插件会强拉价格源并匹配当前已配置的模型，将命中的映射自动写回配置，同时列出未匹配的清单。
注意事项¶
- 零构建链：插件无需构建，源码为
lib/index.js(host, ESM) 和lib/client.js(client, factory CJS classic script)。修改 host 代码需重启，修改 client 代码刷新页面即可。 - 数据源：费用优先读取 DSH 全量
session.history中每条assistant/message的usage、message.source与事件时间。 - 许可证：MIT License。
开发与维护¶
该插件遵循零依赖原则，主要文件位于 lib/ 目录。开发者可通过本机 Node ≥ 18 环境直接运行测试（node test\run-tests.mjs）。
