dsh-tokenlens 1.6.7 → 1.7.1

package/CHANGELOG.md

@@ -4,6 +4,28 @@
 
 **版本记录约定**：同一发布日只保留一个章节，标题取当日**最后一个**已发布版本号；当日多次发布的改动合并到该章节，并在标题下注明当日实际发布过的版本号（npm 上仍可安装这些独立版本）。若当日已有发布，后续小改动不再单独增加版本号，而是并入下一篇日志。这样日志按天规整、不出现同日多个小版本。
 
+## 1.7.1 — 2026-11-06
+
+（当日已发布版本：v1.6.5 / v1.6.6 / v1.6.7 / v1.7.0 / v1.7.1）
+
+- **fix(ui): 未最大化窗口时芯片悬停导致整个对话区闪烁**——`Tooltip` 的气泡锚在芯片右缘，窗口变窄时会溢出 dock，撑出**对话区底部的横向滚动条**；滚动条又挤压布局、导致 hover 被反复触发，于是整片区域持续重绘。芯片改用**原生 `title`**：不产生任何 DOM，不可能影响布局。v1.7.0 只去掉原生 `title` 保留 Tooltip，方向反了——真正的成因是 Tooltip 本身
+- **feat(ui): TPS 趋势图由柱状改为曲线**——速率是连续量，折线比逐日立柱更易读。改为单条 `polyline` 曲线 + 淡色面积填充；每天一个透明命中列承载 `title`，鼠标移上去显示「日期 · 速率（输出 ÷ 耗时）」
+- fix(ui): **TPS 卡片宽度与「明细」卡片一致**（`flex: 1 1 100%`）——此前它没有 flex 规则，宽度收缩到内容宽
+- 测试：363 → 364（芯片不再包 Tooltip、标题为原生字符串、速度卡片满宽、曲线为 polyline+area 且不填充线体、透明命中列携带日期与速率）
+
+## 1.7.0 — 2026-11-06
+
+（当日已发布版本：v1.6.5 / v1.6.6 / v1.6.7 / v1.7.0）
+
+- **fix(ui): 弹窗改为 portal 到 `<body>`，恢复视口居中**——DSH 0.2.2-rc.1 里 `conversation.input.overlay` 槽位的祖先建立了包含块（transform / filter / contain），`position: fixed` 因此相对「对话区」解析，弹窗只能贴在对话区底部。改用 `react-dom` 的 `createPortal` 挂到 `document.body`，彻底脱离该祖先链。`react-dom` 缺失时（含 Node 测试环境）自动回退为原地渲染，绝不抛错
+- **fix(ui): 芯片悬停不再让整个对话区闪烁**（v1.7.1 进一步修正为改用原生 `title`）——v1.7.0 曾移除冗余的原生 `title` 并保留平台 `Tooltip`，但窄窗口下成因其实是 Tooltip 气泡溢出
+- **feat(ui): 新增「输出速度（TPS）」趋势图**，位于明细下方、独占整行——输出 Token ÷ 模型自身耗时（`step/start` → `assistant/message`）。工具调用发生在消息之后，因此等待时间不被计入；输出 Token 含思考 Token，弹窗提示已说明
+- feat(stats): Host 侧新增 `speed` 序列（顶层为全 Harness 合计，每个 provider 行另有自己的序列，跟随作用域切换）；按天聚合 `{day, outputTokens, seconds, tps, steps}`，无正耗时的日期直接跳过而不是给出无限速率。缓存 schema 升至 6，首次会重扫
+- **fix(stats): 「最近X天」封顶 30 天**——此前 provider 首次出现超过 30 天时会报「最近90天」，而同期所有其他数字与图表都只覆盖 30 天。现在 `effectiveDays` 封顶 30，且 `sinceEffective` 在超窗时改用 30 天桶，保证**标签与数字描述同一区间**；`daily` 序列尾部由 120 天收敛为 30 天
+- 测试：357 → 363（TPS 配对与未配对步骤跳过、零耗时日期跳过、provider 作用域序列、30 天封顶与标签/数据一致、弹窗 portal 与无 react-dom 回退、TPS 图表与空态）
+
+## 1.7.0 之前的同日版本见下方各节
+
 ## 1.6.7 — 2026-11-05
 
 （当日已发布版本：v1.6.5 / v1.6.6 / v1.6.7）

package/README.en.md

@@ -144,7 +144,7 @@ Host bridge route: `/api/tokenlens`; agent tool: `tokenlens_usage`.
 
 ## Development
 
-Node.js ≥ 24, zero runtime dependencies: `node --test` runs the 357 tests.
+Node.js ≥ 24, zero runtime dependencies: `node --test` runs the 364 tests.
 
 Release: `node scripts/bump-version.mjs <version> "<note>"` updates `package.json`, `PLUGIN_VERSION` and `CHANGELOG.md`; see [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md).
 

