前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在智能体开发或长期运行的服务中，开发者往往会遇到 Token 消耗过快但难以定位来源的情况：是哪个模型在消耗？哪个项目最贵？是缓存未命中还是推理成本过高？dsh-token-use 插件将实时 Token 用量统计与消费金额估算整合进 DSH 的设置面板，通过可视化的方式解决「看不见的成本」问题。
插件简介¶
dsh-token-use 是一个实时 Token 用量仪表盘，旨在为 DSH 提供可视化的用量监控与成本分析能力。
- 定位：Admin / Security 类插件。
- 维护者：huangyuheng。
- 许可：MIT。
核心功能¶
该插件通过设置页面的四个标签页提供全方位的数据支持：
-
概览
- 卡片展示：显示估算金额、总量（输入+输出+缓存）、输入、输出、缓存读写、推理与调用次数。
- 趋势图：基于 ECharts 绘制。支持堆叠面积图（缓存/输入/输出构成）、金额柱状图（右轴）以及显著的日均参考线。支持 7 / 30 / 90 天切换。
- 使用热力图：展示近 12 个月的用量，一格代表一天。支持按「总计」或「金额」着色，悬停即可查看当天的详细数据。
- 筛选：支持按天/月/年/时间段/全部查询，以及按模型筛选。
-
模型统计
- 展示所有模型的用量与金额明细表。支持按天、月、年或自定义时间段查询。
-
项目统计
- 展示所有项目的用量与金额明细表，同样支持多维度的范围查询。
-
配置信息
- 版本与环境：对比各组件（dsh-service、dsh、本插件）的版本与通道（rc/alpha/stable），显示运行环境参数（平台、Node 版本、PID、端口、运行时长等）。
- 健康检查：检查接口响应、客户端 bundle 加载情况以及 Harness 自检（profile 完整性、依赖解析等）。
- 系统操作：支持一键重启与关机操作（均带二次确认）。
金额估算¶
- 计算逻辑：金额基于 DeepSeek 官方定价 × 本地用量 × 高峰/空闲时段倍率计算。
- 计费范围：仅统计模型名中包含
deepseek的模型，其他模型（如 claude、gpt）不计金额。 - 数据来源：插件每天抓取一次官方定价页并缓存，联网失败时会使用内置快照兜底。
- 注意：金额为估算值，受官方调价、缓存计费口径与统计延时影响，请以官网结算金额为准。
安装与启用¶
安装后，插件会在 DSH 设置侧边栏中生成一级入口「Token 用量」。
# 通过 npm 包安装
dsh plugin --profile web add dsh-token-use
# 或从 GitHub 源码安装
dsh plugin --profile web add github:huangyuheng/dsh-token-use
# 或从本地解压目录安装
dsh plugin --profile web add /解压路径/dsh-token-use
典型用法¶
安装并重启 dsh web 后，在设置页面即可查看数据。插件通过 session/event 事件总线增量累加数据，无需宿主侧轮询。
API 接口示例：
# 获取概览数据
curl 'http://127.0.0.1:3080/dsh-token-use?day=2026-09-10'
# 查询指定月份
curl 'http://127.0.0.1:3080/dsh-token-use?month=2026-09'
# 查询指定模型
curl 'http://127.0.0.1:3080/dsh-token-use?model=deepseek-v4-flash'
# 获取版本与运行环境
curl http://127.0.0.1:3080/dsh-token-use/config
# 执行健康检查
curl http://127.0.0.1:3080/dsh-token-use/health
# 一键重启服务
curl -X POST http://127.0.0.1:3080/dsh-token-use/restart
# 关机
curl -X POST http://127.0.0.1:3080/dsh-token-use/shutdown
注意事项¶
- 运行环境：需要
dsh web版本 ≥ 0.1.0-rc.6。 - 数据依赖：插件需要联网获取最新定价，失败时使用内置快照。
- 统计口径：金额为估算值，且仅统计 DeepSeek 模型。辅助调用（如联网搜索、会话标题）不计金额。
- 性能设计：宿主侧不写盘、不加定时器，完全基于事件总线增量更新，避免资源浪费。
