复核第 1 轮:对比入口预先问默认基准带 5 秒超时、问到没有默认基准时写「选择基准对比…」直接去对比页手动选、切回页面时再问一次;工件页签的悬停照实写,320px 时校验值和大小不再拆开

- 对比入口(pages/runs/compare/entry.tsx):预先问 compare/base 卡着不回时 5 秒后按没问到算,叫法退回「与上一次对比」、可点,不再一直停在不可点的「正在查找」;问到没有默认基准(多为工作流的第一次运行)时写「选择基准对比…」,点了直接去只带本次的对比页手动选(对比页自己再找一次),不再写「与上一次对比」、点了再问一遍弹提示;切去别的标签页再切回来时再问一次,问的期间保留原来的叫法、可点,问到不一样才换,问不到不改;更正预先问那段注释的前提(compare/base 不回 409、422,不先问是因为这些入口本来不给点)
- 运行详情「工件」页签头的悬停写上证据快照、核查记录和每个节点的产出三组(RUN_ARTIFACTS_TEXT.tabTitle,RunDetailView 只换这一处);证据快照的悬停不再说「结论里的数字从这里来」,点明含核查、质询时执行的查询;核查记录的悬停用行上的种类名,指明其间执行的查询见「证据快照」;两句都在 45 字内
- 工件行的校验值和大小包在一起排、一起折行,这一栏窄于 22rem 时收起校验值:320px 下大小不再单独折到种类下面,每行仍是两行
- 对比页没带运行时的说明缩成 32 字,不逐个列菜单项的叫法
- 检查:check-compare 补预先问超时、没有默认基准、切回页面再问、点了才发现没有基准后叫法跟着改、工件页签悬停几节;check-verify 改两组悬停的断言、补 320px;check-schedules 的假 compare/base 补上 previous: false(和服务端一致),断言运行详情菜单项与触发历史链接的叫法一字不差
This commit is contained in:
ThearchyHelios
2026-10-06 18:25:35 +08:00
parent b8dfbdb335
commit 53bb356fae
8 changed files with 292 additions and 72 deletions
+17 -8
View File
@@ -3194,6 +3194,8 @@ export const RUN_COMPARE_TEXT = {
menu: '与上一次对比',
/** 上一次失败、取消、还没结束:基准是再往前成功的那一次,不能说成「上一次」 */
menuLastOk: '与上一次成功的运行对比',
/** 没有默认基准(多为工作流的第一次运行):没有「上一次」可比,点了去对比页手动选 */
menuPick: '选择基准对比…',
menuSealedOnly: '运行结束并封存后才能对比',
/** 没有 workflow_id 的运行:画布、问数据里没保存就运行的,或者工作流删掉之后被置空的。服务端只比同一个已保存的工作流 */
menuNoWorkflow: '工作流未保存或已删除,无法对比',
@@ -3240,8 +3242,8 @@ export const RUN_COMPARE_TEXT = {
pickGone: (id: string, missing: boolean) => `${id}(${missing ? '记录不存在' : '无法读取'})`,
// 页面状态
noTarget: '未指定要对比的运行',
/** 菜单项的两种叫法都写上:上一次没有成功时,菜单里写的是「与上一次成功的运行对比」 */
noTargetHint: '在运行详情的「更多」菜单中选择「与上一次对比」或「与上一次成功的运行对比」,即可对照本次与上一次成功的运行',
/** 不逐个列菜单项的叫法(看有没有默认基准、是不是紧挨着的上一次,有三种),只说在哪里打开、默认比的是哪一次 */
noTargetHint: '可从运行详情的「更多」菜单打开对比,默认以上一次成功的运行为基准',
toRuns: '前往记录',
finding: '正在查找基准运行…',
loading: '正在对比两次运行…',
@@ -3400,17 +3402,24 @@ export const RUN_COMPARE_TEXT = {
/**
* 运行详情「工件」页签(pages/runs/ArtifactsPane.tsx):这次运行按内容校验值存下的每一件东西,按节点分组。筛选按
* pages/runs/model.ts 的 artifactGroup 分三组:证据快照是结论里数字的出处;核查记录是双盲复算、反方审稿、审批质询对
* 结论的核查与问答,单独一组,不和数字的出处混在一起;节点产出是过程里的中间值。各种工件的名字和说明在 model.ts,
* 后来新加的放在这里(质询回答的在 INQUIRY_TEXT)
* pages/runs/model.ts 的 artifactGroup 分三组:证据快照是取数、检索的原始结果和口径卡、报告文档、表结构;核查记录是
* 双盲复算、反方审稿、审批质询对结论的核查与问答,单独一组;节点产出是过程里的中间值。按种类归组:核查、质询时执行的
* 查询仍是查询快照,在证据快照里(一次运行里这类查询可能比流程本身的还多),所以证据快照不能说成「结论里的数字都从
* 这里来」。各种工件的名字和说明在 model.ts,后来新加的放在这里(质询回答的在 INQUIRY_TEXT)
*/
export const RUN_ARTIFACTS_TEXT = {
/** 运行详情「工件」页签头上的悬停:人先看到的这句要和页签里的三组对得上。清单还没取回来时不写件数 */
tabTitle: (n?: number | null) =>
(n == null ? '本次运行保存的证据、核查记录和产出' : `${n} 件:证据快照、核查记录和每个节点每一次的产出`),
filterGroup: '按类型筛选工件',
filter: { all: '全部', evidence: '证据快照', verify: '核查记录', output: '节点产出' } as Record<string, string>,
/** 筛选按钮的悬停:这一组装的是什么。核查时执行的查询按种类仍是查询快照,归在证据快照里,要说一声 */
/**
* 筛选按钮的悬停:这一组装的是什么。核查、质询时执行的查询按种类仍是查询快照、在证据快照里,两组都要说一声;
* 核查记录这一组列的是行上的种类名(双盲复算对照、反方审稿记录、质询回答)
*/
filterHint: {
evidence: '查询、工具调用、知识检索的原始结果,以及口径卡、报告文档和查询时的表结构:结论里的数字从这里来',
verify: '双盲复算的对照、反方审稿的记录、审批质询的回答:对结论的核查与问答。核查时执行的查询,快照归在证据快照里',
evidence: '查询、工具调用、知识检索的原始结果,口径卡、报告文档和表结构;含核查、质询时执行的查询',
verify: '对结论的核查与问答:双盲复算对照、反方审稿记录、质询回答;其间执行的查询见「证据快照」',
output: '每个节点每执行一次的产出:循环里每一轮都有一件',
} as Record<string, string>,
/** 同一个节点同一类的第几件:循环里几十件节点产出要分得开 */
+8 -3
View File
@@ -80,7 +80,8 @@ const FIRST_ROWS = 300
*
* 每一行按列表这一栏自己的宽度排(容器查询,不看视口:详情区在宽屏上也可能很窄)。窄时
* 说明换到第二行占满整行,第一行留种类、校验值、大小和时刻;以前挤在一行里,390px
* 宽时说明只剩三个字。序号和第几次尝试放在截断的范围外,按钮的悬停写全说明。
* 宽时说明只剩三个字。序号和第几次尝试放在截断的范围外,按钮的悬停写全说明。再窄
* (320px 的手机)时收起校验值,每行仍是两行。
*/
export function ArtifactsPane({ list, graph, trace, labelOf, onMoment }: {
list: ArtifactList
@@ -261,8 +262,12 @@ function Group({ nodeId, rows, total, graph, trace, labelOf, t0, t1, onOpen, onM
<span className="min-w-0 truncate" data-artifact-about="">{about}</span>
{extra && <span className="tnum shrink-0 text-faint" data-artifact-nth="">{extra}</span>}
</span>
<span className="mono shrink-0 text-2xs text-faint @max-[35rem]:ml-auto" title={`内容校验值 ${a.id}`}>{a.id.slice(0, 8)}</span>
<span className="tnum w-16 shrink-0 text-right text-2xs text-faint">{formatBytes(a.size)}</span>
{/* 校验值和大小一起排、一起折行:分开时更窄的屏上大小会单独折到种类下面、校验值留在右边。窄于 22rem(320px
的手机)时收起校验值,第一行才放得下种类和大小;打开后的查看器里写着校验值 */}
<span className="flex shrink-0 items-center gap-2 @max-[35rem]:ml-auto">
<span className="mono text-2xs text-faint @max-[22rem]:hidden" title={`内容校验值 ${a.id}`}>{a.id.slice(0, 8)}</span>
<span className="tnum w-16 text-right text-2xs text-faint" data-artifact-size="">{formatBytes(a.size)}</span>
</span>
</button>
{at != null && onMoment ? (
<button type="button" className="btn btn-xs btn-ghost tnum w-[86px] shrink-0 justify-end"
+2 -2
View File
@@ -25,7 +25,7 @@ import {
} from './model'
import { ArtifactsPane, useRunArtifacts } from './ArtifactsPane'
import { EvidencePane } from './EvidencePane'
import { EVIDENCE_AUDIT_TEXT } from '../../lib/terms'
import { EVIDENCE_AUDIT_TEXT, RUN_ARTIFACTS_TEXT } from '../../lib/terms'
import { ClassChip, MoreMenu, RunTabs, TierChip, copyText, type MenuItem, type TabItem } from './parts'
import { ProvenanceBar, Telemetry, runClocks } from './Telemetry'
import { TracePane } from './TracePane'
@@ -538,7 +538,7 @@ export function RunDetailView({ runId, onChange, onDeleted }: {
{ key: 'evidence', label: EVIDENCE_AUDIT_TEXT.tab, title: EVIDENCE_AUDIT_TEXT.tabTitle },
{
key: 'artifacts', label: '工件', count: artifactCount, unit: '件', tone: 'quiet',
title: artifactCount == null ? '本次运行保存的证据和产出' : `${artifactCount} 件:查询和工具调用的原始结果、每个节点每一次的产出`,
title: RUN_ARTIFACTS_TEXT.tabTitle(artifactCount),
},
]
+51 -17
View File
@@ -6,6 +6,7 @@ import { toast } from '../../../components/ui'
import { RUN_COMPARE_TEXT as T } from '../../../lib/terms'
import type { Run } from '../../../types'
import type { MenuItem } from '../parts'
import { compareErrorKind } from './model'
/** 对比页的地址。via 是默认基准的来历(同一定时任务 / 同一工作流),只跟着这一次跳转走,换了基准就不再显示 */
export interface CompareVia { base: string; reason: string }
@@ -15,29 +16,41 @@ export const comparePath = (target: string, base?: string | null) =>
/** 查找超过这么久才挂「正在查找」的提示:答复快的不闪一下 */
const NOTE_DELAY_MS = 300
/**
* 预先问默认基准最多等这么久:连得上却卡着不回(代理、网络卡住)时按没问到算,入口不一直停在不可点的「正在查找」。
* 平常一两百毫秒就回来;点了之后那一次不设这个限,慢了有「正在查找」的提示
*/
const ASK_TIMEOUT_MS = 5000
/**
* 预先问到的默认基准。key 是问的哪一次运行的哪一份封存(运行 id + 清单哈希:失败后接着运行完会重新封存,基准可能跟着
* 变);previous 为 null 是没问到(找不到默认基准、出错),叫法退回「与上一次对比」,点了照常再问、照实说
* 变)。base:previous 是紧挨着的上一次,earlier 是再往前成功的那一次(上一次失败、取消、还没结束),none 是没有默认
* 基准(对比页会写「没有默认基准」、让人手动选);null 是没问到(出错、超时),叫法退回「与上一次对比」,点了照常再问、
* 照实说
*/
interface Known { key: string; previous: boolean | null }
interface Known { key: string; base: 'previous' | 'earlier' | 'none' | null }
/**
* 运行详情「更多」菜单里的「与上一次对比」。先问服务端默认的基准(同一定时任务上一次成功的运行,没有就同一工作流、
* 同一类别上一次成功的运行;定时任务触发历史里同名的入口由服务端用同一个函数挑,两处比的是同一对运行),找到了再跳到
* 对比页;找不到时留在原页,提示服务端给的原因,并给「手动选择基准」去对比页自己挑。
* 对比页;点了才发现找不到(预先问时还有)时留在原页,提示服务端给的原因,并给「手动选择基准」去对比页自己挑。
* 这几种不给点,点了也只会被拒:没封存、还在运行的(对比只认已封存的运行,409);不属于已保存工作流的——画布、问数据
* 里没保存就运行的,和工作流删掉之后 workflow_id 被置空的(服务端找不到同一工作流的运行,手动选也是 422)。
*
* 叫法和触发历史里的链接一致:基准不是紧挨着的上一次(上一次失败、取消、还没结束)时写「与上一次成功的运行对比」。
* 点之前就得知道,所以拿到能对比的运行就预先问一次(previous)。问到之前这一项只写「正在查找」、不给点:菜单开着时不会
* 先写一个叫法、问到了再换成另一个,也点不到一个说错了的入口;平常运行一打开就问,人点开菜单时早已问到。预先问不到
* (找不到默认基准、出错)不提示,叫法退回「与上一次对比」,点了照常再问一次、照实说。
* 先写一个叫法、问到了再换成另一个,也点不到一个说错了的入口;平常运行一打开就问,人点开菜单时早已问到。问到没有默认
* 基准(多为工作流的第一次运行)时写「选择基准对比…」,点了直接去只带本次的对比页手动选:没有上一次可比还写「与上一次
* 对比」会误导人,再问一遍、弹一条提示也是多走一步。预先问不到(出错、ASK_TIMEOUT_MS 内没回来)不提示,叫法退回
* 「与上一次对比」、可点,点了照常再问一次、照实说。
*
* 点了总是再问一次、按这一次的答复跳:详情页可能开了很久,中间有运行接着运行完、被删掉,基准跟着变,预先问到的不一定还是
* 现在的。菜单点完就收起:查找慢于一眨眼时挂一条提示,接口慢的时候不至于像没反应。离开运行详情(组件卸载)时取消请求、
* 收起提示,晚到的答复不再把人带去对比页。卸载取消不了全部:地址已经换了、新页面还没画出来(路由按过渡渲染)的那一下
* 答复回来,组件还在,请求也没取消。所以答复回来时再看一眼地址:人已经不在点菜单时的那个运行详情上,就不跳、也不提示。
* 切去别的标签页、窗口再切回来时再问一次:详情页可能开了很久,这期间在别处删掉、接着运行完了哪一次,基准跟着变。再问
* 期间保留原来的叫法、照样可点(不退回「正在查找」,菜单开着也不闪),问到了不一样才换,问不到不改。
*
* 点了总是再问一次、按这一次的答复跳(没有默认基准的除外,对比页自己会再找一次):预先问到的不一定还是现在的。菜单
* 点完就收起:查找慢于一眨眼时挂一条提示,接口慢的时候不至于像没反应。离开运行详情(组件卸载)时取消请求、收起提示,
* 晚到的答复不再把人带去对比页。卸载取消不了全部:地址已经换了、新页面还没画出来(路由按过渡渲染)的那一下答复回来,
* 组件还在,请求也没取消。所以答复回来时再看一眼地址:人已经不在点菜单时的那个运行详情上,就不跳、也不提示。
*
* 写成 hook、在运行详情的提前返回之前调用:预先查找和点了之后查找中的状态都得在拿到运行之前就挂上。run 为空(还在读
* 运行记录)时交回的这一项不会被画出来
@@ -57,30 +70,50 @@ export function useCompareEntry(run: Run | null, live: boolean): MenuItem {
const orphan = !run?.workflow_id
const unsealed = live || !run?.manifest_hash
// 能对比的才预先问:不能对比的入口本来就不给点,问了也是 409、422
// 能对比的才预先问:对比页只认已封存、属于已保存工作流的运行,这两种入口本来就不给点,先问没有用处
const target = run && !orphan && !unsealed ? run.id : null
const key = target ? `${target}:${run?.manifest_hash}` : null
// 切回这一页的次数:每切回来一次再问一次
const [round, setRound] = useState(0)
useEffect(() => {
if (!key) return
const onShow = () => { if (document.visibilityState === 'visible') setRound((n) => n + 1) }
document.addEventListener('visibilitychange', onShow)
return () => document.removeEventListener('visibilitychange', onShow)
}, [key])
useEffect(() => {
if (!target || !key) return
const ctrl = new AbortController()
api.compare.base(target, { signal: ctrl.signal }).then(
(found) => setKnown({ key, previous: found.previous !== false }),
() => { if (!ctrl.signal.aborted) setKnown({ key, previous: null }) },
api.compare.base(target, { signal: ctrl.signal, timeoutMs: ASK_TIMEOUT_MS }).then(
(found) => { if (!ctrl.signal.aborted) setKnown({ key, base: found.previous === false ? 'earlier' : 'previous' }) },
(e: unknown) => {
if (ctrl.signal.aborted) return
// 没有默认基准算问到了(判法同对比页);出错、超时算没问到:头一回退回「与上一次对比」,再问时不改原来的叫法
if (compareErrorKind(e, true) === 'no-base') setKnown({ key, base: 'none' })
else setKnown((k) => (k?.key === key ? k : { key, base: null }))
},
)
return () => ctrl.abort()
}, [target, key])
}, [target, key, round])
const resolved = known && known.key === key ? known : null
// 预先问的那一次还没回来:这一项只写正在查找,不先写一个叫法、问到了再换
const asking = !!key && !resolved
const label = asking ? T.menuFinding
: resolved?.base === 'earlier' ? T.menuLastOk : resolved?.base === 'none' ? T.menuPick : T.menu
return {
key: 'compare',
label: asking ? T.menuFinding : resolved?.previous === false ? T.menuLastOk : T.menu,
label,
icon: <GitCompareArrows size={12} />,
disabled: orphan || unsealed || asking || busy,
hint: orphan ? T.menuNoWorkflow : unsealed ? T.menuSealedOnly : busy ? T.menuFinding : undefined,
onSelect: () => {
if (!run || !key) return
// 已经知道没有默认基准:直接去只带本次的对比页,那里自己再找一次(这期间有了就用上),找不到写明、在上方手动选
if (resolved?.base === 'none') {
navigate(comparePath(run.id))
return
}
const ctrl = new AbortController()
// 点菜单时所在的运行详情。只比路径:同一页里换视图、改列表筛选(改查询串)不算离开
const from = window.location.pathname
@@ -98,13 +131,14 @@ export function useCompareEntry(run: Run | null, live: boolean): MenuItem {
api.compare.base(run.id, { signal: ctrl.signal }).then((found) => {
if (left()) return
// 这一次的答复也定叫法:跳不走(地址没换成)时菜单上写的和刚问到的一致
setKnown({ key, previous: found.previous !== false })
setKnown({ key, base: found.previous === false ? 'earlier' : 'previous' })
const via: CompareVia = { base: found.base_run_id, reason: found.reason }
navigate(comparePath(run.id, found.base_run_id), { state: via })
}, (e: unknown) => {
if (left()) return
if (e instanceof ApiError && e.kind === 'http' && e.status === 404) {
setKnown({ key, previous: null })
// 点了才发现没有默认基准(这期间基准那一次被删了,或者预先问没问到):照实说,下次打开菜单写「选择基准对比…」
setKnown({ key, base: compareErrorKind(e, true) === 'no-base' ? 'none' : null })
toast.info(e.message, { action: { label: T.pickManually, onClick: () => navigate(comparePath(run.id)) } })
} else {
toast.error(e)
+4 -4
View File
@@ -369,10 +369,10 @@ export function artifactDescription(kind: string, meta?: Record<string, any> | n
}
/**
* 工件页签上的三组:evidence 证据快照(查询、工具、检索的快照,口径卡、报告文档、表结构,结论里的数字从这里来);
* verify 核查记录(双盲复算、反方审稿、审批质询对结论的核查与问答:不是数字的出处,以前混在证据快照里,和「原始结果」
* 的说明对不上);output 节点产出(过程里的中间值,一次循环就是几十件)。按种类分:核查时执行的查询种类仍是查询快照,
* 归在证据快照;认不出的种类也算证据快照,宁可醒目
* 工件页签上的三组:evidence 证据快照(查询、工具、检索的快照,口径卡、报告文档、表结构);verify 核查记录(双盲复算、
* 反方审稿、审批质询对结论的核查与问答:以前混在证据快照里,和「原始结果」的说明对不上);output 节点产出(过程里的
* 中间值,一次循环就是几十件)。按种类分:核查、质询时执行的查询种类仍是查询快照,归在证据快照(两组的悬停说明都写明
* 了);认不出的种类也算证据快照,宁可醒目
*/
export type ArtifactGroup = 'evidence' | 'verify' | 'output'
const VERIFY_KINDS: ReadonlySet<string> = new Set(['dual_check', 'challenge', 'inquiry_answer'])