@rayadesu/dsh-client-ui-billing 0.2.2 → 0.2.4

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: 0856ee1b93e49f34da5f534ce189568b8157d157
-README.zh.md: 80a4334b4eaf79636fbdad0ce9484f07dfb1f8e0
+README.md: b4ac01bab9f32a7bdad2dbd1f86f2f4a53f25af6
+README.zh.md: d7719cf98df1cf5b8c8189c99901019a37f04e45

package/README.md

@@ -2,9 +2,11 @@
 
 English | [中文](README.zh.md)
 
-Web billing feature owner: contributes one entry to `conversation.session.header.utilities` that mounts its own `billing` Remote, reads the DeepSeek account balance, this session's billed spend, and today's spend across every session through `billing/getBalance`, `billing/getSessionSpend`, and `billing/getTodaySpend`, and renders them 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.
+Web billing feature owner: contributes one entry to `conversation.session.header.utilities` that mounts its own `billing` Remote, reads the DeepSeek account balance, this session's billed spend, today's spend across every session, today's per-session ranking, and one turn's cost through `billing/getBalance`, `billing/getSessionSpend`, `billing/getTodaySpend`, `billing/getTodaySessionsSpend`, and `billing/getTurnSpend`, and renders them 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 nothing while the first fetch is in flight. Clicking it opens a label box with the remaining amount, this session's billed spend (本会话花费, priced per message at the official peak/off-peak rate — peak windows apply weekdays Mon–Fri only, weekends are off-peak) 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. 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 nothing while the first fetch is in flight. Clicking it opens a label box with the remaining amount, this session's billed spend (本会话花费, priced per message at the official peak/off-peak rate — peak windows apply weekdays Mon–Fri only, weekends are off-peak) 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. Below the model rows the panel ends with the **today session-spend ranking** (`今日会话花费`): sessions sorted by today's cost, highest first, each row carrying the session's durable title (renames sync automatically) and its amount; 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. For each completed turn's closing assistant message, the entry reads `billing/getTurnSpend` (memoized per session + message, since settled turns never change) and renders a muted `本轮花费：¥X` label in the actions row, next to the turn's usage card. Turns that priced to zero (no DeepSeek usage) and failed loads render nothing, so a Remote outage never clutters the row.
 
 The badge is account-level even though the slot is session-scoped: the header utilities row is simply the one always-visible title-bar seat the shell offers, and the balance it shows does not vary by session — but the spend lines do, because they price the current session's own token usage through `billing/getSessionSpend` and every session's usage through `billing/getTodaySpend`. Copy goes through the package's own `billing` locale namespace; styling uses tokens only.
 
@@ -12,9 +14,9 @@ The badge is account-level even though the slot is session-scoped: the header ut
 
 The spends follow the conversation and the balance stays a manual snapshot:
 
-- **Spends follow 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 this session's spend (`billing/getSessionSpend`) and today's spend (`billing/getTodaySpend`), local pricing passes with no network request, so the spend lines stay live during an ongoing conversation. 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 host-side cache (see `dsh-llm-billing`) then serves the first miss for the rest of the minute.
+- **Spends follow 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 this session's spend (`billing/getSessionSpend`), today's spend (`billing/getTodaySpend`), and the ranking (`billing/getTodaySessionsSpend`), local pricing passes with no network request, so the spend lines stay live during an ongoing conversation. 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 host-side cache (see `dsh-llm-billing`) then serves the first miss for the rest of the minute.
 - **Balance is manual** — the account balance is fetched on mount, on session switch, and on the explicit refresh action (`billing/getBalance`). There is no polling and no automatic refetch: the balance line only changes when one of those events happens.
-- **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/getTodaySpend(true)`, which bypasses the host-side cache; the turn-triggered recompute and the mount/session-switch read use the cached path.
+- **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/getTodaySpend(true)` and `billing/getTodaySessionsSpend(true)`, which bypass the host-side cache; the turn-triggered recompute and the mount/session-switch read use the cached path.
 
 ## Model Experience
 
@@ -27,4 +29,6 @@ None; the package never assembles or sends provider requests, and its one RPC is
 ## Known Limitations and Deferred Work
 
 - **First balance line only** — the balance reads the primary (`balance_infos[0]`) currency line; other currency lines are not shown.
+- **Ranking capped at 10** — the panel shows at most `SESSION_RANKING_LIMIT` sessions, with a "…N more sessions" hint.
+- **Turn cost needs a finalized closing message** — interrupted turns have no actions row, so no turn cost is shown for them.
 - **Balance does not follow automatically** — the balance is a manual snapshot (no polling): spending from another client does not move the shown value until a refresh or browser reload.

package/README.zh.md

@@ -2,9 +2,11 @@
 
 [English](README.md) | 中文
 
