From 6a54ab06c2877a73c3be57a6a90485c3cae68b58 Mon Sep 17 00:00:00 2001 From: ThearchyHelios Date: Tue, 6 Oct 2026 14:36:21 +0800 Subject: [PATCH] =?UTF-8?q?J3=20=E5=A4=8D=E6=A0=B8=E4=BF=AE=E6=AD=A3?= =?UTF-8?q?=EF=BC=88=E7=AC=AC=201=20=E8=BD=AE=EF=BC=89=EF=BC=9A=E8=BF=87?= =?UTF-8?q?=E6=9C=9F=E7=9A=84=E8=AF=81=E6=8D=AE=E5=9B=BE=E9=87=8D=E5=8F=96?= =?UTF-8?q?=E4=B8=80=E6=AC=A1=EF=BC=8C=E5=8F=AA=E6=9C=89=E5=8F=8D=E6=96=B9?= =?UTF-8?q?=E6=A0=87=E8=AE=B0=E7=9A=84=E5=8F=A5=E5=AD=90=E5=9C=A8=E9=9D=A2?= =?UTF-8?q?=E6=9D=BF=E9=87=8C=E5=85=88=E5=86=99=E5=88=A4=E6=96=AD=EF=BC=8C?= =?UTF-8?q?=E6=B2=A1=E5=8F=8D=E6=9F=A5=E6=88=90=E7=9A=84=E4=B8=8D=E8=AF=B4?= =?UTF-8?q?=E6=88=90=E5=8F=8D=E6=96=B9=E6=A8=A1=E5=9E=8B=E7=9A=84=E5=88=A4?= =?UTF-8?q?=E6=96=AD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 证据图缓存会过期:正文有运行就取证据图,之后一直用缓存。审批卡里展开过报告的话,缓存的是运行停在审批上那一刻的图:报告 改写后(第二次审批、同一张卡换稿)新稿在那份图里找不到,一个标记都挂不上;审批之后才审完的反方审稿,成果区也看不到;证据页 挂上时只管「运行已结束、图没封存」,停在第二次审批上的运行、别处正在取的那份都不管,画的是旧稿、审计表却是新取的。改成: - EvidenceDoc(useRunGraph)挂上、换稿那一刻手里已有的那份,找不到正文这一稿,或者正文是运行的成果(EvidenceField 给 settled)而那份没封存,就按(运行、报告、工件)重取一次;重取回来还是这样就作罢,挂上时还没有、正在取的那份不算过期; - 证据页挂上时手里那份不是「封存了、封存的就是这一版(manifest_seq)」就重取,不看运行停在哪;别处正在取的取回来再看一眼; 重取回来之前占位,第一次渲染就按挂上那一刻手里的那份定,不先画一帧旧稿。 整句面板的反方审稿:只有反方标记的句子(没有可点片段、也没有裁判判定)只能从标记点进来,面板却只认片段接口的 unit.challenge,还在取时这一节空着,答 500 时整节消失、也不说为什么。EvidencePanel 收下正文的标记(marks),片段接口还没答、 答不了、答了却没有可用内容时先按标记写出判断(ChallengeSummary 导出的 ClaimVerdictPending),说正在获取、未能获取(带重试, 重试后焦点落到「反方的理由与查询」或新的「重试」上)、无法查看;拿到 unit.challenge 换成完整的单句展示。 没反查成的句子:单句展示里一定没反查成的那一句不再写「判断由反方模型给出」(那是服务端按规则记的无法判断,反方模型没看过); 无法判断的句末标记悬停说明、先行版的落款写「可能是反方模型的判断,也可能是未能反查时记下的」,说不准的仍写判断出自反方模型。 其余几处: - 挂上时一个键盘目标都没有、反方标记随证据图后来才到:Tab 位交给第一枚标记(以前三枚都是 tabindex=-1,Tab 跳过整份报告); - 只有反方标记的句子,读屏不再把「反方审稿」念两遍; - 带字的醒目标记悬停、展开时不铺浅底(10px 的失败色、提醒色字叠在 14% 的浅底上,浅色主题只有 4.0 左右),改描 1px 内边, 和裁判徽标并在一起的同样;无法判断换成省略号盾牌,不再和裁判的「?」、质询的问号挤成三个问号,也和经受住的勾分得开。 检查:check-evidence 新增 mark-panel(片段接口压着、答 500、重试,390px 不溢出)、mark-tab(标记晚到进 Tab 顺序)、stale(审批卡 换稿、同一张卡换稿、成果区、证据页停在审批上和别处正在取,各重取一次、对上了不再取、旧稿一帧都不画)三节,marks 一节补读屏原文 逐字比、展开和悬停时的对比度、图标形状、无法判断的说法,verify 一节改等单句展示(原来等的选择器单句模式里没有,每遍白等 4 秒); 新预览用例 evidence-marks-text、evidence-marks-stale(dev/fixtures/evidence_marks.tsx)。check-challenge 新增 challenge-claim-quiet: 单句、不谈出具,给齐正式运行、运行 id、degrades 也不写降档、不取运行类别(以前这个开关在哪个用例里都观察不到)。 --- frontend/src/dev/fixtures/challenge.tsx | 10 + frontend/src/dev/fixtures/evidence_marks.tsx | 143 ++++++++ frontend/src/lib/terms.ts | 14 + frontend/src/pages/runs/EvidencePane.tsx | 45 ++- frontend/src/run/ChallengeSummary.tsx | 44 ++- frontend/src/run/EvidenceDoc.tsx | 139 +++++--- frontend/src/run/EvidencePanel.tsx | 99 ++++-- frontend/src/types.ts | 8 +- scripts/check-challenge.mjs | 19 ++ scripts/check-evidence.mjs | 328 ++++++++++++++++++- 10 files changed, 775 insertions(+), 74 deletions(-) create mode 100644 frontend/src/dev/fixtures/evidence_marks.tsx diff --git a/frontend/src/dev/fixtures/challenge.tsx b/frontend/src/dev/fixtures/challenge.tsx index eb00d9d2..b2947d90 100644 --- a/frontend/src/dev/fixtures/challenge.tsx +++ b/frontend/src/dev/fixtures/challenge.tsx @@ -37,6 +37,10 @@ import fx from './challenge.json' * - ?syn=challenge-approval-dup:同 many,工件里补出来的一句和条目里的一句原文相同、unit 不同(工件由检查脚本合成) * - ?syn=challenge-approval-norecord:同 many,审稿记录没存上(artifact 为 null) * + * 证据面板的单句展示(scope="claim"): + * - ?syn=challenge-claim-quiet:被推翻的那一句,「不谈出具」(issuance={false})。给了正式运行、运行 id,服务端也说被推翻的 + * 会降档(degrades)——审批卡上这几样凑齐就写「出具会降档」;这里一句和出具有关的话都不说,也不为此取运行类别 + * * 运行类别(GET /api/runs/{id})、工件(GET /api/artifacts/{id})都由检查脚本用 page.route 伪造;直接打开时取不到, * 卡上照实不说降档、点开一句说无法获取。 * @@ -253,6 +257,12 @@ export const cases: Record JSX.Element> = { ), + 'challenge-claim-quiet': () => ( +
+ it.verdict === 'refuted') })]} + runId={RUNS.formal} runClass="formal" scope="claim" issuance={false} /> +
+ ), 'challenge-inspector': () => , 'challenge-inspector-chain': () => , } diff --git a/frontend/src/dev/fixtures/evidence_marks.tsx b/frontend/src/dev/fixtures/evidence_marks.tsx new file mode 100644 index 00000000..61f23dbd --- /dev/null +++ b/frontend/src/dev/fixtures/evidence_marks.tsx @@ -0,0 +1,143 @@ +import { useState, type JSX } from 'react' +import { EvidencePane } from '../../pages/runs/EvidencePane' +import { EvidenceDoc, EvidenceField } from '../../run/EvidenceDoc' +import { useEvidence } from '../../store/evidence' +import type { EvidenceDocData, Run } from '../../types' +import judge from '../../run/__tests__/evidence-judge.json' + +/** + * 正文里被反方审过的句子(期 4,run/EvidenceDoc 的句末标记)的预览用例,scripts/check-evidence.mjs 按它们检查。报告文档 + * 取自 run/__tests__/evidence-judge.json 的 plain(后端 compose_doc 真跑出来的周报,内容虚构);证据图、片段接口、审计 + * 接口都由检查脚本伪造,这里不发任何写请求。 + * + * - ?syn=evidence-marks-text:同一份周报,数字、取值都改成纯文字:整份报告一个可点的片段都没有,也没开裁判,挂上时键盘 + * 顺序是空的。证据图(检查脚本晚一点答)带着被审过的句子,标记到了以后得进 Tab 顺序。前面摆一个按钮,从它按 Tab 进报告 + * - ?syn=evidence-marks-stale:同一次运行先后在几个地方挂这份报告,看手里那份证据图过期了重不重取。按钮换场景(每按一次 + * 都重新挂):审批卡里的初稿(old);报告改写后第二次审批的新稿(new);同一个实例从初稿换到新稿(switch,同画布的审批 + * 浮层换审批);运行结束后成果区的新稿(output,EvidenceField);运行详情的证据页(pane-interrupted:运行停在第二次审批 + * 上;pane-succeeded:运行已经结束、封存过)。两份文档预先放进证据 store:文档按工件 id 永久缓存,取文档不是这里要看的 + */ + +/** 同一次运行:初稿是夹具里那一份,新稿改了一句话和一个数(文档的 run_id 改成这次运行,成果区按它认是不是同一次运行) */ +const RUN = 'run-evidence-marks-stale' +const OLD_ART = judge.plain.doc_artifact +const NEW_ART = 'b7'.repeat(32) +const BASE = judge.plain.doc as unknown as EvidenceDocData + +const OLD: EvidenceDocData = { ...BASE, run_id: RUN } +const NEW: EvidenceDocData = { + ...BASE, + run_id: RUN, + markdown: (BASE.markdown ?? '').replace('增长主要来自新客首单,老客复购持平。', '增长主要来自老客复购,新客首单持平。') + .replace('退款 29 单', '退款 31 单'), + blocks: BASE.blocks.map((b) => ({ + ...b, + units: b.units?.map((u) => ({ + ...u, + segments: u.segments?.map((s) => (s.id === 's11' ? { ...s, text: '增长主要来自老客复购,新客首单持平。' } + : s.id === 's14' && s.cite ? { ...s, text: '31', cite: { ...s.cite, value: 31, rendered: '31' } } : s)), + })), + })), +} + +/** 一个可点的片段都没有的那一份:非结构片段一律改成普通文字,去掉出处 */ +const TEXT_ONLY: EvidenceDocData = { + ...BASE, + blocks: BASE.blocks.map((b) => ({ + ...b, + units: b.units?.map((u) => ({ + ...u, + segments: u.segments?.map((s) => (s.kind === 'structural' ? s : { id: s.id, kind: 'text', text: s.text, state: 'neutral' })), + })), + })), +} + +function TextOnly() { + return ( +
+ +
+ +
+
+ ) +} + +type Stage = 'old' | 'new' | 'switch' | 'output' | 'pane-interrupted' | 'pane-succeeded' +const STAGES: [Stage, string][] = [ + ['old', '审批卡 · 初稿'], ['new', '第二次审批 · 新稿'], ['switch', '同一张卡换稿'], ['output', '成果区 · 新稿'], + ['pane-interrupted', '证据页 · 停在审批上'], ['pane-succeeded', '证据页 · 运行已结束'], +] + +function runOf(status: 'interrupted' | 'succeeded'): Run { + const done = status === 'succeeded' + return { + id: RUN, workflow_id: null, workflow_name: '周报', status, input: {}, output: {}, error: null, + usage: { input_tokens: 0, output_tokens: 0, cost_usd: 0 } as Run['usage'], run_class: 'formal', version: 2, + manifest_hash: done ? 'c'.repeat(64) : null, manifest_seq: done ? 64 : null, + created_at: '2026-10-05T06:00:00', started_at: '2026-10-05T06:00:00', + } +} + +/** 审批卡里展开的报告(同 run/ApprovalReport 的 ReportDoc:限高、窄栏、自带证据条) */ +function Card({ doc, artifact }: { doc: EvidenceDocData; artifact: string }) { + return ( +
+ +
+ ) +} + +/** 同一个 EvidenceDoc 实例从初稿换到新稿 */ +function Switch() { + const [fresh, setFresh] = useState(false) + return ( +
+ +
+ +
+
+ ) +} + +function Stale() { + // 首次渲染前把两份文档放进 store:文档按工件 id 永久缓存,证据页、成果区按工件 id 取的就是它们 + useState(() => { + useEvidence.setState((s) => ({ + docs: { ...s.docs, [OLD_ART]: { status: 'ok', data: OLD }, [NEW_ART]: { status: 'ok', data: NEW } }, + })) + return true + }) + const [at, setAt] = useState<{ stage: Stage; n: number }>({ stage: 'old', n: 0 }) + const go = (stage: Stage) => setAt((cur) => ({ stage, n: cur.n + 1 })) + return ( +
+
+ {STAGES.map(([stage, label]) => ( + + ))} +
+ {/* 每按一次都按新的 key 重新挂:同一场景按两次,看手里那份图对上了还会不会重取 */} +
+ {at.stage === 'old' && } + {at.stage === 'new' && } + {at.stage === 'switch' && } + {at.stage === 'output' && ( +
+ +
+ )} + {(at.stage === 'pane-interrupted' || at.stage === 'pane-succeeded') && ( + (id === 'write' ? '写周报' : undefined)} refreshKey="0" /> + )} +
+
+ ) +} + +export const cases: Record JSX.Element> = { + 'evidence-marks-text': () => , + 'evidence-marks-stale': () => , +} diff --git a/frontend/src/lib/terms.ts b/frontend/src/lib/terms.ts index e8a4013a..aedba907 100644 --- a/frontend/src/lib/terms.ts +++ b/frontend/src/lib/terms.ts @@ -3963,8 +3963,22 @@ export const CHALLENGE_TEXT = { claimUnreviewed: '这一句未能反查,已记为无法判断', /** 同上,但无法判断的句子里还有查过了、数据不够的:说不准是不是这一句 */ claimMaybeUnreviewed: (n: number) => `这份报告有 ${formatNumber(n)} 句未能反查,已记为无法判断,这一句可能在其中`, + /** + * 单句展示的先行版:只知道判断(正文标记用的证据图),这一句的理由、查询和整份报告的计数要等片段接口答回来。 + * 还在取、取不到(给重试)、答了却没有可用的内容 + */ + claimPending: '正在获取反方的理由与查询…', + claimFailed: '未能获取反方的理由与查询', + claimNoDetail: '无法查看反方的理由与查询', + /** + * 无法判断的落款:未能反查的句子也记为无法判断(服务端按规则记的,反方模型没看过这一句),说不准是哪一种时不说成反方 + * 模型的判断。证据面板先行版的落款、正文句末标记的悬停说明都用这一句 + */ + judgedUnsure: '可能是反方模型的判断,也可能是未能反查时记下的,并非系统核对', /** 正文句末标记的悬停说明:判断是反方模型给的 */ markTitle: (verdict: string) => `反方审稿:${verdict}(反方模型的判断,并非系统核对)`, + /** 同上,无法判断的那一种(括号里同 judgedUnsure) */ + markTitleUnsure: (verdict: string) => `反方审稿:${verdict}(可能是反方模型的判断,也可能是未能反查时记下的,并非系统核对)`, /** 句末标记读屏念的那一段:跟在句子后面(只有反方审稿时),或接在裁判的判定后面(两样都有时,并在一个标记里) */ markLabel: (verdict: string) => `反方审稿:${verdict}`, diff --git a/frontend/src/pages/runs/EvidencePane.tsx b/frontend/src/pages/runs/EvidencePane.tsx index 812d814b..531d895c 100644 --- a/frontend/src/pages/runs/EvidencePane.tsx +++ b/frontend/src/pages/runs/EvidencePane.tsx @@ -48,20 +48,40 @@ export function EvidencePane({ run, output, labelOf, refreshKey }: { const loadGraph = useEvidence((s) => s.loadGraph) const reloadGraph = useEvidence((s) => s.reloadGraph) const first = useRef(true) + // 报告正文(审批卡里展开的、成果区的)有运行就先取过证据图,取的时候运行可能还停在审批上(之后报告又改写过)、刚收尾还没 + // 封存,也可能是接着跑之前封存的那一版。挂上时手里那份不是「封存了、封存的就是这一版」就重取一次,不看运行停在哪:之后 + // 没有新事件,refreshKey 不再变,过期的那份会一直留着。别处正在取的那份取回来再看一眼(recheck)。 + // 重取回来之前先占位(renewing),不画手里那份:画出来的是旧稿,审计表却是挂上时新取的,点一行会按片段 id 打开旧稿里同号 + // 的片段。第一次渲染就按挂上那一刻手里的那份定,不先画一帧旧稿再收起来;换下来的判据是 store 里那一格不再是它 + const [held] = useState(() => useEvidence.getState().graphs[run.id]) + const [renewing, setRenewing] = useState(() => staleHeld(held, run.manifest_seq)) + const recheck = useRef(false) useEffect(() => { if (first.current) { first.current = false - // 报告正文(成果区、审批卡里展开的那份)有运行就先取过证据图,取的时候运行可能还停在审批上、刚收尾还没封存: - // 运行已经结束、手里那份却说没封存时重取一次,不然这一页顶上一直写着尚未封存(之后没有新事件,refreshKey 不再变) - const held = useEvidence.getState().graphs[run.id] - if (held?.status === 'ok' && SETTLED.has(run.status) && !held.data?.seal?.sealed) void reloadGraph(run.id) - else void loadGraph(run.id) + if (!staleHeld(held, run.manifest_seq)) void loadGraph(run.id) + else if (held?.status === 'loading') recheck.current = true + else void reloadGraph(run.id) return } void reloadGraph(run.id) - }, [run.id, run.status, refreshKey, loadGraph, reloadGraph]) + // held 是挂上那一刻的,之后不变 + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [run.id, run.status, run.manifest_seq, refreshKey, loadGraph, reloadGraph]) + useEffect(() => { + // 挂上时那一份还没换下来(重取还没发出、还没回来),或者正在取:接着等 + if (!renewing || graphSlot === held || graphSlot?.status === 'loading') return + if (recheck.current) { + recheck.current = false + if (graphSlot?.status === 'ok' && !sealedNow(graphSlot.data, run.manifest_seq)) { + void reloadGraph(run.id) + return + } + } + setRenewing(false) + }, [renewing, graphSlot, held, run.id, run.manifest_seq, reloadGraph]) const audit = useAudit(run.id, refreshKey) - const graph = graphSlot?.data + const graph = renewing ? undefined : graphSlot?.data const [root, setRoot] = useState(null) const wide = useWide(root, 880) @@ -232,6 +252,17 @@ const openKey = (row: AuditRow): string | undefined => /** 已经收尾的运行:还在跑、停在审批上的,报告可能还没写,说「这次的报告没有逐段证据」太早 */ const SETTLED = new Set(['succeeded', 'failed', 'cancelled']) +/** + * 手里这份证据图能不能直接用:封存了,而且封存的就是运行现在这一版(失败后接着跑的运行会重新封存,manifest_seq 跟着变)。 + * 运行记录上没有 manifest_seq(老运行)、老服务端的证据图没给时只看封没封存 + */ +const sealedNow = (graph: EvidenceGraph | undefined, seq: number | null | undefined) => + !!graph?.seal?.sealed && (seq == null || graph.seal.manifest_seq == null || graph.seal.manifest_seq === seq) + +/** 证据页挂上时手里那份(别处取的)要不要重取:正在取的取回来再看;取到了的不是封存的这一版就重取。没有、取失败的照常取 */ +const staleHeld = (held: { status: string; data?: EvidenceGraph } | undefined, seq: number | null | undefined) => + held?.status === 'loading' || (held?.status === 'ok' && !sealedNow(held.data, seq)) + /** * 工作流现在的图能不能一键升级:拿它去校验,看有没有 evidence.upgrade_available 这条建议。老后端不给 * 这条建议,横幅也就不出现(它也没有升级接口)。按工作流 id 和版本记住答案:同一张图的几条运行不重复问; diff --git a/frontend/src/run/ChallengeSummary.tsx b/frontend/src/run/ChallengeSummary.tsx index a0a0db4d..5a277302 100644 --- a/frontend/src/run/ChallengeSummary.tsx +++ b/frontend/src/run/ChallengeSummary.tsx @@ -42,7 +42,8 @@ export interface ChallengeSummaryProps { * - 审批卡(scope 为 report),紧跟在报告核对概况(ApprovalReports)后面:一行概况(四种判断各几句),出具相关的那一句, * 有句子反查没完成时再说一行「N 句未能反查」,逐句列出结论原文和判断,点开一句再按 challenge_artifact 取完整内容,看 * 反方的理由和它执行过的查询。审稿记录没存上(没有工件)时只列判断、不能点开,整块说一次。 - * - 证据面板(scope 为 claim、issuance 为 false):一句话的判断,展开同样按 challenge_artifact 取这一句的理由和查询。 + * - 证据面板(scope 为 claim、issuance 为 false):一句话的判断,展开同样按 challenge_artifact 取这一句的理由和查询。片段 + * 接口还没答回来、答不了时,由 ClaimVerdictPending 先按正文标记(证据图)写出判断,说清在等什么、给重试。 * * 判断是反方模型给的,不是系统核对:颜色照结论句裁判的那一套,「经受住」也不用确定性的绿。 * 「出具会降档」只在谈出具(issuance)、正式运行、有被推翻的结论、被推翻的真会让出具降档时才写:服务端给了 degrades 就照它 @@ -443,8 +444,45 @@ function ClaimBlock({ report, challenge, run }: { )} {noRecord &&

{CHALLENGE_TEXT.noRecord}

} - {/* 判断标签看着像结论,得说清是谁判的:展开取到审稿记录之后带上模型名 */} -

{CHALLENGE_TEXT.judgedBy(detail.data?.model ?? null)}

+ {/* 判断标签看着像结论,得说清是谁判的:展开取到审稿记录之后带上模型名。这一句一定没反查成(surely)的不写:那是 + 服务端按规则记的无法判断,反方模型没看过这一句,上面一行已经说了。说不准的(maybe)照旧写 */} + {!surely &&

{CHALLENGE_TEXT.judgedBy(detail.data?.model ?? null)}

} + + ) +} + +/** 证据面板先行版在等什么:片段接口还在取、取不到、答了却没有可用的 unit.challenge */ +export type ClaimWait = 'loading' | 'error' | 'missing' + +/** + * 单句展示的先行版(证据面板):只知道这一句的判断(正文标记用的证据图 challenge_verdicts),审稿记录、整份报告的计数要等 + * 片段接口的 unit.challenge。判断标签先画出来——用户是点着句末醒目的「被推翻」进来的,这一节不能空着;还在取时说正在获取, + * 取不到给重试(onRetry),答了却没有可用的内容时照实说看不了。拿到 unit.challenge 之后调用方换成完整的单句展示 + * (ChallengeSummary 的 scope="claim")。无法判断的说不准是不是根本没反查成(要整份报告的计数才分得出),落款不说成反方模型 + * 的判断。不谈出具,同证据面板里的完整展示 + */ +export function ClaimVerdictPending({ verdict, wait, onRetry }: { verdict: string; wait: ClaimWait; onRetry?: () => void }) { + return ( +
+
+ +
+ {wait === 'loading' ? ( +

{CHALLENGE_TEXT.claimPending}

+ ) : ( +
+ + {wait === 'error' ? CHALLENGE_TEXT.claimFailed : CHALLENGE_TEXT.claimNoDetail} + + {wait === 'error' && onRetry && ( + + )} +
+ )} +

+ {verdict === 'inconclusive' ? CHALLENGE_TEXT.judgedUnsure : CHALLENGE_TEXT.judgedBy(null)} +

) } diff --git a/frontend/src/run/EvidenceDoc.tsx b/frontend/src/run/EvidenceDoc.tsx index 7f8bd26f..454e2e35 100644 --- a/frontend/src/run/EvidenceDoc.tsx +++ b/frontend/src/run/EvidenceDoc.tsx @@ -5,7 +5,7 @@ import { } from 'react' import { createPortal } from 'react-dom' import { - ListChecks, MessageCircleQuestion, ShieldAlert, ShieldCheck, ShieldMinus, ShieldQuestion, ShieldX, type LucideIcon, + ListChecks, MessageCircleQuestion, ShieldAlert, ShieldCheck, ShieldEllipsis, ShieldMinus, ShieldX, type LucideIcon, } from 'lucide-react' import clsx from 'clsx' import { rovingTarget } from '../components/ui' @@ -19,8 +19,11 @@ import { CHALLENGE_TEXT, EVIDENCE_STATE_LABEL, EVIDENCE_TEXT, INQUIRY_TEXT, JUDGE_TEXT, claimTally, evidenceTally, type ClaimTallyCounts, } from '../lib/terms' -import { useEvidence, useVerdicts } from '../store/evidence' -import type { ChallengeVerdict, EvidenceBlock, EvidenceDocData, EvidenceSegment, EvidenceUnit, EvidenceVerdict } from '../types' +import { useEvidence, useVerdicts, type Slot } from '../store/evidence' +import type { + ChallengeVerdict, EvidenceBlock, EvidenceChallengeVerdicts, EvidenceDocData, EvidenceGraph, EvidenceSegment, EvidenceUnit, + EvidenceVerdict, +} from '../types' import { EvidencePanel, type PanelMode, type PanelView } from './EvidencePanel' import { askAbout, type InquiryAccess } from './Inquiry' import { BlockView, Markdown, StyledSlice, inlineStyles, numericColumns, type InlineStyles } from './Markdown' @@ -36,7 +39,8 @@ import { BlockView, Markdown, StyledSlice, inlineStyles, numericColumns, type In * 结论句的判定(四期)只在句末挂一枚小徽标(◆ ◇ ! ○ ?),整句不画线;证据相矛盾(和旧的证据不支持)的整句 * 铺一层浅底。徽标也是按钮:点开是这一句的「模型的解释」。判定是模型给的,颜色一律不用确定性的绿。 * 被反方审过的句子(期 4,证据图的 reports[].challenge_verdicts)同样在句末挂标记:被推翻、被削弱带字、醒目,经受住、 - * 无法判断只有淡色图标;有判定的句子并在同一枚徽标里。点开都是整句面板,没有可点片段的句子也打得开。 + * 无法判断只有淡色图标;有判定的句子并在同一枚徽标里。点开都是整句面板,没有可点片段的句子也打得开。证据图有运行就取 + * 一次;手里那份是别处早先取的、已经过期(报告改写过、运行收尾之前取的)时重取一次,见 useRunGraph。 * * 键盘:整份报告只占一个 Tab 位(roving tabindex)。←/→ 在有状态的片段、句末徽标间走,↑/↓ 按 * 句子走(表格里按列走到上一行 / 下一行,出了表格接着按句子走),n / N 跳到下一处 / @@ -217,23 +221,61 @@ function verticalTarget(model: Model, id: string, down: boolean): string | null return model.unitFirst[(u + (down ? 1 : -1) + n) % n] ?? null } +type GraphReport = NonNullable[number] + /** - * 这份报告里被反方审过的句子 → 判断(证据图 reports[].challenge_verdicts)。只认证据图里这份报告、而且封存的就是正文 - * 这一份(工件 id 对得上)的那一项:证据图说的是这个报告节点最后写的那一稿,正文是另一稿时同一个句子编号说的可能是别的话。 + * 证据图里的这一项说的是不是正文这一份:同一个报告节点,封存的就是这一稿(工件 id 对得上)。证据图说的是这个报告节点最后 + * 写的那一稿,正文是另一稿时同一个句子编号说的可能是别的话。正文没记报告节点、没给工件 id 的(预览、老文档)不按它比 + */ +const sameReport = (r: GraphReport | undefined, report: string | undefined, artifact: string | undefined) => + (!report || !r?.node_id || r.node_id === report) && (!artifact || r?.doc_artifact === artifact) + +/** + * 这次运行的证据图(正文的反方标记、按需判过的句子都从这里来):有运行就取一次,同一次运行只取一回,不逐句请求。 + * + * 挂上(或换了一稿)那一刻手里已经有的那一份是别处早先取的,可能过期了。审批卡里展开过报告,取的就是运行停在审批上那一刻 + * 的图:之后报告改写了(第二次审批、同一张卡换稿),正文这一稿在那份图里找不到,一个标记都挂不上;正文是运行的成果 + * (settled)而那份图没封存,审批之后才审完的反方审稿不在里面。这两种按(运行、报告、工件)重取一次,重取回来还是这样 + * 就作罢(正文是改写前的原件时本来就对不上),不反复请求。挂上时还没有、正在取的那一份是这时候取的,不算过期。证据页自己 + * 管重取(pages/runs/EvidencePane) + */ +function useRunGraph(runId: string | undefined, report: string | undefined, artifact: string | undefined, settled: boolean): + EvidenceGraph | undefined { + const slot = useEvidence((s) => (runId ? s.graphs[runId] : undefined)) + const loadGraph = useEvidence((s) => s.loadGraph) + const reloadGraph = useEvidence((s) => s.reloadGraph) + const key = runId ? `${runId}\u0000${report ?? ''}\u0000${artifact ?? ''}` : '' + // 挂上、换了一稿那一刻手里已经取到的那一份:只有它可能过期,看过一次就放下 + const held = useRef<{ key: string; slot: Slot | null }>({ key: '', slot: null }) + useEffect(() => { + if (!runId || held.current.key === key) return + const cur = useEvidence.getState().graphs[runId] + held.current = { key, slot: cur?.status === 'ok' ? cur : null } + void loadGraph(runId) + }, [runId, key, loadGraph]) + useEffect(() => { + const h = held.current + if (!runId || h.key !== key || !h.slot || slot !== h.slot) return + h.slot = null + const graph = slot.data + const mine = (graph?.reports ?? []).some((r) => sameReport(r, report, artifact)) + if (!mine || (settled && !graph?.seal?.sealed)) void reloadGraph(runId) + }, [runId, key, slot, report, artifact, settled, reloadGraph]) + return slot?.data +} + +/** + * 这份报告里被反方审过的句子 → 判断(证据图 reports[].challenge_verdicts),只认说的就是正文这一份的那一项(sameReport)。 * 没有运行、证据图还没取到(或取不到)、一句都没审、老服务端都是 undefined */ -function useChallengeMarks(runId: string | undefined, report: string | undefined, artifact: string | undefined): - Record | undefined { - const graph = useEvidence((s) => (runId ? s.graphs[runId]?.data : undefined)) - return useMemo(() => { - const hit = (graph?.reports ?? []).find((r) => (!report || !r?.node_id || r.node_id === report) - && (!artifact || r?.doc_artifact === artifact)) - const raw: unknown = hit?.challenge_verdicts - if (!raw || typeof raw !== 'object') return undefined - const marks = Object.fromEntries(Object.entries(raw as Record) - .filter((e): e is [string, string] => !!e[0] && typeof e[1] === 'string' && !!e[1])) - return Object.keys(marks).length ? marks : undefined - }, [graph, report, artifact]) +function challengeMarks(graph: EvidenceGraph | undefined, report: string | undefined, artifact: string | undefined): + EvidenceChallengeVerdicts | undefined { + const hit = (graph?.reports ?? []).find((r) => sameReport(r, report, artifact)) + const raw: unknown = hit?.challenge_verdicts + if (!raw || typeof raw !== 'object') return undefined + const marks = Object.fromEntries(Object.entries(raw as Record) + .filter((e): e is [string, string] => !!e[0] && typeof e[1] === 'string' && !!e[1])) + return Object.keys(marks).length ? marks : undefined } /** 句末标记读屏念的那一句:截到 40 字(同 lib/evidence 的 claimLabel) */ @@ -302,6 +344,11 @@ export const EvidenceDoc = forwardRef(function EvidenceDoc({ doc, artifact, runId, dense = false, label, panel = 'auto', dock, onView, tally = false, runClass, - tier, inquiry }, ref) { + tier, settled = false, inquiry }, ref) { const blocks = useMemo(() => doc.blocks ?? [], [doc]) const report = doc.node_id || undefined // 质询要知道是哪次运行的哪份报告:两样缺一样就不挂入口 const ask = !!inquiry && !!runId && !!report // 封存之后按需追加的判定:盖过文档里的「未裁判 · 按需」。只换句末徽标,封存的文档一个字不改 const overlay = useVerdicts(runId, report) + // 有运行就取这次运行的证据图(同一次运行只取一次,不逐句请求;过期了重取一次):它带着被反方审过的句子 + // (reports[].challenge_verdicts,正式、探索运行都可能有,反方审稿在报告写完之后才审,文档里没有这份记录),探索运行的 + // 报告还带着之前按需判过的句子(reports[].post_seal_verdicts,useVerdicts 读),重新打开页面时标记、徽标都还在 + const graph = useRunGraph(runId, report, artifact, settled) // 被反方审过的句子:句末挂标记(和裁判的判定并在一个徽标里),点开是整句面板 - const marks = useChallengeMarks(runId, report, artifact) + const marks = useMemo(() => challengeMarks(graph, report, artifact), [graph, report, artifact]) const model = useMemo(() => buildModel(blocks, overlay, ask, marks), [blocks, overlay, ask, marks]) const counts = useMemo(() => docTally(doc), [doc]) const claims = useMemo(() => claimCounts(doc, overlay), [doc, overlay]) - // 有运行就取一次这次运行的证据图(同一次运行只取一次,不逐句请求):它带着被反方审过的句子(reports[].challenge_verdicts, - // 正式、探索运行都可能有,反方审稿在报告写完之后才审,文档里没有这份记录),探索运行的报告还带着之前按需判过的句子 - // (reports[].post_seal_verdicts),重新打开页面时标记、徽标都还在 - const loadGraph = useEvidence((s) => s.loadGraph) - useEffect(() => { if (runId) void loadGraph(runId) }, [runId, loadGraph]) const rootRef = useRef(null) const instance = useId() const panelId = `${instance}-panel` @@ -344,9 +390,10 @@ export const EvidenceDoc = forwardRef { - if (current && !model.index.has(current)) setCurrent(model.order[0] ?? null) + if (current ? !model.index.has(current) : model.order.length > 0) setCurrent(model.order[0] ?? null) }, [model, current]) // 同一时刻只开一个面板:另一份报告打开了自己的面板,这边的就收起 @@ -402,7 +449,8 @@ export const EvidenceDoc = forwardRef close()} onLocate={(id) => { focusSeg(id, { flash: true }); openSeg(id) }} @@ -921,22 +970,31 @@ const DocBlock = memo(function DocBlock({ block, dense, doc, visual, current, ac } }) -/** 反方审稿的判断在句末徽标里的样子 */ +/** 反方审稿的判断在句末徽标里的样子。soft 是悬停、展开时铺的浅底,醒目的那两种不铺(见 LOUD_RING) */ interface MarkLook { icon: LucideIcon; color: string; soft: string; loud: boolean } /** * 被推翻、被削弱醒目:盾牌图标加判断两个字,用失败色、提醒色;经受住、无法判断低调:只有淡色的盾牌图标(悬停、读屏照样 - * 说得出是哪一种)。四种图标各不相同,去掉颜色也分得开;判断是反方模型给的,经受住也不用确定性的绿。认不出的判断按低调画 + * 说得出是哪一种)。四种图标各不相同,去掉颜色也分得开:无法判断用省略号不用问号——句末常常已经有裁判的「?」(未裁判、 + * 证据不足)和「质询」的问号,再添一个问号就分不清了,和经受住的勾也更好分。判断是反方模型给的,经受住也不用确定性的绿。 + * 认不出的判断按低调画 */ const MARK_LOOK: Record = { - refuted: { icon: ShieldX, color: 'var(--st-failed)', soft: 'var(--st-failed-soft)', loud: true }, - weakened: { icon: ShieldMinus, color: 'var(--st-waiting)', soft: 'var(--st-waiting-soft)', loud: true }, + refuted: { icon: ShieldX, color: 'var(--st-failed)', soft: 'transparent', loud: true }, + weakened: { icon: ShieldMinus, color: 'var(--st-waiting)', soft: 'transparent', loud: true }, stands: { icon: ShieldCheck, color: 'var(--text-faint)', soft: 'var(--st-idle-soft)', loud: false }, - inconclusive: { icon: ShieldQuestion, color: 'var(--text-faint)', soft: 'var(--st-idle-soft)', loud: false }, + inconclusive: { icon: ShieldEllipsis, color: 'var(--text-faint)', soft: 'var(--st-idle-soft)', loud: false }, } const markLook = (verdict: string): MarkLook => (Object.hasOwn(MARK_LOOK, verdict) ? MARK_LOOK[verdict as ChallengeVerdict] : { icon: ShieldAlert, color: 'var(--text-faint)', soft: 'var(--st-idle-soft)', loud: false }) +/** + * 带字的醒目标记悬停、展开时不铺浅底(index.css 的 .ev-badge 按 --ev-soft 铺),改描一圈细边:10px 的失败色、提醒色字叠在 + * 14% 的浅底上,浅色主题里对比度只有 4.0 左右(页面底色上),面板开着时这枚标记一直是展开态。和裁判徽标并在一起的同样 + * 不铺(浅底是裁判判定的颜色,字是反方的颜色)。细边用徽标的字色,和焦点环(2px 强调色、外扩)分得开 + */ +const LOUD_RING = 'hover:shadow-[inset_0_0_0_1px_currentColor] aria-expanded:shadow-[inset_0_0_0_1px_currentColor]' + /** * 句末徽标里反方审稿的那一截。和裁判的字形并在一个徽标里时跟在字形后面(after)。醒目的那两种连字一起写:字号定成 * 10px(同句末的「无证据」小标签),窄栏里 0.72em 的上标只有 8px,汉字认不清 @@ -1014,7 +1072,10 @@ function UnitView({ unit, doc, current, active, panelId, code, tag, badge, ask } ? `${meta.label}${verdict.post_seal ? ` · ${JUDGE_TEXT.postSeal}` : ''}(${verdict.judge || JUDGE_TEXT.judgeModel} · 非确定)${ verdictMissing(verdict) ? `。${JUDGE_TEXT.missing(verdictMissing(verdict))}` : ''}` : limitOf(verdict) ? `${meta.label}:${JUDGE_TEXT.limitNotJudged}` : `${meta.label}:${meta.hint}` - const challengeTitle = badge?.challenge ? CHALLENGE_TEXT.markTitle(challengeLabel(badge.challenge)) : '' + // 无法判断的句子可能根本没反查成(服务端按规则记的无法判断,反方模型没看过),正文里分不出是哪一种:不说成反方模型的判断 + const challengeTitle = !badge?.challenge ? '' + : badge.challenge === 'inconclusive' ? CHALLENGE_TEXT.markTitleUnsure(challengeLabel(badge.challenge)) + : CHALLENGE_TEXT.markTitle(challengeLabel(badge.challenge)) const look = badge?.challenge ? markLook(badge.challenge) : null const body = ( <> @@ -1030,7 +1091,7 @@ function UnitView({ unit, doc, current, active, panelId, code, tag, badge, ask } {badge && (meta || look) && (