可点击证据第三期:表名字段名和引文也点得开、可疑实体与结论句、受管门禁 G1–G5、证据审计导出

一、表结构、实体与引文

- 数据源工具查库时顺带存一份表结构快照(schema_snapshot),和查询快照一起进台账、进封存;
  台账里的查询记下 SQL 用到的表
- 报告里的表名、字段名可以点:反引号里的名字一律核对,正文里的裸名字只在明显是标识符时才自动链接,
  常见英文单词不链接;点开看到它出现在哪次查询、类型、所属的表,快照被截断时写明
- 找不到的名字标成可疑实体:在快照、SQL、结果列里都没有的记「可能是编造的名字」并给出最接近的 3 个;
  快照被截断、核对不了的记「核对不了」,不冤枉成编造
- 检索引文 [[q:K1|原文]]:原文在检索快照的命中片段里逐字出现(空白归一化后)才算有出处,点开高亮原文位置
- 自动链接的名字不算句子的引用,只有写作者写的引用才算

二、结论句与出具

- 报告节点新增 claims:off(默认,保持原样)或 require_citation(没有引用的结论句计入缺口)
- 受管级别的正式运行里,可疑实体和没有引用的结论句按「有缺口」降档,不拦截;探索运行和已发布级别只标注
- 契约的 claims 和报告节点的设置取更严的那个;受管正式运行里写 ignore 也按降档处理,并给出警告
- 出具横幅除了数字,也写出可疑实体和没有引用的结论句

三、受管门禁 G1–G5(只看图和配置)

- G1 带契约的出口,成果字段的文字只能来自报告撰写节点
- G2 模型写的文字不绕过报告撰写节点直接流进出口
- G3 报告撰写节点写明 numbers: strict、on_violation: fail、claims: require_citation
- G4 口径卡的输入不来自计算角色的沙箱代码
- G5 给口径卡供数的 agent 配 output_schema 并开 cite_fields
- 受管级别是错误、挡住发布;已发布级别只给警告;已经发布的版本照常运行,下次发布时按新规则检查
- 每条规则都接进发布前自动修复(一键修复 / 给选项 / 交给 Copilot);禁止的改动补上关 cite_fields、
  删 output_schema、放宽契约 claims;Copilot 兜底不许自己把代码节点标成 source、不许放宽报告节点
- 发布弹窗里选「交给 Copilot」时明确写「正在交给 Copilot」

四、旧运行与审计

- 没有契约的旧答案:数字和已封存的查询单元格、口径卡值按数值比对,每个数最多 3 个候选,
  默认折叠,写明「猜测的来源,不能当证据」
- 有契约的旧运行:候选只从已封存的口径卡里找,人为插进工件表的行不当证据
- 证据审计:GET /api/runs/{id}/evidence/audit 按「无证据 / 可疑实体 / 有出处 / 旧运行猜测」分组,
  可导出 JSON 和 CSV(带封存状态);记录页和画布上的报告节点显示「有出处 N · 无证据 M」

五、SQL 守卫修正(安全)

- 去注释改成单遍扫描,认得字符串和各方言的引号(单引号转义、MySQL 反斜杠与 #、PostgreSQL 的 $$ 与嵌套注释、
  Oracle 的 q'[…]'、SQLite 的方括号);以前字符串里的 -- 会被当成注释,SELECT '--'; DROP … 这类写法能骗过多语句拦截
- 看不到服务器设置时每种读法都扫一遍,读法之间切分不一致就拒绝,任何一种读法是写操作就按写操作处理
- 执行查询和工具危险判定都按数据源的方言检查

六、其他

- 修掉检查脚本里画布检查的一处竞态,并行估时按实测更新
This commit is contained in:
ThearchyHelios
2026-09-29 05:26:34 +08:00
parent fcdcc30d4e
commit d071bf119f
65 changed files with 15316 additions and 378 deletions
+39 -1
View File
@@ -26,8 +26,11 @@ 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 { EvidenceGuessView } from '../run/EvidenceGuess'
import { IssuanceBanner } from '../run/AssistantStream'
import mdPinned from '../run/__tests__/markdown-pinned.json'
import type { EvidenceDocData } from '../types'
import type { EvidenceDocData, EvidenceGraph } from '../types'
import '../index.css'
/**
@@ -189,6 +192,8 @@ 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
/** 同一份旧契约的出具,去掉位置:老运行就是这样,只能按字符串标 */
const LEGACY_LOOSE = {
matched: EV_LEGACY.matched.map(({ start: _s, end: _e, ...m }) => m),
@@ -269,6 +274,38 @@ function EvidenceOnly() {
<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>
<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 />
@@ -561,6 +598,7 @@ function Harness() {
lib: { format, status, keys, terms, errors, explain, health, actor, validation, evidence },
evidenceFixture,
evidenceQuery,
evidenceEntity,
}
createRoot(document.getElementById('root')!).render(