可点击证据第二期:取数链路打通、问数据的答案逐段可点;发布前自动修复

一、可点击证据第二期

取数链路
- 智能体、工具节点、代码节点、知识检索取数时都记进证据台账;报告目录按台账编出 Q1… / K1…
- 报告可以引用快照里的一格([[v:Q1.r0.gmv]]),也可以由系统从快照生成整张表([[table:Q1 cols=… rows=0-4]]),
  表里每一格都是可点的片段;取值一律以快照为准,取回快照时复验哈希
- 口径卡表达式新增 cell(x, row, column),lineage 精确到单元格
- 智能体开 cite_fields(配合 output_schema)后,循环结束做一次结构化抽取,每个字段标出取自哪次查询的哪一格,
  再到快照里核对:一致记 verified;不一致以快照为准并告警;查不到的记为空值,永远不兜底成 0
- 代码节点新增 evidence_role(source / compute)和 code_sha;沙箱算出来的数不能被报告直接引用,要进口径卡
- 查询快照记下列类型,文本列按文本渲染(年份 "2026" 不再显示成「2,026」)
- 升级前发起的运行(停在审批上的)一律走旧逻辑:新的 task 只追加在循环之后,恢复时不会错号

证据接口与面板
- 片段链接上查询步骤:SQL、被引用的行加前后各 2 行、高亮到格;数据源可设 mask_columns 遮罩列,
  遮罩在查询时记进快照,数据源事后改名或删除也照样遮罩(在有身份体系之前,遮罩只减少暴露,不是安全边界)
- 输入来源写明核对结果(与快照一致 / 模型报的值和快照不一致 / 没查到记为空);口径卡缺输入时也给出完整的链
- 受管出具要在契约里声明 cells 才能引用单元格;受管与否记在所钉版本上,改画布不再让受管版本的正式运行降级
- 口径卡可以用 caliber_from 钉住另一个已发布工作流里的口径卡,上游有新版本时按 upgrade_policy 处置,
  和子工作流同一套规则;子工作流节点也补上了升版处置的配置项

Copilot、校验与报错
- 问数据的答案里有数字时,搭 input → 智能体 → 报告 → 出口,报告直接引用查过的单元格
- 写 SQL 前核对数据源的表结构,SQL 里出现表结构里没有的列会被打回
- 不再搭「智能体文字 → 转换节点解析 JSON」这种图;转换节点的 JSON 报错分清是上游模型写坏了、
  模板里裸插了模型文字(给出 | json 的改法),还是模板本身写错了
- 工具节点遇到「查询失败」「SQL 被拒绝」判为失败;发起运行前检查绑定的工具是否存在,不存在时直接拒绝并给出入口

二、发布前自动修复

- 问题带上机器编号(code)和修复 id;新增只读接口 POST /api/workflows/{id}/publish-check 和 /autofix
- 修复分三类:答案唯一、不降低要求的一键修复;要人拿主意的给选项(不替人选);结构性问题交给 Copilot
- 一律先预览,不自动保存、不自动发布;删节点、删契约、放宽审批、关掉 strict、改级别等降低要求的改动一律拒绝,
  Copilot 的方案也要过这一关;应用后重跑检查,错误必须变少且不能冒出新的
- 发布弹窗打开就先检查;问题面板新增「发布前检查」,平时就能看到、就地修掉
- 门禁修正:契约有 report_from 时不再要求 narrative(模板⑨可以发成受管);全图默认审批为「全部放行」时同样拦下
- 修掉画布保存会抹掉全图默认(defaults)的老问题:以前任何一次保存都会把它清空,审批 always 因此被悄悄放宽

