@rayadesu/dsh-client-ui-billing 0.3.10 → 0.3.11

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # last confirmed-consistent state. Both languages carry equal authority; after
 # editing either side, bring the other along and re-record both hashes with:
 #   git hash-object README.md README.zh.md
-README.md: cd35c163925d48ff81774fefd45ea8deb06d59bd
-README.zh.md: 7d06d48a6da7337faa1acea887b59a6624a81ea3
+README.md: aa8362e8ae5fd116cfff977101ddb4ec0cc0bd31
+README.zh.md: a10b50f901fea3fd26b615c41d7318eda55c43d7

package/README.md

@@ -4,7 +4,7 @@ English | [中文](README.zh.md)
 
 Web billing feature owner: contributes one entry to `conversation.session.header.utilities` that mounts its own `billing` Remote and renders the DeepSeek account balance, this session's billed spend (read from the host-pushed `billingTodaySpend` projection, with `billing/getSessionSpend` as the fallback when the projection registry is absent), today's spend across every session (`billing/getTodaySpend`), today's per-session ranking (`billing/getTodaySessionsSpend`), and per-turn costs (`billing/getSessionTurnSpends`) as a top-right label box. The host half of the capability lives in [`dsh-llm-billing`](../llm-billing/README.md), which owns the `/user/balance` transport, the peak/off-peak pricing table, and the `billing` Remote namespace; this package mounts that Remote and renders what it returns.
 