-Web 额度特性的归属方：向 `conversation.session.header.utilities` 贡献一个条目，自己挂载 `billing` Remote，通过 `billing/getBalance`、`billing/getSessionSpend` 与 `billing/getTodaySpend` 读取 DeepSeek 账户余额、本会话的计费花费与今日所有会话的计费花费，并在右上角渲染成一个标签框。该能力的宿主侧在 [`dsh-llm-billing`](../llm-billing/README.md)，它拥有 `/user/balance` 传输、峰谷计价表与 `billing` Remote 命名空间；本包挂载那个 Remote 并渲染它返回的内容。
+Web 额度特性的归属方：向 `conversation.session.header.utilities` 贡献一个条目，自己挂载 `billing` Remote，通过 `billing/getBalance`、`billing/getSessionSpend`、`billing/getTodaySpend`、`billing/getTodaySessionsSpend` 与 `billing/getTurnSpend` 读取 DeepSeek 账户余额、本会话的计费花费、今日所有会话的计费花费、今日按会话的排行与单个回合的花费，并在右上角渲染成一个标签框。该能力的宿主侧在 [`dsh-llm-billing`](../llm-billing/README.md)，它拥有 `/user/balance` 传输、峰谷计价表与 `billing` Remote 命名空间；本包挂载那个 Remote 并渲染它返回的内容。
 
-触发器显示两行——剩余额度与本轮对话的计费花费（「本轮对话花费 ¥X」）——首个请求在途时不渲染任何东西。点击后展开一个标签框：剩余金额、本会话的计费花费（本会话花费，按官方峰/谷单价逐条消息计价——高峰窗口仅周一至周五适用，周末按低谷价——右侧并列今日所有会话的合计「今日共花费」）、每个模型一行的花费及其缓存命中/未命中输入/输出分项（「缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z」）、手动刷新按钮与花费说明。刷新时旧值不消失，刷新失败保留上一次有效值。没有可计价消耗的会话或日子显示「暂无消耗记录」而不是编造数字。失败——未配置 API key、凭据被拒绝、传输错误——渲染弱化的「额度不可用」，其提示携带 Remote 自己的错误信息。
+触发器显示两行——剩余额度与本轮对话的计费花费（「本轮对话花费 ¥X」）——首个请求在途时不渲染任何东西。点击后展开一个标签框：剩余金额、本会话的计费花费（本会话花费，按官方峰/谷单价逐条消息计价——高峰窗口仅周一至周五适用，周末按低谷价——右侧并列今日所有会话的合计「今日共花费」）、每个模型一行的花费及其缓存命中/未命中输入/输出分项（「缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z」）、手动刷新按钮与花费说明。模型行下方是**今日会话花费排行**（`今日会话花费`）：按今日花费从高到低排列的会话列表，每行带会话的持久标题（重命名自动同步）与金额；最多渲染 `SESSION_RANKING_LIMIT`（10）行，其余以「…还有 N 个会话」提示。刷新时旧值不消失，刷新失败保留上一次有效值。没有可计价消耗的会话或日子显示「暂无消耗记录」而不是编造数字。失败——未配置 API key、凭据被拒绝、传输错误——渲染弱化的「额度不可用」，其提示携带 Remote 自己的错误信息。
+
+本包还贡献**本轮花费条目**（`billing-turn-cost`，order 20）到 ui-chat 的 `conversation.chat.assistant-actions` list slot——与 `ui-message-feedback` 同一条操作条，多条目共存。对每条已完成回合的收尾助手消息，条目通过 `billing/getTurnSpend` 读取花费（按会话 + 消息 memo，回合落定后不再变化），在操作行里（与时间、复制、分叉同一排，紧邻该回合的「本轮用量」卡片）渲染弱化的「本轮花费：¥X」。回合没有 DeepSeek 用量（花费为 0）或加载失败时不渲染，Remote 故障不会污染操作行。
 
 角标是账户级的，尽管插槽是会话作用域：顶栏工具行不过是外壳提供的那个始终可见的标题栏席位，余额并不随会话变化——但花费行会，因为它通过 `billing/getSessionSpend` 按当前会话自己的 token 用量计价、通过 `billing/getTodaySpend` 按所有会话的用量计价。文案走本包自己的 `billing` locale 命名空间；样式只用 token。
 
@@ -12,9 +14,9 @@ Web 额度特性的归属方：向 `conversation.session.header.utilities` 贡
 
 花费跟随会话、额度保持手动快照：
 
-- **花费随回合结束自动更新（去抖）** —— 组件通过框架 `useSession` 座位订阅当前会话的「运行中」标志。每当一轮 prompt 回合结束（标志翻回空闲），就只重算**本会话的花费**（`billing/getSessionSpend`）与**今日共花费**（`billing/getTodaySpend`，纯本地计价、不发网络请求），连续对话时花费行实时跟随。重算有 2 秒去抖，回合突发（agent 连续多轮）只计价一次；宿主侧缓存（见 `dsh-llm-billing`）随后在一分钟内服务首次未命中。
+- **花费随回合结束自动更新（去抖）** —— 组件通过框架 `useSession` 座位订阅当前会话的「运行中」标志。每当一轮 prompt 回合结束（标志翻回空闲），就只重算**本会话的花费**（`billing/getSessionSpend`）、**今日共花费**（`billing/getTodaySpend`）与**排行**（`billing/getTodaySessionsSpend`，纯本地计价、不发网络请求），连续对话时花费行实时跟随。重算有 2 秒去抖，回合突发（agent 连续多轮）只计价一次；宿主侧缓存（见 `dsh-llm-billing`）随后在一分钟内服务首次未命中。
 - **额度保持手动** —— 账户余额在挂载、切换会话、点刷新按钮时拉取（`billing/getBalance`）。**没有轮询、不会自动重拉**：余额行只在这几个时机变化。
