dsh-pulse
English | 简体中文
dsh 的会话用量与费用观测台。统计所有会话（活跃和已持久化的）的 token 用量，按内置的 DeepSeek 官方费率估算费用，并显示官方平台余额。一切运行在 UI 平面：没有模型可见的工具，不消耗任何 token。
功能
- 用量走势：今天显示分时折线图，7 天 / 30 天显示每日柱状图，90 天 / 1 年显示 GitHub 风格热力图；支持最长 30 天的自定义日期范围
- 项目 / 模型过滤器：两个可搜索下拉框，把整个仪表盘限定到某个工作区和/或某个模型
- 跨供应商模型区分：模型按「供应商 · 显示名称」来自 Models 配置；同名模型被多个供应商同时提供时才带上供应商前缀，否则只显示名称。选中第三方（非 DeepSeek 官方）模型时隐藏官方余额；未配置费用的第三方模型连费用估算和月度预算一起隐藏
- 模型分布 / 项目排行：占比条与排行表
- 会话明细与子代理归因：会话按项目分组，每组带子代理小计（数量 / token / 费用）；展开任意会话进入断点分析——在累计消耗曲线上点最多 3 个断点，逐段读取 token 与费用（秒级精度，适合拆「调研 / 思考 / 总结」阶段）
- 费用估算：逐模型费率，区分峰谷时段；没有规则的模型单独列为未定价
- 费用走势：每日费用火花线，快照积累一天后叠加官方扣费对账线
- 官方余额：用宿主已存的 key 查询 DeepSeek 开放平台余额，支持手动刷新
快速上手
dsh plugin --profile web add -w dsh-pulse重启 dsh web，打开 设置 → 用量观测台。任意对话里输入 /pulse 得到文本摘要（命令不会到达模型）；侧栏底部按钮打开悬浮面板。所有入口共用同一个数据源 GET /pulse/stats。
若已存有 DEEPSEEK_API_KEY，仪表盘还会显示官方余额，并在快照积累一天后出现对账线。
安装 / 卸载
dsh plugin --profile <name> 在 profile 目录内调用 pnpm，并自动调和 dsh.profile.bundles。profile 是 pnpm workspace 根，所以 add 要带 -w：
# 从 npm registry
dsh plugin --profile web add -w dsh-pulse
# 从打包的 tarball
dsh plugin --profile web add -w /abs/path/to/dsh-pulse-0.4.1.tgz
# 从源码检出（开发）
dsh plugin --profile web add -w link:/abs/path/to/dsh-pulse
# 从 git
dsh plugin --profile web add -w git+https://github.com/Enc-hanted/dsh-pulse……或手动在 ~/.dsh/profiles/web/package.json 的 dependencies 里加 "dsh-pulse": "link:/abs/path/to/dsh-pulse"，再到 profile 目录里 pnpm install。之后重启 dsh web（新增插件热加载；改代码需要重启）。
dsh plugin --profile web remove -w dsh-pulse下次启动时它会从 dsh.profile.bundles 移除。可选残留，均可安全删除：~/.dsh/settings.yaml 里的 pulse 节，以及 ~/.dsh/storages/pulse_balance.json。本插件从不存储密钥。
费用模型
单价为每百万 token 的 CNY 金额，默认值来自官方价格页 https://api-docs.deepseek.com/zh-cn/quick_start/pricing/（核对于 2026-08-17）。 DeepSeek 按峰谷时段计费：北京时间 09:00–12:00 与 14:00–18:00 为高峰，其余时段谷价 = 峰价的一半。
| 模型 | 时段 | 未缓存输入 | 缓存命中 | 输出 |
|---|---|---|---|---|
| deepseek-v4-flash | 高峰 | 3 | 0.1 | 9 |
| deepseek-v4-flash | 谷时 | 1.5 | 0.05 | 4.5 |
| deepseek-v4-pro | 高峰 | 9 | 0.3 | 27 |
| deepseek-v4-pro | 谷时 | 4.5 | 0.15 | 13.5 |
规则可按供应商限定：provider 填供应商 route id 时只对该供应商的同名模型生效（精确匹配优先），留空则通配该模型 id 的所有供应商（官方默认如此）。这让你能给「代理商也卖 deepseek-v4-flash」这类情况单独定价，而不影响官方渠道。
供应商可整体标记为月付费（monthlyProviders，定价页每个供应商分组的开关）：该供应商所有模型无需单价，费用按 0 边际计（算作已配置，不算未定价）。
币种：每条规则以 CNY（默认）或 USD 计价，USD 模型通过 usdToCny（默认 6.8，定价页可改）折算，总额永远是单一 CNY 数字。折算按设计就是手动汇率：这是估算器，不是记账。costEnabled: false 隐藏费用数字，其余照常。
配置
设置 → 用量观测台 → 定价与费用 编辑单价。模型行只来自 Models 设置页的模型配置（不可手动添加/删除），DeepSeek 官方单价自动回填；每行填谷时输入/缓存命中/输出单价、CNY/USD 选择器，以及 24 小时高峰条（北京时间，默认官方窗口，全部取消 = 平价）。只保存你改过的行：没动的模型继续走官方通配默认价，官方改价自动跟上；恢复官方价把一行清回未改状态。每个供应商分组头有月付费开关，开启后该组模型收起单价输入。汇率字段用未保存的编辑即时重新计价已加载的窗口。刷新目录重读模型目录；启用费用估算整体关掉费用数字。没有 llm 服务时页面无可编辑行。
方案对比（设置 → 用量观测台 → 方案对比）用可调的用量场景（总输入、输出占比、缓存命中率）对比各模型费率下的预估成本。方案直接来自定价与费用页的有效规则（含官方默认），费率改动自动生效；可临时添加对比方案，所有方案可显隐。场景可取自真实用量窗口，也可手动设置。
显示设置（设置 → 用量观测台 → 显示设置）控制仪表盘各面板的显隐（含会话明细面板），以及侧栏按钮的余额显示。仪表盘上的月度预算卡片可设定 CNY 预算，显示本月已用、进度条和按日均速率推算的月底预测；余额栏会按近期扣费速率显示余额可撑天数。均为本地偏好。
保存写入 $DSH_HOME/settings.yaml（pulse: 节），立即生效，重启后仍在。恢复内置默认把用户节清回组合配置与官方默认。没有设置服务时页面只读。
按 profile 在 cordis.patch.yml 覆盖：
- insert:
- id: pulse
name: 'dsh-pulse'
config:
defaultDays: 30 # 客户端未带范围时服务的窗口
topProjects: 8 # 项目排行行数上限
projectDepth: 1 # 项目标签保留的路径段数（1..3）
costEnabled: true # false 隐藏费用数字
usdToCny: 6.8 # 统一 CNY 总额的 USD→CNY 汇率
monthlyProviders: [] # 包月订阅的供应商 route id，其模型费用按 0 计
pricing: # 逐模型覆盖内置默认
- model: deepseek-v4-pro
input: 4.5
cacheRead: 0.15
output: 13.5
peak: # 峰时单价（默认官方窗口）
input: 9
cacheRead: 0.3
output: 27
currency: CNY
- model: third-party-x # 平价 USD 规则 + 自定义高峰时段
input: 0.5
output: 2
currency: USD
peakHours: [0, 1, 2, 3, 4, 5] # 按北京时间计峰的小时
- provider: pi-ai # 只对该供应商的同名模型生效
model: deepseek-v4-flash
input: 2
output: 4官方余额
GET /pulse/balance 用宿主已存的 key 查询 DeepSeek 开放平台，每次请求经凭据缝现取。零新增配置、零新增密钥存储：key 不离开宿主进程（只出现在一次出站 Authorization 头里），失败只映射为通用原因码，回复在服务端缓存 60 秒（?refresh=1 绕过），响应带 cache-control: no-store，出站请求拒绝重定向。未配置或不可达时，卡片自动隐藏或显示带重试的失败提示。
每次成功查询记录一条 {t, total} 快照（只有金额）到滚动 30 天的存储（pulse_balance，上限 1000 条、5 分钟去重）。每日官方扣费由余额序列推算，算不出来的日子（充值掩盖、缺少前序快照、超出最新快照）记为 null。费用火花线把它画成第三条细线。注意这是那把 key 的总扣费：别的工具共用同一把 key 时也会算进来。
兼容性
已在 @deepseek-ai/dsh 0.1.0-rc.7（Windows，Node 24.14.1）上验证；dsh 要求 Node ≥ 22.15。旧版宿主（不含分时明细）仍可正常显示，费用按谷价估算。
开发
node test/aggregate-test.mjs && node test/view-test.mjs && node test/mirror-test.mjs && node test/host-test.mjs
node scripts/sync-mirror.mjs # 改 src/view.js 后重新生成 bundle 镜像特别致谢 Linux Do 社区。
MIT — 见 [LICENSE](./LICENSE)。