-The trigger shows two lines — the remaining balance and this conversation's billed spend ("本轮对话花费 ¥X") — and renders immediately from the last settled balance (kept per plugin instance), revalidating in the background; before the first balance ever lands it renders nothing. Clicking it opens a label box with the remaining amount, this session's billed spend (本会话花费, priced per usage sample at the official peak/off-peak rate — peak windows apply weekdays Mon–Fri only, weekends are off-peak; a forked session prices only its own post-fork work) with today's all-session spend beside it (今日共花费), one priced row per model with the cache-hit / cache-miss-input / output cost breakdown ("缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z"), a manual refresh action, and a spend disclaimer. The remaining-amount row (`API 剩余金额`) renders larger than the spend rows below it. Below the model rows the panel ends with the **today session-spend ranking** (`今日会话花费`): sessions sorted by today's cost, highest first, each row a fixed right-aligned rank column, then the same middot separator the cost breakdown uses ("·" with the same size, tone, and spacing), then the session's durable title (renames sync automatically), then its amount — the title keeps its indented rank column; at most `SESSION_RANKING_LIMIT` (10) rows render, with a "…还有 N 个会话" hint for the rest. Refreshing keeps the last values visible rather than blanking them, and a refresh failure retains the last good value. A session or day without priced usage shows a "no usage recorded" word rather than a fabricated figure. A failure — no API key configured, a rejected credential, a transport error — renders a muted "Balance unavailable" word whose tooltip carries the Remote's own error message.
+The trigger shows two lines — the remaining balance and this conversation's billed spend ("本轮对话花费 ¥X") — and renders immediately from the last settled balance (kept per plugin instance), revalidating in the background; before the first balance ever lands it renders nothing. Clicking it opens a label box with the remaining amount, this session's billed spend (本会话花费, priced per usage sample at the official peak/off-peak rate — peak windows apply weekdays Mon–Fri only, weekends are off-peak; a forked session prices only its own post-fork work) with today's all-session spend beside it (今日); a bare parenthesized amount rides right after the session amount (（¥X）) — that is **this session's share of today**, taken from the already-fetched today-session ranking and matched by the current session id, so it is neither the ranking's first row nor the day's total: it renders （—） while that ranking has not settled, and （¥0） once it settled without a row for this session; next come one priced row per model with the cache-hit / cache-miss-input / output cost breakdown ("缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z"), a manual refresh action, and a short spend disclaimer on the `?` button (only DeepSeek and MiMo models are estimated, each message priced at its own peak/off-peak rate, followed, on the next line (flush left), by a bare version like `v0.3.11` — stamped in at build time from this package's manifest, so a report can name the build; the full rate schedule lives in the host README, because the DSH tooltip bubble fits a short label only, is clipped at the viewport edge when long, and cannot be hovered — the hint is placed below the button, the side whose viewport fit can flip). The remaining-amount row (`API 剩余金额`) renders larger than the spend rows below it (本会话花费 with its parenthesized today share, and 今日). Below the model rows the panel ends with the **today session-spend ranking** (`今日会话花费`): sessions sorted by today's cost, highest first, each row a fixed right-aligned rank column, then the same middot separator the cost breakdown uses ("·" with the same size, tone, and spacing), then the session's durable title (renames sync automatically), then its amount — the title keeps its indented rank column; at most `SESSION_RANKING_LIMIT` (10) rows render, with a "…还有 N 个会话" hint for the rest. Refreshing keeps the last values visible rather than blanking them, and a refresh failure retains the last good value. A session or day without priced usage shows a "no usage recorded" word rather than a fabricated figure. A failure — no API key configured, a rejected credential, a transport error — renders a muted "Balance unavailable" word whose tooltip carries the Remote's own error message.
 
 The package also contributes the **turn-cost entry** (`billing-turn-cost`, order 20) to ui-chat's `conversation.chat.assistant-actions` list slot — the same strip `ui-message-feedback` uses, so entries coexist; the entry's own CSS `order: 1` sorts it after every order-0 sibling, so the amount lands at the **end** of the actions row (after the clock). The entry renders a plain static `¥X` (no icon, no label, no interaction) for each completed turn's closing assistant message, resolved from a shared per-session `messageId → cost` map (`billing/getSessionTurnSpends`, one fetch per session, coalesced across concurrently mounting rows; a message id the map does not know triggers exactly one refetch for a newly completed turn). Turns that priced to zero (no DeepSeek usage) and failed loads render nothing, so a Remote outage never clutters the row.
 
@@ -15,7 +15,7 @@ The badge is account-level even though the slot is session-scoped: the header ut
 The spends follow the conversation and the balance is cached, not polled:
 
 - **Session spend is pushed, not fetched** — the host folds each session's spend into the client-visible `billingTodaySpend` projection and pushes every change; the badge subscribes with the framework `useProjection` seat, so the session line is live with zero Remote calls while the projection registry is composed. When the key is absent, the same line falls back to `billing/getSessionSpend`.
-- **Today's spend follows settled turns, debounced** — the component subscribes to the current session's running flag through the framework `useSession` seat. When a prompt turn settles (the flag flips back to idle) it recomputes today's spend (`billing/getTodaySpend`); the recompute is debounced for two seconds, so a burst of turns (an agent continuing across turns) prices once instead of once per turn. The ranking (`billing/getTodaySessionsSpend`) is fetched only while the detail panel is open (and on refresh), so a badge that stays closed never pays for the all-session scan.
+- **Today's spend follows settled turns, debounced** — the component subscribes to the current session's running flag through the framework `useSession` seat. When a prompt turn settles (the flag flips back to idle) it recomputes today's spend (`billing/getTodaySpend`); the recompute is debounced for two seconds, so a burst of turns (an agent continuing across turns) prices once instead of once per turn. The ranking (`billing/getTodaySessionsSpend`) is fetched only while the detail panel is open (and on refresh), so a badge that stays closed never pays for the all-session scan; the parenthesized today share on the 本会话花费 row reads that same fetch, so it costs no extra request and moves with the ranking (（—） until the first one settles).
 - **Balance is TTL-cached** — the account balance is fetched on mount, on session switch, and on the explicit refresh action. The host reuses one snapshot for up to 15 seconds (`force` on the manual refresh bypasses it) and aborts a request after 5 seconds; the browser keeps the last settled value so a session switch renders the amount immediately. There is still no polling and no automatic refetch.
 - **Refresh keeps the last values** — an in-flight refresh leaves the previous values on screen, and a failed refresh retains the last good value instead of blanking it. The refresh action calls `billing/getBalance(true)`, `billing/getTodaySpend(true)`, and `billing/getTodaySessionsSpend(true)`, which bypass the host-side caches; the turn-triggered recompute and the mount/session-switch reads use the cached path.
 

package/README.zh.md

@@ -4,7 +4,7 @@
 
 Web 额度特性的归属方：向 `conversation.session.header.utilities` 贡献一个条目，自己挂载 `billing` Remote，并渲染 DeepSeek 账户余额、本会话的计费花费（读宿主推送的 `billingTodaySpend` 投影，投影注册表不存在时回退 `billing/getSessionSpend`）、今日所有会话的计费花费（`billing/getTodaySpend`）、今日按会话的排行（`billing/getTodaySessionsSpend`）与各回合花费（`billing/getSessionTurnSpends`），在右上角渲染成一个标签框。该能力的宿主侧在 [`dsh-llm-billing`](../llm-billing/README.md)，它拥有 `/user/balance` 传输、峰谷计价表与 `billing` Remote 命名空间；本包挂载那个 Remote 并渲染它返回的内容。
 
-触发器显示两行——剩余额度与本轮对话的计费花费（「本轮对话花费 ¥X」）——有上次已落定的余额就立即渲染（按插件实例保留），后台校验；首次余额尚未到达时不渲染任何东西。点击后展开一个标签框：剩余金额、本会话的计费花费（本会话花费，按官方峰/谷单价逐条用量样本计价——高峰窗口仅周一至周五适用，周末按低谷价——分叉会话只按分叉后的自有工作计价——右侧并列今日所有会话的合计「今日共花费」）、每个模型一行的花费及其缓存命中/未命中输入/输出分项（「缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z」）、手动刷新按钮与花费说明。剩余金额行（`API 剩余金额`）字号大于下方花费行。模型行下方是**今日会话花费排行**（`今日会话花费`）：按今日花费从高到低排列的会话列表，每行以右对齐的名次列开头，后接与花费分项相同的小圆点分隔符（「·」，字号、色调与间距一致），再是会话的持久标题（重命名自动同步），最后是金额——标题在名次列后缩进对齐；最多渲染 `SESSION_RANKING_LIMIT`（10）行，其余以「…还有 N 个会话」提示。刷新时旧值不消失，刷新失败保留上一次有效值。没有可计价消耗的会话或日子显示「暂无消耗记录」而不是编造数字。失败——未配置 API key、凭据被拒绝、传输错误——渲染弱化的「额度不可用」，其提示携带 Remote 自己的错误信息。
+触发器显示两行——剩余额度与本轮对话的计费花费（「本轮对话花费 ¥X」）——有上次已落定的余额就立即渲染（按插件实例保留），后台校验；首次余额尚未到达时不渲染任何东西。点击后展开一个标签框：剩余金额、本会话的计费花费（「本会话花费」，按官方峰/谷单价逐条用量样本计价——高峰窗口仅周一至周五适用，周末按低谷价——分叉会话只按分叉后的自有工作计价——同行右侧并列今日所有会话的合计「今日」；本会话花费金额后紧跟一个括号括起来的纯金额（`（¥X）`），那是**本会话今日份**的花费，取自已拉取的今日会话排行、按当前会话 id 匹配，所以既不是排行首行、也不是当日合计——排行未落定时显示 `（—）`，落定但该会话没有行时显示 `（¥0）`）、每个模型一行的花费及其缓存命中/未命中输入/输出分项（「缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z」）、手动刷新按钮，以及「?」按钮上的一句简短花费说明（只估算 DeepSeek 与 MiMo 模型、按每条消息自身时刻的峰谷单价计价，下一行顶格是纯版本号（如 `v0.3.11`）——构建期从本包 manifest 注入，便于反馈时指明所用版本；费率明细在宿主 README —— DSH 的悬停气泡只装得下短文案，过长会在视口边缘被裁掉且无法悬停阅读，所以说明放在按钮下方，纵向适配可翻转的那一侧）。剩余金额行（`API 剩余金额`）字号大于下方花费行（`本会话花费` 与其括号金额、`今日`）。模型行下方是**今日会话花费排行**（`今日会话花费`）：按今日花费从高到低排列的会话列表，每行以右对齐的名次列开头，后接与花费分项相同的小圆点分隔符（「·」，字号、色调与间距一致），再是会话的持久标题（重命名自动同步），最后是金额——标题在名次列后缩进对齐；最多渲染 `SESSION_RANKING_LIMIT`（10）行，其余以「…还有 N 个会话」提示。刷新时旧值不消失，刷新失败保留上一次有效值。没有可计价消耗的会话或日子显示「暂无消耗记录」而不是编造数字。失败——未配置 API key、凭据被拒绝、传输错误——渲染弱化的「额度不可用」，其提示携带 Remote 自己的错误信息。
 
 本包还贡献**本轮花费条目**（`billing-turn-cost`，order 20）到 ui-chat 的 `conversation.chat.assistant-actions` list slot——与 `ui-message-feedback` 同一条操作条，多条目共存；条目自身的 CSS `order: 1` 把它排到所有 order-0 兄弟之后，金额因此落在操作行**行尾**（时钟之后）。它为每个已完成回合的收尾助手消息渲染一个纯静态 `¥X`（无图标、无文字标签、不可点击），金额来自每会话共享的 `messageId → 金额` 映射（`billing/getSessionTurnSpends`，每会话只拉一次，并发挂载的行共享同一请求；映射里没有的消息 id 只触发一次重拉，对应当前刚完成的回合）。回合没有 DeepSeek 用量（花费为 0）或加载失败时不渲染，Remote 故障不会污染操作行。
 
@@ -15,7 +15,7 @@ Web 额度特性的归属方：向 `conversation.session.header.utilities` 贡
 花费跟随会话、额度带缓存但不轮询：
 
 - **本会话花费靠推送，不靠拉取** —— 宿主把每个会话的花费折进客户端可见的 `billingTodaySpend` 投影并推送每次变化；徽标用框架 `useProjection` 座位订阅，因此投影注册表装配时该行零 Remote 调用、实时更新。键不存在时同一行回退到 `billing/getSessionSpend`。
-- **今日共花费随回合结束更新（去抖）** —— 组件通过框架 `useSession` 座位订阅当前会话的「运行中」标志。每当一轮 prompt 回合结束（标志翻回空闲）就重算**今日共花费**（`billing/getTodaySpend`）；重算有 2 秒去抖，回合突发（agent 连续多轮）只计价一次。**排行**（`billing/getTodaySessionsSpend`）只在详情面板打开时（以及手动刷新时）拉取，徽标一直关着就不会为全量会话扫描买单。
+- **今日花费随回合结束更新（去抖）** —— 组件通过框架 `useSession` 座位订阅当前会话的「运行中」标志。每当一轮 prompt 回合结束（标志翻回空闲）就重算**今日**（`billing/getTodaySpend`）；重算有 2 秒去抖，回合突发（agent 连续多轮）只计价一次。**排行**（`billing/getTodaySessionsSpend`）只在详情面板打开时（以及手动刷新时）拉取，徽标一直关着就不会为全量会话扫描买单；「本会话花费」行括号里的今日份金额也来自这次排行读取，所以它不额外发请求，代价是与排行同进同退（面板刚打开、排行未落定时先是 `（—）`）。
 - **额度带 TTL 缓存** —— 账户余额在挂载、切换会话、点刷新按钮时拉取。宿主 15 秒内复用同一份快照（手动刷新带 `force` 绕过），单次请求 5 秒超时；浏览器保留最后一次已落定值，切会话时立即渲染。仍然**没有轮询、不会自动重拉**。
 - **刷新保留旧值** —— 刷新在途时旧值留在屏幕上，刷新失败保留上一次有效值，不清空。刷新按钮调用 `billing/getBalance(true)`、`billing/getTodaySpend(true)` 与 `billing/getTodaySessionsSpend(true)`，绕过宿主侧缓存；回合结束触发的重算与挂载/切换会话的读取走缓存路径。
 

package/lib/client.js

@@ -4365,8 +4365,25 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return `¥${amount.toFixed(4).replace(/\.?0+$/, "")}`;
 		}
 		//#endregion
