前言¶
在使用 DSH Web 进行开发时，开发者通常能直观地看到 Token 的消耗与用时，但往往缺乏对“具体花费”的量化。官方界面未提供按官方价格计算的计费入口。dsh-turn-cost 旨在解决这一问题，它通过在 DSH 原生 UI 中追加计价 Pill，展示基于 DeepSeek 官方 API 价格的每轮与累计花费。
插件简介¶
这是一个适用于 DSH Web 的计价插件，由 Quimos-M 维护，遵循 MIT 协议。它不修改 DSH 官方源码，而是通过公共接缝在界面中追加计算逻辑。核心价值在于将 Token 消耗实时转化为可感知的金额，并支持按轮次、按会话、按代理维度的明细查看。
核心功能¶
- 每轮与会话累计花费：在会话统计行和每轮动作行中显示花费 Pill。会话累计为各轮累加值，每轮花费为该轮所有请求的总和。
- 分项金额统计：点击花费 Pill 可查看明细。明细包含缓存命中输入、缓存未命中输入、输出三部分的 Token 数与对应金额。
- 子代理聚合计价：支持将子代理的花费聚合到父会话中。弹窗支持分页查看，第 1 页为总计，后续页面分别展示主 Agent 和各子代理的明细。
- 动态价格与模型信息：计价依据当前请求时刻的模型价格，自动区分峰谷时段，并显示当前模型信息。
安装与启用¶
使用 DSH 提供的插件命令进行安装。确保你的 DSH 版本在兼容范围内（见下方兼容性说明）。
dsh plugin --profile web add link:~/dsh-plugins/dsh-turn-cost
安装完成后，重启 DSH Web 服务，插件会自动装配。
使用方法¶
- 查看概览：在会话列表中，输入框下方的统计行会显示“会话累计花费”。
- 查看单轮：在对话流中，每轮回答的动作行尾部会显示“每轮花费”。
- 查看明细：点击任意花费 Pill（例如
花费 1.23 CNY），会弹出分项明细窗口。 - 分页操作：使用
←→或点击‹›翻页。第 1 页为该轮/该会话的总计，第 2 页为主 Agent，后续页面为各子代理。若没有子代理，则无翻页控件。
计价逻辑与边界¶
本插件显示的花费是基于 DSH 接口获取的 Token 消耗，并乘以 DeepSeek 官方 API 价格计算得出的估算值。
- 计价精度：金额以微元整数累加，显示保留四位小数。
- 峰谷定价：支持按模型家族与生效时间版本化，自动区分高峰与空闲时段（高峰为平日 09:00-12:00、14:00-18:00，为谷价的 2 倍）。
- 包含范围：包含常规模型请求的计价。
- 不包含范围：
- 不包含标题生成、联网搜索等旁路调用费用。
- 不包含非官方 Provider（如经适配器接入的第三方模型）的计价，除非在配置中放开。
- 准确性声明：此数值仅为估算，实际价格以 DeepSeek 官方文档和账单为准。
兼容性与注意事项¶
- DSH 版本：兼容 DSH
0.1.5-rc.1至0.2.0-rc.2。 - 共存性：插件仅使用公共接缝，不替换或隐藏原生元素，与其他插件共存时不会产生 DOM 冲突。
- 卸载：从 profile 的
bundles与dependencies移除dsh-turn-cost并重启即可完全移除。
dsh-turn-cost 插件为 DSH 开发者提供了一个透明、可视化的成本监控方案。你可以通过 GitHub 仓库 获取源码与更多设计细节。
