deepseek-harness/packages/client/ui-openrouter-usage/README.md

@deepseek-ai/dsh-client-ui-openrouter-usage

English | 中文

OpenRouter spend surface plugin, browser half: the per-session 会话费用 readout (CostDock) in the conversation.composer.dock strip (order 5, right after the shipped stats line) plus the account 余额 badge (BalanceBadge) at the sidebar foot (sidebar.footer.action).

CostDock reads the durable openRouterCost projection (seeded by the history tail page, updated by session/projection frames), showing 会话费用 $X.XX only once a step actually priced — no zero-cost group. An unknown-pricing step count surfaces in a tooltip so the figure's coverage stays visible. CostDock therefore owns no store, refresh chain, or event listener.

BalanceBadge is account-global, so it is not a session projection: the slot inject face carries a snapshot() callback that polls the host ctx.remote.openRouterUsage.snapshot() Remote on a 60s interval and drives local state. In the collapsed rail it renders only the balance marker; in the wide column a labeled pill. Unknown or absent figures render the empty placeholder. Both entries render nothing before real data exists, so an assembly without the OpenRouter gateway or key costs no layout.

The /client exports are the plugin body (apply/inject), the CostDock/BalanceBadge components, and the injected face types.

Model Experience

Indirectly, none. Neither the cost readout nor the balance badge injects any model context; they are pure client-side read models over the openRouterCost projection and the openRouterUsage Remote snapshot. The agent loop and all prompts are unchanged.

KV Cache effect

None. Cost derives from existing logged usage events and balance is a fetched account figure; neither is a new model-visible input.

Known Limitations and Deferred Work

• Priced as of the fold — CostDock renders whatever the durable projection holds; figures for already-folded history reflect the pricing table at fold time (see dsh-openrouter-usage).
• Polled, not pushed — BalanceBadge polls the host snapshot; there is no openRouterUsage forwarded-event channel, so the figure updates on the poll interval rather than instantly.