dsh-balance

dsh-balance

简体中文 | English

DeepSeek Harness 插件，用于查询 DeepSeek / StepFun API 余额，以及 DeepSeek / StepFun / Tokener 的可用模型和多维消费统计。API Key 仅由本机 Host 使用，不会发送到浏览器。

界面使用 Harness 原生侧栏、主页面和主题变量。侧栏“插件”下方新增“用量统计”，独立查看所有对话的提供方、模型、会话和日期统计；默认显示全部提供方与全部时间，支持提供方和日期范围筛选。活动打卡图按浏览器时区的星期 × 24 小时汇总请求次数，圆点大小随次数变化；悬停或使用方向键可查看请求数与 token 明细。选择器采用主题化浮层菜单，支持方向键、Home/End、Enter、Escape 和按名称检索。设置页支持 DeepSeek / StepFun / Tokener 切换。统计范围除今日 / 7 天 / 30 天 / 全部时间外，还可自定义起止日期；时区默认跟随浏览器，可切换为 UTC 等常用时区，日期分组、打卡图与月度预测均按所选时区计算。总消费卡片在限定范围时显示与上一同期的对比，并按当月已用天数线性预测本月花费。余额走势仅保留在当前 Harness 进程内（最近 48 次实时查询），重启后重新累积。「会话」分类下点击会话名可下钻查看该会话的完整请求明细（不受范围与提供方筛选影响），随时返回总览；「导出 JSON / CSV」分别导出完整摘要与当前分类表格（会话视图导出请求级记录），汇率输入框可即时换算人民币合计。运行 pnpm preview 可查看使用示例数据的新版界面。

聊天框底部会跟随当前会话所选的提供方与模型更新余额；设置页可独立切换提供方。 功能 DeepSeek：查看总余额、充值余额和赠送余额 StepFun：查看可用余额、总充值金额、总赠送金额及预付费 / 后付费账户类型 Tokener：按提供方、模型、会话、日期统计本地请求和 token，以公开目录价估算美元费用；通过官方 /v1/models 查询模型 提供方独立缓存；支持大小写不敏感的 Provider ID 在聊天框下方显示当前 provider、模型和余额，兼容模型选择器与 /model 切换 从当前提供方的 /models 接口读取可用模型、所属组织与创建时间 在设置页按所选 provider、模型、会话和日期查看实际 usage 消费，并在当前会话的“消费”Tab 查看请求明细 明确区分已计费、免费（已知价格且费用为 0）与未计费请求；缺少 provider usage、未知 provider 或未知模型时不进行费用估算 日期按浏览器 IANA 时区分组；DeepSeek 峰谷价格始终按北京时间计算 DeepSeek 费用显示 USD、StepFun 显示原生 CNY；配置 usdToCny 后显示人民币合计 缓存查询结果并支持手动刷新 模型列表标注内置参考价（输入 / 输出每百万 tokens），未收录价格的模型明确标记 统计页「会话」分类中点击任一会话，下钻查看该会话的完整请求明细，可随时返回总览 一键导出当前视图为 JSON 或 CSV（总览导出所选分类或完整摘要，会话导出请求级记录），数据不离开本机 统计页可直接填写 USD→CNY 汇率（存于浏览器 localStorage，无需重启）；插件配置 usdToCny 优先生效 配置 pricingOverrides 可用自定义费率替换内置价格（按 provider + model 匹配，支持生效时间），模型列表与计费估算同步生效 设置页展示近期余额走势（进程内最近 48 次查询），并可按币种配置低额预警（lowBalance），聊天框下方同步提示 统计页支持自定义日期范围与 12 个常用时区（默认跟随浏览器），月度按当前节奏预测，限定范围时与上一同期对比 余额与模型查询对 429 / 5xx 自动重试（尊重 Retry-After，指数退避，最多 3 次尝试） 依据 DeepSeek 峰谷定价，在高峰时段（北京时间 9:00–12:00、14:00–18:00）将聊天框下方的余额指示灯变为橙色 原生支持简体中文和英文，并跟随 Harness 系统语言切换 支持 Harness 已保存的 DEEPSEEK_API_KEY

兼容性

自 0.13.1 起，插件采用宽泛兼容范围：>=0.2.2-rc.1 ，进入“设置 → 模型余额”。该入口位于“Agent 预设”下方，余额摘要也会显示在已有会话的聊天框下方。API Key 可在“设置 → 模型”中保存，或通过 DEEPSEEK_API_KEY 环境变量提供。

消费统计从已保存会话日志读取，包含当前运行会话已写入的记录，不展示 prompt 内容。可在插件配置中增加固定汇率，例如：

也可按币种配置低额预警阈值（币种大小写不敏感，低于阈值时设置页与聊天框下方会出现提示）：

还可用自定义费率替换内置价格（需完整的 USD 或 CNY 三项费率，effectiveFrom 可省略，默认立即生效；修改后需重启 Harness）：

自定义价格同时作用于设置页模型列表标注与消费统计估算；未覆盖的模型仍按内置价格计算。汇率除配置 usdToCny 外，也可在统计页直接填写（仅保存在本浏览器，插件配置优先生效）。