@deepseek-ai/dsh-client-ui-billing

English | 中文

Web 额度特性的归属方：向 conversation.session.header.utilities 贡献一个条目，自己挂载 billing Remote，通过 billing/getEstimate 读取 DeepSeek 账户余额与按模型的剩余任务估算，并在右上角渲染成一个标签框。该能力的宿主侧在 dsh-llm-billing，它拥有 /user/balance 传输、跨会话用量折叠、峰谷计价表与 billing Remote 命名空间；本包挂载那个 Remote 并渲染它返回的内容。

触发器显示两行——剩余额度与当前模型的剩余任务估算（「按当前模型预计还能跑 N 个任务」）——首个请求在途时不渲染任何东西。点击后展开一个标签框：剩余金额加手动刷新按钮、每个模型一行的剩余任务（「还能跑 N 个任务」）。每条估算用人民币余额除以该模型的历史「每会话平均计费 token × 当前峰/谷单价」。刷新时旧值不消失，刷新失败保留上一次有效值。没有消耗记录的模型显示「暂无消耗记录」而不是编造数字。失败——未配置 API key、凭据被拒绝、传输错误——渲染弱化的「额度不可用」，其提示携带 Remote 自己的错误信息。

角标是账户级的，尽管插槽是会话作用域：顶栏工具行不过是外壳提供的那个始终可见的标题栏席位，而它显示的值并不随会话变化。文案走本包自己的 billing locale 命名空间；样式只用 token。

模型体验

无，因为本包为人类渲染账户级的 provider 事实，不触及 prompt、消息、schema、流或工具结果。模型对 provider 额度的视角仍在 dsh-llm 在请求失败时抛出的 QUOTA / INVALID_CREDENTIAL 错误码里。

KV Cache effect

无；本包从不组装或发送 provider 请求，它唯一的 RPC 是一次带凭据的账户读取，不落在 provider 的 KV 缓存里。

已知限制与暂缓事项

• 一次估算、只取首条余额线 —— 估算使用主要（balance_infos[0]）币种，非人民币余额返回 null，所以纯美元账户只显示余额、不换算任务数。多币种换算暂缓。
• 平均是会话粒度，不是按模型意图 —— 一个会话里切换模型时，会分别计入它实际调用过的每个模型，因此每个模型的平均是「每次调用会话」，不是「每次声明任务」。换算只是估算，不是计费承诺。
• 仅手动刷新 —— 数字是挂载时刻与点击刷新时的点快照。它不会在长会话中自动跟随余额变化。