Files
AgentLab/frontend/src/dev/ui-harness.tsx
T
ThearchyHelios e4f8ee5d08 Excel 导入改造期 4:证据下钻——报告里引用上传表格的数,点开能看到它来自原表格的哪一格;裁判核对时看得到来源、口径、接受理由和区域外文字
推断的来源(新 engine/direct_select、data/provenance、data/provenance_db;api/evidence 新增推断来源接口)
- 只对直接引用一列的查询下钻:受限文法用和执行时相同的 SQLite 分词读法,别名互换、自连接、表达式、聚合、子查询、集合运算(含藏在注释、字符串、方括号、转义、BOM 之后的)一律只给表级来历;再用 EXPLAIN 字节码和授权回调兜底
- 结果带齐主键、值非空,按主键参数化回查只读快照、类型和值严格一致才给格子;不一致时整份重算库哈希,哈希不符标红
- 从导入清单和溯源找回格子:宽表、交叉表逆透视的长表(日期取自表头格、年份取自统计期、行标签、分段标题)、列表、合计表、按期累积的并集(换算到所属那一期);原文与规范写法不同时一并列出
- 清单读不到、登记哈希与清单不一致、快照已回收、遮罩列,都只给表级来历或不给,写明原因;原件已清除、接受已作废照实显示;未封存的运行照常推断并标明
- 相关核对:这一行、这一期的核对结论与接受理由

裁判摘录(engine/judge)
- 带期 4 标记的报告,上传表格的查询旁加来源行、口径行、接受理由、可见单元格里的区域外文字和人工录入的统计期;限定语写明这些数未经系统核对,长度有上限、截断时写明
- 隐藏行列里的区域外文字不送;设了遮罩的源只写条数

前端证据面板(run/EvidenceProvenance;ManifestBody 从版本页抽出复用)
- 「推断的来源」一节与已封存的证据分开标注:格子坐标、取自哪些格、年份来源、规范写法、回查、相关核对、数据版本与各期;标红与拒绝原因按状态显示

不变的部分
- 文档顶层加 provenance 标记,只有新报告走新路径;期 4 之前的运行、非上传源、手工源的面板、复核、裁判摘录逐字不变,由金样测试钉住
- 执行器给区域外文字记录是否在隐藏行列;不建「导入校验」系统表(D6)
2026-10-02 14:38:10 +08:00