-- **刷新保留旧值** —— 刷新在途时旧值留在屏幕上，刷新失败保留上一次有效值，不清空。刷新按钮调用 `billing/getTodaySpend(true)`，绕过宿主侧缓存；回合结束触发的重算与挂载/切换会话的读取走缓存路径。
+- **刷新保留旧值** —— 刷新在途时旧值留在屏幕上，刷新失败保留上一次有效值，不清空。刷新按钮调用 `billing/getTodaySpend(true)` 与 `billing/getTodaySessionsSpend(true)`，绕过宿主侧缓存；回合结束触发的重算与挂载/切换会话的读取走缓存路径。
 
 ## 模型体验
 
@@ -27,4 +29,6 @@ Web 额度特性的归属方：向 `conversation.session.header.utilities` 贡
 ## 已知限制与暂缓事项
 
 - **只取首条余额线** —— 余额读取主要（`balance_infos[0]`）币种行；其它币种行不显示。
+- **排行上限 10** —— 面板最多显示 `SESSION_RANKING_LIMIT` 个会话，其余以「…还有 N 个会话」提示。
+- **本轮花费需要已定稿的收尾消息** —— 中断的回合没有操作行，不显示本轮花费。
 - **额度不自动跟随** —— 余额保持手动快照（无轮询）：其他客户端产生的消耗不会让界面数值自动变化，需手动刷新或刷新浏览器。

package/lib/client.js

@@ -4120,6 +4120,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				"outputCost": number()
 			}))
 		});
+		const _rayadesu_dsh_llm_billing_billing_getTodaySessionsSpend_parameter_0$schema = union([
+			_undefined(),
+			literal(false),
+			literal(true)
+		]);
+		const _rayadesu_dsh_llm_billing_billing_getTodaySessionsSpend_result$schema = object({ "sessions": array(object({
+			"sessionId": intersection(string(), unknown()),
+			"title": union([literal(null), string()]),
+			"total": number()
+		})) });
 		const _rayadesu_dsh_llm_billing_billing_getTodaySpend_parameter_0$schema = union([
 			_undefined(),
 			literal(false),
@@ -4141,6 +4151,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				"outputCost": number()
 			}))
 		});
+		const _rayadesu_dsh_llm_billing_billing_getTurnSpend_parameter_0$schema = intersection(string(), unknown());
+		const _rayadesu_dsh_llm_billing_billing_getTurnSpend_parameter_1$schema = string();
+		const _rayadesu_dsh_llm_billing_billing_getTurnSpend_result$schema = object({ "total": number() });
 		const TYPERT_REMOTE = {
 			package: "@rayadesu/dsh-llm-billing",
 			descriptors: [
@@ -4158,7 +4171,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/llm-billing/src/balance.ts",
-						"line": 143,
+						"line": 154,
 						"column": 3
 					}
 				},
@@ -4185,7 +4198,35 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/llm-billing/src/balance.ts",
-						"line": 154,
+						"line": 165,
+						"column": 3
+					}
+				},
+				{
+					id: "@rayadesu/dsh-llm-billing#billing/getTodaySessionsSpend",
+					service: "billing",
+					namespace: "billing",
+					method: "getTodaySessionsSpend",
+					invocation: { kind: "direct" },
+					parameters: [{
+						name: "force",
+						wire: "force",
+						source: "json",
+						acceptsUndefined: true,
+						codec: {
+							mode: "strict",
+							typeSymbol: "@rayadesu/dsh-llm-billing#billing/getTodaySessionsSpend:force",
+							schema: _rayadesu_dsh_llm_billing_billing_getTodaySessionsSpend_parameter_0$schema
+						}
+					}],
+					result: {
+						mode: "strict",
+						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekTodaySessionsSpend",
+						schema: _rayadesu_dsh_llm_billing_billing_getTodaySessionsSpend_result$schema
+					},
+					sourceLocation: {
+						"file": "packages/llm-billing/src/balance.ts",
+						"line": 192,
 						"column": 3
 					}
 				},
