DeepSeek Harness 的核心哲学是「一切皆插件」。在实际使用中,开发者往往需要追踪 Token 消耗与对应的金钱成本。dsh-cost-stats 是一个客户端插件,它直接在聊天界面中展示每轮对话的 USD 成本、统计图表和交互式支出时间线。
该插件由 thezavtrak-a11y 维护,旨在解决 DeepSeek Harness 仅传递 Token 而不传递货币金额的问题。它通过本地费率表计算成本,并将结果集成到消息操作行、会话汇总和独立选项卡中,无需对上游逻辑进行打补丁。
核心功能¶
每轮 USD 成本芯片¶
每条可计费的消息都会在操作行右侧显示 USD 芯片。芯片显示总费用,并按功能分类(工具、推理、读取)拆分,使用图标区分。点击芯片可查看分项详情,包括请求/Token 数量、费用细分以及 Token 桶表。
交互式支出时间线¶
时间线工具支持缩放、平移和查看累积成本。默认开启空闲压缩,当对话暂停超过 20 分钟时,该区域会被绘制为斜线区域,避免非活动时间拉平图表。支持的时间范围包括 1 小时、6 小时、24 小时、7 天和全部历史。
统计图表与 KPI¶
在“Расход”选项卡中,可以查看成本 KPI、图表、评级和费率表。图表包含按轮次划分的 Token 堆叠、成本分布、时间分布等。
会话费用汇总¶
在撰写器下方,可以查看整个会话的总成本和剩余余额。
安装与启用¶
该插件使用 dsh.client 和 dsh.bundle.patch 声明,安装方式与其他 DSH 插件一致。
# 从 checkout 安装或从已发布的副本安装
dsh plugin --profile <profile> add <checkout>
安装后刷新页面即可加载新插件。如果需要手动挂载,需依赖 cordis.patch.yml,并确保 Node 版本 >= 22。
典型用法¶
- 查看单次成本:在聊天对话中,操作行右侧会显示每轮的 USD 芯片,点击可查看详细分项。
- 分析会话支出:切换到“Расход”选项卡,查看 KPI、图表和模型费用占比。
- 分析流量趋势:在时间线工具中,使用鼠标滚轮缩放、拖拽平移,或双击重置视图。
- 监控会话预算:在撰写器下方查看会话总成本及账户剩余余额。
注意事项¶
- 本地费率表:DSH 仅传递 Token,插件必须依赖本地费率表来计算精确的金钱成本。
- 降级处理:当精确计费不可用时,会根据请求重建数据并标记为
≈;若缺少特定路由,相应区块将不显示。 - 许可证:插件使用 MIT 许可证。
- 依赖:安装和运行需要 Node.js >= 22。
总结¶
dsh-cost-stats 通过将成本数据直接嵌入 DeepSeek Harness 的用户界面,解决了开发者难以直观感知单次对话和整体会话支出的痛点。它提供了从微观(单轮芯片)到宏观(时间线与图表)的完整成本分析能力。
- 项目主页: https://www.skillhub.cn/plugins/thezavtrak-a11y/dsh-cost-stats
- GitHub: https://github.com/thezavtrak-a11y/dsh-cost-stats