验证(沙箱):tsc 干净,生产构建通过,pytest 2268 passed(两遍),check-all 17 项检查、3915 项全过
(新增 check-publish);关键行为做了变异验证、全部抓到。
This commit is contained in:
ThearchyHelios
2026-09-28 21:20:04 +08:00
parent 62aac187d8
commit fcdcc30d4e
74 changed files with 19372 additions and 380 deletions
+23 -2
View File
@@ -4,7 +4,7 @@ import type { CopilotOp, FixKind, RunFinal } from '../run/decode'
import { decodeRun } from '../run/decode'
import { errorMessage, humanizeError, isNetworkError } from '../lib/errors'
import { guardReview, hasEvidence } from '../lib/evidence'
import { explainRunError } from '../lib/explain'
import { explainRunError, explainStartError } from '../lib/explain'
import { parseServerTime } from '../lib/format'
import { useCatalog } from './catalog'
import { useConversations } from './conversations'
@@ -484,6 +484,27 @@ function runFailure(error: string | null | undefined, detail?: string | null): F
const lineOf = (f: Failure) => (f.reason ? `${f.title}:${f.reason}` : f.title)
/**
* 发起运行那一下被拒(POST /runs 的 ApiError)的说明。绑定的工具在本机不存在(422 run_tool_missing)
* 按 lib/explain 讲,带上直达入口(数据源工具去数据页,自定义 / MCP 工具去工具页),和画布上
* 发起被拒(run/RunControl)同一套;这时还没有运行 id,流里的报错块不会再拿原话认一遍,
* 所以入口得在这里就记进 failure。别的照旧按一句报错拆
*/
function startFailure(e: unknown): Failure {
const x = explainStartError(e)
if (!x) return failureOf(e)
return {
title: x.title,
reason: x.reason,
hint: x.action,
detail: x.raw && x.raw !== x.title ? x.raw : undefined,
continuable: false,
...(x.fix ? { fix: x.fix } : {}),
...(x.fixTo ? { fixTo: x.fixTo } : {}),
...(e instanceof ApiError ? { source: e.message } : {}),
}
}
/** 运行记录被删了:没有断点可续,也补不回完整答案 */
const GONE: Failure = {
title: '上次没有跑完',
@@ -1437,7 +1458,7 @@ async function launch(
// 在这里不成立——这一页没有谁会替它重发
const failure: Failure = isNetworkError(e)
? { ...failureOf(e, { hint: '后端连上之后点「重跑这一轮」,搭好的工作流不用重来。' }), rerun: true }
: failureOf(e)
: startFailure(e)
patch(() => ({
phase: 'error', status: PHASE_TEXT.error, error: lineOf(failure), failure,
cancel: null, endedAt: Date.now(),
+50
View File
@@ -57,8 +57,23 @@ export function toFlow(graph: GraphSpec): { nodes: FlowNode[]; edges: Edge[] } {
}
}
/**
* 图上节点和连线以外的部分(全图默认 defaults、viewport)。画布只管节点和连线,以前 toGraph
* 只拼这两样,保存时 PATCH 整张图,defaults 被整个抹掉——其中审批默认 always 会悄悄放宽成
* 全局设置。打开工作流时记下来,toGraph 原样带回去;和 savedSig 一样只属于当前这张图
*/
let graphExtras: Pick<GraphSpec, 'defaults' | 'viewport'> = {}
const extrasOf = (graph: GraphSpec | null | undefined): Pick<GraphSpec, 'defaults' | 'viewport'> => {
const out: Pick<GraphSpec, 'defaults' | 'viewport'> = {}
if (graph?.defaults && Object.keys(graph.defaults).length) out.defaults = structuredClone(graph.defaults)
if (graph?.viewport && Object.keys(graph.viewport).length) out.viewport = structuredClone(graph.viewport)
return out
}
export function toGraph(nodes: FlowNode[], edges: Edge[]): GraphSpec {
return {
...structuredClone(graphExtras),
nodes: nodes.map((n) => ({
id: n.id,
type: n.data.nodeType,
@@ -560,6 +575,11 @@ interface StudioState {
load: (workflow: Workflow | null) => void
/** 整张换掉(自动排版)。画布锁着时不换、返回 false:调用方别再报「已换好」 */
setGraph: (graph: GraphSpec) => boolean
/**
* 发布前修复的预览落到画布上:记一步撤销(label),节点的位置和选中照旧、不重新取景——
* 改的只是几个配置项,镜头一跳人就找不到刚才在看的节点了。锁着时不落、返回 false
*/
applyFixes: (graph: GraphSpec, label: string) => boolean
onNodesChange: (changes: NodeChange[]) => void
onEdgesChange: (changes: EdgeChange[]) => void
onConnect: (conn: Connection) => void
@@ -1087,6 +1107,7 @@ export const useStudio = create<StudioState>((set, get) => ({
get().cancelCopilot?.()
dragOrigin = null
glideSeq++
graphExtras = extrasOf(workflow?.graph)
savedSig = graphSig(nodes, edges)
lastVarSignature = ''
set({
@@ -1120,6 +1141,8 @@ export const useStudio = create<StudioState>((set, get) => ({
setGraph: (graph) => {
if (locked(get)) return false
const { nodes, edges } = toFlow(graph)
// 整图替换(Copilot、导入)带了 defaults 才换;没带的不能当成「清空」
if (graph.defaults !== undefined) graphExtras = { ...graphExtras, ...extrasOf({ ...graph, viewport: undefined }) }
glideSeq++
commit(set, get, '替换整个画布')
set({ nodes, edges, selectedId: null, dirty: true, fitRequest: get().fitRequest + 1 })
@@ -1127,6 +1150,33 @@ export const useStudio = create<StudioState>((set, get) => ({
return true
},
applyFixes: (graph, label) => {
if (locked(get)) return false
const next = toFlow(graph)
// 发布前修复可能改的是全图默认(比如把 defaults.approval 从 never 改成 dangerous)。
// 后端回来的整张图总带着 defaults,照它换;viewport 留着画布自己的
if (graph.defaults !== undefined) {
const { viewport } = graphExtras
graphExtras = { ...extrasOf({ ...graph, viewport: undefined }), ...(viewport ? { viewport } : {}) }
}
const { nodes: cur, selectedId } = get()
const byId = new Map(cur.map((n) => [n.id, n]))
// 已有的节点只换名字和配置:位置、量好的尺寸、选中都留着,React Flow 不用重新量一遍
const nodes = next.nodes.map((n) => {
const old = byId.get(n.id)
return old ? { ...old, data: { ...old.data, label: n.data.label, config: n.data.config } } : n
})
glideSeq++
commit(set, get, label)
set({
nodes, edges: next.edges,
selectedId: selectedId && nodes.some((n) => n.id === selectedId) ? selectedId : null,
dirty: graphSig(nodes, next.edges) !== savedSig,
})
void get().validate()
return true
},
onNodesChange: (changes) => {
if (locked(get)) {
// 锁定期间只放行量尺寸和选中:前者是 React Flow 自己的,后者不改图