@@ -4213,7 +4254,43 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/llm-billing/src/balance.ts",
-						"line": 167,
+						"line": 178,
+						"column": 3
+					}
+				},
+				{
+					id: "@rayadesu/dsh-llm-billing#billing/getTurnSpend",
+					service: "billing",
+					namespace: "billing",
+					method: "getTurnSpend",
+					invocation: { kind: "direct" },
+					parameters: [{
+						name: "sessionId",
+						wire: "sessionId",
+						source: "json",
+						codec: {
+							mode: "strict",
+							typeSymbol: "@rayadesu/dsh-llm-billing#billing/getTurnSpend:sessionId",
+							schema: _rayadesu_dsh_llm_billing_billing_getTurnSpend_parameter_0$schema
+						}
+					}, {
+						name: "messageId",
+						wire: "messageId",
+						source: "json",
+						codec: {
+							mode: "strict",
+							typeSymbol: "@rayadesu/dsh-llm-billing#billing/getTurnSpend:messageId",
+							schema: _rayadesu_dsh_llm_billing_billing_getTurnSpend_parameter_1$schema
+						}
+					}],
+					result: {
+						mode: "strict",
+						typeSymbol: "@rayadesu/dsh-llm-billing/types#DeepSeekTurnSpend",
+						schema: _rayadesu_dsh_llm_billing_billing_getTurnSpend_result$schema
+					},
+					sourceLocation: {
+						"file": "packages/llm-billing/src/balance.ts",
+						"line": 205,
 						"column": 3
 					}
 				}
@@ -4221,13 +4298,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		};
 		//#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 = "._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_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}";
-		const tagId = "@rayadesu/dsh-client-ui-billing/BalanceBadge.module.css";
-		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+		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_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-tertiary);padding:6px 8px 2px;font-size:11px;line-height:16px}._4_Wqcq_rankingRow{border-radius:8px;align-items:baseline;gap:8px;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_rankingName{min-width:0;color:var(--dsw-alias-label-secondary);text-overflow:ellipsis;white-space:nowrap;flex:1;font-size:12px;line-height:18px;overflow:hidden}._4_Wqcq_rankingAmount{color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums;flex:none;font-size:12px;line-height:18px}._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");
 			tag.dataset.plugin = "@rayadesu/dsh-client-ui-billing";
-			tag.dataset.pluginCss = tagId;
-			tag.textContent = css;
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
 			document.head.appendChild(tag);
 		}
 		var BalanceBadge_module_css_default = {
@@ -4244,6 +4321,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"modelName": "_4_Wqcq_modelName",
 			"modelRow": "_4_Wqcq_modelRow",
 			"panel": "_4_Wqcq_panel",
+			"ranking": "_4_Wqcq_ranking",
+			"rankingAmount": "_4_Wqcq_rankingAmount",
+			"rankingIndex": "_4_Wqcq_rankingIndex",
+			"rankingMore": "_4_Wqcq_rankingMore",
+			"rankingName": "_4_Wqcq_rankingName",
+			"rankingRow": "_4_Wqcq_rankingRow",
+			"rankingTitle": "_4_Wqcq_rankingTitle",
 			"refreshButton": "_4_Wqcq_refreshButton",
 			"root": "_4_Wqcq_root",
 			"spendRow": "_4_Wqcq_spendRow",
@@ -4273,10 +4357,24 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			};
 		}
 		/** CNY amount, up to four decimals with trailing zeros trimmed. */
