dsh-costview

dsh-costview | 轻量化QoL插件

本插件在助手消息的元数据行追加了 ¥x.xx 的显示功能： 按 DSH 记录的每轮 token 用量和官方高峰 / 空闲两档单价，估算这一轮花了多少钱。

兼容性：在 DSH 桌面版 0.2.1-rc.2 可运行

效果

• 金额统一保留两位小数（精确到「分」）。不足半分钱的用量会显示成 ¥0.00；
• 注意：数字以 DeepSeek 账单为准，此处为估算值。

估算方式

• 单价只覆盖 deepseek-flash。assistant 节点的 usage 里不带模型名， 换用 deepseek-v4-pro 等其他模型时金额是错的（会严重偏低）；
• 一轮对话若是跨过 12:00 / 18:00 这种档位边界，整轮会按最后一次请求的档位计价；
• 缓存写入官方没有单独定价，这里并入「缓存未命中输入」计算；
• 取不到单轮数据时会退回到整会话累计，那一条会明显偏大。

计费规则

高峰时段（北京时间）：周一至周五（不含中国法定节假日）09:00–12:00、14:00–18:00； 其余时段——含周末与法定节假日全天——都算空闲时段，空闲价恰好是高峰价的一半。

单价在 client.js 的 RATE_CARD（人民币 / 百万 tokens，deepseek-flash）：

项目	高峰时段	空闲时段
输入（缓存未命中）	2.00	1.00
输入（缓存命中）	0.04	0.02
输出	8.00	4.00

数值取自官方价目页 https://api-docs.deepseek.com/zh-cn/quick_start/pricing/。 官方调价后请直接改 client.js 里的 RATE_CARD。

法定节假日（/holiday）

放假安排没法从时间戳推断，所以插件不内置任何节假日表：默认只按「周末 + 峰谷时段」判档。 需要精确到节假日时，在 Web 客户端的 / 菜单里跑一次 /holiday：

• 联网拉去年 + 今年两份（这样跨年的会话也有档位），把放假日写进 localStorage['dsh-costview:holidays']，此后离线可用；
• 数据源是 holiday-cn（每年一份静态 JSON， 条目形如 { date, name, isOffDay }），经 jsDelivr CDN 取；条目里的 papers 指向国务院公告原文；
• 只把 isOffDay: true 的日期当放假日；调休补班的周末按官方字面照旧算空闲时段， 不做特殊处理（也就是这些天上下午的用量仍按空闲价计）；
• 它是 action 类型的命令，点了就跑，不产生任何会话 token。结果是静默的 —— 想知道拉没拉到，再敲一次 /holiday 看候选项那一行：未拉取时显示「当前未记录」， 拉取后显示「已记录 2025/2026 年共 N 个放假日（YYYY-MM-DD 拉取）」；
• 拉取失败（断网 / CDN 不可用）会保留已有记录，只在 console 里写一条错误；
• 刷新成功后已渲染的金额会立刻重算。

想手工补某一天，也可以在 DevTools 里改 localStorage['dsh-costview:holidays'] 的 offDays 数组（北京时间 'YYYY-MM-DD'）。 注意插件只在首次用到时读一次，改完要 Ctrl+R 重载。

已知问题

• 只覆盖 deepseek-flash，换模型金额不准；
• 一轮跨峰谷边界时整轮按后一档计价；
• 没有悬浮框；token 明细与档位挂在元素上不可见的 data-dsh-costview-* 属性里 （tier / uncached / cache-read / cache-write / output），排查时在 DevTools 里看；
• 部分插件的安装卸载过程可能会导致本插件的 GUI 界面暂时失效，重启即可。

安装 / 卸载

不发布到 npm。两种装法任选其一。

方式一：直接从 GitHub 安装（推荐）

# <DSH 安装目录> = DeepSeek Harness 的安装位置，dsh.cmd 在其 resources\runtime\cli\bin\ 下
& '<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add github:Yulu224/dsh-costview

方式二：clone 后挂载本地目录

git clone https://github.com/Yulu224/dsh-costview.git
& '<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add '<克隆目录>'

卸载

& '<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop remove dsh-costview