口径台账:固定执行、验证审阅发布与增量重导入

- QueryCore 固定执行(K09):按已发布的不可变口径跑一次,交回类型化标量、发布/manifest 引用与逐查询证据
- 依赖闭包(K08):按选中的指标算出要拷的取数节点、要的入口字段,接进 derive / compose / metrics
- SQL 模板参数完整性(K01):试跑、组合问数、派生图、运行时取数共用一套语义,缺参数在渲染前就拒
- 受限字段变更服务(K03)与口径领域边界(K01):改动打在整图深拷贝上,身份与证据归属不可改
- 版本化受控模板绑定(K04):业务口径按显式绑定落到 SQL,对不上就报 unsupported / needs_update
- 验证记录(K05)与最小审阅:样例匹配不等于正式批准,审批人只从服务端身份取
- 发布依据清单(K07):发布时按不可变图物化内容寻址清单,正式用途按它判
- 增量重导入(K11)与 B/L/R 三方合并、受限自然语言修改提案(K12):只产候选,落图仍走既有写路径
- 接口与前端:口径草稿页接上字段变更、绑定状态、验证与重导入,新增 caliber-drafts / studio 检查脚本

验证:前端 tsc -b 通过。
This commit is contained in:
ThearchyHelios
2026-11-10 15:05:18 +08:00
parent 9d8b41430e
commit 2f90f0eb3a
126 changed files with 35506 additions and 809 deletions
+8
View File
@@ -96,6 +96,11 @@ const ORDER = [
// 评测与口径账本(docs/design/next-round 01、02)
'evals', // 评测:题集、加题、发起与进度、结果表、对比与 A/B、口径命中与重复度
'ledger', // 口径账本:证据里的「口径」一步、轮次摘要与出具 / 对账、对账视图、认证队列
'caliber-drafts', // 口径草稿页:业务规则工作台(K06;能改的资产才开表单、一次提交所有受影响指标、撤销、
// 基准版本过期保留编辑、同步不了的原因与技术待办、独立期望与审阅、验证结论按证据说)
// + 文档更新 / 增量重导入(K11:三方逐格、按工作项身份接受与拒绝、人工对齐、漏项不当删除、
// 恢复、旧 L 重算三方、覆盖)+ 一句话改口径(K12:只读预览、澄清、确认之后才落一版、
// 输入改过必须重新预览)
// 应用平台(docs/design/app-platform-and-look.md §4.5)。check-auth 不在这里:它要另起一套开着本地账号登录的服务,
// 由编排者单独跑(关登录时的这些检查照常在这里跑)
'apps', // 应用页、印章、点数字看出处、入口校验、实例页
@@ -125,6 +130,9 @@ const ESTIMATE = {
blueprint: 90, personal: 45, records: 30, files: 30,
// 下一轮第 4 波:2026-10-16 两套服务、八道并行时的实测
'catalog-changes': 43, evals: 33, ledger: 31,
// 口径工作台(K06)加文档更新与一句话(K11 / K12):2026-11-10 本地实测 60 秒上下(全是伪造接口、不连真数据,
// 机器一挤就慢)
'caliber-drafts': 65,
// 上面的 evidence、compare、bundle 按分析能力一轮第 2 波之后(2026-10-21,两套服务、八道并行)的实测改过:证据面板、
// 运行对比、可验证报告各加了分析结论的几段
}
File diff suppressed because it is too large Load Diff
+35 -4
View File
@@ -24,8 +24,8 @@
import { readFileSync } from 'node:fs'
import { chromium } from '../frontend/node_modules/playwright-core/index.mjs'
import {
CELL_LABELS, CELL_WHOLE, ISSUE, QUEUE, RECONCILE, RECONCILE_VALUES, WHOLE, WHOLE_LABELS, copiedMetricDetail, ledgerOf,
metricDetail, reconciledOf,
CELL_LABELS, CELL_WHOLE, ISSUE, QUEUE, RECONCILE, RECONCILE_NO_ACCESS, RECONCILE_VALUES, WEEKLY, WHOLE, WHOLE_LABELS,
copiedMetricDetail, ledgerOf, metricDetail, noAccessReconcile, reconciledOf,
} from './ledger-fixtures.mjs'
const WEB = process.env.AGENTLAB_WEB ?? 'http://localhost:5273'
@@ -181,6 +181,23 @@ await section('「口径」一步的三种情况:来自口径、相关口径
check('没有运行时报错', errors.length === 0, errors.join(' | '))
})
// ---------------------------------------------------------------- 没权对账
await section('没权对账:证据面板里只写说明,不摆「看差多少」按钮', async () => {
const { page, errors } = await open('/ui-harness.html?evidence=1', {
reply: evidenceReply(() => ledgerOf(RUN, { actions: [RECONCILE_NO_ACCESS] })) })
await page.waitForSelector('#evidence-wide [data-ev-caliber-of="s6"]', { timeout: 10000 })
await openSeg(page, 's8')
await page.locator('[data-evidence-panel] [data-ev-ledger="related"]').waitFor({ timeout: 5000 })
const related = await panelPart(page).innerText()
check('相关口径那一条照旧写清差在哪', related.includes('相关口径「订单口径」v1(已发布)')
&& related.includes('口径只保留状态为已支付的行'), related)
check('没有授权:写清是哪份口径、当前身份发不了', related.includes('当前这个身份没有发起对账的授权'), related)
check('……不摆「看差多少」按钮', await page.locator('[data-evidence-panel] [data-ledger-reconcile-open]').count() === 0)
check('……也不出现 undefined 的身份', !related.includes('undefined') && !related.includes('vundefined'), related)
check('没有运行时报错', errors.length === 0, errors.join(' | '))
})
// ---------------------------------------------------------------- 逐格判
await section('同一条查询的几个数逐格标:一格来自口径、一格只是相关,整题不等价不给出具', async () => {
@@ -460,10 +477,13 @@ await section('使用者看到的入口照服务端的动作:不能出具的
delete refused.auto_reason
// 摘要只认四种标签(分析结论的数不和口径比对,服务端不给它们标签):混进来认不出的种类,不计、不出 NaN
const LED = ledgerOf(RUN_U, { labels: { ...WHOLE_LABELS, s40: { kind: 'analysis' }, s42: { reason: '没有种类' } },
whole: WHOLE, actions: [refused, RECONCILE],
whole: WHOLE, actions: [refused, RECONCILE,
// 没权对账的那一项:匿名(服务端抹掉身份),界面上只写说明——换一份口径,免得和上面那项撞在一起
noAccessReconcile(RECONCILE, { caliber: WEEKLY.caliber, query: 'q-gmv', workflow_name: '周报口径', level_text: '受管' })],
// 出具过的是另一份口径(订单口径):周报口径这一项还没出具过,照服务端的原因写为什么不能出具
issued: [{ run_id: 'run-iss-u', status: 'succeeded', workflow_id: 'wf-orders', version: 1, tier: 'degraded', tier_text: '降档出具', auto: true }] })
const reply = (method, p) => {
const writes = []
const reply = (method, p, body) => {
if (method === 'GET' && p === '/conversations') return { json: [conv] }
if (method === 'GET' && p === `/conversations/${conv.id}`) return { json: { ...conv, turns: [turn] } }
if (p.startsWith('/conversations')) return { json: {} }
@@ -473,6 +493,10 @@ await section('使用者看到的入口照服务端的动作:不能出具的
if (method === 'GET' && p === `/runs/${RUN_U}/evidence`) return { json: EV.graph }
if (method === 'GET' && p.startsWith('/artifacts/')) return { json: { id: EV.doc_artifact, content: { ...EV.doc, run_id: RUN_U } } }
if (method === 'GET' && p.startsWith('/approvals')) return { json: [] }
if (method === 'POST' && p === `/ledger/answers/${RUN_U}/reconcile`) {
writes.push({ key: `POST ${p}`, body })
return { status: 409, json: { detail: '检查脚本:不真的发起对账', code: 'ledger_reconcile_refused' } }
}
return null
}
const { page, errors } = await open(`/chat/${conv.id}`, { me: USER, reply })
@@ -484,6 +508,13 @@ await section('使用者看到的入口照服务端的动作:不能出具的
check('不能出具:照服务端的原因写「请搭建者出具」,不摆出具按钮', text.includes('请搭建者出具')
&& await page.locator('[data-ledger-issue-button]').count() === 0, text)
check('能对账:照样摆对账按钮', await page.locator('[data-ledger-turn-reconcile]').count() === 1)
// 服务端没给身份的那一项(这个身份没有使用授权):只写说明,不摆按钮。身份被抹掉了,所以写法里也没有版本号
check('没权对账的那一项:只写是哪份口径、没有发起按钮',
await page.locator('[data-ledger-turn-reconcile]').count() === 1
&& await page.locator('[data-ledger-turn-reconcile-refused]').count() === 1
&& text.includes('对账:「周报口径」(受管)(当前这个身份没有发起对账的授权)'), text)
check('……没权的那一项不出现 undefined 的身份', !text.includes('undefined') && !text.includes('vundefined'), text)
check('……也没替它发过对账请求', writes.length === 0, JSON.stringify(writes))
const issued = page.locator('[data-ledger-issued="run-iss-u"]')
const issuedText = (await issued.innerText().catch(() => '')).replace(/\s+/g, ' ')
check('自动出具过的正式运行:写「按口径自动出具」、哪份口径和档位', issuedText.includes('按口径自动出具')
+85
View File
@@ -3376,6 +3376,91 @@ await section('分析卡:节点库认得、卡片摘要、检查器按方法
check('全程页面没有报错', errors.length === 0, errors.slice(0, 2).join(';'))
})
// ================================================================ 保存遇上并发修改(K02)
await section('保存被拒(有人先改过同一张图):不丢本地编辑、不自动重发、人点一下就能存进去', async () => {
const base = FAKES['st-main'].version
const latest = base + 1
let inflight = 0
let maxInflight = 0
const hits = []
const { page, errors, state } = await open({
// 覆盖夹具的 PATCH:按基准版本答——不是服务端现在那一版就 409 stale_revision(和真服务端同一形状)
before: async (p) => {
await p.route(/\/api\/workflows\/st-main$/, async (route) => {
const req = route.request()
if (req.method() !== 'PATCH') return route.fallback()
const body = req.postDataJSON()
state.patches.push(body)
hits.push(body.expected_revision)
inflight += 1
maxInflight = Math.max(maxInflight, inflight)
await new Promise((r) => setTimeout(r, 150))
inflight -= 1
if (body.expected_revision !== latest) {
return route.fulfill({
status: 409, contentType: 'application/json',
body: JSON.stringify({
detail: `这份内容基于 v${body.expected_revision},现在已经是 v${latest}:有人先改过,请刷新后再改,`
+ '你刚才的修改还在页面上,可以改完再存',
code: 'stale_revision', current_version: latest }),
})
}
return route.fulfill({ status: 200, contentType: 'application/json',
body: JSON.stringify({ ...FAKES['st-main'], ...body, version: latest, status: 'draft' }) })
})
},
})
check('画布打开着,页面没有报错', errors.length === 0, errors.slice(0, 2).join(';'))
const edit = () => S(page, () => window.__studio.getState().updateNode('lookup', { label: '背景检索(我改的)' }))
const snap = () => S(page, () => {
const s = window.__studio.getState()
return { stale: s.staleSave, dirty: s.dirty, version: s.workflow?.version,
label: s.nodes.find((n) => n.id === 'lookup')?.data.label }
})
await edit()
await blur(page)
check('改完是「未保存」', (await snap()).dirty)
// 第一次保存:被拒
await page.keyboard.press(`${MOD}+s`)
await page.waitForTimeout(700)
const refused = await snap()
check('被拒之后本地编辑一个字没丢,还是「未保存」',
refused.dirty && refused.label === '背景检索(我改的)', JSON.stringify(refused))
check('被拒之后没有自动重发(只发了那一次 PATCH)', hits.length === 1, `${hits.length} 次:${hits.join(',')}`)
const banner = page.locator('[data-stale-save]')
check('横幅明确写出「你基于哪一版、服务端现在是哪一版」',
(await banner.innerText().catch(() => '')).includes(`你基于 v${base}`)
&& (await banner.innerText().catch(() => '')).includes(`现在是 v${latest}`), await banner.innerText().catch(() => ''))
check('横幅给出两条明确的路', await banner.locator('[data-stale-save-rebase]').count() === 1
&& await banner.locator('[data-stale-save-reload]').count() === 1)
// 第二次:人明确点「用最新版本再保存」
await banner.locator('[data-stale-save-rebase]').click()
await page.waitForTimeout(700)
const saved = await snap()
check('第二次按服务端现在这一版为基准发出', hits[1] === latest, hits.join(','))
check('存进去的是画布上这一份(本地编辑没丢)',
state.patches[1]?.graph?.nodes?.find((n) => n.id === 'lookup')?.data.label === '背景检索(我改的)')
check('存完不是「未保存」,横幅也收了', !saved.dirty && saved.stale === null, JSON.stringify(saved))
check('版本跟到服务端那一版', saved.version === latest, saved.version)
// ⌘S 连按:不会拿同一个基准版本并发发两次(请求一次只有一个在路上,第二次连按不再多发一趟)
maxInflight = 0
hits.length = 0
await S(page, () => window.__studio.getState().updateNode('lookup', { label: '背景检索(连按)' }))
await blur(page)
await page.keyboard.press(`${MOD}+s`)
await page.keyboard.press(`${MOD}+s`)
await page.waitForTimeout(800)
check('⌘S 连按:同时只有一个保存在路上', maxInflight === 1, `最多 ${maxInflight} 个`)
check('⌘S 连按:连按一次只发一次请求', hits.length === 1, `${hits.length} 次:${hits.join(',')}`)
check('⌘S 连按都用最新基准版本', hits.every((v) => v === latest), hits.join(','))
check('全程页面没有报错', errors.length === 0, errors.slice(0, 2).join(';'))
})
check('整个检查没有弹出原生 confirm / prompt', dialogs === 0, `${dialogs} 次`)
check('检查没有写库(兜底拦下的写请求)', writes.length === 0, writes.slice(0, 4).join('、'))
+16 -2
View File
@@ -70,14 +70,28 @@ export const RECALL = {
tasks: [{ id: 'tk-recall-1', reason: 'caliber', to_version: 2 }],
}
/** 看差多少(s8 那条查询、订单口径):参数是推断的,要先核对 */
/**
* 看差多少(s8 那条查询、订单口径):参数是推断的,要先核对。
* `available: true` 是服务端**确实给了身份**(workflow_id / version)的那一项:界面据此摆按钮。
*/
export const RECONCILE = {
kind: 'reconcile', query: 'q-orders', caliber: ORDERS.caliber, workflow_id: ORDERS.workflow_id, version: 1, node_id: 'fetch',
workflow_name: '订单口径', level_text: '已发布', needs_check: true, check_reason: '参数按这次的 SQL 推断,请核对',
workflow_name: '订单口径', level_text: '已发布', available: true, needs_check: true, check_reason: '参数按这次的 SQL 推断,请核对',
binding: [{ field: 'start', value: '2026-09-01' }], fallback: false,
fields: [{ name: 'start', required: true, has_default: false }, { name: 'store', required: false, has_default: true }],
}
/**
* 当前这个身份**没有使用授权**的那一项:服务端只给说明,不把口径身份带出来(view._action_view 对 available 为假的那几项
* 把 workflow_id / version 抹掉)。界面照旧写清是哪份口径、差在哪,但不摆按钮——也就发不出一个 workflow_id / version
* 空着的请求。base 是原来那一项(默认订单口径那一项),要换一份口径就给 over 覆盖 caliber / query 这些。
*/
export const noAccessReconcile = (base = RECONCILE, over = {}) => {
const { workflow_id, version, ...rest } = base
return { ...rest, ...over, available: false }
}
export const RECONCILE_NO_ACCESS = noAccessReconcile()
/** 按口径正式出具(整题等价于周报口径):搭建者能一键,不自动的原因写在 auto_reason */
export const ISSUE = {
kind: 'issue', workflow_id: WEEKLY.workflow_id, version: 2, caliber: WEEKLY.caliber, workflow_name: '周报口径', how: 'independent',