-		function formatSpend(amount) {
+		function formatSpend$1(amount) {
 			return `¥${amount.toFixed(4).replace(/\.?0+$/, "")}`;
 		}
 		/**
+		* Run one fetch line: the fetch is deferred to a microtask so the effect's
+		* render commits before any state update lands; a settled value is stored
+		* while `current` stays true, and a rejection keeps the previous value (a
+		* no-op unless `onReject` supplies fallback handling) so a failed refetch
+		* never blanks the UI.
+		*/
+		function fetchLine(current, fetch, store, onReject) {
+			return Promise.resolve().then(fetch).then((value) => {
+				if (current()) store(value);
+			}, (reason) => {
+				if (current()) onReject?.(reason);
+			});
+		}
+		/**
 		* Render the billing badge in the session-header utilities row. The trigger
 		* shows the remaining balance and this conversation's billed spend and opens
 		* a label box with the amount, this session's spend with its cache-hit /
@@ -4292,10 +4390,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		* @param props - Remote face, locale, and the standard session-header runtime share.
 		* @returns the badge, or null until the first balance fetch settles.
 		*/
-		function BalanceBadge({ getBalance, getSessionSpend, getTodaySpend, sessionId, useSession, t }) {
+		function BalanceBadge({ getBalance, getSessionSpend, getTodaySpend, getTodaySessionsSpend, sessionId, useSession, t }) {
 			const [balance, setBalance] = (0, react.useState)(null);
 			const [spend, setSpend] = (0, react.useState)(null);
 			const [todaySpend, setTodaySpend] = (0, react.useState)(null);
+			const [sessionsSpend, setSessionsSpend] = (0, react.useState)(null);
 			const [error, setError] = (0, react.useState)(null);
 			const [refreshing, setRefreshing] = (0, react.useState)(false);
 			const [open, setOpen] = (0, react.useState)(false);
@@ -4305,28 +4404,23 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const pricedRunningRef = (0, react.useRef)(running);
 			(0, react.useEffect)(() => {
 				let current = true;
+				const isCurrent = () => current;
 				setRefreshing(balance !== null);
 				Promise.resolve().then(() => {
-					const balanceRequest = Promise.resolve().then(getBalance).then((value) => {
-						if (!current) return;
+					const balanceRequest = fetchLine(isCurrent, getBalance, (value) => {
 						setBalance(value);
 						setError(null);
 					}, (reason) => {
-						if (!current) return;
 						if (balance === null) setError(reason instanceof Error ? reason.message : String(reason));
 					});
-					const sessionSpendRequest = Promise.resolve().then(() => getSessionSpend(sessionId)).then((value) => {
-						if (!current) return;
-						setSpend(value);
-					}, () => {});
-					const todaySpendRequest = Promise.resolve().then(() => getTodaySpend(request > 0)).then((value) => {
-						if (!current) return;
-						setTodaySpend(value);
-					}, () => {});
+					const sessionSpendRequest = fetchLine(isCurrent, () => getSessionSpend(sessionId), setSpend);
+					const todaySpendRequest = fetchLine(isCurrent, () => getTodaySpend(request > 0), setTodaySpend);
+					const sessionsSpendRequest = fetchLine(isCurrent, () => getTodaySessionsSpend(request > 0), setSessionsSpend);
 					Promise.allSettled([
 						balanceRequest,
 						sessionSpendRequest,
-						todaySpendRequest
+						todaySpendRequest,
+						sessionsSpendRequest
 					]).then(() => {
 						if (current) setRefreshing(false);
 					});
@@ -4338,6 +4432,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				getBalance,
 				getSessionSpend,
 				getTodaySpend,
+				getTodaySessionsSpend,
 				sessionId,
 				request
 			]);
@@ -4346,17 +4441,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				pricedRunningRef.current = running;
 				if (running) return;
 				let current = true;
+				const isCurrent = () => current;
 				const timer = setTimeout(() => {
-					Promise.resolve().then(() => {
-						Promise.resolve().then(() => getSessionSpend(sessionId)).then((value) => {
-							if (!current) return;
-							setSpend(value);
-						}, () => {});
-						Promise.resolve().then(() => getTodaySpend()).then((value) => {
-							if (!current) return;
-							setTodaySpend(value);
-						}, () => {});
-					});
+					fetchLine(isCurrent, () => getSessionSpend(sessionId), setSpend);
+					fetchLine(isCurrent, () => getTodaySpend(), setTodaySpend);
+					fetchLine(isCurrent, () => getTodaySessionsSpend(), setSessionsSpend);
 				}, 2e3);
 				return () => {
 					clearTimeout(timer);
@@ -4365,6 +4454,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			}, [
 				getSessionSpend,
 				getTodaySpend,
+				getTodaySessionsSpend,
 				sessionId,
 				running
 			]);
@@ -4402,7 +4492,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			};
 			const line = primaryLine(balance);
 			const amount = line === void 0 ? "—" : `${line.symbol}${line.total}`;
-			const spendLine = spend !== null && spend.models.length > 0 ? t("trigger.conversationSpend", { amount: formatSpend(spend.total) }) : void 0;
+			const spendLine = spend !== null && spend.models.length > 0 ? t("trigger.conversationSpend", { amount: formatSpend$1(spend.total) }) : void 0;
 			return (0, react_jsx_runtime.jsxs)("div", {
 				ref: rootRef,
 				className: BalanceBadge_module_css_default.root,
@@ -4460,10 +4550,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 							className: BalanceBadge_module_css_default.spendRow,
 							children: [(0, react_jsx_runtime.jsx)("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$1(spend.total) })
 							}), (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) })
+								children: t("label.todaySpend", { amount: todaySpend === null ? "—" : todaySpend.models.length === 0 ? t("stat.none") : formatSpend$1(todaySpend.total) })
 							})]
 						}),
 						spend?.models.map((model) => (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [(0, react_jsx_runtime.jsxs)("div", {
@@ -4473,26 +4563,120 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 								children: model.displayName
 							}), (0, react_jsx_runtime.jsx)("span", {
 								className: BalanceBadge_module_css_default.tasks,
-								children: formatSpend(model.cost)
+								children: formatSpend$1(model.cost)
 							})]
 						}), (0, react_jsx_runtime.jsx)("div", {
 							className: BalanceBadge_module_css_default.costRow,
 							children: (0, react_jsx_runtime.jsxs)("span", {
 								className: BalanceBadge_module_css_default.costBreakdown,
 								children: [
-									t("label.cost.hit", { amount: formatSpend(model.cacheHitInputCost) }),
+									t("label.cost.hit", { amount: formatSpend$1(model.cacheHitInputCost) }),
 									" · ",
-									t("label.cost.input", { amount: formatSpend(model.cacheMissInputCost) }),
+									t("label.cost.input", { amount: formatSpend$1(model.cacheMissInputCost) }),
 									" · ",
-									t("label.cost.output", { amount: formatSpend(model.outputCost) })
+									t("label.cost.output", { amount: formatSpend$1(model.outputCost) })
 								]
 							})
-						})] }, model.model))
+						})] }, model.model)),
+						sessionsSpend !== null && sessionsSpend.sessions.length > 0 && (0, react_jsx_runtime.jsxs)("div", {
+							className: BalanceBadge_module_css_default.ranking,
+							children: [
+								(0, react_jsx_runtime.jsx)("div", {
+									className: BalanceBadge_module_css_default.rankingTitle,
+									children: t("label.sessionRanking")
+								}),
+								sessionsSpend.sessions.slice(0, 10).map((row, index) => (0, react_jsx_runtime.jsxs)("div", {
+									className: BalanceBadge_module_css_default.rankingRow,
+									children: [
+										(0, react_jsx_runtime.jsx)("span", {
+											className: BalanceBadge_module_css_default.rankingIndex,
+											children: index + 1
+										}),
+										(0, react_jsx_runtime.jsx)("span", {
+											className: BalanceBadge_module_css_default.rankingName,
+											title: row.title ?? void 0,
+											children: row.title ?? t("stat.untitled")
+										}),
+										(0, react_jsx_runtime.jsx)("span", {
+											className: BalanceBadge_module_css_default.rankingAmount,
+											children: formatSpend$1(row.total)
+										})
+									]
+								}, row.sessionId)),
+								sessionsSpend.sessions.length > 10 && (0, react_jsx_runtime.jsx)("div", {
+									className: BalanceBadge_module_css_default.rankingMore,
+									children: t("label.sessionRanking.more", { count: sessionsSpend.sessions.length - 10 })
+								})
+							]
+						})
 					]
 				}) : null]
 			});
 		}
 		//#endregion
