dsh-plugin-turn-costv1.0.0

dsh-plugin-turn-cost

每轮对话费用 · 会话累计 · 预算与余额提醒 · 计费明细统计 · Excel 导出 · 人民币/美元

在每轮对话底部显示这一轮以及整个会话花了多少钱，并且支持预算提醒、余额提醒和全部会话账单统计（可导出 Excel）。

用量 19.2k
(谷) 本轮 ¥0.189    会话 ¥1.048

截图

页脚金额与预算胶囊：每轮结束显示「(峰/谷) 本轮 ¥… 会话 ¥…」，输入框上方常驻预算按钮（超预算时出现橙色感叹号）。

本轮费用明细：点「本轮」展开，含轮次 ID、模型、计费时段、Token 统计与逐项金额。

会话费用明细：点「会话」展开，含会话 tokens、会话合计、统计范围与会话 ID。

设置预算：输入框上方的预算按钮点开后，可查看本会话已用/当前预算并调整；账户余额、赠送余额与剩余合计也在这里展示。

计费明细统计：所有会话的账单汇总，可按币种、分组方式、排序方式、时间范围查看，勾选后导出 Excel。

余额提醒与显示项：人民币/美元阈值、当前余额，以及控制页脚与预算按钮显示的三项开关。

这个插件解决了什么问题

• 看不懂 token 用量，算不清花了多少钱：DSH 只在对话底部显示 token 数，而 DeepSeek 按 token 计费。装了它，每轮结束就能直接看到「这一轮多少钱、这个会话累计多少钱」，不用再拿 token 数去手算。
• 长会话不知道总成本，也难以复盘：会话越聊越长，钱在不知不觉中累积；历史轮次也说不清各花了多少。插件把每轮金额固定下来、累计值随对话冻结，随时可以回头看。
• 容易超预算、余额见底才发现：可以给单个会话设预算、给账户余额设提醒，达到阈值时提前收到提示，而不是等扣光。
• 会话一多，账单无法汇总：所有会话的花费集中在一页，按工作区/时间/币种筛选、排序、勾选，并可直接导出 Excel 用于记账或报账。
• 数据要加载才能算：费用记录保存在本地，不加载更早的对话也能看到最后几轮的正确数字，会话改名也会同步。
• 中英文/双币种环境算不准：人民币和美元各自按 DeepSeek 官方价目表计价，不套用汇率，英文界面自动显示美元。

简单说：把「token 烧了多少钱」从看不见、算不清，变成每一轮都清楚、每个会话可追溯、可提醒、可导出。

主要功能

• 本轮 / 会话花费：每轮对话结束显示该轮估算金额，以及截至这一轮的会话累计金额。历史轮次金额固定不变，后面的对话不会改写前面的数字。
• 明细弹窗：点「本轮」看 token 用量、计价时段、每个计费桶的单价与金额；点「会话」看累计 tokens、统计范围、会话 ID。
• 峰谷标记：(峰) / (谷) 表示该轮结束在高峰还是低谷（低谷 5 折）。已下线、全天同价的模型不加标记。
• 预算提醒：输入框上方常驻「预算 ¥N」，新对话或进行中的对话都能点开设置/调整。本会话累计达到预算时给出提醒，只提醒、不打断。
• 余额提醒：在设置里为人民币、美元分别设置阈值，余额（充值余额）低于阈值时提醒一次；支持「稍后提醒」（当天不再提醒）和「不再提醒」（直到余额回升后再次跌破才提醒）。
• 计费明细统计：独立设置页，列出每个会话的花费，支持按工作区目录 / 工作区树 / 单列表分组，按名称或时间排序，按当天 / 7 天 / 1 月 / 3 月 / 半年 / 1 年筛选。
• 勾选与导出：每个会话、每个分组都能勾选（支持全选），选中后导出为 Excel；未选中时点击导出会提示「当前没有选中」。
• 币种切换：统计页的「币种」可在人民币 / 美元间切换，全界面金额与符号同步变化，美元金额会缓存在本地，来回切换不重算。
• 本地记录：每轮、每个会话的费用都记录在本地（localStorage），不需要加载更早的对话就能显示正确数据；会话重命名后记录里的名字也会同步。

如何使用

1. 安装：用 plugin_manager 安装仓库地址 https://github.com/jerodji/dsh-plugin-turn-cost（或先 clone，再安装本地目录），安装完成后强制刷新页面（⌘⇧R）。需要 DSH >= 0.2.2-alpha.3。
2. 看花费：对话结束后，底部 token 用量下方会出现「本轮 / 会话」两个金额；点它们看明细，点空白处或按 Esc 关闭。
3. 设预算：点输入框右上方的「预算」按钮，输入金额确认。超出预算时按钮前出现橙色感叹号，数字变橙。
4. 设余额提醒：设置 →「计费明细统计」→「余额提醒」，分别填人民币、美元阈值。
5. 看全部账单：设置 →「计费明细统计」→「会话计费统计」，选择分组方式、排序方式、时间范围、币种；勾选需要的会话或分组，点「导出为 Excel」。
6. 控制显示项：同一页面「显示项」里可分别关闭「本轮」「会话」「预算」的显示。

统计说明

• 金额是按 DeepSeek 官方价目估算的：人民币与美元各用自己的官方价目表，不做汇率换算。
• 高峰时段为北京时间周一至周五 09:00–12:00、14:00–18:00，其余时间按低谷价（5 折）；按每轮自己的结束时间判断。
• 联网搜索 / 网页抓取按成功请求数计费（¥5 或 $0.75 / 1000 次），只统计新版 Search/Fetch API 的调用。
• 法定节假日未剔除，跨峰谷的轮次按结束时间取价，属于近似值。
• 未识别的模型不显示金额；中止且没有任何回复的轮次不显示徽标，按 0 计入累计。

兼容性

结论：推荐 0.2.2 及以上版本；最低可安装 0.1.6-alpha.2，但 0.1.6/0.1.7 系列属于早期版本，显示位置与图标会有所降级。以上旧版本结论来自对各个版本包的静态核对，只在 0.2.2-rc.1 上做过实机验证。

隐私与限制

• 所有费用数据只保存在本机 localStorage，不上传任何服务器。
• 仅统计 token 与联网工具费用；账户余额来自 DSH 的账户接口。
• 目前面向 DSH Web 界面；不同版本的界面结构变化可能影响显示位置。

实现细节、数据结构与开发说明见 DETAILS.md。