dsh-balance-tasks

DeepSeek Harness 插件：余额与任务数换算显示。

右下角悬浮卡实时显示：

• 余额（官方 /user/balance，总余额/赠送/充值）
• 还能跑多少个任务（估算：1 任务 ≈ 1 会话；统一口径：每个任务价格 = 平均单次任务消耗的 Tokens（新增上下文 delta + 输出 outAvg，历史平均）× 当前档单价 + 当前已有的上下文 Tokens（按缓存命中价重读），从当前上下文起逐任务计价直到余额耗尽）
• 当前峰谷档位 + 距切换倒计时（UTC 峰时段 01:00–04:00、06:00–10:00，即北京时间 9–12、14–18）

点击卡片可立即刷新余额。

安装

dsh plugin --profile web add <本目录>

重启 dsh web 后生效。要求已在 设置 → 模型 配置 DEEPSEEK_API_KEY（插件复用同一把 Key，通过凭据服务解析，不出本机）。

数据口径

• usage 折叠自 llm/stream 的 usage 块（含子代理、压缩、标题等辅助调用），与官方账单口径一致；
• 计费价格与 dsh-conversation-cost 一致：未命中输入按 miss 价、缓存命中按 hit 价、输出（含 reasoning）按 out 价；
• 峰谷按调用发生时刻判定，2026-08-17 00:00 北京时间起生效，谷时 = 峰时半价；
• 聚合账本持久化在 $DSH_HOME/storages/balance-tasks.json（10 秒节流 + 退出落盘），重启后估算保留；
• 判断口径（统一）：剩余任务数 = 从当前上下文 ctx 起逐任务累加——每个任务价格 = 平均新增上下文(delta)×miss + 当时上下文(ctx)×hit + 平均输出(outAvg)×out，ctx 每次 +delta，直到余额耗尽；即把「历史平均单任务消耗」与「当前已有上下文」统一进同一个计价公式，不再输出两套互不相同的数字；
• 估算仅对 CNY 余额 生效；无历史用量时显示「暂无用量记录」。

接口

GET /api/balance-tasks（?refresh=1 强制重查余额）返回 { balance, tier, tierSecondsLeft, stats: { totalSessions, totalCost, overallAvgCostPerTask, overallAvgTokensPerTask, overallRemainingTasks }, perModel: [...] }；perModel[].remainingTasks 为统一口径剩余任务数，perModel[].avgTokensPerTask（历史平均 tok/个）、avgOutputPerTask（平均输出 tok/个）、contextTokens（当前上下文）、growthPerTask（平均新增 tok/任务）、nextTaskCost（下一任务价格 = delta×miss + ctx×hit + outAvg×out）。

卸载

dsh plugin --profile web remove dsh-balance-tasks

MIT License