+		//#region \0dsh-css:C:\Users\admin\Desktop\me\code\DeepSeek-Harness-chat-billing\packages\ui-billing\src\client\TurnCostAction.module.css.mjs
+		const css = ".l2XZIa_cost{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;white-space:nowrap;flex:none;font-size:12px;line-height:18px}";
+		const tagId = "@rayadesu/dsh-client-ui-billing/TurnCostAction.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@rayadesu/dsh-client-ui-billing";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var TurnCostAction_module_css_default = { "cost": "l2XZIa_cost" };
+		//#endregion
+		//#region lib/types/client/TurnCostAction.js
+		/** Per-turn billed-cost label in the closing assistant message's actions row. */
+		/** CNY amount, up to four decimals with trailing zeros trimmed. */
+		function formatSpend(amount) {
+			return `¥${amount.toFixed(4).replace(/\.?0+$/, "")}`;
+		}
+		const turnCostCache = /* @__PURE__ */ new Map();
+		const TURN_COST_CACHE_LIMIT = 1024;
+		async function cachedTurnCost(sessionId, messageId, getTurnSpend) {
+			const key = `${sessionId}\0${messageId}`;
+			const cached = turnCostCache.get(key);
+			if (cached !== void 0) return cached;
+			const { total } = await getTurnSpend(sessionId, messageId);
+			if (turnCostCache.size >= TURN_COST_CACHE_LIMIT) turnCostCache.clear();
+			turnCostCache.set(key, total);
+			return total;
+		}
+		/**
+		* Render one Turn's billed cost as a muted label inside the closing message's
+		* actions row, between the built-in copy/branch controls and the message
+		* clock. The label appears only after the cost settles and hides again when
+		* the Turn priced to zero (no DeepSeek usage); a failed fetch stays hidden so
+		* a Remote outage never clutters the row.
+		* @param props - the closing message id, the session runtime share, and the injected cost reader.
+		* @returns the cost label, or null while loading, on failure, or for zero cost.
+		*/
+		function TurnCostAction({ messageId, sessionId, getTurnSpend, t }) {
+			const [cost, setCost] = (0, react.useState)(null);
+			(0, react.useEffect)(() => {
+				let current = true;
+				Promise.resolve().then(() => cachedTurnCost(sessionId, messageId, getTurnSpend)).then((total) => {
+					if (current) setCost(total);
+				}, () => {
+					if (current) setCost(null);
+				});
+				return () => {
+					current = false;
+				};
+			}, [
+				getTurnSpend,
+				messageId,
+				sessionId
+			]);
+			if (cost === null || cost <= 0) return null;
+			return (0, react_jsx_runtime.jsx)("span", {
+				className: TurnCostAction_module_css_default.cost,
+				"data-turn-cost": true,
+				children: t("turnCost", { amount: formatSpend(cost) })
+			});
+		}
+		//#endregion
 		//#region lib/types/client/locales.js
 		/** `billing` namespace dictionaries. */
 		/** Dictionary namespace owned by this plugin. */
@@ -4508,12 +4692,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"label.cost.input": "未命中输入 {amount}",
 			"label.cost.output": "输出 {amount}",
 			"stat.none": "暂无消耗记录",
+			"stat.untitled": "未命名",
 			"state.unavailable": "额度不可用",
 			"action.refresh": "刷新",
 			"info.aria": "花费说明",
 			"info.hint": "仅能预估 DeepSeek 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。费率按 8 月 17 日实行的标准，高峰时段为北京时间周一至周五 9:00–12:00、14:00–18:00，周末全天按低谷价计费。",
 			"badge.aria": "DeepSeek 额度：{amount}",
