mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-16 23:42:00 +00:00
e10c4f23fc
来自 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 项旧断言(按旧日期格式找运行行),第三波更新。
79 lines
2.6 KiB
TypeScript
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()
|
|
}
|