前言¶
DeepSeek Harness（DSH）采用插件化架构。在 Web 界面进行智能体开发或调试时，精确控制单次会话的 API 调用成本是常见需求。dsh-session-cost 插件为此提供了实时、基于官方计价引擎的成本统计功能，帮助开发者直观监控 DeepSeek 模型的使用情况。
插件简介¶
这是一个运行在 DeepSeek Harness Web 界面的会话花费插件，由 Lzh3070 维护。它会在输入框旁显示当前会话的 DeepSeek API 累计花费。
核心功能¶
- 输入框实时花费：在
conversation.input.right槽位（模型选择器左侧）显示当前会话的 DeepSeek API 花费，每 5 秒刷新一次。 - 严格模型门槛：仅当会话当前模型为 DeepSeek 时生效。使用其他模型（如 MiniMax、Kimi）时，徽标自动隐藏，且非 DeepSeek 模型的请求不计价、不进入统计。
- 悬停浮窗展示明细：鼠标悬停在花费徽标上，会弹出与界面风格一致的浮窗，展示：
- 会话花费明细表格（输入/缓存命中/输出 × 数量 × 有效单价 = 金额）。
- 今日（DSH）用量：本机 DSH 会话今日（北京时间）消耗的 DeepSeek 花费。
- 账户余额：通过读取凭证中的
DEEPSEEK_API_KEY，经 DeepSeek 官方user/balance接口获取。
- 官方计价引擎：按 DeepSeek 官方价格时间表，对每条
assistant/message消息按其发生时刻逐条计价。包含 2026-08-17 起的高峰/空闲定价（北京时间 09:00–12:00 / 14:00–18:00 为高峰，其余时段半价），并包含插件安装之前的历史。 - 性能友好：会话日志按 revision 缓存（5 秒轮询 = 一次 stat 比对，不重复解压解析）；今日/余额独立 60 秒节奏。
安装与启用¶
- 执行安装命令：
dsh plugin --profile web add @phynez_1103/dsh-session-cost
- 安装完成后，重启 dsh web 服务，并在浏览器执行硬刷新（Ctrl+Shift+R）以加载新插件。
- 首次使用时，需在设置 → 模型中配置
DEEPSEEK_API_KEY。未配置时余额显示--，但会话花费仍可显示。
典型用法¶
- 在设置中配置 DeepSeek API 凭证。
- 切换当前会话模型为 DeepSeek 系列。
- 进行对话交互，输入框旁会出现花费徽标（例如
¥0.12）。 - 鼠标悬停在徽标上，查看详细的计价表格、今日用量及账户余额。
注意事项¶
- 包名区分：本插件的 npm 包名是带 scope 的
@phynez_1103/dsh-session-cost。npm 上的裸名包dsh-session-cost（如 ChengChe106/dsh-session-cost）是另一个同名插件，与本仓库无关。 - 计价范围：仅对 DeepSeek 模型计价，其他模型不计价且不显示。
- 许可证：许可证为 MIT。
结语¶
dsh-session-cost 提供了一个轻量级、基于官方计价引擎的解决方案，适合需要在 Web 界面监控 DeepSeek API 成本的开发者。更多细节可参考 GitHub 仓库 或 社区目录。