+		//#region lib/types/client/version.js
+		/**
+		* The plugin's own version, reported in the spend-hint bubble so a report can
+		* name the build actually in use.
+		*
+		* The value is stamped in at build time rather than read at runtime: a browser
+		* bundle has no manifest to read. `packages/tsdown.client.ts` defines
+		* `__DSH_PLUGIN_VERSION__` from this package's own `package.json` (the three
+		* published packages share one version), and `vitest.config.ts` defines the
+		* same constant from the same manifest so the suites see what a release ships.
+		* The `typeof` guard keeps a source run without either definition (a foreign
+		* bundler, a bare `tsc` check) from throwing on the undeclared global.
+		* @module @rayadesu/dsh-client-ui-billing/version
+		*/
+		/** The installed plugin version, e.g. `0.3.10`; `dev` when nothing stamped one. */
+		const PLUGIN_VERSION = "0.3.11";
+		//#endregion
 		//#region \0dsh-css:C:\Users\admin\Desktop\me\code\DeepSeek-Harness-chat-billing\packages\ui-billing\src\client\BalanceBadge.module.css.mjs
-		const css$1 = "._4_Wqcq_root{position:relative}._4_Wqcq_trigger{background:var(--dsw-alias-fill-l2);min-height:32px;color:var(--dsw-alias-label-secondary);cursor:pointer;border:0;border-radius:8px;align-items:center;gap:4px;padding:4px 8px;display:inline-flex}._4_Wqcq_trigger:hover,._4_Wqcq_trigger:focus-visible{color:var(--dsw-alias-label-primary)}._4_Wqcq_trigger svg{transition:transform .12s}._4_Wqcq_chevronOpen{transform:rotate(180deg)}._4_Wqcq_triggerLines{text-align:left;flex-direction:column;align-items:flex-start;gap:0;display:flex}._4_Wqcq_linePrimary{font-variant-numeric:tabular-nums;font-size:12px;line-height:16px}._4_Wqcq_lineSecondary{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:15px}._4_Wqcq_unavailable{color:var(--dsw-alias-label-tertiary)}._4_Wqcq_inlineIcon{color:var(--dsw-alias-label-tertiary);flex:none}._4_Wqcq_spinning{color:var(--dsw-alias-label-tertiary);flex:none;animation:.8s linear infinite _4_Wqcq_spin}@keyframes _4_Wqcq_spin{to{transform:rotate(360deg)}}._4_Wqcq_panel{z-index:100;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-specific-menu);width:336px;max-width:min(360px,100vw - 32px);box-shadow:var(--dsw-shadow-lv3);border-radius:12px;flex-direction:column;gap:2px;padding:6px;display:flex;position:absolute;top:calc(100% + 6px);right:0}._4_Wqcq_amountRow{border-radius:8px;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}._4_Wqcq_amountLabel{color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums;font-size:13px;line-height:18px}._4_Wqcq_amountRow>._4_Wqcq_amountLabel{font-size:15px;line-height:22px}._4_Wqcq_spendRow{border-top:1px solid var(--dsw-alias-border-l2);border-radius:0;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}._4_Wqcq_costRow{align-items:center;padding:2px 8px 6px;display:flex}._4_Wqcq_costBreakdown{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:16px}._4_Wqcq_amountActions{align-items:center;gap:2px;display:inline-flex}._4_Wqcq_infoButton,._4_Wqcq_refreshButton{width:24px;height:24px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}._4_Wqcq_infoButton:hover,._4_Wqcq_infoButton:focus-visible,._4_Wqcq_refreshButton:hover,._4_Wqcq_refreshButton:focus-visible{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-l2)}._4_Wqcq_modelRow{border-radius:8px;justify-content:space-between;align-items:baseline;gap:8px;padding:6px 8px;display:flex}._4_Wqcq_modelName{color:var(--dsw-alias-label-secondary);flex:none;font-size:12px;line-height:18px}._4_Wqcq_tasks{text-align:right;min-width:0;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;overflow-wrap:anywhere;font-size:12px;line-height:18px}._4_Wqcq_ranking{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:0;padding-top:2px;display:flex}._4_Wqcq_rankingTitle{color:var(--dsw-alias-label-secondary);padding:6px 8px 2px;font-size:12px;line-height:18px}._4_Wqcq_rankingRow{border-radius:8px;align-items:baseline;gap:0;min-width:0;padding:3px 8px;display:flex}._4_Wqcq_rankingRow:hover{background:var(--dsw-alias-fill-l2)}._4_Wqcq_rankingIndex{width:16px;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;text-align:right;flex:none;font-size:11px;line-height:16px}._4_Wqcq_rankingDot{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;white-space:pre;flex:none;font-size:11px;line-height:16px}._4_Wqcq_rankingName{min-width:0;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;text-overflow:ellipsis;white-space:nowrap;flex:1;font-size:11px;line-height:16px;overflow:hidden}._4_Wqcq_rankingAmount{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;flex:none;margin-left:8px;font-size:11px;line-height:16px}._4_Wqcq_rankingMore{color:var(--dsw-alias-label-tertiary);padding:2px 8px 4px;font-size:11px;line-height:16px}";
+		const css$1 = "._4_Wqcq_root{position:relative}._4_Wqcq_trigger{background:var(--dsw-alias-fill-l2);min-height:32px;color:var(--dsw-alias-label-secondary);cursor:pointer;border:0;border-radius:8px;align-items:center;gap:4px;padding:4px 8px;display:inline-flex}._4_Wqcq_trigger:hover,._4_Wqcq_trigger:focus-visible{color:var(--dsw-alias-label-primary)}._4_Wqcq_trigger svg{transition:transform .12s}._4_Wqcq_chevronOpen{transform:rotate(180deg)}._4_Wqcq_triggerLines{text-align:left;flex-direction:column;align-items:flex-start;gap:0;display:flex}._4_Wqcq_linePrimary{font-variant-numeric:tabular-nums;font-size:12px;line-height:16px}._4_Wqcq_lineSecondary{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:15px}._4_Wqcq_unavailable{color:var(--dsw-alias-label-tertiary)}._4_Wqcq_inlineIcon{color:var(--dsw-alias-label-tertiary);flex:none}._4_Wqcq_spinning{color:var(--dsw-alias-label-tertiary);flex:none;animation:.8s linear infinite _4_Wqcq_spin}@keyframes _4_Wqcq_spin{to{transform:rotate(360deg)}}._4_Wqcq_panel{z-index:100;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-specific-menu);width:336px;max-width:min(360px,100vw - 32px);box-shadow:var(--dsw-shadow-lv3);border-radius:12px;flex-direction:column;gap:2px;padding:6px;display:flex;position:absolute;top:calc(100% + 6px);right:0}._4_Wqcq_amountRow{border-radius:8px;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}._4_Wqcq_amountLabel{color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums;font-size:13px;line-height:18px}._4_Wqcq_amountRow>._4_Wqcq_amountLabel{font-size:15px;line-height:22px}._4_Wqcq_spendToday{color:var(--dsw-alias-label-tertiary);font-size:12px}._4_Wqcq_spendRow{border-top:1px solid var(--dsw-alias-border-l2);border-radius:0;justify-content:space-between;align-items:center;gap:8px;padding:6px 8px;display:flex}._4_Wqcq_costRow{align-items:center;padding:2px 8px 6px;display:flex}._4_Wqcq_costBreakdown{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;font-size:11px;line-height:16px}._4_Wqcq_amountActions{align-items:center;gap:2px;display:inline-flex}._4_Wqcq_infoButton,._4_Wqcq_refreshButton{width:24px;height:24px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}._4_Wqcq_infoButton:hover,._4_Wqcq_infoButton:focus-visible,._4_Wqcq_refreshButton:hover,._4_Wqcq_refreshButton:focus-visible{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-l2)}._4_Wqcq_modelRow{border-radius:8px;justify-content:space-between;align-items:baseline;gap:8px;padding:6px 8px;display:flex}._4_Wqcq_modelName{color:var(--dsw-alias-label-secondary);flex:none;font-size:12px;line-height:18px}._4_Wqcq_tasks{text-align:right;min-width:0;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;overflow-wrap:anywhere;font-size:12px;line-height:18px}._4_Wqcq_ranking{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:0;padding-top:2px;display:flex}._4_Wqcq_rankingTitle{color:var(--dsw-alias-label-secondary);padding:6px 8px 2px;font-size:12px;line-height:18px}._4_Wqcq_rankingRow{border-radius:8px;align-items:baseline;gap:0;min-width:0;padding:3px 8px;display:flex}._4_Wqcq_rankingRow:hover{background:var(--dsw-alias-fill-l2)}._4_Wqcq_rankingIndex{width:16px;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;text-align:right;flex:none;font-size:11px;line-height:16px}._4_Wqcq_rankingDot{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;white-space:pre;flex:none;font-size:11px;line-height:16px}._4_Wqcq_rankingName{min-width:0;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;text-overflow:ellipsis;white-space:nowrap;flex:1;font-size:11px;line-height:16px;overflow:hidden}._4_Wqcq_rankingAmount{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;flex:none;margin-left:8px;font-size:11px;line-height:16px}._4_Wqcq_rankingMore{color:var(--dsw-alias-label-tertiary);padding:2px 8px 4px;font-size:11px;line-height:16px}";
 		const tagId$1 = "@rayadesu/dsh-client-ui-billing/BalanceBadge.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
 			const tag = document.createElement("style");