762 lines
42 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { useEffect, useState } from 'react'
import type { ReactNode } from 'react'
import { createRoot } from 'react-dom/client'
import { BrowserRouter } from 'react-router-dom'
import { Database, Inbox, Plus, Trash2, RefreshCw } from 'lucide-react'
import {
DeleteButton, EmptyState, ErrorState, Field, HealthPill, IconButton, Kbd, Modal, Notice, OfflineBanner, PageHeader,
SectionBar, Skeleton, StatusBadge, StatusPill, Tabs, TabPanel, ToastHost, confirmDialog, deferDelete,
promptDialog, toast, useRadioGroup, withoutDeferred,
} from '../components/ui'
import { ReceiptSummary } from '../pages/import/ReceiptBlocks'
import { ApiError, api, streamCopilot } from '../api/client'
import { useCatalog, useDatasources, useOnReconnect } from '../store/catalog'
import { STATUS } from '../lib/status'
import { formatClock, formatCost, formatDateTime, formatDuration, formatTime, formatTokens } from '../lib/format'
import * as format from '../lib/format'
import * as status from '../lib/status'
import * as keys from '../lib/keys'
import * as terms from '../lib/terms'
import * as errors from '../lib/errors'
import * as explain from '../lib/explain'
import * as health from '../lib/health'
import * as actor from '../lib/actor'
import * as validation from '../lib/validation'
import * as evidence from '../lib/evidence'
import { EvidenceDoc, EvidenceField } from '../run/EvidenceDoc'
import { Markdown } from '../run/Markdown'
import evidenceFixture from '../run/__tests__/evidence-doc.json'
import evidenceQuery from '../run/__tests__/evidence-query.json'
import evidenceEntity from '../run/__tests__/evidence-entity.json'
import evidenceJudge from '../run/__tests__/evidence-judge.json'
import evidenceVerdict from '../run/__tests__/evidence-verdict.json'
import evidenceProvenance from '../run/__tests__/evidence-provenance.json'
import { EvidenceGuessView } from '../run/EvidenceGuess'
import { IssuanceBanner } from '../run/AssistantStream'
import mdPinned from '../run/__tests__/markdown-pinned.json'
import type { EvidenceDocData, EvidenceGraph, TrialReceipt } from '../types'
import '../index.css'
/**
* 基础组件的离线预览(ui.tsx)。
*
* 只有 dev server 会加载(vite build 的 input 只有 index.html),不进生产包。
* 存在的理由:弹窗的焦点管理、Esc 的输入法判断、toast 的寿命这些东西,在真实
* 页面里要凑齐场景才看得到;这里每样都摆出来,亮暗两套主题一键切换。
*
* 打开 http://localhost:5273/ui-harness.html
*
* window.__ui 和各个按钮的 id 是检查脚本在用的,改名要一起改。
*/
const ALL_STATUS = Object.keys(STATUS)
function Block({ title, children }: { title: string; children: ReactNode }) {
return (
<section className="rounded-xl border bg-panel p-4" data-block={title}>
<h3 className="mb-3 text-[11px] font-semibold uppercase tracking-wide text-faint">{title}</h3>
{children}
</section>
)
}
function DirtyModalDemo() {
const [open, setOpen] = useState(false)
const [text, setText] = useState('')
return (
<>
<button className="btn btn-sm" id="open-dirty" onClick={() => setOpen(true)}>打开编辑弹窗</button>
<Modal
open={open}
onClose={() => { setOpen(false); setText('') }}
title="编辑 Skill"
dirty={text.trim() !== ''}
footer={
<>
<button className="btn" onClick={() => { setOpen(false); setText('') }}>取消</button>
<button className="btn btn-primary" onClick={() => { setOpen(false); setText(''); toast.ok('已保存') }}>保存</button>
</>
}
>
<div className="flex flex-col gap-3">
<Field label="名称" hint="小写英文、数字和下划线" required>
{(p) => <input className="field" {...p} placeholder="sales_report" />}
</Field>
<Field label="指令" hint="填了内容再按 Esc 或点遮罩,会先问一句">
{(p) => (
<textarea className="field" rows={4} {...p} value={text} onChange={(e) => setText(e.target.value)} />
)}
</Field>
</div>
</Modal>
</>
)
}
/**
* 页面自己拉的列表:断开期间拿到 [],恢复后靠 useOnReconnect 重拉。
* 运行记录、数据源、会话这些页面都是这个形状。
*/
function LocalListDemo() {
const [runs, setRuns] = useState<{ id: string }[] | null>(null)
const [loads, setLoads] = useState(0)
const load = () => {
setLoads((n) => n + 1)
void api.runs.list({ limit: 3 }).catch(() => []).then(setRuns)
}
useEffect(load, [])
useOnReconnect(load)
return (
<div className="text-xs text-dim">
<div className="flex items-center gap-2">
<span>
页面自己的列表:拉取 <span id="local-list-loads" className="mono">{loads}</span> 次 · 当前{' '}
<span id="local-list-count" className="mono">{runs?.length ?? '—'}</span> 条
</span>
<button className="btn btn-sm ml-auto" id="local-list-reload" onClick={load}>重新拉取</button>
</div>
{runs && !runs.length && <EmptyState title="还没有运行记录" className="py-4" />}
</div>
)
}
const DEMO_ROWS = [
{ id: 'orders', name: 'orders' }, { id: 'sales_daily', name: 'sales_daily' }, { id: 'hr_attendance', name: 'hr_attendance' },
]
const RADIO = ['service_name', 'sid', 'dsn'] as const
/** 管理页共用件:页头、分节、连通胶囊、单选组、删除后可撤销 */
function ManageKitDemo() {
const [rows, setRows] = useState(DEMO_ROWS)
const [mode, setMode] = useState<(typeof RADIO)[number]>('service_name')
const radio = useRadioGroup(RADIO, mode, setMode)
const [now] = useState(() => Date.now())
const reload = () => setRows(withoutDeferred(DEMO_ROWS, '/api/__harness__/rows'))
return (
<div className="flex flex-col gap-3">
<div className="overflow-hidden rounded-lg border" id="page-header-demo">
<PageHeader icon={<Database size={13} />} title="数据" subtitle="接入的数据库和传上来的表格" actions={<button className="btn btn-sm">刷新</button>} />
</div>
<SectionBar title="数据库" hint="接入后助手编排时看得见这些库的结构">
<button className="btn btn-sm btn-primary"><Plus size={12} /> 接入数据库</button>
</SectionBar>
<div className="flex flex-wrap items-center gap-x-4 gap-y-2" id="health-demo">
<HealthPill />
<HealthPill checkingSince={now - 1200} />
<HealthPill record={{ ok: true, ms: 42, at: now - 3 * 60_000 }} />
<HealthPill record={{ ok: false, at: now - 60 * 60_000, error: '连不上:端口没开' }} />
<HealthPill record={{ ok: true, ms: 380, at: 0 }} stale />
<HealthPill record={{ ok: false, at: 0, error: '连不上:认证没通过' }} />
</div>
<div role="radiogroup" aria-label="连接方式" className="flex gap-1" id="radio-demo">
{RADIO.map((v) => (
<button key={v} type="button" className={v === mode ? 'btn btn-sm btn-primary' : 'btn btn-sm'} {...radio(v)} onClick={() => setMode(v)}>
{v}
</button>
))}
</div>
<ul className="flex flex-col gap-1 text-xs" id="defer-demo">
{rows.map((r) => (
<li key={r.id} className="flex items-center gap-2" data-row={r.id}>
<span className="mono flex-1">{r.name}</span>
<DeleteButton
label={`删除 ${r.name}`}
onClick={() => deferDelete({
what: `「${r.name}」`,
url: `/api/__harness__/rows/${r.id}`,
hide: () => setRows((l) => l.filter((x) => x.id !== r.id)),
restore: reload,
commit: () => Promise.resolve(),
})}
/>
</li>
))}
</ul>
<button className="btn btn-sm self-start" id="defer-reload" onClick={reload}>重拉列表</button>
</div>
)
}
/**
* useDatasources 的挂载探针:检查脚本用 window.__ui.mountDatasources(n) 同时挂 n 个消费方,
* 数请求看「过期才拉、多处挂载只拉一次、启动落定后补拉」
*/
let setDatasourceConsumers: (n: number) => void = () => {}
function DatasourceConsumer() {
const { list, state } = useDatasources()
return <span data-ds-consumer={state}>{list.length}</span>
}
function DatasourceConsumers() {
const [n, setN] = useState(0)
useEffect(() => { setDatasourceConsumers = setN }, [])
return <div hidden data-ds-consumers={n}>{Array.from({ length: n }, (_, i) => <DatasourceConsumer key={i} />)}</div>
}
const EV_DOC = evidenceFixture.doc as unknown as EvidenceDocData
/** 第二期:查询单元格、整表、口径卡来源(evidence-query.json,compose_doc 真跑出来的) */
const EV_QUERY = evidenceQuery.doc as unknown as EvidenceDocData
const EV_LEGACY = evidenceFixture.legacy
/** 第三期:表名字段名、可疑实体、核对不了的名字、逐字引文(evidence-entity.json,compose_doc 真跑出来的) */
const EV_ENTITY = evidenceEntity.doc as unknown as EvidenceDocData
/** 第四期:结论句裁判。正式运行节点里判好的(inline)、探索运行按需判的(on_demand)、没开裁判的探索运行 */
const EV_JUDGE = evidenceJudge.formal.doc as unknown as EvidenceDocData
const EV_JUDGE_EXPLORE = evidenceJudge.explore.doc as unknown as EvidenceDocData
const EV_JUDGE_PLAIN = evidenceJudge.plain.doc as unknown as EvidenceDocData
/**
* 裁判拆档(JR):证据相矛盾、证据不足(写明缺什么)、讲方法的句子(只挂表名字段名和整份查询)、裁判模型和写作
* 模型相同、模型不在价格表里。探索运行那份的证据图里带着一条拆档之前留下的「证据不支持」(evidence-verdict.json)
*/
const EV_VERDICT = evidenceVerdict.formal.doc as unknown as EvidenceDocData
const EV_VERDICT_EXPLORE = evidenceVerdict.explore.doc as unknown as EvidenceDocData
/**
* Excel 导入期 4:上传表格的单元格追到原表格子(evidence-provenance.json)。文档由 compose_doc 真跑、带文档标记;
* 片段接口、推断来源接口、导入清单的工件都由 check-evidence 用 page.route 伪造(按 runId 认出这一份夹具)
*/
const EV_PROVENANCE = evidenceProvenance.doc as unknown as EvidenceDocData
/** 同一份旧契约的出具,去掉位置:老运行就是这样,只能按字符串标 */
const LEGACY_LOOSE = {
matched: EV_LEGACY.matched.map(({ start: _s, end: _e, ...m }) => m),
unmatched_numbers: EV_LEGACY.unmatched.map(({ start: _s, end: _e, ...u }) => u),
}
/**
* 长报告:把夹具的块重复 n 遍(块、句、片段的 id 各自加后缀),stats 和违规清单去掉,
* 计数从片段自己数。用来看块级 content-visibility、超长折叠、跳转进折叠区时自动展开
*/
function longDoc(doc: EvidenceDocData, times: number): EvidenceDocData {
const blocks = Array.from({ length: times }, (_, k) => doc.blocks.map((b) => ({
...b, id: `${b.id}-${k}`,
units: b.units.map((u) => ({ ...u, id: `${u.id}-${k}`, segments: u.segments.map((s) => ({ ...s, id: `${s.id}-${k}` })) })),
}))).flat()
return { ...doc, blocks, stats: undefined, violations: undefined, markdown: undefined }
}
const EV_LONG = longDoc(EV_DOC, 16)
/** 回执块的样例(合成的假数据):三种排除原因里有一种是界面不认识的,要写「其他原因」,不露枚举值 */
const DEMO_RECEIPT: TrialReceipt = {
ledger: [{ sheet: '客流汇总', nonempty_scan: 771, nonempty_read: 771, roles: { value: 771 }, unclaimed: 0 }],
tables: [{ name: '日客流', sheet: '客流汇总', kind: 'data', columns: [], grain: ['日期'], rows: 30 }],
placeholders: { '·': 30 },
canonicalized_total: 17,
outside_text: [{ sheet: '客流汇总', cell: '客流汇总!B3', text: '客流汇总表', kind: 'text' }],
rows_excluded: [
{ sheet: '客流汇总', reason: 'ignored_rows', rows: [[32, 32]], cells: 3, anchor: '补录(人次)', block: '交叉表' },
{ sheet: '客流汇总', reason: 'total_not_kept', rows: [[28, 30]], cells: 93, block: '交叉表' },
{ sheet: '客流汇总', reason: 'mystery_reason', rows: [[40, 41]], cells: 2 },
],
}
/** 期 3 的共用件:提示条 Notice(从导入向导挪进 ui.tsx)、回执块(向导回执和版本页清单视图共用) */
function NoticeKitDemo() {
const [focused, setFocused] = useState('')
return (
<div className="flex flex-col gap-3">
<div className="flex flex-col gap-2" id="notice-demo">
<Notice tone="info" attr={{ 'data-demo-notice': 'info' }}>已应用修复,请重新试运行</Notice>
<Notice tone="warn" attr={{ 'data-demo-notice': 'warn' }}>服务端的同版本数据文件曾被改动,已用本次上传的文件恢复</Notice>
<Notice tone="err" attr={{ 'data-demo-notice': 'err' }} className="mt-1">
导入失败:当前版本未受影响
<div className="text-2xs text-dim" id="notice-detail">细节写在第二行</div>
</Notice>
</div>
<div className="border-t pt-3" id="receipt-demo">
<ReceiptSummary receipt={DEMO_RECEIPT} onFocus={setFocused} />
<div className="mt-1 text-2xs text-faint">定位到:<span id="receipt-focus" className="mono">{focused}</span></div>
</div>
<div className="border-t pt-3" id="receipt-unrecorded">
<ReceiptSummary receipt={{ tables: DEMO_RECEIPT.tables }} />
</div>
</div>
)
}
/**
* 可点击证据的演示:宽栏(侧边面板 / 窄屏时底部抽屉)、360px 窄栏(栏内展开)、旧契约的
* 按位置标记。文档是后端 compose_doc 真跑出来的夹具(evidence-doc.json,只用通用名);
* runId 是假的,片段接口由 check-evidence 用 page.route 伪造,直接打开时面板照实说取不到
*/
function EvidenceDemo() {
return (
<div className="flex flex-col gap-4" id="evidence-demo">
<div id="evidence-wide" className="rounded-lg border p-3">
<EvidenceDoc doc={EV_DOC} artifact={evidenceFixture.doc_artifact} runId={evidenceFixture.run_id} label="周报" tally />
</div>
<div id="evidence-narrow" className="rounded-lg border bg-panel p-2.5" style={{ width: 360, maxWidth: '100%' }}>
<EvidenceDoc doc={EV_DOC} artifact={evidenceFixture.doc_artifact} runId={evidenceFixture.run_id} label="周报" dense tally />
</div>
<div className="grid gap-3 md:grid-cols-2">
<div id="legacy-marks" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">旧契约 · 按位置标(日期里的 15 不画)</div>
<Markdown text={EV_LEGACY.text}
marks={evidence.issuanceMarks({ matched: EV_LEGACY.matched, unmatched_numbers: EV_LEGACY.unmatched })} />
</div>
<div id="legacy-loose" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">老运行 · 没有位置,按字符串标</div>
<Markdown text={EV_LEGACY.text} marks={evidence.issuanceMarks(LEGACY_LOOSE)} />
</div>
</div>
</div>
)
}
/** ?evidence=1:只摆证据演示,360px 宽度的检查和截图不被别的演示撑宽 */
function EvidenceOnly() {
const [theme, setTheme] = useState<'dark' | 'light'>(() => {
const t = new URLSearchParams(location.search).get('theme') === 'light' ? 'light' : 'dark'
document.documentElement.setAttribute('data-theme', t)
return t
})
const flip = (t: 'dark' | 'light') => { setTheme(t); document.documentElement.setAttribute('data-theme', t) }
return (
<div className="h-full overflow-y-auto">
<div className="mx-auto flex max-w-5xl flex-col gap-3 p-4">
<div className="flex items-center gap-2">
<h1 className="text-base font-semibold">可点击证据</h1>
<div className="ml-auto flex gap-1">
<button className="btn btn-sm" id="theme-dark" onClick={() => flip('dark')} aria-pressed={theme === 'dark'}>暗</button>
<button className="btn btn-sm" id="theme-light" onClick={() => flip('light')} aria-pressed={theme === 'light'}>亮</button>
</div>
</div>
<EvidenceDemo />
{/*
第二期:报告直接引用查询单元格、整表,口径卡的输入核对到 agent 字段和查询快照。
片段接口由 check-evidence 用 page.route 伪造(按 runId 认出这一份夹具)
*/}
<div className="flex flex-col gap-4" id="evidence-query-demo">
<div id="evidence-query" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">查询单元格、整表、口径卡来源</div>
<EvidenceDoc doc={EV_QUERY} artifact={evidenceQuery.doc_artifact} runId={evidenceQuery.run_id} label="answer" tally />
</div>
<div id="evidence-query-narrow" className="rounded-lg border bg-panel p-2.5" style={{ width: 360, maxWidth: '100%' }}>
<EvidenceDoc doc={EV_QUERY} artifact={evidenceQuery.doc_artifact} runId={evidenceQuery.run_id} label="answer" dense tally />
</div>
</div>
{/*
第三期:表名字段名(反引号里的、标记的、自动链接的)、可疑实体、核对不了的名字、逐字引文。
片段接口由 check-evidence 用 page.route 伪造(按 runId 认出这一份夹具)
*/}
<div className="flex flex-col gap-4" id="evidence-entity-demo">
<div id="evidence-entity" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">表名字段名、可疑实体、逐字引文</div>
<EvidenceDoc doc={EV_ENTITY} artifact={evidenceEntity.doc_artifact} runId={evidenceEntity.run_id} label="answer" tally />
</div>
<div id="evidence-entity-narrow" className="rounded-lg border bg-panel p-2.5" style={{ width: 360, maxWidth: '100%' }}>
<EvidenceDoc doc={EV_ENTITY} artifact={evidenceEntity.doc_artifact} runId={evidenceEntity.run_id} label="answer" dense tally />
</div>
{/* 没有契约的旧运行:按数值猜的候选(guess_sources 真跑出来的),默认折叠 */}
<div id="evidence-guess" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">旧运行 · 按数值猜的可能来源</div>
<EvidenceGuessView guesses={evidence.guessesOf(evidenceEntity.legacy.graph as unknown as EvidenceGraph)} />
</div>
{/* 出具横幅那一行:数字都有出处,可疑名字、没挂依据的结论句也要写出来,可疑名字也给「定位下一处」 */}
<div id="issuance-line" className="flex flex-col gap-2 rounded-lg border p-3">
{([['suspect', 3, 2, 1], ['clean', 3, 0, 0], ['names', 0, 1, 0]] as const).map(([key, total, suspect, claims]) => (
<div key={key} data-issuance-case={key}>
<IssuanceBanner
issuance={{ tier: 'degraded', matched_numbers: 3, metrics_checked: 2,
...(claims ? { claims: { policy: 'require_citation', uncited_claims: claims } } : {}) }}
evidence={{
counts: { total, cited: total, none: 0, other: 0, hidden: 0, structural: 0, noSegment: 0, suspect, unverified: 0 },
onNext: () => { const w = window as any; w.__issuanceNext = (w.__issuanceNext ?? 0) + 1 },
}} />
</div>
))}
</div>
</div>
{/*
第四期:结论句裁判。片段接口、按需裁判接口由 check-evidence 用 page.route 伪造(按 runId 认出夹具)。
探索运行没开裁判的那份不给运行类别:面板按运行 id 取一次
*/}
<div className="flex flex-col gap-4" id="evidence-judge-demo">
<div id="evidence-judge" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">正式运行 · 节点里当场判的结论句(进封存)</div>
<EvidenceDoc doc={EV_JUDGE} artifact={evidenceJudge.formal.doc_artifact} runId={evidenceJudge.formal.run_id}
runClass="formal" label="answer" tally />
</div>
<div id="evidence-judge-narrow" className="rounded-lg border bg-panel p-2.5" style={{ width: 360, maxWidth: '100%' }}>
<EvidenceDoc doc={EV_JUDGE} artifact={evidenceJudge.formal.doc_artifact} runId={evidenceJudge.formal.run_id}
runClass="formal" label="answer" dense tally />
</div>
<div id="evidence-judge-explore" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">探索运行 · 按需裁判(点开哪句判哪句,封存后追加)</div>
<EvidenceDoc doc={EV_JUDGE_EXPLORE} artifact={evidenceJudge.explore.doc_artifact} runId={evidenceJudge.explore.run_id}
label="answer" tally />
</div>
<div id="evidence-judge-explore-narrow" className="rounded-lg border bg-panel p-2.5" style={{ width: 360, maxWidth: '100%' }}>
<EvidenceDoc doc={EV_JUDGE_EXPLORE} artifact={evidenceJudge.explore.doc_artifact} runId={evidenceJudge.explore.run_id}
label="answer" dense tally />
</div>
<div id="evidence-judge-plain" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">探索运行 · 没开裁判的报告(照样能点开结论句请模型判断)</div>
<EvidenceDoc doc={EV_JUDGE_PLAIN} artifact={evidenceJudge.plain.doc_artifact} runId={evidenceJudge.plain.run_id}
label="answer" tally />
</div>
{/* 裁判拆档:证据相矛盾、证据不足(缺什么)、讲方法的句子挂的 SQL 和字段清单、裁判模型的两条提醒 */}
<div id="evidence-verdict" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">正式运行 · 证据相矛盾、证据不足、讲方法的句子(裁判模型和写作模型相同,模型不在价格表里)</div>
<EvidenceDoc doc={EV_VERDICT} artifact={evidenceVerdict.formal.doc_artifact} runId={evidenceVerdict.formal.run_id}
runClass="formal" label="answer" tally />
</div>
<div id="evidence-verdict-narrow" className="rounded-lg border bg-panel p-2.5" style={{ width: 360, maxWidth: '100%' }}>
<EvidenceDoc doc={EV_VERDICT} artifact={evidenceVerdict.formal.doc_artifact} runId={evidenceVerdict.formal.run_id}
runClass="formal" label="answer" dense tally />
</div>
<div id="evidence-verdict-explore" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">探索运行 · 按需裁判,证据图里有一条拆档之前的「证据不支持」</div>
<EvidenceDoc doc={EV_VERDICT_EXPLORE} artifact={evidenceVerdict.explore.doc_artifact}
runId={evidenceVerdict.explore.run_id} label="answer" tally />
</div>
{/* 出具横幅那一行多一段结论句:「结论 4 句(支持 1 · 部分支持 1 · 不支持 1 · 未裁判 1)」 */}
<div id="issuance-claims" className="flex flex-col gap-2 rounded-lg border p-3">
{/*
judge-uncited:开了裁判的文档,没挂依据的那句送了裁判、按判定数在「支持 3」里(或预筛放掉了不数),
出具(io.py)照样按没挂依据记 1 句——横幅得另起「没挂依据的结论句 1」,不能被结论句那一段吞掉
*/}
{/*
rework:裁判拆档之后的计数(证据相矛盾、证据不足);insufficient:只有证据不足一种问题,照样给「定位下一处」
*/}
{([
['judged', { total: 4, supported: 1, partial: 1, contradicted: 0, insufficient: 0, unsupported: 1, unjudged: 1, uncited: 0 }, null],
['cited', { total: 4, supported: 3, partial: 0, contradicted: 0, insufficient: 0, unsupported: 0, unjudged: 0, uncited: 1 }, null],
['all', { total: 2, supported: 2, partial: 0, contradicted: 0, insufficient: 0, unsupported: 0, unjudged: 0, uncited: 0 }, null],
['judge-uncited', { total: 3, supported: 3, partial: 0, contradicted: 0, insufficient: 0, unsupported: 0, unjudged: 0, uncited: 0 },
{ policy: 'judge', uncited_claims: 1 }],
['rework', { total: 7, supported: 1, partial: 1, contradicted: 2, insufficient: 1, unsupported: 1, unjudged: 1, uncited: 0 }, null],
['insufficient', { total: 3, supported: 2, partial: 0, contradicted: 0, insufficient: 1, unsupported: 0, unjudged: 0, uncited: 0 }, null],
] as const).map(([key, claims, issued]) => (
<div key={key} data-issuance-case={key}>
<IssuanceBanner
issuance={{ tier: 'degraded', matched_numbers: 3, metrics_checked: 0,
claims: issued ?? { policy: 'require_citation', uncited_claims: claims.uncited } }}
evidence={{
counts: { total: 3, cited: 3, none: 0, other: 0, hidden: 0, structural: 0, noSegment: 0, suspect: 0,
unverified: 0, claims },
onNext: () => { const w = window as any; w.__claimsNext = (w.__claimsNext ?? 0) + 1 },
}} />
</div>
))}
</div>
</div>
{/*
Excel 导入期 4:推断的来源。宽栏一份、360 宽的画布右栏一份(栏内展开,不出横向滚动)
*/}
<div className="flex flex-col gap-4" id="evidence-provenance-demo">
<div id="evidence-provenance" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">上传表格的单元格:数据版本、推断的来源、相关核对</div>
<EvidenceDoc doc={EV_PROVENANCE} artifact={evidenceProvenance.doc_artifact} runId={evidenceProvenance.run_id}
label="answer" tally />
</div>
<div id="evidence-provenance-narrow" className="rounded-lg border bg-panel p-2.5" style={{ width: 360, maxWidth: '100%' }}>
<EvidenceDoc doc={EV_PROVENANCE} artifact={evidenceProvenance.doc_artifact} runId={evidenceProvenance.run_id}
label="answer" dense tally />
</div>
</div>
<div id="evidence-long" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">长报告:{EV_LONG.blocks.length} 块,块级 content-visibility,超过 3000 字先折叠</div>
<EvidenceDoc doc={EV_LONG} label="长报告" tally />
</div>
{/*
成果字段按工件 id 取文档。check-evidence 把这几件工件伪造成:正文这份(能画)、
另一次运行写的(run_id 不同)、没记正文的(缺 markdown)——后两种都得退回普通文本
*/}
<div id="evidence-fields" className="grid gap-3 md:grid-cols-3">
{[['fx-field-ok', '正文这份'], ['fx-field-other-run', '另一次运行写的'], ['fx-field-no-markdown', '没记正文']].map(([id, name]) => (
<div key={id} id={id} className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">成果字段 · {name}</div>
<EvidenceField artifact={id} text={evidenceFixture.output['周报']} runId={evidenceFixture.run_id} dense label="周报" />
</div>
))}
</div>
{/*
没有 _evidence 的旧回答:同一批文字用现在的 Markdown 渲染,check-evidence 拿它和
Markdown.tsx 改动前(HEAD)渲染出来的 outerHTML(markdown-pinned.json)逐字比对
*/}
<div id="md-pinned" className="rounded-lg border p-3">
<div className="mb-1 text-2xs text-faint">旧回答的 Markdown:和改动前逐字比对</div>
{(mdPinned.samples as { id: string; text: string; dense: boolean; marks?: any[] }[]).map((p) => (
<div key={p.id} data-pin={p.id} className="border-t py-2 first:border-t-0">
<Markdown text={p.text} dense={p.dense} marks={p.marks} />
</div>
))}
</div>
</div>
</div>
)
}
function Harness() {
const [theme, setTheme] = useState<'dark' | 'light'>(() => {
// 没有显式主题时会跟随系统;预览要确定是哪一套,开场就钉住
const t = (document.documentElement.getAttribute('data-theme') as 'dark' | 'light') || 'dark'
document.documentElement.setAttribute('data-theme', t)
return t
})
const [tab, setTab] = useState('a')
const [last, setLast] = useState('')
const backend = useCatalog((s) => s.backend)
const flip = (t: 'dark' | 'light') => {
setTheme(t)
document.documentElement.setAttribute('data-theme', t)
}
return (
<div className="flex h-full flex-col">
<OfflineBanner />
<DatasourceConsumers />
<div className="flex-1 overflow-y-auto">
<div className="mx-auto flex max-w-5xl flex-col gap-4 p-6">
<div className="flex items-center gap-2">
<h1 className="text-base font-semibold">基础组件</h1>
<span className="text-xs text-faint">ui.tsx · lib/*</span>
<div className="ml-auto flex gap-1">
<button className="btn btn-sm" id="theme-dark" onClick={() => flip('dark')} aria-pressed={theme === 'dark'}>暗</button>
<button className="btn btn-sm" id="theme-light" onClick={() => flip('light')} aria-pressed={theme === 'light'}>亮</button>
<button
className="btn btn-sm"
id="toggle-offline"
onClick={() => useCatalog.setState(backend === 'down'
? { backend: 'ok', backendError: null, retryAt: null }
: { backend: 'down', backendError: '连不上后端服务(可能没启动或正在重启),稍后重试', retryAt: Date.now() + 8000, lastOkAt: Date.now() - 42_000 })}
>
{backend === 'down' ? '恢复在线' : '模拟离线'}
</button>
</div>
</div>
<Block title="状态徽标 · 彩色">
<div className="flex flex-wrap gap-x-5 gap-y-3" id="badges-color">
{ALL_STATUS.map((s) => (
<div key={s} className="flex w-24 flex-col items-center gap-1.5">
<StatusBadge status={s} size={18} />
<span className="text-[11px] text-dim">{STATUS[s as keyof typeof STATUS].label}</span>
<span className="mono text-[10px] text-faint">{s}</span>
</div>
))}
</div>
</Block>
<Block title="状态徽标 · 灰度(去掉颜色也要认得出)">
<div className="flex flex-wrap gap-x-5 gap-y-3" id="badges-gray" style={{ filter: 'grayscale(1)' }}>
{ALL_STATUS.map((s) => (
<div key={s} className="flex w-24 flex-col items-center gap-1.5">
<StatusBadge status={s} size={18} animate={false} />
<span className="text-[11px] text-dim">{STATUS[s as keyof typeof STATUS].short}</span>
</div>
))}
</div>
</Block>
<Block title="状态标签 StatusPill">
<div className="flex flex-wrap gap-2">
{ALL_STATUS.map((s) => <StatusPill key={s} status={s} />)}
</div>
<div className="mt-3 flex flex-wrap items-center gap-3 text-xs text-dim">
<span>后端 interrupted:</span>
<StatusPill status="interrupted" pendingApproval />
<StatusPill status="interrupted" pendingApproval={false} />
<span className="ml-4">plain:</span>
<StatusPill status="succeeded" plain />
<StatusPill status="failed" plain />
</div>
</Block>
<div className="grid grid-cols-2 gap-4">
<Block title="弹窗 Modal · confirm · prompt">
<div className="flex flex-wrap gap-2">
<DirtyModalDemo />
<button
className="btn btn-sm"
id="open-confirm"
onClick={async () => setLast(String(await confirmDialog({
title: '发布这个版本?', body: '发布后可以发起正式运行。', confirmLabel: '发布 v4',
})))}
>确认框</button>
<button
className="btn btn-sm btn-danger"
id="open-danger"
onClick={async () => setLast(String(await confirmDialog({
title: '删除工作流「⑥ 多 Agent 协作」?',
consequences: ['连同 4 条运行记录一起删除', '不可恢复'],
confirmLabel: '删除工作流和 4 条记录',
danger: true,
})))}
>危险确认</button>
<button
className="btn btn-sm btn-danger"
id="open-require"
onClick={async () => setLast(String(await confirmDialog({
title: '删除封存过的正式运行?',
body: '这条运行的清单封存过,是审计凭证。',
consequences: ['事件流、产出物、封存哈希一起删除', '之后无法再核对'],
confirmLabel: '删除凭证',
danger: true,
requireText: 'a3f9c2',
})))}
>照抄确认</button>
<button
className="btn btn-sm"
id="open-prompt"
onClick={async () => setLast(JSON.stringify(await promptDialog({
title: '新建工作流', label: '名称', initial: '未命名工作流 09-26 10:05', confirmLabel: '新建',
validate: (v) => (v === '新工作流' ? '已经有一个同名的了' : null),
})))}
>输入框</button>
</div>
<div className="mt-2 text-[11px] text-faint">结果:<span id="dialog-result" className="mono text-dim">{last || '—'}</span></div>
</Block>
<Block title="提示 toast">
<div className="flex flex-wrap gap-2">
<button className="btn btn-sm" onClick={() => toast('已复制到剪贴板')}>普通</button>
<button className="btn btn-sm" onClick={() => toast.ok('已保存')}>成功</button>
<button className="btn btn-sm" onClick={() => toast.warn('这张图有 2 条警告')}>警告</button>
<button className="btn btn-sm" id="toast-error" onClick={() => toast.error('保存失败:工作流名称不能为空')}>出错</button>
<button
className="btn btn-sm"
id="toast-network"
onClick={() => toast.error(new ApiError(0, '连不上后端服务(可能没启动或正在重启),稍后重试',
{ kind: 'network', raw: 'TypeError: Failed to fetch' }))}
>网络断</button>
<button
className="btn btn-sm"
onClick={() => toast.ok('已提取为草稿「⑥ 多 Agent 协作 · 提取模板」', {
action: { label: '去画布打开', onClick: () => toast('(这里会跳到画布)') },
})}
>带动作</button>
<button
className="btn btn-sm"
onClick={() => toast('已删除会话「本周销量」', 'info', {
action: { label: '撤销', onClick: () => toast.ok('已恢复') }, duration: 5000,
})}
>撤销</button>
<button className="btn btn-sm" onClick={() => { for (let i = 0; i < 6; i++) toast(`第 ${i + 1} 条`) }}>叠 6 条</button>
<button className="btn btn-sm" onClick={() => toast.dismiss()}>全部关掉</button>
</div>
</Block>
</div>
<div className="grid grid-cols-2 gap-4">
<Block title="空态 EmptyState(模拟离线时会变)">
<EmptyState
icon={<Inbox size={22} />}
title="还没有工作流"
body="新建一张空白工作流,或者让助手按一句话画出来。"
action={<button className="btn btn-sm btn-primary"><Plus size={12} /> 新建工作流</button>}
/>
<EmptyState title="没有匹配的工具" offline={false} className="py-4" />
<div id="empty-source-demo" className="border-t">
<EmptyState
source="workflows"
title="还没有工作流"
className="py-4"
action={<button className="btn btn-sm btn-primary" id="empty-source-action"><Plus size={12} /> 新建</button>}
/>
</div>
</Block>
<Block title="出错 ErrorState">
<ErrorState
error={new ApiError(0, '连不上后端服务(可能没启动或正在重启),稍后重试', { kind: 'network', raw: 'TypeError: Failed to fetch' })}
onRetry={() => toast('重试')}
className="py-4"
/>
<ErrorState
compact
error={'2 validation errors for GraphSpec\nnodes.1.type\n Input should be \'input\', \'output\' … [type=literal_error]'}
/>
<ErrorState
compact
className="mt-2"
error={new ApiError(409, '这条运行还在跑,先停止再删除。', { raw: '409 {"detail":"这条运行还在跑,先停止再删除。"}' })}
/>
</Block>
</div>
<div className="grid grid-cols-2 gap-4">
<Block title="加载 Skeleton">
<Skeleton rows={4} />
<Skeleton rows={2} cols={3} height={44} className="mt-4" />
<div className="mt-4 border-t pt-3"><LocalListDemo /></div>
</Block>
<Block title="图标按钮 · 键帽 · 格式">
<div className="flex items-center gap-2">
<IconButton label="删除这条记录" icon={<Trash2 size={13} />} variant="danger" />
<IconButton label="刷新列表" shortcut="Mod+R" icon={<RefreshCw size={13} />} />
<Kbd combo="Mod+K" />
<Kbd combo="Mod+Enter" />
<Kbd combo="Alt+V" />
<Kbd combo="Shift+?" />
<Kbd combo="Esc" />
</div>
<dl className="mt-3 grid grid-cols-[auto_1fr] gap-x-3 gap-y-1 text-xs tabular-nums">
<dt className="text-faint">耗时</dt>
<dd>{[820, 7600, 59_960, 74_000, 119_600, 3_720_000].map(formatDuration).join(' · ')}</dd>
<dt className="text-faint">计时</dt>
<dd className="mono">{[7_630, 74_310, 3_723_400].map(formatClock).join(' · ')}</dd>
<dt className="text-faint">tokens</dt>
<dd>{formatTokens(56034)} · {formatTokens(56034, { compact: true })} · {formatTokens(null)}</dd>
<dt className="text-faint">成本</dt>
<dd>{[0.0312, 0.0004, 0, 1.2345].map(formatCost).join(' · ')}</dd>
<dt className="text-faint">时间</dt>
<dd title={formatDateTime('2026-09-26T01:11:19.891698')}>
{formatTime('2026-09-26T01:11:19.891698')} · {formatTime('2026-09-25T04:52:00Z')} · {formatDateTime('2026-09-26T01:11:19.891698')}
</dd>
</dl>
</Block>
</div>
<Block title="管理页共用件">
<ManageKitDemo />
</Block>
<Block title="提示条 Notice · 回执块">
<NoticeKitDemo />
</Block>
<Block title="可点击证据 EvidenceDoc(单独看:?evidence=1)">
<EvidenceDemo />
</Block>
<Block title="标签页 Tabs · 表单字段 Field">
<Tabs
label="示例标签"
idPrefix="demo"
tabs={[{ key: 'a', label: '模型接入' }, { key: 'b', label: '数据源', badge: 2 }, { key: 'c', label: '偏好' }]}
active={tab}
onChange={setTab}
/>
<TabPanel idPrefix="demo" tabKey={tab} className="grid grid-cols-2 gap-3 pt-3">
<Field label="Base URL" htmlFor="demo-url" hint="OpenAI 兼容端点,以 /v1 结尾" required>
<input id="demo-url" className="field" aria-describedby="demo-url-hint" placeholder="https://…/v1" />
</Field>
<Field label="标识" error="只能用小写英文、数字和下划线,并以字母开头">
{(p) => <input className="field" defaultValue="Sales-DB" {...p} style={{ borderColor: 'var(--err)' }} />}
</Field>
</TabPanel>
</Block>
</div>
</div>
</div>
)
}
;(window as any).__ui = {
toast, confirmDialog, promptDialog, useCatalog, ApiError, api, streamCopilot,
mountDatasources: (n: number) => setDatasourceConsumers(n),
// 检查脚本直接拿应用同一份模块实例测 lib:instanceof ApiError 才靠得住
lib: { format, status, keys, terms, errors, explain, health, actor, validation, evidence },
evidenceFixture,
evidenceQuery,
evidenceEntity,
evidenceJudge,
evidenceVerdict,
}
createRoot(document.getElementById('root')!).render(
<BrowserRouter>
<ToastHost>
{new URLSearchParams(location.search).get('evidence') === '1' ? <EvidenceOnly /> : <Harness />}
</ToastHost>
</BrowserRouter>,
)