Skip to content

0.1.5 — 曲线统一 / 双指标同图 / 侧边栏今日明细

Choose a tag to compare

@HTempt HTempt released this 08 Nov 04:37
· 7 commits to main since this release

npm: dsh-token-board@0.1.5

dsh plugin --profile web add "dsh-token-board@0.1.5"

或下载下方 .tgz 离线安装。


新增

  • 侧边栏行的「今日 N 次」变成独立点击区,点它直接弹今日明细。 原来行尾的
    「6327万 · 171次」是一整段 CSS ::after 文本,整行只有「打开面板」一个动作;现在这段
    文字拆成两个紧邻的 span(6327万 · + 171次),外观完全不变,只是「171次」那一段
    单独可点:点它直接弹当日明细对话框(与日历弹出的同一个 DayDialog,按需从 day 路由
    读数据),点行内其他任何位置仍是打开使用统计面板。
    • 两段 span 拼接后与原来的字符串逐字相同(6327万 · 171次),颜色、字重、6px 间距
      全部沿用原规则;实测两版渲染宽度 161.47 / 161.48px、像素墨迹 905 / 905,逐像素一致。
      (::after 的空内容盒仍会吃掉 6px 外边距,因此挂上 span 后把间距变量归零。)
    • 点击与 Enter/Space 都阻止冒泡,所以对话框弹出时面板不会在背后切换。
    • 今日无数据(或首次读取未落地)时该段不渲染内容,点击无效——不会弹空对话框。
    • 数据每次刷新原地更新文字;shell 重建行后由 label 回调重新挂载。
    • 若标题节点拒绝子节点,自动退回原来的 ::after 单段文本(功能降级但不丢数字)。
    • 对话框渲染在 document.body 的独立 React 根里(面板关闭时页面树不存在),
      position:fixed; z-index:1500 覆盖全部 shell 层。

重构

  • 三张图的图例抽成一个共用组件。 趋势卡、时段页签、今日详情的小时卡各自长了一份
    逐字节相同的 legendItem 实现(按钮 + aria-pressed + data-active + 色条):
    同一个开关写三遍,改一处就得记得改另外两处,漏一处就出现"两个图例行为不一致"的怪现象。
    • 新增 MetricLegend(图例即开关)与 toggleSeries(统一的状态 reducer)、
      SERIES(系列名/颜色/文案的唯一来源)——三张卡现在只传入 visible 和 onToggle。
    • keys 参数负责"只列画了的系列":今日卡在无调用的那天只传 ["tokens"],
      不再需要调用方自己写 hasCalls ? item : null。
    • 状态仍由各卡自己持有(图例在卡片头、图在卡片体,一个所有者才不会互相打架)。
    • 实测三张卡状态机一致:单关任一曲线、双关(今日卡出现"都已隐藏"提示且保留基准线
      与 24 个命中带)、恢复,行为逐项相同。JS 里已无重复实现。

