dsh-billing-glass

LIMITATIONS

Known limitations

- **"Daily spend" is official-only**: the row is hidden unless `DEEPSEEK_PLATFORM_TOKEN` is configured. A balance-delta estimate is no longer displayed because top-ups/refunds make it unreliable. - **Peak windows are weekdays-only per the official page as of 2026-08-23**: the official footnote defines peak hours as Mon–Fri 9:00–12:00 / 14:00–18:00 Beijing time (weekends are all off-peak). The page did not spell this out between 2026-08-17 and 08-22; replay stats use the current definition, so replayed amounts for those days may be slightly below the real bill if the platform billed daily peak/valley back then. - **Session cost and spend stats are locally computed, not a provider invoice**: they are priced from the plugin's built-in official price tables and message tokens, and may differ slightly from the final platform bill (pricing moment, rounding, peak/valley interpretation). - **Spend stats only cover messages the plugin has seen**: the current session can be replayed from the persistent session log (including pre-install history), but other historical sessions that the plugin never processed are not in the local ledger. - **Unknown models fail closed**: a model missing from the catalog is marked unpriced rather than priced at zero, so displayed totals may understate the real bill; re-run `scripts/sync-providers.js` or provide a pricing scheme to close the gap. - **Some providers have no public balance endpoint**: their balance shows "—", though session cost is still priced from the catalog. - **The price catalog can lag**: non-DeepSeek prices come from the harness built-in pi-ai catalog snapshot; re-run `scripts/sync-providers.js` after harness upgrades. DeepSeek can be checked on demand with the "verify pricing" button. - **DeepSeek historical pricing only covers audited windows**: policies carry `[since, until]`; unaudited gaps and retired aliases (`deepseek-chat`/`deepseek-reasoner`) are marked unpriced instead of inheriting old prices forever. - **Official daily spend uses the Beijing day boundary** (Asia/Shanghai), independent of the host/server timezone. - **The model series tag is a display heuristic**: brand-new model names may show no tag or a generic one; it never affects pricing. - **Balance freshness has latency**: DeepSeek balances refresh at most every 10s (other providers 60s), and the provider's own balance settlement may lag further.