From a007270536cbe31585791f8cc04d8757dd64f5e8 Mon Sep 17 00:00:00 2001 From: ThearchyHelios Date: Sat, 3 Oct 2026 09:36:40 +0800 Subject: [PATCH] =?UTF-8?q?=E6=95=B0=E6=8D=AE=E7=9B=AE=E5=BD=95=E9=98=B6?= =?UTF-8?q?=E6=AE=B5=200=20=E5=89=8D=E7=AB=AF=EF=BC=9A=E8=AF=81=E6=8D=AE?= =?UTF-8?q?=E9=9D=A2=E6=9D=BF=E7=BB=99=E4=B8=8D=E5=AE=8C=E6=95=B4=E7=9A=84?= =?UTF-8?q?=E6=8C=87=E6=A0=87=E6=A0=87=E3=80=8C=E7=BB=93=E6=9E=9C=E4=B8=8D?= =?UTF-8?q?=E5=AE=8C=E6=95=B4=E3=80=8D=E5=B9=B6=E5=86=99=E6=98=8E=E5=8E=9F?= =?UTF-8?q?=E5=9B=A0=EF=BC=8C=E6=88=AA=E6=96=AD=E5=88=87=E5=BC=80=E7=9A=84?= =?UTF-8?q?=20Agent=20=E5=AD=97=E6=AE=B5=E6=A0=87=E3=80=8C=E5=B7=B2?= =?UTF-8?q?=E6=88=AA=E6=96=AD=E3=80=8D=EF=BC=8C=E8=BF=90=E8=A1=8C=E6=97=B6?= =?UTF-8?q?=E9=97=B4=E7=BA=BF=E8=AF=B4=E6=B8=85=E6=8C=87=E6=A0=87=E4=B8=8D?= =?UTF-8?q?=E5=AE=8C=E6=95=B4=E7=9A=84=E5=8E=9F=E5=9B=A0=E5=92=8C=E4=B8=8B?= =?UTF-8?q?=E4=B8=80=E6=AD=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- frontend/src/lib/evidence.ts | 4 ++++ frontend/src/lib/terms.ts | 5 +++++ frontend/src/run/EvidencePanel.tsx | 24 ++++++++++++++++++++---- frontend/src/run/decode.ts | 11 +++++++++++ frontend/src/types.ts | 6 ++++++ scripts/check-decode.mjs | 22 ++++++++++++++++++++++ scripts/check-evidence.mjs | 26 ++++++++++++++++++++++++++ 7 files changed, 94 insertions(+), 4 deletions(-) diff --git a/frontend/src/lib/evidence.ts b/frontend/src/lib/evidence.ts index dfc73213..445d6b0d 100644 --- a/frontend/src/lib/evidence.ts +++ b/frontend/src/lib/evidence.ts @@ -398,6 +398,10 @@ export type SourceTone = 'ok' | 'warn' | 'alert' | 'muted' export function inputSource(input: EvidenceInput): { tone: SourceTone; text: string; reason?: string } { const status = input.status ?? '' if (input.via === 'agent_field') { + // 被截断切开的数组字段:取回的每一格都对得上,但字段只含取回的那部分行 + if (status === 'verified' && input.truncated === true) { + return { tone: 'warn', text: `${EVIDENCE_TEXT.sourceVerified};${EVIDENCE_TEXT.inputTruncated}` } + } if (status === 'verified') return { tone: 'ok', text: EVIDENCE_TEXT.sourceVerified } if (status === 'mismatch') { return { tone: 'warn', text: EVIDENCE_TEXT.sourceMismatch(evidenceValue(input.model_value), evidenceValue(input.value)) } diff --git a/frontend/src/lib/terms.ts b/frontend/src/lib/terms.ts index 14065607..c9df87d7 100644 --- a/frontend/src/lib/terms.ts +++ b/frontend/src/lib/terms.ts @@ -237,6 +237,11 @@ export const EVIDENCE_TEXT = { unmatchedPlain: '无法追溯的数字:', uncited: '该数字未使用引用标记,系统无法核对其来源', missingValue: '缺少输入:口径卡本次未计算出该指标的值', + /** 指标拿截断的查询结果整组算出来(计数、求和……):值只算到了取回的那部分,出具按缺口降档 */ + incomplete: '结果不完整', + incompleteFallback: '基于被截断的查询结果计算,结果不完整', + /** 输入是 Agent 交来、被截断切开的数组字段 */ + inputTruncated: '查询结果已截断,该字段只含取回的部分行', unshowable: (value: string) => `有值(${value}),但无法按口径卡的格式显示`, chainPending: '正在加载算式和输入…', /** 证据接口逐项复核出来的问题。正常时不说,出问题才醒目 */ diff --git a/frontend/src/run/EvidencePanel.tsx b/frontend/src/run/EvidencePanel.tsx index 0a71294f..d651c78b 100644 --- a/frontend/src/run/EvidencePanel.tsx +++ b/frontend/src/run/EvidencePanel.tsx @@ -1106,12 +1106,21 @@ function MetricPart({ step, entry, inputs, runId, seal, pending, failed, resolve const dash = rendered === NONE || entry?.rendered === NONE const missing = entry?.status === 'missing_input' || (value == null && (dash || !resolved)) const unshowable = !missing && dash && value != null + // 拿截断的查询结果整组算出来的:值是真的算出来的,但只算到了取回的那部分,出具已按缺口降档 + const incomplete = step?.incomplete === true || entry?.incomplete === true + const incompleteReason = step?.incomplete_reason || entry?.incomplete_reason || EVIDENCE_TEXT.incompleteFallback return (
{name} {resolved && rendered && {rendered}} + {incomplete && ( + + {EVIDENCE_TEXT.incomplete} + + )}
{(caliber || version || artifact || from) && (
@@ -1127,6 +1136,9 @@ function MetricPart({ step, entry, inputs, runId, seal, pending, failed, resolve )} {missing &&

{EVIDENCE_TEXT.missingValue}

} + {incomplete && ( +

{incompleteReason}

+ )} {unshowable && (

{EVIDENCE_TEXT.unshowable(valueText(value))} @@ -1201,12 +1213,16 @@ function IntegrityList({ code, items }: { code: string; items: string[] }) { function InputChip({ input, link }: { input: EvidenceInput; link?: InputLink }) { const host = useEvidenceHost() const missing = input.status === 'missing' || input.value == null + // Agent 交来、被截断切开的数组字段:对它计数、求和只算到了取回的那部分 + const cut = !missing && input.truncated === true const node = input.node_id ? host.nodeLabel?.(input.node_id) || input.node_id : '' const via = input.via ? VIA_TEXT[input.via] ?? nodeTypeLabel(input.via) : '' - const from = [node && `来自节点「${node}」`, via && `(${via})`, input.role && ` · ${ROLE_TEXT[input.role] ?? input.role}`] - .filter(Boolean).join('') - const style = missing ? { color: 'var(--st-waiting)', borderColor: 'var(--st-waiting)' } : { color: 'var(--text)' } - const body = {valueText(input.value)} ← {input.path ?? NONE}{missing ? '(缺失)' : ''} + const from = [node && `来自节点「${node}」`, via && `(${via})`, input.role && ` · ${ROLE_TEXT[input.role] ?? input.role}`, + cut && ` · ${EVIDENCE_TEXT.inputTruncated}`].filter(Boolean).join('') + const style = missing || cut ? { color: 'var(--st-waiting)', borderColor: 'var(--st-waiting)' } : { color: 'var(--text)' } + const body = ( + {valueText(input.value)} ← {input.path ?? NONE}{missing ? '(缺失)' : cut ? '(已截断)' : ''} + ) return (

  • {link ? ( diff --git a/frontend/src/run/decode.ts b/frontend/src/run/decode.ts index 1c1569da..6b0dde52 100644 --- a/frontend/src/run/decode.ts +++ b/frontend/src/run/decode.ts @@ -745,6 +745,17 @@ function explainLog(code: string | undefined, message: string): Pick { substituted?: string recompute_ok?: boolean | null status?: string + /** metric:表达式把截断的查询结果当成整组用了(计数、求和……),值只算到了取回的那部分 */ + incomplete?: boolean + /** metric:不完整的原因(人话,「基于被截断的查询结果计算(只取回了前 1000 行),结果不完整」) */ + incomplete_reason?: string inputs?: EvidenceInput[] /** 口径卡钉在哪个工作流的哪一版(metric;方案第 5 节的写法,接口实际给在 source 上) */ caliber_from?: EvidenceCaliberSource | null diff --git a/scripts/check-decode.mjs b/scripts/check-decode.mjs index d13f188f..056f54d2 100644 --- a/scripts/check-decode.mjs +++ b/scripts/check-decode.mjs @@ -1316,6 +1316,28 @@ await section('agent 字段按出处核对(可点击证据第二期):抽 && !odd.some((s) => /undefined|NaN/.test(`${s.title}${s.sub ?? ''}`)), odd.map((s) => s.title).join(' | ')) }) +await section('口径卡指标不完整(数据目录阶段 0):截断的查询结果整组拿来算的指标,警告说人话并指到 SQL', async () => { + const E = (seq, type, node_id, data = {}) => ({ seq, type, node_id, ts: 1790000000 + seq, data }) + // 原话和 backend/app/engine/nodes/metrics.py 的 _incomplete_reason 同一个句式。先核对后端源码还是这么说的 + const INCOMPLETE = '指标「入园人次」基于被截断的查询结果计算(只取回了前 1000 行),结果不完整' + const metricsPy = readFileSync(`${root}backend/app/engine/nodes/metrics.py`, 'utf8') + check('后端发指标不完整警告的格式还是夹具里这一种', metricsPy.includes('code="metric_incomplete"') + && metricsPy.includes('message=f"指标「{m[\'name\']}」{m[\'incomplete_reason\']}"') + && metricsPy.includes('f"基于被截断的查询结果计算(只取回了{fetched[0]}),结果不完整"'), + '改了 metrics.py 的说法就同步改 decode.ts 的 explainLog 和这里的夹具') + const all = flatten(mod.decodeRun([ + E(1, 'node.started', 'card', { node_type: 'metrics' }), + E(2, 'log', 'card', { level: 'warn', code: 'metric_incomplete', metric: 'visits', message: INCOMPLETE }), + E(3, 'node.finished', 'card', { duration_ms: 3 }), + ])) + const inc = all.find((s) => s.code === 'metric_incomplete') + check('metric_incomplete 说人话:标题点名哪个指标不完整', inc?.title === '指标「入园人次」结果不完整', inc?.title) + check('……原因放副标题,原话留在展开区', inc?.sub === '基于被截断的查询结果计算(只取回了前 1000 行)' && inc?.detail === INCOMPLETE, + `${inc?.sub} / ${inc?.detail}`) + check('……是提醒(warn),下一步指到 SQL,节点本身照样成功', inc?.level === 'warn' && !!inc?.next?.includes('SQL') + && all.find((s) => s.kind === 'node')?.status === 'done', `${inc?.level} ${inc?.next}`) +}) + await section('结论句裁判(可点击证据第四期):裁判调用单独成行、几条警告说人话、封存后按需裁判有记录', async () => { const E = (seq, type, node_id, data = {}) => ({ seq, type, node_id, ts: 1790000000 + seq, data }) // 原话和后端同一个格式:engine/judge.py 的 run_request、engine/nodes/report.py 的改写一次。先核对后端源码还是这么说的 diff --git a/scripts/check-evidence.mjs b/scripts/check-evidence.mjs index 6e40bca0..f6ddf70f 100644 --- a/scripts/check-evidence.mjs +++ b/scripts/check-evidence.mjs @@ -1010,6 +1010,32 @@ await section('caliber', '口径卡来源和升版处置', async () => { await none.ctx.close() }) +await section('incomplete', '截断的查询结果整组算出来的指标:标「结果不完整」并写明原因,完整的指标不标', async () => { + await openQ(page, '45,678.5元', { wait: '[data-ev-expression]' }) + check('完整的指标不出不完整标识', await panel(page).locator('[data-ev-incomplete], [data-ev-incomplete-reason]').count() === 0) + check('……输入也不标「已截断」', !(await panel(page).locator('[data-ev-input]').allInnerTexts()).some((t) => t.includes('已截断'))) + await page.keyboard.press('Escape') + // 接口的形状:backend/app/api/evidence.py 的指标步骤带 incomplete / incomplete_reason,输入带 Agent 字段证据里的 truncated + const REASON = '基于被截断的查询结果计算(只取回了前 1000 行),结果不完整' + const cut = await probeQ((id, body) => ({ ...body, chain: (body.chain ?? []).map((st) => (st.step === 'metric' + ? { ...st, incomplete: true, incomplete_reason: REASON } : st.step === 'input' ? { ...st, truncated: true } : st)) })) + await openQ(cut.page, '45,678.5元', { wait: '[data-ev-incomplete]' }) + const p = cut.page.locator('[data-evidence-panel]') + const chip = p.locator('[data-ev-incomplete]') + check('指标名旁有「结果不完整」标识,悬停看原因', (await chip.innerText().catch(() => '')) === '结果不完整' + && await chip.getAttribute('title') === REASON, await chip.innerText().catch(() => '')) + const why = await p.locator('[data-ev-incomplete-reason]').innerText().catch(() => '') + check('原因写在指标下面', why === REASON, why) + const warn = await tokenColor(cut.page, 'color', 'var(--st-waiting)') + check('用提醒色(不是失败色:值是真算出来的,只是不全)', await chip.evaluate((el) => getComputedStyle(el).color) === warn) + const inputs = await p.locator('[data-ev-input]').allInnerTexts() + check('被截断切开的 Agent 字段输入标「已截断」', inputs.some((t) => t.includes('(已截断)')), inputs.join('|')) + const source = await p.locator('[data-ev-sources]').innerText().catch(() => '') + check('……输入来源写明与快照一致、但只含取回的部分行', source.includes('与快照一致;查询结果已截断,该字段只含取回的部分行'), + source.replace(/\s+/g, ' ').slice(0, 160)) + await cut.ctx.close() +}) + await section('q-narrow', '查询步骤在 360px:栏内展开、底部抽屉都不横向滚动;减少动效', async () => { const overflow = () => page.evaluate((sel) => { const el = document.querySelector(sel)