@@ -4400,6 +4417,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"refreshButton": "_4_Wqcq_refreshButton",
 			"root": "_4_Wqcq_root",
 			"spendRow": "_4_Wqcq_spendRow",
+			"spendToday": "_4_Wqcq_spendToday",
 			"spin": "_4_Wqcq_spin",
 			"spinning": "_4_Wqcq_spinning",
 			"tasks": "_4_Wqcq_tasks",
@@ -4408,7 +4426,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"unavailable": "_4_Wqcq_unavailable"
 		};
 		/** The detail box opened from the badge trigger. */
-		function BalancePanel({ amount, spend, todaySpend, sessionsSpend, refreshing, onRefresh, t }) {
+		function BalancePanel({ amount, sessionId, spend, todaySpend, sessionsSpend, refreshing, onRefresh, t }) {
+			const sessionToday = sessionsSpend === null ? void 0 : sessionsSpend.sessions.find((row) => row.sessionId === sessionId)?.total ?? 0;
 			return (0, react_jsx_runtime.jsxs)("div", {
 				className: BalanceBadge_module_css_default.panel,
 				role: "dialog",
@@ -4422,9 +4441,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						}), (0, react_jsx_runtime.jsxs)("span", {
 							className: BalanceBadge_module_css_default.amountActions,
 							children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
-								label: t("info.hint"),
+								label: t("info.hint", { version: PLUGIN_VERSION }),
+								side: "bottom",
 								delayMs: 200,
-								maxWidth: 340,
+								maxWidth: 300,
 								children: (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: BalanceBadge_module_css_default.infoButton,
@@ -4443,9 +4463,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					}),
 					(0, react_jsx_runtime.jsxs)("div", {
 						className: BalanceBadge_module_css_default.spendRow,
-						children: [(0, react_jsx_runtime.jsx)("span", {
+						children: [(0, react_jsx_runtime.jsxs)("span", {
 							className: BalanceBadge_module_css_default.amountLabel,
-							children: t("label.sessionSpend", { amount: spend === null ? "—" : spend.models.length === 0 ? t("stat.none") : formatSpend(spend.total) })
+							children: [t("label.sessionSpend", { amount: spend === null ? "—" : spend.models.length === 0 ? t("stat.none") : formatSpend(spend.total) }), (0, react_jsx_runtime.jsx)("span", {
+								className: BalanceBadge_module_css_default.spendToday,
+								children: t("label.sessionSpend.today", { amount: sessionToday === void 0 ? "—" : formatSpend(sessionToday) })
+							})]
 						}), (0, react_jsx_runtime.jsx)("span", {
 							className: BalanceBadge_module_css_default.amountLabel,
 							children: t("label.todaySpend", { amount: todaySpend === null ? "—" : todaySpend.models.length === 0 ? t("stat.none") : formatSpend(todaySpend.total) })
@@ -4731,6 +4754,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					t
 				}), open ? (0, react_jsx_runtime.jsx)(BalancePanel, {
 					amount,
+					sessionId,
 					spend,
 					todaySpend,
 					sessionsSpend,
@@ -4859,7 +4883,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"trigger.conversationSpend": "本轮对话花费：{amount}",
 			"label.amount": "API 剩余金额：{amount}",
 			"label.sessionSpend": "本会话花费：{amount}",
-			"label.todaySpend": "今日共花费：{amount}",
+			"label.sessionSpend.today": "（{amount}）",
+			"label.todaySpend": "今日：{amount}",
 			"label.cost.hit": "缓存命中 {amount}",
 			"label.cost.input": "未命中输入 {amount}",
 			"label.cost.output": "输出 {amount}",
@@ -4868,7 +4893,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"state.unavailable": "额度不可用",
 			"action.refresh": "刷新",
 			"info.aria": "花费说明",
-			"info.hint": "仅能预估 DeepSeek 及 MiMo 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。基础费率按 DeepSeek 8 月 17 日实行的标准，其中 flash 系列（V4.1 Flash / V4 Flash / Vision Exp）自 9 月 10 日 12:00 起执行新价（谷时 0.02 / 1.0 / 4.0 元每百万 token，峰时为其两倍），该时刻之前的消息仍按原价；V4 Pro 自 9 月 14 日 12:00 起改由 V4.1 Flash 服务并按其实施费率计费。高峰时段为北京时间周一至周五 9:00–12:00、14:00–18:00，周末全天按低谷价计费；MiMo 系列不区分峰谷，统一费率。",
+			"info.hint": "估算：仅 DeepSeek 与 MiMo 模型，按每条消息自身时刻的峰谷官方单价计价（高峰：工作日 9:00–12:00、14:00–18:00）。\nv{version}",
 			"badge.aria": "DeepSeek 额度：{amount}",
 			"panel.aria": "DeepSeek 额度详情",
 			"label.sessionRanking": "今日会话花费",
@@ -4880,7 +4905,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"trigger.conversationSpend": "This conversation: {amount}",
 			"label.amount": "API balance: {amount}",
 			"label.sessionSpend": "This session: {amount}",
-			"label.todaySpend": "Today total: {amount}",
+			"label.sessionSpend.today": " ({amount})",
+			"label.todaySpend": "Today: {amount}",
 			"label.cost.hit": "Cache hit {amount}",
 			"label.cost.input": "Missed input {amount}",
 			"label.cost.output": "Output {amount}",
@@ -4889,7 +4915,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"state.unavailable": "Balance unavailable",
 			"action.refresh": "Refresh",
 			"info.aria": "About this spend",
-			"info.hint": "Only DeepSeek and MiMo models are estimated. This session's spend is priced per message at the rate of its Beijing-time peak/off-peak hour: cache-hit input, cache-miss input (including cache writes), and output (including reasoning) are billed separately. The base rates follow DeepSeek's August 17 pricing; the flash series (V4.1 Flash, V4 Flash, Vision Exp) was re-priced from September 10, 12:00 Beijing time (off-peak 0.02 / 1.0 / 4.0 CNY per 1M tokens, peak at twice those prices) while messages from before that instant keep the earlier rates, and V4 Pro switches to V4.1 Flash and its rates from September 14, 12:00 Beijing time. Peak hours are Beijing time Monday–Friday 09:00–12:00 and 14:00–18:00, and weekends are billed at off-peak prices all day. MiMo series uses a flat rate with no peak/off-peak distinction.",
+			"info.hint": "Estimate: DeepSeek and MiMo models only, each message priced at the official peak/off-peak rate of its own time (peak: weekdays 09:00–12:00, 14:00–18:00).\nv{version}",
 			"badge.aria": "DeepSeek balance {amount}",
 			"panel.aria": "DeepSeek balance details",
 			"label.sessionRanking": "Today session spend",

package/lib/types/client/BalancePanel.d.ts

@@ -1,12 +1,17 @@
 import type { DeepSeekSessionSpend, DeepSeekTodaySessionsSpend, DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import { NS } from './locales.ts';
-/** How many per-session ranking rows the panel shows before the overflow hint. */
+/**
+ * How many per-session ranking rows the panel shows before the overflow hint.
+ */
 export declare const SESSION_RANKING_LIMIT = 10;
 /** Panel props: precomputed amount plus the same spend values the badge holds. */
 export interface BalancePanelProps {
     /** Primary balance line, e.g. `¥123.45`; `—` when the provider reports none. */
     amount: string;
+    /** The session this panel belongs to: the row looked up in today's ranking. */
+    sessionId: SessionId;
     spend: DeepSeekSessionSpend | null;
     todaySpend: DeepSeekTodaySpend | null;
     sessionsSpend: DeepSeekTodaySessionsSpend | null;
@@ -15,5 +20,5 @@ export interface BalancePanelProps {
     t: PropsLocale<typeof NS>['t'];
 }
 /** The detail box opened from the badge trigger. */
-export declare function BalancePanel({ amount, spend, todaySpend, sessionsSpend, refreshing, onRefresh, t }: BalancePanelProps): import("react").JSX.Element;
+export declare function BalancePanel({ amount, sessionId, spend, todaySpend, sessionsSpend, refreshing, onRefresh, t }: BalancePanelProps): import("react").JSX.Element;
 //# sourceMappingURL=BalancePanel.d.ts.map

package/lib/types/client/locales.d.ts

@@ -7,7 +7,8 @@ export declare const zh: {
     readonly 'trigger.conversationSpend': "本轮对话花费：{amount}";
     readonly 'label.amount': "API 剩余金额：{amount}";
     readonly 'label.sessionSpend': "本会话花费：{amount}";
-    readonly 'label.todaySpend': "今日共花费：{amount}";
+    readonly 'label.sessionSpend.today': "（{amount}）";
+    readonly 'label.todaySpend': "今日：{amount}";
     readonly 'label.cost.hit': "缓存命中 {amount}";
     readonly 'label.cost.input': "未命中输入 {amount}";
     readonly 'label.cost.output': "输出 {amount}";
@@ -16,7 +17,7 @@ export declare const zh: {
     readonly 'state.unavailable': "额度不可用";
     readonly 'action.refresh': "刷新";
     readonly 'info.aria': "花费说明";
-    readonly 'info.hint': "仅能预估 DeepSeek 及 MiMo 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。基础费率按 DeepSeek 8 月 17 日实行的标准，其中 flash 系列（V4.1 Flash / V4 Flash / Vision Exp）自 9 月 10 日 12:00 起执行新价（谷时 0.02 / 1.0 / 4.0 元每百万 token，峰时为其两倍），该时刻之前的消息仍按原价；V4 Pro 自 9 月 14 日 12:00 起改由 V4.1 Flash 服务并按其实施费率计费。高峰时段为北京时间周一至周五 9:00–12:00、14:00–18:00，周末全天按低谷价计费；MiMo 系列不区分峰谷，统一费率。";
+    readonly 'info.hint': "估算：仅 DeepSeek 与 MiMo 模型，按每条消息自身时刻的峰谷官方单价计价（高峰：工作日 9:00–12:00、14:00–18:00）。\nv{version}";
     readonly 'badge.aria': "DeepSeek 额度：{amount}";
     readonly 'panel.aria': "DeepSeek 额度详情";
     readonly 'label.sessionRanking': "今日会话花费";

package/lib/types/client/version.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The plugin's own version, reported in the spend-hint bubble so a report can
+ * name the build actually in use.
+ *
+ * The value is stamped in at build time rather than read at runtime: a browser
+ * bundle has no manifest to read. `packages/tsdown.client.ts` defines
+ * `__DSH_PLUGIN_VERSION__` from this package's own `package.json` (the three
+ * published packages share one version), and `vitest.config.ts` defines the
+ * same constant from the same manifest so the suites see what a release ships.
+ * The `typeof` guard keeps a source run without either definition (a foreign
+ * bundler, a bare `tsc` check) from throwing on the undeclared global.
+ * @module @rayadesu/dsh-client-ui-billing/version
+ */
+/** The installed plugin version, e.g. `0.3.10`; `dev` when nothing stamped one. */
+export declare const PLUGIN_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rayadesu/dsh-client-ui-billing",
   "description": "Session-header DeepSeek account-balance and conversation-spend badge over the billing Remote",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -47,7 +47,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.3.10",
+    "@rayadesu/dsh-llm-billing": "^0.3.11",
     "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.5",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.5",
     "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.5",
@@ -58,7 +58,7 @@
     "@deepseek-ai/dsh-session": "^0.1.2-alpha.5"
   },
   "devDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.3.10",
+    "@rayadesu/dsh-llm-billing": "^0.3.11",
     "@deepseek-ai/dsh-api-gateway": "^0.1.2-alpha.5",
     "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.5",
     "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.5",