dsh-token-total 1.1.3 → 1.1.5

package/README.md

@@ -15,6 +15,7 @@ DSH（DeepSeek Harness）Web 插件：**Token 用量统计看板** + **单会话
 ### 统计看板
 
 入口在左侧边栏的插件区（与原生「插件」页并列的独立页面），点开即为看板，分上中下三部分。
+![统计看板](assets/image.png)
 
 #### 上部
 
@@ -40,6 +41,8 @@ DSH（DeepSeek Harness）Web 插件：**Token 用量统计看板** + **单会话
 
 会话输入框下方原生的「用时与速度 / Token 用量」两枚胶囊被接管并增强：
 
+![单会话统计](assets/image-1.png)
+
 - **Token 胶囊**显示的是**整棵会话树**（主智能体 + 全部子智能体）的合计，点开弹窗分为「主智能体 / 子智能体 / 会话合计」三行，并给出子智能体会话数。
 - 子智能体是独立持久化的会话，通过日志头的 `parentSession` 串成树；插件按需重放这些日志汇总（同一套 `(turn, step)` 去重规则，且跳过 fork 继承来的事件前缀，避免与父会话重复计数）。
 - **会话 Token 明细始终开启**：未命中缓存、缓存读 / 写、输出分别列出；底部胶囊的缓存命中率始终显示两位小数。
@@ -49,6 +52,7 @@ DSH（DeepSeek Harness）Web 插件：**Token 用量统计看板** + **单会话
 ### 会话「用量」页
 
 在每个会话原生的「对话 / 轨迹」旁新增 **用量** tab；沿用会话切换与视图导航，不另造顶部栏或输入框。