-			"panel.aria": "DeepSeek 额度详情"
+			"panel.aria": "DeepSeek 额度详情",
+			"turnCost": "本轮花费：{amount}",
+			"label.sessionRanking": "今日会话花费",
+			"label.sessionRanking.more": "…还有 {count} 个会话"
 		};
 		/** English dictionary, key-identical to the Chinese source of truth. */
 		const en = {
@@ -4526,12 +4714,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"label.cost.input": "Missed input {amount}",
 			"label.cost.output": "Output {amount}",
 			"stat.none": "No usage recorded",
+			"stat.untitled": "Untitled",
 			"state.unavailable": "Balance unavailable",
 			"action.refresh": "Refresh",
 			"info.aria": "About this spend",
 			"info.hint": "Only DeepSeek 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. Rates follow the August 17 pricing; 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.",
 			"badge.aria": "DeepSeek balance {amount}",
-			"panel.aria": "DeepSeek balance details"
+			"panel.aria": "DeepSeek balance details",
+			"turnCost": "This turn: {amount}",
+			"label.sessionRanking": "Today session spend",
+			"label.sessionRanking.more": "…{count} more sessions"
 		};
 		//#endregion
 		//#region lib/types/client/index.js
@@ -4542,6 +4734,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"locale",
 			"remote"
 		];
+		/** Unwrap one Remote result into its value, reporting the endpoint on failure. */
+		function unwrap(endpoint, result) {
+			if (!result.ok) throw new Error(`${endpoint} failed: ${result.error.code}: ${result.error.message}`);
+			return result.value;
+		}
 		/**
 		* Client plugin body: mount the `billing` Remote, register the dictionaries,
 		* and contribute the header utility badge.
@@ -4555,30 +4752,28 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				zh,
 				en
 			}), "ui-billing: dictionaries");
-			const injected = () => ({
-				getBalance: async () => {
-					const result = await billing.getBalance();
-					if (!result.ok) throw new Error(`billing.getBalance failed: ${result.error.code}: ${result.error.message}`);
-					return result.value;
-				},
-				getSessionSpend: async (sessionId) => {
-					const result = await billing.getSessionSpend(sessionId);
-					if (!result.ok) throw new Error(`billing.getSessionSpend failed: ${result.error.code}: ${result.error.message}`);
-					return result.value;
-				},
-				getTodaySpend: async (force) => {
-					const result = await billing.getTodaySpend(force);
-					if (!result.ok) throw new Error(`billing.getTodaySpend failed: ${result.error.code}: ${result.error.message}`);
-					return result.value;
-				}
-			});
+			const injected = {
+				getBalance: async () => unwrap("billing.getBalance", await billing.getBalance()),
+				getSessionSpend: async (sessionId) => unwrap("billing.getSessionSpend", await billing.getSessionSpend(sessionId)),
+				getTodaySpend: async (force) => unwrap("billing.getTodaySpend", await billing.getTodaySpend(force)),
+				getTodaySessionsSpend: async (force) => unwrap("billing.getTodaySessionsSpend", await billing.getTodaySessionsSpend(force)),
+				getTurnSpend: async (sessionId, messageId) => unwrap("billing.getTurnSpend", await billing.getTurnSpend(sessionId, messageId))
+			};
 			ctx.slots.inject("conversation.session.header.utilities", () => ctx.slots.register({
 				name: "conversation.session.header.utilities",
 				id: "billing-balance",
 				order: 30,
 				locale: NS,
-				inject: injected
+				inject: () => injected
 			}, BalanceBadge));
+			const turnCostInjected = { getTurnSpend: injected.getTurnSpend };
+			ctx.slots.inject("conversation.chat.assistant-actions", () => ctx.slots.register({
+				name: "conversation.chat.assistant-actions",
+				id: "billing-turn-cost",
+				order: 20,
+				locale: NS,
+				inject: () => turnCostInjected
+			}, TurnCostAction));
 		}
 		//#endregion
 		exports.apply = apply;

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

@@ -1,5 +1,5 @@
 /** Session-header billing badge: balance plus the current conversation's billed spend. */
-import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types';
+import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySessionsSpend, DeepSeekTodaySpend, DeepSeekTurnSpend } from '@rayadesu/dsh-llm-billing/types';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { NS } from './locales.ts';
@@ -15,9 +15,18 @@ export interface BalanceBadgeInjected {
      * passes it, the turn-triggered recompute does not.
      */
     getTodaySpend: (force?: boolean) => Promise<DeepSeekTodaySpend>;
+    /**
+     * Read today's billed spend per session, sorted by cost descending; rejects
+     * with the Remote error message. `force` behaves as in {@link getTodaySpend}.
+     */
+    getTodaySessionsSpend: (force?: boolean) => Promise<DeepSeekTodaySessionsSpend>;
+    /** Read one completed Turn's billed cost, located by its closing message id. */
+    getTurnSpend: (sessionId: SessionId, messageId: string) => Promise<DeepSeekTurnSpend>;
 }
 /** Full props assembled by the header utilities slot renderer. */
 export type BalanceBadgeProps = PropsRuntime<'conversation.session.header.utilities'> & InjectFace<BalanceBadgeInjected> & PropsLocale<typeof NS>;
