dsh-pulse
dsh-pulse
DeepSeek Harness 的会话用量与费用观测台。它把每个会话——无论活跃还是已持久化、来自哪种前端——折算成 token 走势，按 DeepSeek 官方费率计价，并把平台余额与订阅额度放在估算旁边。纯界面：没有模型可见的工具，插件不消耗 token，数据不离开本机。
简体中文 · English · 文档 · 更新日志
仪表盘：费用估算、官方余额、订阅额度、缓存命中率
功能
用量走势 ：不超过 30 天的任意窗口，提供小时 / 每日 / 90 天与 1 年热力图；点进某一天可下钻到逐模型以及输入 / 缓存 / 输出的拆分，模型占比与项目排行就在走势旁边。费用估算与对账 ：按官方峰谷费率计价，逐模型、逐供应商定价，未定价用量单独列出而不并入总额；展开卡片可看月度预算与本地估算、官方扣费的逐日对账表。余额与订阅 ：估算旁边就是 DeepSeek 平台余额，另有月付 Coding 套餐（GLM Coding Plan、Kimi For Coding、MiniMax Coding Plan），带 5 小时 / 每周窗口、重置时刻、燃速预估与分项目消耗。会话明细 ：会话按项目分组并带子代理小计；在会话的累计消耗曲线上放最多三个断点，即可读出每一段的 token 与费用。异常观察 ：单日消耗达到前 7 日 P95 的 3 倍以上，以及一天内把同一工具调用重复几十次的会话。只给数字与标识，不告诉你该怎么做。贴合工作流 ：从 / 菜单打开、限定于当前会话的精简浮层，共享的项目 / 模型过滤器，四套主题，CSV 导出，面板宽度可拖拽。
订阅额度与对账的展开图：
订阅额度展开：GLM 与 Kimi 的 5 小时 / 每周窗口用量
对账：逐日官方扣费、本地估算与差额
安装
dsh plugin --profile web add -w dsh-pulse
重启 dsh web——宿主侧在插件加载时完成注册——然后打开 设置 → 用量观测台 。入口有三处：侧栏底部按钮、设置页，以及任意对话 / 菜单中的 pulse 一行（打开限定于该会话工作区的浮层）。三者共用同一个数据源 GET /pulse/stats；面板左缘可拖拽调宽。
# update / remove
dsh plugin --profile web add -w dsh-pulse@latest
dsh plugin --profile web remove -w dsh-pulse
其他来源用同样的命令安装——用你需要的 tarball、git URL 或 link: 检出重新 add 一次：
dsh plugin --profile web add -w /abs/path/to/dsh-pulse-<version>.tgz
dsh plugin --profile web add -w link:/abs/path/to/dsh-pulse
若已配置 DEEPSEEK_API_KEY，余额与对账线会自动出现。
隐私与数据
事实来源是 dsh 自己的会话日志。 插件没有私有的用量历史：每个数字都在请求时折出。卸载、重装，甚至删掉投影缓存，完整历史都会重新折出。两个插件自有的快照文件 ，都是可选的，也都可以删：余额快照（只存金额，滚动 30 天）与额度快照（每个窗口一个百分比，滚动 30 天）。它们只用于对账线和燃速预估。凭据从不落盘。 API key 只留在宿主进程内，每次请求只出现在一个出站 Authorization 头里。出站请求只有三类 ：官方余额、订阅额度，以及「关于」面板（插件「设置」标签页底部）上的手动检查更新——绝不自动发起，没有遥测。默认没有任何模型可见的接口。 主包不注册任何工具。可选的配套包 dsh-pulse-usage-query 增加一个只读工具，只有你自己挂载才会生效 。
完整存储表：配置 → 数据与存储 。
配置
日常设置都在 设置 → 用量观测台 ：定价与费用、显示与主题、方案对比，以及手动检查更新；月度预算则是仪表盘上的一张卡片。按 profile 的覆盖写在 cordis.patch.yml：
- insert:
- id: pulse
name: 'dsh-pulse'
config:
defaultDays: 30
topProjects: 8
costEnabled: true
usdToCny: 6.8
monthlyProviders: []
单价以每百万 token 的 CNY 金额计，默认取自官方价格页；高峰时段为北京时间工作日的 09:00–12:00 与 14:00–18:00，其余时段一律半价。配置参考 覆盖完整选项表、自定义高峰时段、逐供应商定价、月付供应商与辅助调用（估算）。
兼容性
dsh ≥ 0.2.0-rc.2（0.2.x 系列） ，Node ≥ 22.19。接缝包是 peer 依赖，插件始终运行在宿主自己的副本上。Web 前端 ：完整观测台与会话浮层。终端面（可选） ：挂载于 dsh-tui ≥ 0.13.0（已在 0.16.1 上验证），提供 /pulse、/pulse-day、/pulse-month、/pulse-year、/pulse-cost、/pulse-sessions。迷你卡位于输入框上方；Esc 逐级返回上一场景。用量与前端无关 ：Web、dsh-tui、headless 或 ACP 跑出的会话都会被统计。
降级行为、诊断与 0.1.x 代际的历史见兼容性说明 。
FAQ
面板没有数据？ 刚装完没有可折的历史——先跑一个会话；同时确认插件装在活跃 profile 中，且 dsh web 已重启。没有余额块？ 宿主需要配置 DeepSeek API key（DEEPSEEK_API_KEY 或客户端登录）；没有时该块自动隐藏。估算与官方扣费不一致？ 官方数字是那把 key 的总扣费——共用同一把 key 的其他工具也会算进来；辅助调用是估算，会自我校准，偏差持续时会触发告警。订阅百分比看起来偏低？ 套餐只上报百分比；总额由本机流量反推，共用 key 时读数会偏低。按趋势看即可。保存返回 409？ 与其他窗口的保存撞车了；编辑器已自动刷新，重试即可。dsh-tui 里没有 /pulse？ 确认插件也装在 dsh-tui profile 中并重启；启动日志里出现一行 C-070 … unattributed 属预期。
开发
npm ci
npm test # 10 suites: host, aggregate, view, quota adapters, package shape, client smoke, TUI, golden, style, manifest
npm run typecheck
npm run build # rebuild lib/client.js from src/
构建配置、测试地图、面向插件作者的扩展槽位与发版清单见开发 。
特别致谢 Linux Do 社区。
MIT — 见 LICENSE 。