+![会话用量页](assets/image-2.png)
 
 - **两张实时卡**（形制参考 [magpie](https://github.com/yetone/magpie)）并排位于子代理／模型明细之下、请求记录之上，回答「提示词里现在有什么」与「整场会话到底花了什么」两个不同的问题：
   - 左卡「**当前上下文**」：`已用 / 模型窗口 tokens` 大字附占用百分比，标题行右侧是当前供应商 · 模型；下方一条**整条即模型窗口**的堆叠条——有颜色的部分是已用的七类（按类别占比分色），尾部是还没用上的余量，所以条本身就是占用率；再下面按统一图例列出系统提示词、用户消息、技能注入、工具结果、工具定义、注入内容、助手消息各自的占比与估算 token（输出不占窗口，故不列）。鼠标悬浮可读精确 token 数与占上下文比例；模型窗口未知时只写已用数。
@@ -56,7 +60,7 @@ DSH（DeepSeek Harness）Web 插件：**Token 用量统计看板** + **单会话
   - 两张卡都由会话明细轮询驱动（每 1.5 秒一次），不额外起计时器；旧宿主只提供其中一份数据时，另一张卡显示空态而非整组消失，两份都缺时整组不渲染。窄视口下自动上下堆叠。
 
 - 浅色页面两行统计卡：第一行请求数量（附失败数）、总 tokens（附精确值）、缓存命中率（附命中 token）、token 速度（附平均首 token）；第二行输入、输出、缓存读取、缓存写入四个 token 桶。不显示费用。
-- 子代理明细使用每个子代理的**真实名称**（取自子代理标签，缺失时回退到会话标题、工作目录或会话 id）。
+- 子代理明细与请求记录使用每个子代理的**真实名称**：优先子代理自身标签，再取最新非空会话标题；旧 CLI 记录缺少标题时，读取本次会话树中实际父会话的 `subagent/catalog` 任务标签，最后才回退到日志头名称、工作目录或会话 id。只使用各日志的自有事件，不把继承的父标题／目录当作自身名称，不改写历史日志，也不改变 Token 统计。若直接打开旧子会话、实际父会话不在本次读取树中，则保留原有回退名称。
 - 中部为等宽、等高的 **子代理明细** 与 **按模型明细**；窄视口自动堆叠。使用固定列布局而非横向滚动，长名称省略并可悬浮查看全名，token 数同样可悬浮查看精确值。按模型明细的名称使用模型选择器的**显示名称**（路由 id 保留在悬浮提示中，无法解析时回退为 id）；当多行显示名称相同（忽略大小写与分隔符）时，在名称下方用灰色小字标明各自供应商以便区分。
 - 请求记录按**轮**折叠（压缩调用归入独立分组），**默认全部折叠**；展开某一轮可查看该轮每一次请求的时间、模型、tokens、命中率、状态与入 / 出 / 读 / 写明细，支持单组展开和全部展开 / 收起。失败尝试、实际重试、压缩调用纳入统计；仅继承的父会话历史不重复计算。
 - 页面每 1.5 秒串行读取当前会话明细，切换或离开 tab 会取消请求和计时器。统计含本会话及所有后代的自有历史日志，缺失的首 token / 速度显示 `—`，读取错误保留上次成功结果。

package/lib/client.js

@@ -31531,7 +31531,8 @@ window.__ModuleLoader__.load({
 				self,
 				subagents: tree?.subagents ?? { ...ZERO },
 				total: tree === null ? self : combinedTotals(tree, self),
-				subagentSessions: tree?.subagentSessions ?? 0
+				subagentSessions: tree?.subagentSessions ?? 0,
+				...tree?.coverage ? { coverage: tree.coverage } : {}
 			};
 		}
 		function hasAnyTokens(totals) {
@@ -31901,9 +31902,11 @@ window.__ModuleLoader__.load({
 		}
 		function UsagePill({ usage, tree, t, dialog, dock }) {
 			const { open, setOpen, rootRef, panelRef, pos } = useStatDialog(dialog);
-			const billed = sessionUsageForDisplay(usage, tree?.tree ?? null).total;
+			const display = sessionUsageForDisplay(usage, tree?.tree ?? null);
+			const billed = display.total;
 			const total = billedTotal(billed);
-			const totalText = t("message.turnUsage.count", { count: formatTokensCompact(total) });
+			const incomplete = display.coverage?.complete === false;
+			const totalText = (incomplete ? "≥ " : "") + t("message.turnUsage.count", { count: formatTokensCompact(total) });
 			const cacheHit = cacheHitPercent(billed);
 			const cacheHitText = cacheHit !== null ? t("stats.cacheHit", { percent: cacheHit }) : null;
 			const exactCount = (value) => t("message.turnUsage.count", { count: formatTokens(value) });
@@ -31916,7 +31919,8 @@ window.__ModuleLoader__.load({
 					className: StatsLineEnhanced_module_default.pill,
 					"aria-haspopup": "dialog",
 					"aria-expanded": open,
-					"aria-label": cacheHitText === null ? totalText : totalText + " · " + cacheHitText,
+					"aria-label": (incomplete ? t("stats.partial") + " · " : "") + (cacheHitText === null ? totalText : totalText + " · " + cacheHitText),
+					title: incomplete ? t("stats.incomplete", { count: display.coverage.unreadableSessions.length }) : void 0,
 					onClick: () => {
 						setOpen(!open);
 					},
@@ -31943,13 +31947,18 @@ window.__ModuleLoader__.load({
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(DatabaseIcon, {}), t("stats.dialog.usageTitle")]
 							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: StatsLineEnhanced_module_default.dialogTitleValue,
-								children: exactCount(total)
+								children: (incomplete ? "≥ " : "") + exactCount(total)
 							})]
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 							className: StatsLineEnhanced_module_default.dialogTitleRule,
 							"aria-hidden": true
 						}),
+						incomplete && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							role: "status",
+							"data-session-usage-partial": true,
+							children: t("stats.incomplete", { count: display.coverage.unreadableSessions.length })
+						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("dl", {
 							className: StatsLineEnhanced_module_default.dialogDetails,
 							"data-session-stats-usage": true,
@@ -31982,7 +31991,8 @@ window.__ModuleLoader__.load({
 			const stats = (0, react.useMemo)(() => projected ?? deriveStats(settledNodes ?? []), [projected, settledNodes]);
 			const tokenScale = (0, react.useMemo)(() => measuredTokenScale(settledNodes ?? []) ?? 1, [settledNodes]);
 			const tree = useSessionUsage(sessionId, usageSignature(usage, stats.steps));
-			const hasTokens = hasAnyTokens(sessionUsageForDisplay(usage, tree.tree).total);
+			const display = sessionUsageForDisplay(usage, tree.tree);
+			const hasTokens = hasAnyTokens(display.total) || display.coverage?.complete === false;
 			if (stats.steps === 0 && !hasTokens) return null;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				ref: markDockContainer,
@@ -32048,7 +32058,8 @@ window.__ModuleLoader__.load({
 		const StatsUsageEntry = (0, react.memo)(function StatsUsageEntry({ useProjection, t, sessionId }) {
 			const usage = useProjection("tokenUsage");
 			const tree = useSessionUsage(sessionId, usageSignature(usage, usage === void 0 ? 0 : 1));
-			if (!hasAnyTokens(sessionUsageForDisplay(usage, tree.tree).total)) return null;
+			const display = sessionUsageForDisplay(usage, tree.tree);
+			if (!(hasAnyTokens(display.total) || display.coverage?.complete === false)) return null;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(UsagePill, {
 				usage,
 				tree,
@@ -32420,6 +32431,8 @@ window.__ModuleLoader__.load({
 			"stats.cacheMiss": "Cache miss",
 			"stats.dialog.title": "Time & speed",
 			"stats.dialog.usageTitle": "Token usage",
+			"stats.partial": "Partial usage",
+			"stats.incomplete": "{count} subagent session(s) could not be read; totals are incomplete.",
 			"stats.dialog.llmTime": "LLM time",
 			"stats.dialog.toolTime": "Tool time",
 			"stats.dialog.ttft": "Mean TTFT",
@@ -32508,6 +32521,8 @@ window.__ModuleLoader__.load({
 			"stats.cacheMiss": "未命中缓存",
 			"stats.dialog.title": "用时与速度",
 			"stats.dialog.usageTitle": "Token 用量",
+			"stats.partial": "部分用量",
+			"stats.incomplete": "有 {count} 个子会话暂不可读取，总计尚不完整。",
 			"stats.dialog.llmTime": "LLM 用时",
 			"stats.dialog.toolTime": "工具用时",
 			"stats.dialog.ttft": "首 token 平均",
@@ -32596,6 +32611,8 @@ window.__ModuleLoader__.load({
 			"stats.cacheMiss": "未命中快取",
 			"stats.dialog.title": "用時與速度",
 			"stats.dialog.usageTitle": "Token 用量",
+			"stats.partial": "部分用量",
+			"stats.incomplete": "有 {count} 個子會話暫不可讀取，總計尚不完整。",
 			"stats.dialog.llmTime": "LLM 用時",
 			"stats.dialog.toolTime": "工具用時",
 			"stats.dialog.ttft": "首 token 平均",
@@ -33844,6 +33861,15 @@ window.__ModuleLoader__.load({
 					className: SessionUsageView_module_default.scope,
 					children: t("scope")
 				}),
+				detail.coverage?.complete === false && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: SessionUsageView_module_default.error,
+					role: "status",
+					"data-session-usage-partial": true,
+					children: [t("partialCoverage", { count: String(detail.coverage.unreadableSessions.length) }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						title: detail.coverage.unreadableSessions.map((issue) => issue.sessionId).join("\n"),
+						children: t("partialTotals")
+					})]
+				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Metrics, {
 					detail,
 					t
@@ -33972,6 +33998,8 @@ window.__ModuleLoader__.load({
 			noModels: "暂无模型用量",
 			scope: "本会话及所有子代理 · 历史日志累计",
 			note: "统计包含本会话与全部后代的独立请求、重试和压缩调用，不重复计算继承历史。首 token 与速度仅使用已记录的时间信息，缺失时显示 —。",
+			partialCoverage: "有 {count} 个子会话暂不可读取。",
+			partialTotals: "当前仅显示已读取用量，未将缺失用量视为零。",
 			failedLoad: "用量读取失败，已保留上次结果。",
 			retry: "重新读取",
 			completed: "已完成",
@@ -34080,6 +34108,8 @@ window.__ModuleLoader__.load({
 			noModels: "No model usage yet",
 			scope: "This session and all subagents · Historical log totals",
 			note: "Includes independent requests, retries and compaction calls from this session and all descendants, without counting inherited history twice. Timing uses recorded timestamps only; missing values appear as —.",
+			partialCoverage: "{count} subagent session(s) could not be read.",
+			partialTotals: "Only readable usage is shown; missing usage is not treated as zero.",
 			failedLoad: "Could not read usage. The last successful result is preserved.",
 			retry: "Retry",
 			completed: "Completed",
@@ -34188,6 +34218,8 @@ window.__ModuleLoader__.load({
 			noModels: "暫無模型用量",
 			scope: "本會話及所有子代理 · 歷史日誌累計",
 			note: "統計包含本會話與全部後代的獨立請求、重試和壓縮呼叫，不重複計算繼承歷史。首 token 與速度僅使用已記錄的時間資訊，缺失時顯示 —。",
+			partialCoverage: "有 {count} 個子會話暫不可讀取。",
+			partialTotals: "目前僅顯示已讀取用量，未將缺失用量視為零。",
 			failedLoad: "用量讀取失敗，已保留上次結果。",
 			retry: "重新讀取",
 			completed: "已完成",