dsh-spend

dsh plugin --profile web add dsh-spend

dsh-spend

Token usage & cost monitor for DeepSeek Harness — floating widget with multi-dimensional stats, time-series charts, auto-detected billing plans (Code/Token) and estimated spend.

dsh 用量与计费仪表盘：token 调用量、按模型 / 供应商 / 时间统计、预计费用，自动识别订阅制（Code）与按量（Token）计费计划。

简体中文 | [English](README.en.md)

在 dsh Web UI 右下角显示一个悬浮用量窗口：实时查看 token 调用量、多维度统计与预计计费金额，零配置自动识别计费计划并直读订阅商真实额度/余额。

目录

• [功能特性](#功能特性)
• [界面预览](#界面预览)
• [交互方式](#交互方式)
• [供应商自动识别（零配置）](#供应商自动识别零配置)
• [工作原理](#工作原理)
• [安装](#安装)
• [配置](#配置)
• [价格来源与计费口径](#价格来源与计费口径)
• [目录结构](#目录结构)
• [说明与边界](#说明与边界)

---

功能特性

• 🖱️ 三级交互：悬浮胶囊常驻 → hover 摘要预览 → 点击展开四标签页详情面板
• 📊 多维统计：按提供商 / 模型 / 小时 / 天 / 会话 / 工作目录 / 最近调用，含性能指标（TTFT、生成速度）
• 📈 时间序列图表：今日逐小时、24h/72h/7d 时间曲线、52 周活跃热力图
• 🏷️ 计费计划自动识别：内置知识库（17 供应商 / 131 模型价格），自动区分订阅制（Code）与按量（Token）
• 🔴 实时额度 / 余额直读：9 家订阅商内置适配器（额度 7 + 余额 2），展示厂商接口返回的真实值，失败安全回退不崩溃
• ⚡ DeepSeek 峰谷计价：8/17 起按调用时刻自动按高峰/空闲价计费
• 💱 $ / ¥ 货币切换：实时汇率（失败回退 usdCnyRate，默认 7.2）
• 📂 工作区筛选：按项目限定全部统计口径，支持逐级下钻子目录
• 📤 数据导出：调用明细支持 CSV / JSON / 调用明细 CSV 导出，可在独立窗口查看
• 🔁 自动刷新：默认 30s（服务端下发，页面无需改动），面板内也可手动刷新

界面预览

交互方式

层级 · 内容

悬浮胶囊（右下角） · 始终显示预计费用与总 Token（超预算变黄/变红告警）

hover · 摘要预览：费用、Token、输入 / 输出 / 缓存读、调用次数、今日小计

点击展开 · 四标签页详情面板；顶部工作区筛选下拉（按项目限定统计、逐级下钻子目录），标签栏右侧 $ / ¥ 货币切换按钮（悬停预览同款；汇率由服务端实时拉取，失败回退 usdCnyRate 固定值）

四个标签页

• 总览（纯 KPI + 排名摘要，无图表）：
• 统计栏：预计花费（月）+ 构成、当月预计（本月按量外推）、按 token 估算、总 Token、调用、会话、平均 / 次、缓存命中率、月预算（可选配置，超 80% 胶囊变黄、超 100% 变红）、活跃天数 / 连续使用；
• 计划用量：自动识别 Code/Token 计划、档位、额度使用与剩余；
• 费用 Top 提供商 / Top 模型（各 6 行）+ 近 31 天趋势。
• 今日：当天调用数、Token 与费用小结 + 今日逐小时 Token / 费用图（横轴从当天首个有调用的小时起算，避免凌晨空白；当天无调用时窗口收敛到当前小时）+ 时间曲线（默认近 24 小时，可切换 24h / 72h / 7d，首个有调用的小时起算，跨天处自动标注日期）+ 活跃热力图（近 52 周，GitHub 风格，颜色深度 = 当日 Token 量，悬停看 Token / 费用 / 调用）。
• 性能：每模型的首字延时（TTFT）均值 / P50 / P90、生成速度（tokens/s）、总延迟均值 + 按小时的 TTFT / 速度曲线（支持 24h / 72h / 7d 切换，首个有样本的小时起算）。
• 调用明细：每会话 × 模型的调用次数、token 与费用明细 + 按工作目录统计（各项目会话数 / 模型数 / 调用 / 费用）+ 按会话统计 + 最近调用（费用远超均值的异常调用标红点）+ 计费单价表。可在独立窗口打开（随主窗口自动刷新，支持 CSV / JSON / 调用明细 CSV 导出）。

供应商自动识别（零配置）

插件内置供应商知识库（lib/knowledge.js，2026-08-14 官方文档核实）：17 个供应商 / 131 个模型价格。provider id 自动归一化别名：glm→zhipu、kimi→moonshot、dashscope→qwen、gemini→google、grok→xai、claude→anthropic、copilot→github-copilot、minimax-cn→minimax、deepseek-official→deepseek 等。日志中出现的提供商自动匹配知识库生成计划与价格（UI 标记"自动识别"）；显式 plans / pricing 配置始终覆盖自动识别。

订阅制（Code 计划）— 自动识别档位费与额度

供应商 · 默认档 · 档位 · 额度口径

OpenCode Go（opencode-go） · $10/月 · — · 实时额度（官方 GET /zen/go/v1/usage：5h/周/月 实际已用百分比 + 重置时间）；接口不可用时回退周 $30（V4 Flash 约 79,050 请求/周）

OpenAI Codex（openai-codex） · Plus $20/月 · Plus / Pro 5x $100 / Pro 20x $200 / Business · 实时额度（chatgpt.com/backend-api/wham/usage，需本机 ~/.codex/auth.json 登录态；未登录回退 ~100 请求/周）

GitHub Copilot（github-copilot） · Pro $10/月 · Free / Pro / Pro+ $39 / Max $100 / Business / Enterprise · 实时额度（api.github.com/copilot_internal/user，需 GH_TOKEN/GITHUB_TOKEN 或 gh auth login；未登录回退 AI Credits 月 $15）

Claude Code（claude-sub） · Pro $20/月 · Pro / Max 5x $100 / Max 20x $200 · 实时额度（api.anthropic.com/api/oauth/usage，需本机 ~/.claude/.credentials.json 登录态；未登录回退档位表 5h 1x/5x/20x）

智谱 Coding Plan（zhipu） · 官方套餐 · — · 实时额度（官方 bigmodel.cn/api/monitor/usage/quota/limit：5h/周 已用百分比 + 重置时间、MCP 月度次数；凭据缝 ZHIPU_API_KEY；国际站 z.ai 可用 usageEndpoints 换 URL）

MiniMax Token Plan（minimax） · 官方套餐 · — · 实时额度（官方 minimaxi.com/v1/token_plan/remains：5h/周 剩余百分比 + 重置时间；凭据缝 MINIMAX_API_KEY，兜底 MINIMAX_CN_API_KEY；国际站 minimax.io 可用 usageEndpoints 换 URL）

ClinePass（clinepass） · 官方套餐 · — · 实时额度（官方 api.cline.bot/v1/users/me/plan/usage-limits：300 分钟/周/月 已用百分比 + 重置时间；凭据缝 CLINEPASS_API_KEY）

Google AI / Gemini CLI（google-ai-sub） · AI Pro $19.99/月 · AI Pro / Ultra 5x $99.99 / Ultra 20x $199.99 · 无公开用量接口，按官方每日上限（1,500 / 2,000 请求/天）展示

按量计费（Token 计划）— 自动带官方价

供应商 · 已收录模型

OpenAI（openai） · gpt-5.6 sol/terra/luna、gpt-5.5、gpt-5.4 系、gpt-5 系、gpt-5.2、o3/o4-mini/o1

Anthropic（anthropic） · claude-opus-5、sonnet-5、haiku-4-5、fable-5、opus/sonnet-4.x

Google（google） · gemini-3.7/3.6/3.5 flash、3.1-pro、2.5 pro/flash/lite

xAI（xai） · grok-4.6、4.5、4.3、build-0.1

Mistral（mistral） · large-3、medium-3.5、small-4、ministral-3

Moonshot（moonshot） · kimi-k3、k2.7-code

智谱（zhipu） · glm-5.2、5.1、5

阿里（qwen） · qwen3.8-max、3.7-max/plus/flash

MiniMax（minimax） · m3、m2.7

OpenRouter（openrouter） · 实时目录 50 个热门模型

OpenCode Zen（opencode-zen） · PAYG 网关价（Claude/GPT/Gemini/Grok/DeepSeek）

DeepSeek（deepseek） · v4-flash、v4-pro

实时额度 / 余额（厂商直读）

内置适配器（lib/providers/，端点与鉴权 2026-08-25 核实）：

• 额度类（订阅制 Code 计划）：OpenCode Go / OpenAI Codex / Claude Code / GitHub Copilot / 智谱 Coding Plan / MiniMax Token Plan / ClinePass —— 卡片直接展示订阅商接口返回的额度值：每个窗口 5h/周/月的实际已用百分比与重置时间，另附供应商特有额度（Codex 代码评审、Claude Opus/Design 周窗口、Copilot Premium/Chat 快照、智谱 MCP 月度次数）；
• 余额类（按量 Token 计划）：DeepSeek / Moonshot —— 展示真实账户余额（钱包可用余额 + 充值/赠金拆分，随 $/¥ 切换自动换算）。

凭据只读复用本机登录态与凭据缝：

供应商 · 凭据来源

OpenCode Go / DeepSeek / 智谱 / MiniMax / ClinePass / Moonshot · 环境变量或凭据缝：OPENCODE_GO_API_KEY / DEEPSEEK_API_KEY / ZHIPU_API_KEY / MINIMAX_API_KEY（兜底 MINIMAX_CN_API_KEY） / CLINEPASS_API_KEY / MOONSHOT_API_KEY

OpenAI Codex · 本机 ~/.codex/auth.json 登录态

Claude Code · 本机 ~/.claude/.credentials.json 登录态

GitHub Copilot · GH_TOKEN / GITHUB_TOKEN / gh 配置

余额卡自动出现：只要凭据缝（$DSH_HOME/.credentials.yaml）配置了 DEEPSEEK_API_KEY / MOONSHOT_API_KEY，即使该 provider 未出现在会话日志中（例如经 OpenCode Go 网关使用），也会自动生成 token 计划卡展示真实账户余额。登录态缺失或接口失败时卡片显示原因并回退本地配额行。Codex/Claude/Copil

…(truncated)