前言¶
在 DeepSeek Harness（DSH）里跑长对话时，单轮用了多少 token、累计花了多少钱，往往要翻日志或靠感觉估算。若还要把本机多个会话的开销按月汇总、导出给财务，就更缺一套贴在界面上的工具。社区插件 dsh-token-curve（维护者 STao-Gee）在桌面端右栏提供「曲线 + 账单」两页：当前对话逐轮 token 与费用、本机全部会话按月/周汇总，并支持导出 Excel；标题行还可显示账户余额与本会话费用。下文按安装、日常使用与口径说明它的能力边界。
这是什么¶
dsh-token-curve 是 DSH 的客户端插件（platform: web），只做本机读取与展示：解析 ~/.dsh/sessions 下的会话日志，不上传会话内容。当前 package 版本为 0.4.3，许可 MIT，要求 DeepSeek Harness >= 0.2.1-rc.5 与桌面端（Electron）；README 写明 Windows 上验证过，macOS / Linux 未验证。
核心功能¶
曲线页¶
右栏第一页对应当前对话：
- 顶部大字为累计 tokens；标题行右侧两个胶囊：余额（蓝）与本会话费用（绿）。
- 中间为逐轮柱状图 + 累计曲线；可切换 Token / 费用 口径，以及图例（输入 / 缓存读 / 输出 / 累计）。
- 点击某一轮的柱子或曲线节点，展开该轮明细：未缓存输入、写缓存、缓存读、输出的数字与占比，模型调用次数、缓存命中率、起止时刻、金额，以及高峰/空闲条数划分。
- 下方表格列出每轮 token 与金额；进行中的轮次带橙色标记。面板约每 4 秒自动刷新，右上角 ↻ 可手动刷新（会连同余额、账单一起更新）。
自 v0.4.1 起，标题行下方有 单位 万/亿 胶囊，可切换为 M/K；选择保存在浏览器本地。界面上的刻度、提示与账单卡片跟随单位变化；单轮明细内四项仍为精确数字。导出的 Excel 始终为精确数值，不写「万」。
账户余额¶
自 v0.4.0 起，余额胶囊位于「本会话费用」左侧。数据来自 DSH 账号服务的 deepseekAccount.getBalance，与「设置 → 账户」同源；插件不接触 token 与登录态。显示充值钱包；有赠金时悬停可见明细。每 30 秒自动刷新，点击胶囊可立即刷新。未登录、查询失败或服务未就绪时分别显示灰色或红色「余额 —」，不会伪造为 0。
账单页¶
顶部在「曲线 / 账单」间切换。账单统计本机全部会话（含子会话与其它工作区），可按自然月或周一至周日（北京时间）汇总；区间支持全部、本月、上月、近三个月、今年。四张卡片给出合计费用、Tokens、轮次、会话数；汇总表可点行展开逐轮明细（单格超过 150 条时界面只显示最近 150 条，Excel 为全量）。
导出 Excel 按当前口径与区间导出，文件名形如 Token账单_按月_全部_20261108.xlsx。文件含三张表：按月/按周汇总（含合计金额与人民币大写）、费用明细（逐轮）、按会话汇总；数字为 Excel 真数字，便于再求和；打印预设为 A4 横向等。账单页在切换到时才计算，约每 60 秒重算；首次打开需遍历本机会话日志，耗时随日志量增长。
安装与启用¶
推荐通过 npm 包名安装（无需本机 Git）：
dsh plugin add dsh-token-curve
README 亦注明可从源码安装（需要本机已安装 Git，否则可能出现 git ls-remote failed）：
dsh plugin add github:STao-Gee/dsh-token-curve
安装后重启 Harness，或在插件页启用 include:token-curve。插件默认不自动打开右栏——可在任意会话中按 Ctrl+Alt+U，或点击会话头右侧的曲线图标。热键可在面板内 ⌨ Ctrl+Alt+U 胶囊中改绑（须含 Ctrl 或 Alt），保存在 localStorage['dsh-token-curve:hotkey']。
典型用法¶
- 打开会话，用 Ctrl+Alt+U 或曲线图标打开右栏，在曲线页观察逐轮消耗与本会话累计费用。
- 需要核对某一轮时，点该轮节点查看四项 token 拆分与金额。
- 切换到账单，选好按月/按周与区间，查看卡片与汇总表；需要报销或归档时点导出，保存 xlsx。
- 标题行查看余额与本会话费用，与「设置 → 账户」对照。
卸载时，宿主条目 id 为 include:token-curve，可用 plugin_manager set_plugin 关闭而不删文件；彻底移除需 remove_bundle 并删除 local-plugins/dsh-token-curve 目录。
费用口径与数据范围¶
费用非拍脑袋估算：宿主读取 session.v4.jsonl.zstd，按每条 assistant/message 的 usage 累加；逐条消息按北京时间峰谷计价后相加。高峰为周一至周五 9:00–12:00、14:00–18:00，其余含法定节假日为空闲（内置 2025–2027 节假日表）。价目定期从官方《模型 & 价格》同步并校验，面板上 价目 YYYY-MM-DD 胶囊标示当前版本；历史轮次按当前价目重算，导出表内会说明此为估算口径而非历史快照。
分叉会话（isSeeded=true 且含 parentSession）从创建时刻起不再重复计入父会话已计费的历史 token。只读日志，不写不改会话文件。未收录价目的模型不计费并在界面提示。
适用场景与注意¶
适合需要在 DSH 桌面端实时看对话 token/费用、汇总本机多会话开销、导出 Excel 做报销或自查的开发者。插件以当前 DSH 进程权限运行，安装前可在 GitHub 查阅源码与 MIT 许可证；星标与社区目录信息以站点为准。
已知限制包括：账单首次全量读日志可能较慢；余额依赖账号登录；与 dsh-pet 等同屏时可能遮挡点击；会话删除后对应账务不再出现；导出需通过桌面端保存对话框确认保存。
结尾¶
dsh-token-curve 把 token 曲线、本机会话账本与账户余额收到右栏，数据留在本机日志与 DSH 账号服务，适合需要可核对、可导出的用量视角。目录页：https://www.skillhub.cn/plugins/STao-Gee/dsh-token-curve；源码与问题反馈：https://github.com/STao-Gee/dsh-token-curve。