+/** How many per-session ranking rows the panel shows before the overflow hint. */
+export declare const SESSION_RANKING_LIMIT = 10;
 /**
  * Render the billing badge in the session-header utilities row. The trigger
  * shows the remaining balance and this conversation's billed spend and opens
@@ -34,5 +43,5 @@ export type BalanceBadgeProps = PropsRuntime<'conversation.session.header.utilit
  * @param props - Remote face, locale, and the standard session-header runtime share.
  * @returns the badge, or null until the first balance fetch settles.
  */
-export declare function BalanceBadge({ getBalance, getSessionSpend, getTodaySpend, sessionId, useSession, t }: BalanceBadgeProps): import("react").JSX.Element | null;
+export declare function BalanceBadge({ getBalance, getSessionSpend, getTodaySpend, getTodaySessionsSpend, sessionId, useSession, t }: BalanceBadgeProps): import("react").JSX.Element | null;
 //# sourceMappingURL=BalanceBadge.d.ts.map

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

@@ -0,0 +1,28 @@
+/** Per-turn billed-cost label in the closing assistant message's actions row. */
+import type { DeepSeekTurnSpend } from '@rayadesu/dsh-llm-billing/types';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { NS } from './locales.ts';
+/** Injected face: one Turn's billed cost through the billing Remote. */
+export interface TurnCostActionInjected {
+    /** Read one completed Turn's billed cost, located by its closing message id. */
+    getTurnSpend: (sessionId: SessionId, messageId: string) => Promise<DeepSeekTurnSpend>;
+}
+/**
+ * Full props of the per-turn cost entry. The slot's owner share
+ * (`AssistantActionOwnerProps.messageId`) arrives from ui-conversation's
+ * declared `conversation.chat.assistant-actions` slot; the session runtime
+ * share adds `sessionId`.
+ */
+export type TurnCostActionProps = PropsRuntime<'conversation.chat.assistant-actions'> & InjectFace<TurnCostActionInjected> & PropsLocale<typeof NS>;
+/**
+ * Render one Turn's billed cost as a muted label inside the closing message's
+ * actions row, between the built-in copy/branch controls and the message
+ * clock. The label appears only after the cost settles and hides again when
+ * the Turn priced to zero (no DeepSeek usage); a failed fetch stays hidden so
+ * a Remote outage never clutters the row.
+ * @param props - the closing message id, the session runtime share, and the injected cost reader.
+ * @returns the cost label, or null while loading, on failure, or for zero cost.
+ */
+export declare function TurnCostAction({ messageId, sessionId, getTurnSpend, t }: TurnCostActionProps): import("react").JSX.Element | null;
+//# sourceMappingURL=TurnCostAction.d.ts.map

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

@@ -2,6 +2,7 @@
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
 import { type BillingKey } from './locales.ts';
 export type { BalanceBadgeInjected, BalanceBadgeProps } from './BalanceBadge.tsx';
+export type { TurnCostActionInjected, TurnCostActionProps } from './TurnCostAction.tsx';
 export type { BillingKey } from './locales.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {

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

@@ -12,12 +12,16 @@ export declare const zh: {
     readonly 'label.cost.input': "未命中输入 {amount}";
     readonly 'label.cost.output': "输出 {amount}";
     readonly 'stat.none': "暂无消耗记录";
+    readonly 'stat.untitled': "未命名";
     readonly 'state.unavailable': "额度不可用";
     readonly 'action.refresh': "刷新";
     readonly 'info.aria': "花费说明";
     readonly 'info.hint': "仅能预估 DeepSeek 相关模型。本会话花费按每条消息的发生时刻（北京时间）所在峰谷时段单价计费：缓存命中输入、未命中输入（含缓存写入）、输出（含推理）分别计价。费率按 8 月 17 日实行的标准，高峰时段为北京时间周一至周五 9:00–12:00、14:00–18:00，周末全天按低谷价计费。";
     readonly 'badge.aria': "DeepSeek 额度：{amount}";
     readonly 'panel.aria': "DeepSeek 额度详情";
+    readonly turnCost: "本轮花费：{amount}";
+    readonly 'label.sessionRanking': "今日会话花费";
+    readonly 'label.sessionRanking.more': "…还有 {count} 个会话";
 };
 /** English dictionary, key-identical to the Chinese source of truth. */
 export declare const en: Record<BillingKey, string>;

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.2.2",
+  "version": "0.2.4",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -47,7 +47,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.2.2",
+    "@rayadesu/dsh-llm-billing": "^0.2.4",
     "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-typert-protocol": "^0.1.1-rc.2",
@@ -58,7 +58,7 @@
     "@deepseek-ai/dsh-session": "^0.1.1-rc.2"
   },
   "devDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.2.2",
+    "@rayadesu/dsh-llm-billing": "^0.2.4",
     "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-client-test-runtime": "^0.1.1-rc.2",