前言¶
在 DSH 里跑模型时，常见做法是只看平台网页上的账单，或凭感觉估算 Token。官方账单是扣费真值，但不告诉你「哪几个模型」花了多少钱；本地会话里 provider 上报的 usage 能按模型、按天拆开，却可能缺上报、还混着中转和非官方路由。只看一边，对账结论很容易偏。DeepSeek Usage 是社区维护的 DSH 插件，把两种口径放进同一面板，并给出覆盖率与差额，方便写代码间隙核对「今天烧了多少、余额还剩多少」。
这是什么¶
DeepSeek Usage（npm 包名 deepseek-usage）由 sdiwenchen-lang 维护，归类为 admin-security。当前 package 版本为 0.1.6，许可证 MIT，Node 要求 >=18.19.0。
插件在侧边栏提供「用量」入口，点开是居中大弹窗：默认走 官方模式（无登录表单、不接收 token、不落盘凭据），按需读取宿主已登录 DeepSeek 账号的凭据记录，调用平台内部接口取余额与逐日逐模型用量；可切换到 本地模式，通过 DSH 的 sessionPersistence 聚合本机会话日志里的 Token，并按内置/自定义费率估算费用。两种口径并排展示，便于校正。
核心功能¶
官方模式：账单真值¶
取数时读取宿主凭据：
records["deepseek-account-platform/default"].payload.token // kind: "grant"
请求带 x-dsh-auth-token，调用 DeepSeek 平台接口（README 注明为抓包确认的非公开 API），例如：
| 用途 | 端点 |
|---|---|
| 余额 / 累计消费 | GET /api/v0/users/get_user_summary |
| 用量明细（逐日逐模型） | GET /api/v0/usage/amount?month=&year= |
| 费用明细 | GET /api/v0/usage/cost?month=&year= |
在 DSH 里登录 DeepSeek 账号则有数据；退出则面板提示「未检测到 DeepSeek 账号」。上游请求需带浏览器 UA 与 x-app-version，否则可能返回 429。
本地模式：会话日志聚合¶
不依赖 tokenizer，通过宿主可选的 sessionPersistence 读会话事件，折叠规则与 DSH provider-reported usage 一致：四桶互斥（cacheReadTokens、inputTokens、cacheWriteTokens、outputTokens），同一 (turn, step) 的最终 assistant/message 替换 chunk 样本。默认包含本机所有 Provider（DeepSeek、中转、OpenAI/Codex 等）。本地范围不等于官方全客户端账单；对账条会显示覆盖率与说明，不声称两边 1:1。
看板与对账¶
- 总额：充值余额、累计消费（官方口径）。
- 用量趋势：所选时间范围内的消费、API 次数、Token；各模型堆叠柱状图与走势图。
- 本地 AI 聚合：按天/小时折叠；金额标注「按当前费率估算」，未定价模型显示「暂无费率」。
- 用量日历：当月每日 Token 热力图，支持按周/按月跨月汇总。
- 筛选：今天 / 昨天 / 近 7 天 / 近 30 天 / 本月的 / 上月，以及模型多选。
- 各模型消费金额：图表可在「趋势」与「综合」维度切换。
侧边栏底部可常驻三个摘要指标（Token / 消费 / API 次数），各自可开关、改名、换图标并拖拽排序。面板提供 5 套主题色与 17 个内置图标，也可上传 PNG/JPG/SVG（≤200KB）。
本地费用估算¶
内置 139 个模型的四通道费率（输入未命中 / 输出 / 缓存命中 / 缓存写入，USD/百万 Tokens），快照日期 2026-10-30，覆盖 15 家供应商；可在「管理定价」中增删改模型，汇率默认 6.7 可在「显示设置 → 定价」修改，改完重算已缓存 Token 而不重读日志。
插件自有 API（仅回环）¶
端点只监听回环地址，并对 peer 与 Host 做双重校验。例如：
GET /api/deepseek-usage/summary?year=&month=GET /api/deepseek-usage/official?range=today|yesterday|last7|…GET /api/deepseek-usage/local?range=…&scope=all|deepseek&…GET /api/deepseek-usage/reconcile?range=…— 同范围官方 vs 本地对账
完整列表见仓库 README。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议自行查看 GitHub 源码 与 MIT 许可证。
DSH 桌面 App¶
desktop profile 由 Electron 独占，不能使用 dsh plugin --profile desktop 安装。
- 打开 设置 → 插件
- 点 + / Add plugin
- 输入 npm 包名
deepseek-usage（本地开发可填仓库绝对路径，按link:处理） - 安装完成后完全退出并重开 DSH
刚启动时若未见插件入口，刷新一次页面后再试。
Web 版 / CLI¶
确认 CLI 可用：
dsh --version
若未安装，需安装与 App 同版本的 CLI（README 示例版本号，请换成你的 App 版本）：
npm install -g @deepseek-ai/dsh@0.2.1-rc.3
Web 版安装：
dsh plugin --profile web add deepseek-usage
从源码安装（开发调试）：
dsh plugin --profile web add github:sdiwenchen-lang/DeepSeek-Usage
装好后 重启 DSH；侧边栏会出现「DeepSeek Usage · 用量」。
典型用法¶
- 在 DSH 中登录 DeepSeek 账号，安装并重启（或刷新）插件。
- 点击侧边栏 用量，在默认官方视图查看余额、累计消费与所选时间范围的模型用量。
- 切换到本地聚合，查看本机会话 Token 与估算费用；打开对账相关视图，对照覆盖率与官方差额。
- 在「看板设置」中配置侧边栏摘要指标；在「显示设置 → 定价」调整汇率或管理模型单价。
可选配置片段（均有默认值，见 README）：
- id: deepseek-usage-panel
name: deepseek-usage
config:
xAppVersion: "0.1.0"
requestTimeoutMs: 10000
cacheTtlMs: 600000
lookbackMonths: 24
local:
sweepTtlMs: 30000
maxSessions: 5000
pricing:
enabled: true
适用场景与注意¶
适合：需要在 DSH 内快速核对 DeepSeek 官方扣费与本机实际 Token 消耗、按模型看趋势、用日历扫一眼当月用量的开发者。
注意：
- 官方数据依赖 DSH 内已登录的 DeepSeek 账号；插件不单独存凭据。
- 本地日志只覆盖本机 DSH 会话，可能因清理或缺上报而不完整；估算费用依赖费率表，与账单不等价处面板会标明。
- 社区插件目录 SkillHub 条目 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，安装第三方插件前应审阅源码。
结尾¶
DeepSeek Usage 把官方账单余额、逐日逐模型用量与本机会话日志聚合放在同一面板，用对账与覆盖率减少「只看一边」的误判。目录页与源码：
