dsh-cost-meter

dsh plugin --profile web add dsh-cost-meter

dsh-cost-meter

[English](README.md) | 简体中文 · [安装](#安装) · [功能](#功能总览) · [图文演示](#图文演示) · [交流群](#交流与反馈)

<div align="center">

DeepSeek Harness 会话费用统计插件(界面中英双语)








</div>

v1.9.58 修复输入框下方会话费用偶尔消失：会话用量先于插件设置到达时保留加载提示，设置加载后正常显示金额。

宿主要求：DSH 0.2.0 起支持 · 适配目标 0.2.2-alpha.3。完整声明、历史记录与安装排障见下方展开项。

更新说明：[v1.9.58](docs/update-notes-1.9.58.md#中文)。更新后完全重启 DSH。

<details>

<summary>完整功能介绍</summary>

本会话费用 · 当日费用 · OpenCode Go 订阅额度显示 · 预算与已用百分比 · 官方账户余额 · 自定义 Provider 余额查询(可配任意 HTTP 端点) · 余额三段进度条 · 历史记录 · 峰谷计价时段显示(UTC 01:00–04:00、06:00–10:00 为峰时段;周末与中国法定假日全天按谷价,分别标注) · 峰/谷切换前弹窗与系统通知提醒(位置/提前量/提醒类型可配) · 官方价格一键同步 · 类 Codex Token 用量热图 · 多厂商多模型价格计费(内置 170+ 模型 ID 价格目录与自动匹配) · 主流 Coding Plan 额度查询与显示(Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / Cline Pass / SCNet / 火山方舟 / 千问 / 小米 MiMo 十二家,含 Volcano Ark AK/SK 签名与 MiMo 控制台 Cookie 查询) · Plan/API 双轨计费(订阅额度与按量金额分离统计,每 1% 额度与满窗的 token/等值金额估算及日/周/月曲线) · 订阅插件兼容(Codex / ChatGPT 订阅) · 手机端适配(dsh-pocket) · 输入框上方额度横条(预算/Go/Coding Plan 用量一条横排显示,可开关)

</details>

<details>

<summary>兼容、配置与排障说明</summary>

最低支持宿主：DSH 0.2.0。 插件把下限声明在 engines.dsh（宿主准入插件的闸门），不再支持任何 DSH 0.1.x 版本；本轮适配目标为 0.2.2-alpha.3。具体范围与宿主的读取方式见[兼容声明](docs/dsh-0.2.2-compatibility.md#中文)。

新增 [DeepSeek Search／Fetch API 次数费](docs/web-request-fees.md#中文)，只计有结果的成功请求，并将网页抓取独立分类。

配置与验证：[OpenDesign 查询说明](docs/opendesign-billing.md)、[随机端口 / 局域网 / WorkBuddy2API 配置](docs/custom-balance-sources.md)、[透明度修复与性能测量](docs/performance-2026-10-18.md)。

桌面端用户请按 [Desktop 安装说明](docs/install-troubleshooting.md#desktop-安装与更新)，使用应用自带的 CLI 和 desktop Profile。

声明范围内的宿主记录与此前的 0.1.x 历史见[兼容记录](docs/host-compatibility.md)；逐版本清单在 package.json 的 dsh.compatibility.dshReleases。

启动报 Ledger is busy 且费用卡片消失时，参见[账本锁恢复说明](docs/ledger-lock-recovery.md#简体中文)。

交流与反馈：[加入微信交流群 →](#交流与反馈) · 微信交流群已开放，欢迎您加入。

</details>

---

功能总览

功能 · 位置 · 说明

OpenRouter 模型价格 · 模型选择菜单 / 设置 → 费用 → 价格 · 悬停模型查看单价与更新时间，也可在设置中搜索完整目录；前台自动刷新，价格表标记价格变动并提供官方模型链接。无需 API Key，不产生模型使用费用。[说明](docs/openrouter-prices.md#中文)

计费统计与明细 · 会话输入框下方 / 标题栏 / 设置 → 费用 → 计费统计 · 输入、输出、缓存、推理费用；按轮次、模型、搜索和压缩统计；日、周、月及全部记录。[说明](docs/billing-statistics.md#简体中文)

按模型花费卡片 · 侧栏 / 右下角 dock（可配） · 默认关闭；就地展开 Top-N、其它汇总、占比和可选 Token；支持今日 / 近 90 天、展开记忆及 Top-1 角标，见[使用说明](docs/model-cost-card.md)

本会话费用 · 输入区下方 / 会话标题栏 · 实时累计费用 + 输入/缓存/输出 token；输入区下方在“输入”前显示缓存命中率（缓存读取 / 含缓存写入的全部输入）；显示页可开启输入区下方只显示金额，完整费用行保留在悬停提示中；保留输入区／标题栏／关闭的位置设置，标题栏继续提供紧凑「费用明细」按钮

官方余额 · 侧边栏顶部 / 设置页(可配) · 总余额 / 赠送 / 充值,自动刷新 + 手动刷新;可选三段进度条(蓝/橙/灰),当日段只统计官方渠道费用(不含 Coding Plan / 自定义 Provider)

自定义 Provider 余额 · 侧边栏 / 设置页(可配) · 可配置 HTTP 查询任意 Provider 余额(LiteLLM 等);中/英名称、币种、extract 规则(点路径 / 数字常量 / add / subtract / divide,divide 适配 NewApi 等 quota 端点,见下方[示例](#自定义-provider-余额配置示例newapi-模板));与 Coding Plan 同区可折叠配置

OpenCode Go 额度 · 侧边栏 / 设置页 / 右下角(dock,可配) · 滚动 5 小时 / 本周 / 本月用量百分比与重置时间,三档可分别开关,可同时显示预算已用%;Key 自动发现(专用引用 / 官方 Go 路由 apiKeyEnv / 环境变量 / opencode 登录态)或手动填写

Coding Plan 额度 · 侧边栏 / 设置页(每家可配) · 多厂商 coding plan 订阅额度查询(Anthropic Claude Pro/Max、Z.ai/智谱 GLM、MiniMax Token Plan、Kimi Code 本周/5 小时配额(无订阅 Key 时回落 PAYG 余额)、OpenRouter credits、SiliconFlow 余额、CommandCode 5h/周窗口与月度 Credits 余额、Cline Pass 5 小时/周/月三窗口用量%、小米 MiMo Token Plan 套餐/补偿积分窗口与周期截止重置、余额(控制台 Cookie 凭据)、火山方舟 Volcano Ark 5h/周/月三档(需 AK/SK 管控面 HMAC 签名,需 ArkReadOnlyAccess + BillingCenterReadOnlyAccess)),各家独立启用开关、凭据、显示位置与刷新间隔(侧边栏卡片与 Go 额度同款,收起窄栏显示百分比),默认使用官方端点，MiniMax 可[配置可信查询域名](docs/minimax-quota-endpoint.md);无凭据/无订阅为中性提示;SCNet 超算互联网 Token Plan 支持[外部控制台额度快照](docs/scnet-official-snapshot.md)，无有效快照时按官方 Credits 抵扣表由本地账本估算月度用量(无需凭据)

订阅插件兼容 · 设置 → 费用 → Codex / 侧边栏与额度卡片 · 自动检测已安装的 Codex / ChatGPT 订阅插件，把其订阅调用归为 Plan 订阅额度、不计入 API 按量花费；新用量在记账时直接归类，历史 Codex 计费由一次性可关闭提示确认后重算（幂等）。显式 plan/API 配置不被覆盖。[说明](docs/update-notes-1.9.0.md#中文)

Codex 额度显示 · 设置 → 显示 → Codex / 侧边栏与额度横条 · 读取 dsh-codex-subscription、DSH 内置 pi-ai 登录、dsh-chatgpt-sub、@eddyskywalker/dsh-chatgpt-subscription、dsh-codex-connect 的实际额度窗口；数据源可选 auto（按上述顺序尝试）/ subscription / pi-ai / chatgpt-sub / chatgpt / connect。开启额度显示并选择 dsh-chatgpt-sub，即可查看其绑定账号的剩余进度条和重置时间。只有周额度的账号不显示 5h 条。固定来源只查询该来源的当前账号，与计费归类设置互不影响。

SQLite 会话存储（better-session） · 宿主集成 · 自动探测宿主会话后端；当 @morlay/better-session / @morlay/session-rdb（SQLite）接管存储时，历史回填、旧账本导入、历史重定价、小时桶修复、fork 清洗与逐会话费用/轨迹/调用详情继续可用。JSONL 路径行为不变；旧 JSONL 与 RDB 历史不自动合并。[说明](docs/better-session.md)

OpenDesign 额度 · 侧边栏 / 设置页（OpenDesign 厂商） · 从控制台 API 读取工作区 coding plan 窗口；使用 Control Key 时主端点 401/403 会保守回退一次 /billing/preflight，窗口与钱包读取独立降级。[排查说明](docs/opendesign-billing.md#中文)

手机端适配（dsh-pocket） · 全部费用界面 · ≤1023px 窄屏与 dsh-pocket 移动布局下：卡片单列、标签横向滚动、36px 触控高度、对话框不超过 90vh 并避开安全区、宽表横向滚动；桌面布局不变

额度横条 · 输入框上方(显示设置可开关) · 一条横排 chips 实时显示预算已用% / Go 主窗口 / 各已启用 Coding Plan 用量窗口(短标签+迷你进度条,≥80% 预警、≥100% 超支,悬停见重置时刻);点击任意 chip 即刷新对应数据源(budget→状态、Go→Go 额度、厂商→该家全部窗口),同一厂商多窗口融合为一条 chip 分段显示;首次更新弹引导卡由用户自主决定开关;无可用数据自动隐藏

点击立即刷新 · 侧边栏余额/额度图框 · 官方余额 / 自定义余额 / Coding Plan 图框(含窄栏收起态)点击即触发一次查询,刷新中呼吸闪烁,失败保持原值并在悬停提示说明;键盘 Enter/Space 可触发;更新后首次进入有引导提示

简化侧栏显示 · 设置 → 费用 → 显示 · 可选开启；更新首次提示选择，压缩卡片和明细，面板高度限制为视口的 38% 且不超过 320 像素；保留金额、额度、点击刷新与悬停详情，关闭后恢复原布局。[使用说明](docs/sidebar-sim

…(truncated)