package/README.md

@@ -445,7 +445,7 @@ Host 半注册 `tokenlens_usage`，参数 `action`（默认 `snapshot`）与可
 
 ## 验证
 
-- `node --test`：**357 个自动化用例**，覆盖 Host 数据层、供应商适配器（含小米 MiMo 控制台 Cookie 适配器、Command Code 月度额度反推）、统计折叠、各 harness 读取、Design Plan 周期账本与额度计价、窗口锚点切片、工作区自动识别、插件集成与浏览器端渲染 / 交互。
+- `node --test`：**364 个自动化用例**，覆盖 Host 数据层、供应商适配器（含小米 MiMo 控制台 Cookie 适配器、Command Code 月度额度反推）、统计折叠、各 harness 读取、Design Plan 周期账本与额度计价、TPS 速度序列、窗口锚点切片、工作区自动识别、插件集成与浏览器端渲染 / 交互。
 - 在真实环境中验证过 **5 个 harness** 的数据源；本机统计与独立的 SQLite 查询、独立的日志解析逐项对账（差额为 0），跨 harness 合并与供应商映射算术自洽。
 - 供应商接口按各官方文档与参考客户端行为验证；未配置凭据时 chip 静默隐藏，接口异常时按可重试错误降级。
 

package/client.js

@@ -40,6 +40,19 @@ window.__ModuleLoader__.load({
     // words in the shell's module table, so they need no `dsh.client.external`.
     const primitives = require('@deepseek-ai/dsh-client-ui-primitives')
     const { Modal, Button, Tooltip, IconRefreshOutlineRegular } = primitives
+    // v1.7.0: the dialog is portalled to <body>. Rendering it inside the
+    // `conversation.input.overlay` slot stopped reaching the viewport in DSH
+    // 0.2.2-rc.1: an ancestor there establishes a containing block (transform /
+    // filter / contain), so `position: fixed` resolved against the conversation
+    // area and the dialog could only appear at its bottom. `createPortal` escapes
+    // that ancestor entirely. Tolerated as optional so a Host without react-dom
+    // (and the Node test harness) simply renders inline as before.
+    let ReactDOM = null
+    try {
+      ReactDOM = require('react-dom')
+    } catch {
+      ReactDOM = null
+    }
 
     const h = React.createElement
 
@@ -215,6 +228,12 @@ window.__ModuleLoader__.load({
       statsProviderFallback: '当前供应商（{provider}）没有本机记录，显示全部 Harness 合计',
       statsDshTotalLabel: 'DSH 合计',
       statsLast30Days: '最近30天',
+      statsSpeedTitle: '输出速度（TPS）',
+      statsSpeedHint: '输出 Token ÷ 模型自身耗时（step 开始到消息返回）；不含工具调用等待，但输出含思考 Token',
+      statsSpeedTotal: '均值 {tps} tok/s',
+      statsSpeedPeak: '峰值 {tps} tok/s',
+      statsSpeedEmpty: '暂无可计算的速度样本（需要 step 计时数据）',
+      statsSpeedBarTitle: '{date} · {tps} tok/s（{tokens} 输出 ÷ {seconds}s）',
       statsLast7Days: '最近7天',
       stats7DaysShort: '7天',
       statsDaysShort: '{n}天',
@@ -484,6 +503,13 @@ window.__ModuleLoader__.load({
       statsProviderFallback: 'No local records for the current provider ({provider}) — showing all-harness totals',
       statsDshTotalLabel: 'DSH total',
       statsLast30Days: 'Last 30 days',
+      statsSpeedTitle: 'Output speed (TPS)',
+      statsSpeedHint:
+        'Output tokens ÷ the model’s own request time (step start to message); tool waits excluded, reasoning tokens included',
+      statsSpeedTotal: 'avg {tps} tok/s',
+      statsSpeedPeak: 'peak {tps} tok/s',
+      statsSpeedEmpty: 'No speed samples yet (needs step timing data)',
+      statsSpeedBarTitle: '{date} · {tps} tok/s ({tokens} output ÷ {seconds}s)',
       statsLast7Days: 'Last 7 days',
       stats7DaysShort: '7d',
       statsDaysShort: '{n}d',
@@ -1523,6 +1549,8 @@ window.__ModuleLoader__.load({
         // v0.22.1: only subscription-backed providers use the 最近X天 window.
         subscribed: entry.subscribed === true,
         harnesses,
+        // v1.7.0: this provider's own output-speed series.
+        speed: normalizeSpeed(entry.speed),
       }
     }
 
@@ -1557,6 +1585,38 @@ window.__ModuleLoader__.load({
     }
 
     /** The whole stats payload, or null. Handles v1/v2 (DSH-ish) and v3 (provider-scoped). */
+    /**
+     * One output-speed (TPS) series (v1.7.0): `{byDay, total}` or null.
+     *
+     * `tps` is output tokens over the model's own request time, so a day whose
+     * `seconds` is not positive is dropped rather than shown as an infinite rate.
+     */
+    function normalizeSpeed(raw) {
+      if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) return null
+      const byDay = Array.isArray(raw.byDay)
+        ? raw.byDay
+            .filter((entry) => entry !== null && typeof entry === 'object' && typeof entry.day === 'string')
+            .map((entry) => ({
+              day: entry.day,
+              outputTokens: numberOrNull(entry.outputTokens) ?? 0,
+              seconds: numberOrNull(entry.seconds) ?? 0,
+              tps: numberOrNull(entry.tps),
+              steps: numberOrNull(entry.steps) ?? 0,
+            }))
+            .filter((entry) => entry.tps !== null && entry.tps >= 0)
+        : []
+      const totalRaw = raw.total !== null && typeof raw.total === 'object' ? raw.total : {}
+      return {
+        byDay,
+        total: {
+          outputTokens: numberOrNull(totalRaw.outputTokens) ?? 0,
+          seconds: numberOrNull(totalRaw.seconds) ?? 0,
+          tps: numberOrNull(totalRaw.tps),
+          steps: numberOrNull(totalRaw.steps) ?? 0,
+        },
+      }
+    }
+
     function normalizeStats(raw) {
       if (raw === null || typeof raw !== 'object') return null
       const version = Number.isFinite(raw.version) ? raw.version : 1
@@ -1684,6 +1744,8 @@ window.__ModuleLoader__.load({
         workspaces,
         // v0.24.0 daily series for the chart mode (may be empty on old Hosts).
         daily,
+        // v1.7.0: output-speed (TPS) series across every harness.
+        speed: normalizeSpeed(raw.speed),
         zcode,
       }
     }
@@ -3380,6 +3442,11 @@ window.__ModuleLoader__.load({
 .dsh-tokenlens-chart-layout-row>.dsh-tokenlens-capacity{flex:0.85 1 260px}
 .dsh-tokenlens-chart-layout-row>.dsh-tokenlens-stats{flex:1.25 1 330px;min-width:0}
 .dsh-tokenlens-chart-layout-row>.dsh-tokenlens-details{flex:1 1 100%;min-width:0}
+/* v1.7.1: the TPS trend is a full-width row, exactly like the details card. */
+.dsh-tokenlens-chart-layout-row>.dsh-tokenlens-section[data-speed-section]{flex:1 1 100%;min-width:0}
+.dsh-tokenlens-speed-svg{display:block;width:100%;height:96px;overflow:visible}
+.dsh-tokenlens-speed-axis{display:flex;justify-content:space-between;gap:6px;color:var(--dsw-alias-label-tertiary);font-size:10px;line-height:1.2;font-variant-numeric:tabular-nums;min-width:0}
+.dsh-tokenlens-speed-axis>span{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 @media (max-width:680px){.dsh-tokenlens-chart-layout-row>*{flex-basis:100%!important}}
 .dsh-tokenlens-details-charts{min-width:0}
 /* Data-mode 明细: three FULL-WIDTH blocks stacked vertically (v0.30.0 layout). */
@@ -3863,26 +3930,28 @@ window.__ModuleLoader__.load({
       const snapshot = normalizeSnapshot(state.snapshot)
       const brand = providerBrand(state, snapshot)
       const tooltip = chipTooltip(snapshot, state.providerId, t)
+      // v1.7.1: a NATIVE title, not the platform Tooltip. On an unmaximized
+      // window the Tooltip's bubble rendered at the chip's right edge, overflowed
+      // the dock and produced a horizontal scrollbar on the conversation area;
+      // that scrollbar shifted the layout, which re-triggered the hover and
+      // flickered the whole area. A native title draws nothing in the DOM, so it
+      // cannot affect layout at all. The text is unchanged.
       return h(
         'span',
         { className: 'dsh-tokenlens-anchor', 'data-composer-stat': 'tokenlens' },
         h(
-          Tooltip,
-          { label: tooltip, side: 'top' },
-          h(
-            'button',
-            {
-              type: 'button',
-              className: 'dsh-tokenlens-chip',
-              title: t('chipHint'),
-              'aria-label': t('chipHint'),
-              'aria-haspopup': 'dialog',
-              onClick: () => openDialog(sessionId),
-            },
-            h('span', { className: 'dsh-tokenlens-dot', 'data-level': chipLevel(snapshot, state), 'aria-hidden': true }),
-            h('span', { className: 'dsh-tokenlens-brand' }, brand),
-            chipPieces(snapshot, state.providerId, t),
-          ),
+          'button',
+          {
+            type: 'button',
+            className: 'dsh-tokenlens-chip',
+            title: tooltip,
+            'aria-label': t('chipHint'),
+            'aria-haspopup': 'dialog',
+            onClick: () => openDialog(sessionId),
+          },
+          h('span', { className: 'dsh-tokenlens-dot', 'data-level': chipLevel(snapshot, state), 'aria-hidden': true }),
+          h('span', { className: 'dsh-tokenlens-brand' }, brand),
+          chipPieces(snapshot, state.providerId, t),
         ),
       )
     }
@@ -3902,24 +3971,23 @@ window.__ModuleLoader__.load({
         'span',
         { className: 'dsh-tokenlens-anchor', 'data-composer-stat': 'tokenlens' },
         h(
-          Tooltip,
-          { label, side: 'top' },
-          h(
-            'button',
-            {
-              type: 'button',
-              className: 'dsh-tokenlens-chip',
-              title: label,
-              'aria-label': label,
-              'aria-haspopup': 'dialog',
-              ...(needsConfig ? { 'data-needs-config': 'true' } : {}),
-              ...(statsOnly ? { 'data-stats-only': 'true' } : {}),
-              onClick: () => openDialog(sessionId),
-            },
-            h('span', { className: 'dsh-tokenlens-dot', 'data-level': statsOnly ? 'normal' : 'warning', 'aria-hidden': true }),
-            h('span', { className: 'dsh-tokenlens-brand' }, brand),
-            h('span', { className: 'dsh-tokenlens-metric' }, label),
-          ),
+          'button',
+          {
+            type: 'button',
+            className: 'dsh-tokenlens-chip',
+            // v1.7.1: native title, for the same reason as the normal chip — a
+            // Tooltip bubble here could overflow a narrow dock and add a
+            // horizontal scrollbar that made the conversation area flicker.
+            title: label,
+            'aria-label': label,
+            'aria-haspopup': 'dialog',
+            ...(needsConfig ? { 'data-needs-config': 'true' } : {}),
+            ...(statsOnly ? { 'data-stats-only': 'true' } : {}),
+            onClick: () => openDialog(sessionId),
+          },
+          h('span', { className: 'dsh-tokenlens-dot', 'data-level': statsOnly ? 'normal' : 'warning', 'aria-hidden': true }),
+          h('span', { className: 'dsh-tokenlens-brand' }, brand),
+          h('span', { className: 'dsh-tokenlens-metric' }, label),
         ),
       )
     }
@@ -4976,6 +5044,30 @@ window.__ModuleLoader__.load({
       store.set({ showDetails: store.get().showDetails !== true })
     }
 
+    /**
+     * Detach `node` from the slot's ancestor chain by rendering it into <body>
+     * (v1.7.0).
+     *
+     * The `conversation.input.overlay` slot lives inside the conversation area,
+     * and in DSH 0.2.2-rc.1 an ancestor there establishes a containing block, so
+     * the overlay's `position: fixed` resolved against that ancestor and the
+     * dialog could only appear at the bottom of the conversation. Portalling
+     * detaches it so it centres on the viewport. Returns the node unchanged when
+     * react-dom or a DOM is unavailable (the Node test harness), so the rendered
+     * tree keeps its shape there.
+     */
+    function portalize(node) {
+      const canPortal =
+        ReactDOM !== null &&
+        typeof ReactDOM.createPortal === 'function' &&
+        typeof document !== 'undefined' &&
+        document !== null &&
+        document.body !== undefined &&
+        document.body !== null
+      if (!canPortal) return node
+      return ReactDOM.createPortal(node, document.body)
+    }
+
     /**
      * The dialog shell: a fixed overlay with an explicitly sized panel.
      *
@@ -5007,15 +5099,18 @@ window.__ModuleLoader__.load({
           /* closing must never throw */
         }
       }
-      return h(
-        'div',
-        {
-          className: 'dsh-tokenlens-overlay',
-          role: 'presentation',
-          onMouseDown: (event) => {
-            if (event.target === event.currentTarget) close()
+      // v1.7.0: portal to <body> so the overlay centres on the viewport instead
+      // of resolving `position: fixed` against the conversation area.
+      return portalize(
+        h(
+          'div',
+          {
+            className: 'dsh-tokenlens-overlay',
+            role: 'presentation',
+            onMouseDown: (event) => {
+              if (event.target === event.currentTarget) close()
+            },
           },
-        },
         h(
           'div',
           {
@@ -5042,6 +5137,7 @@ window.__ModuleLoader__.load({
           h('div', { className: 'dsh-tokenlens-modal-body' }, children),
           footer === undefined || footer === null ? null : h('div', { className: 'dsh-tokenlens-modal-foot' }, footer),
         ),
+        ),
       )
     }
 
@@ -5959,6 +6055,136 @@ window.__ModuleLoader__.load({
       )
     }
 
+    /**
+     * The output-speed (TPS) trend card (v1.7.0), shown under 明细.
+     *
+     * `tps` is output tokens over the model's OWN request time (`step/start` to
+     * `assistant/message`), so the step's tool calls do not dilute it — but
+     * reasoning tokens are included in "output", which the hint says.
+     */
+    function buildSpeedSection(state, ctx, t) {
+      const stats = ctx.stats
+      const scoped = ctx.providerScoped ? ctx.currentRow?.speed ?? null : stats?.speed ?? null
+      const series = scoped === null || scoped === undefined ? null : scoped
+      const byDay = series === null ? [] : series.byDay
+      const head = h(
+        'div',
+        { key: 'head', className: 'dsh-tokenlens-section-head' },
+        h(
+          'span',
+          { className: 'dsh-tokenlens-section-title' },
+          Icon('chart', 14),
+          t('statsSpeedTitle'),
+        ),
+        series !== null && series.total.tps !== null
+          ? h(
+              'span',
+              { className: 'dsh-tokenlens-hint', 'data-speed-total': String(series.total.tps) },
+              t('statsSpeedTotal', { tps: series.total.tps.toFixed(1) }),
+            )
+          : null,
+      )
+      const body =
+        byDay.length === 0
+          ? h(
+              'div',
+              { key: 'empty', className: 'dsh-tokenlens-chart-empty', 'data-speed-empty': 'true' },
+              h('span', { key: 'hint', className: 'dsh-tokenlens-hint' }, t('statsSpeedEmpty')),
+            )
+          : (() => {
+              // v1.7.1: a CURVE, not bars — the trend is a rate, and a line reads
+              // it far better than per-day columns. The SVG scales to the card
+              // width; `preserveAspectRatio="none"` lets it fill without keeping
+              // the viewBox ratio, and the per-day hover targets are transparent
+              // columns so nothing is distorted.
+              const width = 320
+              const height = 90
+              const pad = 4
+              const max = Math.max(...byDay.map((entry) => entry.tps ?? 0), 1)
+              const stepX = byDay.length > 1 ? (width - pad * 2) / (byDay.length - 1) : 0
+              const points = byDay.map((entry, index) => {
+                const x = byDay.length > 1 ? pad + stepX * index : width / 2
+                const y = height - pad - ((entry.tps ?? 0) / max) * (height - pad * 2)
+                return { x, y }
+              })
+              const line = points.map((point) => `${point.x.toFixed(1)},${point.y.toFixed(1)}`).join(' ')
+              const area = `${pad.toFixed(1)},${(height - pad).toFixed(1)} ${line} ${(width - pad).toFixed(1)},${(height - pad).toFixed(1)}`
+              const columnWidth = byDay.length > 1 ? stepX : width - pad * 2
+              const columns = byDay.map((entry, index) =>
+                h(
+                  'rect',
+                  {
+                    key: `hit-${entry.day}-${index}`,
+                    x: (points[index].x - columnWidth / 2).toFixed(1),
+                    y: 0,
+                    width: Math.max(1, columnWidth).toFixed(1),
+                    height: String(height),
+                    fill: 'transparent',
+                    'data-speed-day': entry.day,
+                    'data-speed-tps': String(entry.tps ?? 0),
+                  },
+                  h(
+                    'title',
+                    { key: 'tip' },
+                    t('statsSpeedBarTitle', {
+                      date: entry.day,
+                      tps: (entry.tps ?? 0).toFixed(1),
+                      tokens: formatTokensPrecise(entry.outputTokens),
+                      seconds: entry.seconds.toFixed(1),
+                    }),
+                  ),
+                ),
+              )
+              const svg = h(
+                'svg',
+                {
+                  key: 'svg',
+                  className: 'dsh-tokenlens-speed-svg',
+                  'data-speed-plot': 'true',
+                  viewBox: `0 0 ${width} ${height}`,
+                  preserveAspectRatio: 'none',
+                  role: 'img',
+                  'aria-label': t('statsSpeedTitle'),
+                },
+                h('polygon', {
+                  key: 'area',
+                  className: 'dsh-tokenlens-speed-area',
+                  points: area,
+                  fill: 'rgba(46,158,91,.18)',
+                  'aria-hidden': 'true',
+                }),
+                h('polyline', {
+                  key: 'line',
+                  className: 'dsh-tokenlens-speed-line',
+                  points: line,
+                  fill: 'none',
+                  stroke: '#2e9e5b',
+                  'stroke-width': '1.6',
+                  'stroke-linecap': 'round',
+                  'stroke-linejoin': 'round',
+                  'vector-effect': 'non-scaling-stroke',
+                  'aria-hidden': 'true',
+                }),
+                columns,
+              )
+              const axis = h(
+                'div',
+                { key: 'axis', className: 'dsh-tokenlens-speed-axis', 'aria-hidden': 'true' },
+                h('span', { key: 'first' }, byDay[0].day),
+                byDay.length > 1 ? h('span', { key: 'peak' }, t('statsSpeedPeak', { tps: max.toFixed(1) })) : null,
+                byDay.length > 1 ? h('span', { key: 'last' }, byDay[byDay.length - 1].day) : null,
+              )
+              return h('div', { key: 'plot', className: 'dsh-tokenlens-speed-plot' }, svg, axis)
+            })()
+      return h(
+        'div',
+        { key: 'speed', className: 'dsh-tokenlens-section', 'data-speed-section': 'true' },
+        head,
+        h('div', { key: 'hint', className: 'dsh-tokenlens-subtitle' }, t('statsSpeedHint')),
+        body,
+      )
+    }
+
     function buildStatsDetails(state, ctx, t) {
       const { stats, hasMonth } = ctx
       if (stats === null) return null
@@ -7422,6 +7648,12 @@ window.__ModuleLoader__.load({
           { key: 'row-details', className: 'dsh-tokenlens-chart-layout-row' },
           buildStatsDetails(state, statsCtx, t),
         ),
+        // v1.7.0: the output-speed trend sits under 明细, as its own full-width row.
+        h(
+          'div',
+          { key: 'row-speed', className: 'dsh-tokenlens-chart-layout-row' },
+          buildSpeedSection(state, statsCtx, t),
+        ),
       )
       const body = [buildManageButton(state, t), statsArea]
       const displayVersion = currentPluginVersionOf(state)

package/index.js

@@ -84,7 +84,7 @@ export const inject = []
 export const PLUGIN_NAME = 'dsh-tokenlens'
 
 /** Plugin version; mirrors package.json (kept here so diagnostics need no fs read). */
-export const PLUGIN_VERSION = '1.6.7'
+export const PLUGIN_VERSION = '1.7.1'
 
 /** Documented defaults; every field of the raw row config is optional. */
 const DEFAULTS = {

package/lib/usage-stats.mjs

@@ -61,7 +61,17 @@ const DECODES_CONCATENATED_FRAMES = (() => {
 const SESSION_FILE = 'session.v4.jsonl.zstd'
 
 /** Cache schema version; a mismatch discards the cache. */
-const CACHE_VERSION = 5
+const CACHE_VERSION = 6
+
+/**
+ * How many days the daily series (and therefore the 图表 mode and the
+ * 最近X天 provider window) may cover (v1.7.0).
+ *
+ * The wire used to carry 120 days, so a provider first seen months ago reported
+ * 最近90天 while every other figure and the charts described 30. One span now
+ * governs all of them.
+ */
+export const DAILY_SERIES_DAYS = 30
 
 /** What the numbers are, by provider id (display fallback; config can override). */
 const PROVIDER_LABELS = {
@@ -235,6 +245,11 @@ export function foldSession(records) {
   const models = Object.create(null)
   const hours = Object.create(null)
   const workspaces = Object.create(null)
+  // v1.7.0: output-speed (TPS) samples. A step's model time is
+  // `assistant/message.time − step/start.time`: the step's tool calls are emitted
+  // AFTER the message, so they do not dilute it.
+  const speed = Object.create(null)
+  const stepStarts = new Map()
   let latestTime = 0
   let sessionCwd = null
   const session = { seeded: false, subagent: false, createdAt: null, id: null, inheritedEvents: 0 }
@@ -267,6 +282,17 @@ export function foldSession(records) {
       continue
     }
     if (boundarySeq !== null && Number.isSafeInteger(record.seq) && record.seq <= boundarySeq) continue
+    // v1.7.0: remember when each step's model request started, so the matching
+    // `assistant/message` can be turned into a duration.
+    if (record.type === 'step/start') {
+      const turn = record.data?.turn
+      const step = record.data?.step
+      const startedAt = typeof record.time === 'number' && Number.isFinite(record.time) ? record.time : null
+      if (startedAt !== null && Number.isSafeInteger(turn) && Number.isSafeInteger(step)) {
+        stepStarts.set(`${turn}:${step}`, startedAt)
+      }
+      continue
+    }
     const usage = usageOf(record)
     if (usage === null) continue
     const time = typeof record.time === 'number' && Number.isFinite(record.time) ? record.time : null
@@ -301,6 +327,23 @@ export function foldSession(records) {
     const dayProvider = (dayBucket.providers[attributedProvider] ??= emptyBucket())
     addBucket(dayProvider, usage)
     addBucket((providers[attributedProvider] ??= emptyBucket()), usage)
+    // v1.7.0: one speed sample per completed step.
+    if (record.type === 'assistant/message' && usage.output > 0) {
+      const turn = record.data?.turn
+      const step = record.data?.step
+      const startedAt = Number.isSafeInteger(turn) && Number.isSafeInteger(step)
+        ? stepStarts.get(`${turn}:${step}`)
+        : undefined
+      const elapsedMs = startedAt === undefined ? null : time - startedAt
+      if (elapsedMs !== null && elapsedMs > 0) {
+        const daySpeed = (speed[day] ??= { providers: Object.create(null) })
+        const slot = (daySpeed.providers[attributedProvider] ??= { output: 0, seconds: 0, steps: 0 })
+        slot.output += usage.output
+        slot.seconds += elapsedMs / 1000
+        slot.steps += 1
+        stepStarts.delete(`${turn}:${step}`)
+      }
+    }
     const modelKey = `${attributedProvider}/${attributedModel}`
     const modelBucket = (models[modelKey] ??= {
       provider: attributedProvider,
@@ -318,7 +361,7 @@ export function foldSession(records) {
       if (Number(key) < cutoff) delete hours[key]
     }
   }
-  return { days, providers, models, hours, workspaces, session }
+  return { days, providers, models, hours, workspaces, session, speed }
 }
 
 /** Merge one file's folded contribution into an aggregate being built. */
@@ -329,6 +372,16 @@ function mergeFold(aggregate, fold) {
       addBucket((target.providers[provider] ??= emptyBucket()), bucket)
     }
   }
+  // v1.7.0: merge the speed samples the same way as the token buckets.
+  for (const [day, daySpeed] of Object.entries(fold.speed ?? {})) {
+    const target = (aggregate.speed[day] ??= { providers: Object.create(null) })
+    for (const [provider, slot] of Object.entries(daySpeed.providers ?? {})) {
+      const into = (target.providers[provider] ??= { output: 0, seconds: 0, steps: 0 })
+      into.output += slot.output
+      into.seconds += slot.seconds
+      into.steps += slot.steps
+    }
+  }
   for (const [provider, bucket] of Object.entries(fold.providers ?? {})) {
     addBucket((aggregate.providers[provider] ??= emptyBucket()), bucket)
   }
@@ -507,7 +560,18 @@ export function createUsageStats(input) {
     const modelsAggregate = Object.create(null)
     const hoursAggregate = Object.create(null)
     const workspacesAggregate = Object.create(null)
+    // v1.7.0: `speedAggregate[day].providers[providerId] = {output, seconds, steps}`
+    const speedAggregate = Object.create(null)
     for (const entry of Object.values(cache.files)) {
+      for (const [day, daySpeed] of Object.entries(entry.speed ?? {})) {
+        const target = (speedAggregate[day] ??= { providers: Object.create(null) })
+        for (const [provider, slot] of Object.entries(daySpeed.providers ?? {})) {
+          const into = (target.providers[provider] ??= { output: 0, seconds: 0, steps: 0 })
+          into.output += typeof slot.output === 'number' ? slot.output : 0
+          into.seconds += typeof slot.seconds === 'number' ? slot.seconds : 0
+          into.steps += typeof slot.steps === 'number' ? slot.steps : 0
+        }
+      }
       for (const [day, dayBucket] of Object.entries(entry.days ?? {})) {
         const target = (daysAggregate[day] ??= { providers: Object.create(null) })
         for (const [provider, bucket] of Object.entries(dayBucket.providers ?? {})) {
@@ -725,6 +789,8 @@ export function createUsageStats(input) {
       providers,
       models: models.slice(0, 12),
       daily,
+      // v1.7.0: raw per-day output-speed samples for the wire builder below.
+      speed: speedAggregate,
       scan,
     }
   }
@@ -789,6 +855,8 @@ export function createUsageStats(input) {
         models: fold.models,
         hours: fold.hours,
         workspaces: fold.workspaces,
+        // v1.7.0: per-day output-speed samples (CACHE_VERSION 6).
+        speed: fold.speed,
       }
       nextFiles[path] = entry
       scanned += 1
@@ -1259,7 +1327,10 @@ export function createUsageStats(input) {
     }
     const daily = [...dailyMap.entries()]
       .sort(([left], [right]) => left.localeCompare(right))
-      .slice(-120)
+      // v1.7.0: 30 days, matching the 最近30天 bucket and the 最近X天 label. The
+      // series used to carry 120 days, so the 图表 mode could plot a wider window
+      // than the 数据 mode described.
+      .slice(-DAILY_SERIES_DAYS)
       .map(([day, entry]) => {
         const providers = Object.create(null)
         for (const [providerId, slot] of entry.providers) {
@@ -1292,15 +1363,77 @@ export function createUsageStats(input) {
       return Math.max(1, Math.round((end - start) / dayMs) + 1)
     }
     const providers = [...providerMap.values()].sort((a, b) => b.allTime.total - a.allTime.total)
+    /**
+     * Build one output-speed series (v1.7.0).
+     *
+     * `tps` is output tokens over the summed model time of the steps that
+     * produced them, so it describes generation speed rather than wall clock:
+     * the tool calls of a step are emitted after its `assistant/message` and are
+     * therefore excluded. A day with no positive duration is dropped instead of
+     * being given an infinite rate.
+     */
+    const speedSeries = (providerId) => {
+      const source = dsh.speed ?? {}
+      const byDay = []
+      let output = 0
+      let seconds = 0
+      let steps = 0
+      for (const day of Object.keys(source).sort()) {
+        if (day < thirtyStart) continue
+        let dayOutput = 0
+        let daySeconds = 0
+        let daySteps = 0
+        for (const [id, slot] of Object.entries(source[day].providers ?? {})) {
+          if (providerId !== null && id !== providerId) continue
+          dayOutput += slot.output
+          daySeconds += slot.seconds
+          daySteps += slot.steps
+        }
+        if (daySeconds <= 0 || dayOutput <= 0) continue
+        byDay.push({
+          day,
+          outputTokens: dayOutput,
+          seconds: Math.round(daySeconds * 10) / 10,
+          tps: Math.round((dayOutput / daySeconds) * 10) / 10,
+          steps: daySteps,
+        })
+        output += dayOutput
+        seconds += daySeconds
+        steps += daySteps
+      }
+      return {
+        byDay,
+        total: {
+          outputTokens: output,
+          seconds: Math.round(seconds * 10) / 10,
+          tps: seconds > 0 ? Math.round((output / seconds) * 10) / 10 : null,
+          steps,
+        },
+      }
+    }
     for (const provider of providers) {
       const effectiveDay = firstDays.get(provider.providerId) ?? todayDay
       provider.effectiveDay = effectiveDay
-      provider.effectiveDays = dayCount(effectiveDay, todayDay)
-      // A provider has no records before its effective day, so the all-time
-      // bucket is exactly the since-effective window.
-      provider.sinceEffective = cloneBucket(provider.allTime)
+      // v1.7.0: the 最近X天 window is capped at the same 30 days the charts and
+      // the 最近30天 bucket use. A provider first seen 90 days ago used to report
+      // 最近90天 while every other figure on the page covered 30.
+      const fullDays = dayCount(effectiveDay, todayDay)
+      const cappedDays = Math.min(DAILY_SERIES_DAYS, fullDays)
+      provider.effectiveDays = cappedDays
+      // The label and the numbers must describe the SAME span. When the real
+      // history is longer than the cap, the since-effective bucket is therefore
+      // the 30-day one rather than all-time (which would carry older records
+      // under a 最近30天 label).
+      provider.sinceEffective =
+        cappedDays < fullDays ? cloneBucket(provider.last30Days) : cloneBucket(provider.allTime)
+      // v1.7.0: each provider row carries its own output-speed series so the
+      // chart can follow the same scope switch as the token sections.
+      provider.speed = speedSeries(provider.providerId)
       for (const harness of Object.values(provider.harnesses ?? {})) {
-        harness.sinceEffective = cloneBucket(harness.allTime)
+        harness.sinceEffective =
+          cappedDays < fullDays && harness.last30Days !== undefined
+            ? cloneBucket(harness.last30Days)
+            : cloneBucket(harness.allTime)
       }
     }
     return {
@@ -1315,6 +1448,8 @@ export function createUsageStats(input) {
       allTime,
       workspaces,
       providers,
+      // v1.7.0: output-speed (TPS) series across every harness.
+      speed: speedSeries(null),
       harnesses,
       models: dsh.models,
       daily,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-tokenlens",
-  "version": "1.6.7",
+  "version": "1.7.1",
   "type": "module",
   "description": "dsh-TokenLens (词元透镜) — provider-aware plan capacity plus local token statistics (today/7d/30d/all-time, by harness/provider/model/workspace) for DSH.",
   "license": "MIT",