Files
AgentLab/frontend/src/run/useRunClock.ts
T
ThearchyHelios e10c4f23fc 界面与交互全面翻修(前两波):运行态有了 HUD 和时间轴,终态会收尾,全站令牌、组件、文案统一
来自 2026-09 的 UI/UX 审查(142 条)。本提交是前两波,第三波(记录页接入时间轴、跨页互链、check-ui 更新、全站扫尾)另行提交。

地基
- 设计令牌:全局规则和 .btn/.field/.chip 放进 CSS 层,Tailwind 工具类重新生效,选中态、开启态不再被吞掉;字号阶梯;
  辅助文字在所有底色上 >= 4.5:1;状态色专用,节点类型色与之拉开色相;「跟随系统」真的跟随,首帧不闪深色;新字标与 favicon
- 基础组件:confirmDialog / promptDialog 取代原生对话框;toast 出错不自动消失、可复制、读屏可播报;离线横幅与断线恢复;
  九种剪影的状态徽标;唯一一份状态文案(lib/status)、格式化(lib/format)、术语(lib/terms)、报错人话(lib/errors)
- 运行态内核:事件折成航迹(run/trace.ts),可投影到任意时刻;取消 / 失败 / 服务重启后统一收尾,不再永远转圈;
  run.status 随事件回写;token 事件不再堆进 events
- 后端:协作成员逐个完成即发事件,调度者决策有事件;时长分执行 / 墙钟 / 等人;API 时间带时区;
  中断的运行也发 stream.end;运行列表可筛选翻页;删除运行 / 工作流有保护;运行默认值接通;可测未保存的配置;
  报错说清发生了什么、为什么、怎么办

功能
- 画布:状态四重编码、固定高度遥测槽、按缩放三档、运行胶囊与 HUD、航迹时间轴与回放、执行轨迹边、
  等待闸门、跟随执行、正式运行只读、一次性时刻(开场点亮、回扫、阻断级联、出具印章)
- 编辑:撤销重做、版本历史、问题面板可定位、三栏可收起、模板与表达式字段区分、变量血缘、快捷键、带搜索的选择器
- 回答流 / 问数据:贴底才跟随滚动、工件下钻、出具横幅列出缺口、答案可复制导出、按会话的忙闲、
  答案不再在 2000 字处截断、重启后这一轮会收尾
- 记录页:待审批 / 运行中 / 失败页签、筛选翻页、实时接流、排错路径指到节点、封存凭证常驻
- 管理页:新的「数据」页、写操作失败都有反馈、弹窗里先测连接、统一持久的连接状态
- 外壳:导航改版、⌘K 命令面板、? 快捷键帮助、404、页面标题与 favicon 状态点、后台提醒

验证(沙箱):tsc 干净,pytest 579 passed,14 个检查脚本中 13 个全绿;check-ui 剩 1 项旧断言(按旧日期格式找运行行),第三波更新。
2026-09-26 23:11:31 +08:00

79 lines
2.6 KiB
TypeScript

import { useEffect, useReducer } from 'react'
/**
* 运行计时用的时钟。全站只有一个 interval,所有在跑的计时器共用同一拍。
*
* 各自 setInterval 的话,胶囊、卡片、时间轴三处的秒数会差出几十毫秒,同一次
* 运行在屏幕上显示三个不同的"已用时间";而且卡片一多就是几十个定时器。
*
* 节拍:有人在看运行中的计时时 100ms 一次(mm:ss.s 的最后一位要走起来);
* 系统关了动效、或页面不可见时退到 1s 一次;没有订阅者就停掉。页面重新可见
* 时立刻补一拍,不让人看到一个停在几分钟前的数字。
*/
type Listener = () => void
const listeners = new Set<Listener>()
let now = Date.now()
let timer: ReturnType<typeof setInterval> | null = null
let period = 0
let watching = false
const reduceMotion = (): boolean =>
typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches
const hidden = (): boolean =>
typeof document !== 'undefined' && document.visibilityState === 'hidden'
function tick(): void {
now = Date.now()
listeners.forEach((l) => l())
}
function reschedule(): void {
const want = listeners.size ? (reduceMotion() || hidden() ? 1000 : 100) : 0
if (want === period) return
if (timer) clearInterval(timer)
timer = null
period = want
if (want) timer = setInterval(tick, want)
}
/** 可见性、动效偏好一变就换节拍。只挂一次,页面整个生命周期都在 */
function watchEnvironment(): void {
if (watching || typeof document === 'undefined') return
watching = true
document.addEventListener('visibilitychange', () => {
reschedule()
if (!hidden() && listeners.size) tick()
})
if (typeof matchMedia === 'function') {
matchMedia('(prefers-reduced-motion: reduce)').addEventListener('change', reschedule)
}
}
/**
* 当前时间(毫秒)。active 为 false 时不订阅节拍,只在组件因为别的原因重渲染
* 时给出当时的时间——终态的数字是定值,用不着每 100ms 重画一遍。
*/
export function useRunClock(active: boolean): number {
const [, bump] = useReducer((x: number) => x + 1, 0)
useEffect(() => {
if (!active) return
watchEnvironment()
listeners.add(bump)
reschedule()
// 停了一阵的时钟 now 是旧的,接上时立刻补一拍
tick()
return () => {
listeners.delete(bump)
reschedule()
}
}, [active])
// 没有节拍在走时 now 可能是很久以前的值,直接取当前时间
if (!timer) now = Date.now()
return active ? now : Date.now()
}