变更

  • 今日详情里的逐小时卡片改成双曲线,并补上峰值与合计。 原来是一排 24 根细竖条,
    只编码了 Token,调用次数只能靠 hover 一个个读;顶部没有峰值、没有合计,也没有
    纵轴参照,只能看出"形状"。现在与「时段」页签同一套语言:
    • Token 蓝线 + 调用紫线,各按本日自己的最大值缩放(两者单位不同,不共轴),
      曲线下保留蓝色渐变,底部有基准线。
    • 图例即开关(与趋势卡、时段页签同一个控件):点「Token 消耗」「调用次数」分别
      隐藏/显示对应曲线,关闭时转灰。隐藏不重缩放——轴上限由数据算,关掉一条时
      另一条逐字符不变(实测两条路径 d 完全相同)。
    • 峰值那一行同时报该小时的 Token 与调用次数(峰值 14:00 · 2.17万 · 9 次):
      按 Token 选出最忙的一小时,紧跟着把它的次数也写出来——读者看到峰值的第一反应
      就是"那这小时多少次",不该再去 hover 一次才拿到。两个数都描述这一小时,
      不是全天。当天没有任何调用时退回纯 Token 文案(峰值 14:00 · 2.17万)。
    • 峰值与两个图例挤在同一行(放不下时自动折行),绘图区压在 80px:
      整张卡片实测 148px(上一版 186px),只比旧柱状卡的约 122px 多出一行文字;
      弹窗仍无需滚动、无横向溢出。本日合计不在这张卡里重复——对话框顶部的摘要行
      已经写了「累计 … · 调用 … 次」,同一弹窗里印两遍只会让人去核对两者是否一致。
    • 两条都关时保留基准线、时刻刻度和 24 个命中带,中央显示「两条曲线都已隐藏…」。
    • 调用为 0 的那天不画紫线也不列紫图例——贴底的直线是噪声,列一个没画的系列是撒谎。
    • hover 从"整格高亮"变成游标 + 每条可见曲线的圆点 + tooltip 只报可见系列;
      命中带仍是 24 个整小时竖带,且首次支持键盘(可聚焦,aria-label 直接带该小时的
      Token 与次数)。
    • 刻度从每 6 小时改为每 3 小时(00/03/…/21)。
      实测:两条曲线 y 范围都严格等于数据范围(无过冲)、x 不回折、不超出绘图区;
      亮色 / 暗色 / 640px / 460px 窄屏均正常,460px 时头部折成两行且无溢出。
  • 时段图把 Token 和调用合并到一张图,图例分开控制。 原来是「按 Token / 按调用」
    二选一的切换开关,两条曲线不能同屏对比;现在与趋势卡同一套双轴语言:Token 蓝线在
    左轴、调用紫线在右轴,各按自己的最大值缩放(两个单位本就不同,不能假装共轴)。
    • 卡片头部的图例变成开关:点「Token 消耗」「调用次数」分别隐藏/显示对应曲线,
      关闭时图例转灰。隐藏不重缩放——轴上限始终由数据算,关掉一条时另一条不动。
    • 摘要栏随系列走:Token 最忙、调用最忙各占一项(都是 14:00),隐藏哪条就少一项。
    • hover 时两条可见曲线各出一个圆点,tooltip 只报可见系列。
    • 两条都关时保留基准线、时刻刻度和 24 个命中带,中央显示「两条曲线都已隐藏…」。
    • 明细表不再跟图例切换变序:固定按 Token 排序(看板的主指标),Token / 调用两列
      并排,共用一行。
  • 时段图的柱状图改成平滑曲线。 24 根柱子换成一条单调三次曲线(与趋势卡同一套
    smoothPathOf,保证不会过冲),点画在每个小时的中心而不是柱位边缘——00:00 的点
    不贴着 y 轴,23:00 的点不被右缘裁掉。曲线下面积保留同色渐变填充,底部补一条基准线
    (柱状图原本免费获得的地板)。hover 从"柱高亮"变成游标 + 线上圆点 + 完整 tooltip,
    命中区仍是完整的整小时竖带(24 个 band),键盘可达。
    实测:23 段贝塞尔、曲线 y 范围与数据点完全一致(14.00–174.00,无过冲)、x 不回折;
    峰值点(14:00)琥珀色圆点标记;亮暗主题、中英文、400px 窄屏均正常。
    同一轮顺带优化了时段页签的表格:按用量排序(最忙时段排第一)、空时段默认折叠
    (一键展开/收起)、补「日均」列、加表头行——原来 24 行按钟点铺开,前 8 行全是零。
  • 消耗趋势图改成平滑曲线。 原来两条线是折线(点与点之间直连),每天的起伏都是一段
    生硬的折角;现在用单调三次曲线(Fritsch–Carlson)连接相邻两天,线条连续。
    选单调而不是常见的 Catmull-Rom / 二次中点平滑,是因为后两者会过冲:单日尖峰会在
    峰顶再鼓出一个包,低谷会被画到零线以下——图上出现数据里没有的值。单调切线在局部极值
    处取水平切线,曲线始终夹在相邻两天的数值之间,既不超出峰值也不跌破谷值。
    实测 70 天数据:曲线 y 范围 47.66–213.92,数据点 y 范围 47.56–213.92,无过冲,
    曲线不回折(x 单调)。面积填充跟随同一条曲线,所以渐变底与描边严丝合缝。
    单点/两点/全零这些边界也验证过:单点画成点,两点是一条直连曲线,全零是一条水平线。
  • 顺带修掉趋势图的一处对齐偏差。 曲线点用的是左右对称内边距,而图表的左右留白
    并不相等(左 44、右 40,因为两侧各有一条数值轴),于是最后一个数据点比绘图区右边缘
    短 4px、零值日比底部基准线低 10px——hover 圆点和游标落在那里时对不上线。
    现在点、面积、游标、圆点共用同一组内边距,末点精确落在绘图区右边缘(680),
    零值日精确落在基准线(204)。
  • 趋势图的图例变成开关,可以单独隐藏/显示某条曲线。 卡片右上角的
    「Token 消耗」「调用次数」现在是两个按钮(原生 <button> + aria-pressed),
    点一下隐藏对应曲线,再点恢复;关闭时图例线条转灰、文字降到 tertiary,仍看得出是控件。
    隐藏是成套的:曲线、渐变面积、那一侧的纵轴刻度、hover 圆点、tooltip 里对应的一行
    一起消失,屏幕上不会留下一个还在报数字的隐藏系列。两条都关掉时图表外框(网格线、
    日期、70 个 hover 热区)保留,中间显示「两条曲线都已隐藏,点上面的图例可以重新显示」,
    避免卡片塌成空白。
    隐藏不改变缩放:纵轴上限始终由数据算,不随显示状态变,所以关掉一条时另一条
    不会跳动、不会在鼠标下重画。无障碍上仍报完整的一天:hover 热区的 aria-label
    始终含 Token 与调用两个数字,隐藏只是视觉偏好。

口径说明(时段统计)

  • 小时按浏览器本地时区切,与日历、趋势的日界线一致。DST 逐 bucket 解析:实测
    2026 年美国秋季回拨,60 个 UTC bucket 全部计数一次、无重复,重复的 01:00 只算
    1 个活跃日;春季跳变时被跳过的 02:00 正确为空。
  • 只统计带时间戳的会话记录。 插件自己的 statistics.json 里 history.days 按天
    归档、没有小时字段,那部分历史不计入时段图,也不按任何规则摊到 24 个钟点——
    摊出来的位置是编的。页签底部写明「本图覆盖窗口内 X% 的消耗(覆盖量 / 窗口总量)」,
    实测本机为 94%(146亿 / 155亿)。
  • renderHourOfDay 与 renderDays 对同一份数据算出的总额一致(实测 420 = 420),
    小时聚合没有漏记或重复计入。
  • 日均按「有记录天数」均分:某钟点用了 30 天、另一钟点只用了 2 天,总量不可比,
    日均才是「这是不是我最贵的时段」的答案。