Skip to content

Commit 65298e3

Browse files
committed
feat: switch live session timing trend metrics
1 parent 8b18572 commit 65298e3

5 files changed

Lines changed: 375 additions & 201 deletions

File tree

docs-linhay/dev/20260523-session-distillation-codex-live-sessions-ui.md

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -84,12 +84,25 @@ Live sessions 的 detail 面板和筛选区本质上是工作台容器,不是
8484
3. 历史请求即使因为 cache 或 sidecar 残留仍带着 `streaming/reconnecting` 且没有 `completedAt`,也不能继续按 `nowMs` 投影;否则图上所有总耗时点会一起增长。
8585
4. 图表只展示固定最近窗口内的请求点,默认窗口为 5 分钟;窗口外请求既不参与曲线,也不参与 y 轴最大值。
8686
5. x 轴域固定为 `latestStartedAt - windowMs``latestStartedAt`,不能再用当前样本 min/max 自动撑满,否则稀疏请求会被视觉上拉成等距。
87-
6. 图表视口默认跟随最新 request sample;只有新的 request timestamp 进入时才推进到右侧最新点,普通 `nowMs` 刷新不能让 x 视口自己前进。
88-
7. 用户横向滚动或拖动图表查看历史后,自动跟随必须暂停;用户回到最右侧后再恢复跟随最新点。
89-
8. 回归测试必须覆盖“stale streaming request + active request”并存时,只有 active request 增长,并覆盖窗口外旧请求被过滤;组件结构测试需覆盖 latest-follow / user-pan pause 边界。
87+
6. 图表类型按 `heartbeat strip chart / rolling strip chart` 处理:最新 request 锚在右侧,时间密度稳定;宽容器能回看更长最近窗口,窄容器只显示更近样本,不提供横向滚动或拖动。
88+
7. 回归测试必须覆盖“stale streaming request + active request”并存时,只有 active request 增长,并覆盖窗口外旧请求被过滤;组件结构测试需覆盖非滚动 fixed viewport 边界。
9089

9190
这类问题不要先调 CSS 或动画。先检查纯模型输出:`points[].values.totalDurationMs``points[].isLive` 是否已经错误增长;如果模型输出错,修模型,不修图表。
9291

92+
### 8. 请求耗时趋势图更像 ECG,不像平滑面积图
93+
94+
最新的视觉反馈说明这块图如果画得太“顺”,会更像普通仪表盘趋势图,而不是 live sessions 里应该有的监护波形。现在更稳的表达是:
95+
96+
1. 继续保留 timestamp 驱动的 x 轴和 metric 驱动的 y 轴,不改数据语义。
97+
2. 图表一次只显示一个 timing metric,对应一条更尖锐的心电波形;不要把多个维度同时叠在图里一起动。
98+
3. 下方“耗时”指标块负责维度切换,`总耗时 / TTFT / 首 token / 流式 / 排队 / 选号 / 连接 / 平均间隔 / 最大间隔` 都可以切换图表。
99+
4. 仍然保留 live request 的光圈标记,让正在增长的样本一眼可见。
100+
5. TTFT / first-token 等次级指标切换后也保持同一套 ECG 波形语言,不再回到虚线趋势图或多线叠加。
101+
102+
### 9. 请求时间线只展示最近 15 条
103+
104+
`请求时间线` 是 detail 面板的扫描区,不是完整历史列表。完整历史仍由 detail/history 数据承载,但页面内只显示排序后的最近 15 条 request,标题行数也以实际展示数量为准,避免 live session 长时间运行后面板无限变长。
105+
93106
## 不纳入
94107

95108
- 不新增独立 `gettokens-codex-live-sessions` skill;当前规则继续归入 `gettokens-domain-engineering` 的 Codex Live Sessions 小节。

0 commit comments

Comments
 (0)