可点击证据第一期:报告里的每个数字都点得开出处

「引用即渲染」:写报告的模型只写引用标记([[m:指标id]]、[[i:输入字段]]、[[see:…]]),数值由系统按口径卡
填进去,每个数字都挂着一条能复算的证据链。本期是数字层闭环;实体、结论句的概率性证据放在后续几期。

内核(engine/evidence.py,口径卡、出具契约、表达式等)
- 口径卡记录每个指标的来源:原式、代入式(每个输入写成「值 ← 路径」)、复算结果、口径与版本
- 出具契约的数值匹配改为按位置标注;同一个值有几个出处时记为「出处不唯一」并列出候选,不再随便挑一个
- 证据 id 由内容派生,事后对不上就是被改过;零值、结构性数字(列表序号、代码块标签)单独处理
- 口径卡新增 on_missing:缺输入时默认仍是整个节点失败,可以改成记为空值、交给契约判档

报告撰写节点(report)与引用模式的出具契约
- 流式生成时 token 里就是真实数字,不会漏出原始标记;裸数字、不存在的引用当场判违规,交回去重写
  (max_repairs,默认 1 次);仍不过时按 on_violation 失败(正式运行默认)或把违规标在报告里(探索运行默认)
- report.checked 事件记下核对结果,落在封存范围内;fail 模式下仍不过时带 failed,运行记录里画成失败
- 出具契约写了 report_from 就按引用核对:取回文档时复验哈希,独立重算一遍,全部带引用才判完整出具
- 成果字段逐字等于报告正文时标注 _evidence;复核只能加说明,不能改写带证据的答案(前后端各拦一道)

证据接口
- GET /api/runs/{id}/evidence 返回证据图;GET …/evidence/segments/{id} 返回一个片段的证据链
- 只认封存范围内的事件能追到的工件,不读 artifacts 表;封存被改过时不把任何一项标成已封存
- 没有报告的旧运行降级为 none 或 legacy_contract

界面
- EvidenceDoc 按块、句、片段渲染报告,片段是和正文一样的按钮;整份报告只占一个 Tab 位,
  ←/→ 在片段间移动、↑/↓ 按句、n/N 跳到下一处「无证据」、Enter 打开面板、Esc 关闭并把焦点还回去
- EvidencePanel:宽屏侧边、窄屏底部抽屉、360px 画布右栏里栏内展开;显示指标步骤、代入式、复算结果、
  封存状态。正文不是封存的那份报告时明确说出来,不拿别的报告的封存画绿
- 出具横幅多一行「N/N 数字有出处 · 无证据 M」和「定位下一处」;没有 _evidence 的旧回答渲染一字不差
- 画布认得报告撰写节点;Copilot 手册补上口径卡、报告节点、出具契约的写法;新增模板「⑨ 可追溯周报」

验证(沙箱):tsc 干净,生产构建通过,pytest 1601 passed,check-all 16 项检查全绿(新增 check-evidence)。
This commit is contained in:
ThearchyHelios
2026-09-28 11:47:23 +08:00
parent b418c0d951
commit e4f2693918
56 changed files with 12309 additions and 215 deletions
+58
View File
@@ -81,6 +81,7 @@
--nt-human: #ce91e6;
--nt-validate: #ebb1fd;
--nt-metrics: #cbaddb;
--nt-report: #a9b0ec;
/* 检索通路的分类色:只说「这一分是哪一路检索贡献的」,不表示状态,所以
不借 accent / ok / warn。两色按 dataviz 校验过:色觉异常下也分得开,
@@ -138,6 +139,7 @@
--nt-human: #6f3d81;
--nt-validate: #885398;
--nt-metrics: #6e557b;
--nt-report: #4f5694;
--via-semantic: #0a7ea4;
--via-keyword: #c2447a;
}
@@ -193,6 +195,7 @@
--nt-human: #6f3d81;
--nt-validate: #885398;
--nt-metrics: #6e557b;
--nt-report: #4f5694;
--via-semantic: #0a7ea4;
--via-keyword: #c2447a;
}
@@ -399,6 +402,7 @@
.nt-transform { --nt: var(--nt-transform); }
.nt-subgraph { --nt: var(--nt-subgraph); }
.nt-metrics { --nt: var(--nt-metrics); }
.nt-report { --nt: var(--nt-report); }
/* --------------------------------------------------------------------------
React Flow 覆盖
@@ -1562,6 +1566,55 @@
animation: sheet-in var(--dur-base) var(--ease-out);
}
/* --------------------------------------------------------------------------
可点击证据(run/EvidenceDoc)。报告里有出处、没出处的片段是原生 button,外观
和正文一样;状态靠下划线的线型和颜色,外观数据在 lib/evidence.ts(颜色、淡底
由组件写成 --ev-line / --ev-soft),这里只管线型和交互态。
不画整句下划线:一份报告满屏都是线就什么都看不出来了。
-------------------------------------------------------------------------- */
.ev-seg {
display: inline;
margin: 0;
padding: 0;
border: 0;
border-radius: 2px;
background: none;
font: inherit;
color: inherit;
letter-spacing: inherit;
line-height: inherit;
text-align: inherit;
white-space: inherit;
cursor: pointer;
text-decoration-line: underline;
text-decoration-color: var(--ev-line, currentColor);
text-decoration-thickness: 1px;
text-underline-offset: 3px;
-webkit-box-decoration-break: clone;
box-decoration-break: clone;
}
.ev-seg[data-ev-line="solid"] { text-decoration-style: solid; }
/* 点状线比实线细碎,同样 1px 在小字号下几乎看不见 */
.ev-seg[data-ev-line="dotted"] { text-decoration-style: dotted; text-decoration-thickness: 1.5px; }
.ev-seg:hover,
.ev-seg[aria-expanded="true"] { background: var(--ev-soft, transparent); }
.ev-seg:focus-visible,
.ev-seg[data-flash] {
outline: 2px solid var(--accent);
outline-offset: 1px;
}
/* 句末的「无证据」小标签:字形加文字,去掉颜色也读得出 */
.ev-tag {
margin: 0 3px;
font-size: 10px;
line-height: 1;
white-space: nowrap;
vertical-align: 1px;
color: var(--st-waiting);
}
.ev-panel-side { animation: sheet-in var(--dur-base) var(--ease-out); }
.ev-panel-rise { animation: fade-up var(--dur-base) var(--ease-out); }
/* 例句卡片依次入场。--i 是序号,错开 40ms 就够读出"一条条出现",
再多就开始等 */
@keyframes rise-in {
@@ -1649,6 +1702,11 @@
.nc-tenth {
display: none;
}
/* 证据面板直接出现,不滑入:滑入停在 0.01ms 的最后一帧虽然看不出来,但它仍然是一段动画 */
.ev-panel-side,
.ev-panel-rise {
animation: none !important;
}
}
/* --------------------------------------------------------------------------