mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-20 18:32:00 +00:00
口径台账:固定执行、验证审阅发布与增量重导入
- 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:
@@ -12,9 +12,10 @@
|
||||
* 请求函数从 ./http 导入,不从 ./client 导入(client.ts 要导入这个文件,反过来就成了循环)。
|
||||
*/
|
||||
import type {
|
||||
CaliberDescriptor, CaliberDraft, CaliberDraftAttachOut, CaliberDraftSummary, CaliberTrialOut, CertifyQueue, DraftMetric,
|
||||
DraftTrialOut, FreezeOut, LedgerFeedbackOut, LedgerFeedbackVerdict, LedgerIssueOut, LedgerReconcileIn, LedgerReconcileOut,
|
||||
RunLedger,
|
||||
CaliberDescriptor, CaliberDraft, CaliberDraftAttachOut, CaliberDraftSummary, CaliberTrialOut, CertifyQueue, DraftExpectIn,
|
||||
DraftImportAcceptOut, DraftImportRun, DraftMetric, DraftOperation, DraftTrialOut, DraftValidationsOut, FreezeOut,
|
||||
LedgerFeedbackOut, LedgerFeedbackVerdict, LedgerIssueOut, LedgerReconcileIn, LedgerReconcileOut, NlChangeOut,
|
||||
NlChangePreviewOut, RunLedger, DraftValidationRecord,
|
||||
} from '../typesLedger'
|
||||
import { get, patch, post, type RequestOptions } from './http'
|
||||
|
||||
@@ -62,10 +63,25 @@ export const caliberLedger = {
|
||||
draftTrial: (draftId: string, opts?: RequestOptions) => get<DraftTrialOut>(`${draftAt(draftId)}/trial`, opts),
|
||||
/**
|
||||
* 按填好的入口字段再试运行一次(POST 同一个路径):参数按入口字段校验,缺必填回 422;
|
||||
* 返回 {run_id, status, metrics, error},status 是 running / succeeded / failed / needs_input
|
||||
* 返回 {run_id, status, metrics, error},status 是 running / succeeded / failed / needs_input。
|
||||
*
|
||||
* 带 expect(K05 的固定期望)时,期望里的指标必须是这张卡上的、要**逐条给全**(不合规回 422,不发起运行);
|
||||
* 跑完把结果追加成一条验证记录。不带 expect 也能跑,但那样只记 observed——没有独立期望就不能算验证通过。
|
||||
*/
|
||||
runDraftTrial: (draftId: string, inputs: Record<string, unknown>) =>
|
||||
post<DraftTrialOut>(`${draftAt(draftId)}/trial`, { inputs }),
|
||||
runDraftTrial: (draftId: string, inputs: Record<string, unknown>, expect?: DraftExpectIn) =>
|
||||
post<DraftTrialOut>(`${draftAt(draftId)}/trial`, expect ? { inputs, expect } : { inputs }),
|
||||
/** 这份草稿的验证记录(新的在前)+ 总情况 + 字段基线状态:K06 读的那份契约 */
|
||||
draftValidations: (draftId: string, opts?: RequestOptions) =>
|
||||
get<DraftValidationsOut>(`${draftAt(draftId)}/validations`, opts),
|
||||
/**
|
||||
* 对一条验证记录做一次审阅(builder 及以上):confirmed / rejected,只追加。请求体里**没有 actor**,
|
||||
* 审批人取服务端身份(关登录时是自报署名);没有能记下来的主体时回 409 review_actor_required。
|
||||
* 返回里的 record 带这次决定和 covers_current(所审记录还算不算覆盖当前定义/绑定)
|
||||
*/
|
||||
reviewValidation: (draftId: string, recordId: string, body: { decision: 'confirmed' | 'rejected'; note?: string;
|
||||
metrics?: string[] }) =>
|
||||
post<{ ok: boolean; draft_id: string; record: DraftValidationRecord }>(
|
||||
`${draftAt(draftId)}/validations/${encodeURIComponent(recordId)}/review`, body),
|
||||
/** 选文档发起起草:documents 是要用的知识库文档 id,guidance 是给模型看的附加要求,
|
||||
* fixed_filters 是每次跑都不变的条件(工厂、产线、属性组),服务端要求写死在 SQL 里、不做成入口字段 */
|
||||
extractDraft: (body: { documents: string[]; collection?: string; datasource_id?: string; guidance?: string;
|
||||
@@ -73,13 +89,85 @@ export const caliberLedger = {
|
||||
post<{ draft_id: string; status: string }>('/ledger/drafts/extract', body),
|
||||
/**
|
||||
* 改标题、整体换掉指标、或把答清的问题消掉(resolved 是问题原文)。服务端据此重算状态:还有问题 → questions_open,
|
||||
* 否则 ready;已经接上或驳回的不改状态
|
||||
* 否则 ready;已经接上或驳回的不改状态。
|
||||
*
|
||||
* 已接管的草稿(有取数图)是 K02 的并发保护对象:expected_revision 是读草稿时给的 revision(必带,缺了 409
|
||||
* revision_required),target.card_id 在多张可写的卡时必须给(否则 409 card_required),request_id 是幂等键——
|
||||
* 同一个键带着同样的内容重发不会多存一版。基准版本过期回 409 stale_revision(另带 current_version),
|
||||
* 这时保留页面上的编辑、刷新详情后再改。
|
||||
*
|
||||
* 走 operations 时回执里另带 change 一段(变更分类、影响指标、定义指纹前后值、失效说明、绑定状态);同键同内容的
|
||||
* 重放交回的是当前视图(带 replayed),不再重算一份回执
|
||||
*/
|
||||
patchDraft: (draftId: string, body: { title?: string; metrics?: DraftMetric[]; resolved?: string[] }) =>
|
||||
patch<CaliberDraft>(draftAt(draftId), body),
|
||||
patchDraft: (draftId: string, body: {
|
||||
title?: string; metrics?: DraftMetric[]; resolved?: string[]
|
||||
/** K03 的字段操作:按稳定 metric_id + 字段路径改一处;和 metrics / resolved 互斥(422 change_conflict) */
|
||||
operations?: DraftOperation[]
|
||||
expected_revision?: number; request_id?: string
|
||||
target?: { workflow_id?: string; card_id?: string }
|
||||
}) => patch<CaliberDraft>(draftAt(draftId), body),
|
||||
/** 接上一次真实运行补取数路径(app/ledger/docattach.py):由它建工作流和版本,定义来自草稿 */
|
||||
attachDraft: (draftId: string, runId: string) => post<CaliberDraftAttachOut>(`${draftAt(draftId)}/attach`, { run_id: runId }),
|
||||
/** 「不是口径」:置 rejected,写一条审计,以后不再出现在列表的待办里 */
|
||||
dismissDraft: (draftId: string, note?: string) =>
|
||||
post<{ ok: boolean; draft_id: string; status: string }>(`${draftAt(draftId)}/dismiss`, { note: note ?? null }),
|
||||
|
||||
// ---- K11 增量重导入(app/ledger/reimport.py、api/caliber_import.py;搭建者)----
|
||||
/** 这份草稿的导入记录(新的在前),每条都带工作项和逐字段三方 */
|
||||
imports: (draftId: string, opts?: RequestOptions) =>
|
||||
get<{ runs: DraftImportRun[] }>(`${draftAt(draftId)}/imports`, opts),
|
||||
/**
|
||||
* 按这份草稿的来源文档重新抽一次候选 R(后台跑)。**不改 L、不改 B**:真正落到图上的只有 accept。
|
||||
* 带 request_id 的:同一份草稿 + 同一个键已经建过就交回那一次,不重复抽、不重复建工作项
|
||||
*/
|
||||
createImport: (draftId: string, requestId?: string) =>
|
||||
post<DraftImportRun>(`${draftAt(draftId)}/imports`, requestId ? { request_id: requestId } : {}),
|
||||
/** 一次导入的现状:工作项、逐字段三方、冲突;queued / running 时轮询它 */
|
||||
importRun: (runId: string, opts?: RequestOptions) =>
|
||||
get<DraftImportRun>(`/ledger/imports/${encodeURIComponent(runId)}`, opts),
|
||||
/**
|
||||
* 按**现在的** L / B 重算这次导入还没决定的三方,并刷新每项的比较锚点(人处置过的决定不动)。
|
||||
* 这是 409 import_stale_l 之后的恢复动作:候选算出来之后 L 被人改过,不能只把 expected_revision 更新到最新一版
|
||||
* 就覆盖上去,要按现在的口径重新算、人重新看过再接受
|
||||
*/
|
||||
refreshImport: (runId: string) =>
|
||||
post<DraftImportRun>(`/ledger/imports/${encodeURIComponent(runId)}/refresh`, {}),
|
||||
/** 人工把一条工作项对到图上某条指标(空串 = 取消对齐):baseline_unknown 和同名不同范围都走这里 */
|
||||
alignImportItem: (runId: string, itemId: string, metricId: string) =>
|
||||
post<DraftImportRun>(`/ledger/imports/${encodeURIComponent(runId)}/items/${encodeURIComponent(itemId)}/align`,
|
||||
{ metric_id: metricId }),
|
||||
/**
|
||||
* 接受选定字段:**一次性**落到 L(新增一版图)并按被接受的那几格推进 B。要带读到的基准版本
|
||||
* (expected_revision,缺了 409 revision_required、对不上 409 stale_revision)和幂等键。
|
||||
* items 一律按**工作项身份**(item_id)指认:同一条指标上可能有多条工作项(重复的候选、同一位被两项候选各带一份
|
||||
* 说法),按 metric_id 指会指错(服务端只在旧调用只给 metric_id 时才要求它在这条导入里唯一对得上一条);
|
||||
* fields 要**明确列出来**(页面列了几格就只接受几格,不靠 auto 猜)。服务端发现要接受的格子「当前内容和算候选时的
|
||||
* 那一版不一样」时回 409 import_stale_l(另带 fields 指出是哪几格),这时不能只更新 expected_revision 覆盖上去,
|
||||
* 要先 refreshImport 按现在的口径重算三方再让人确认
|
||||
*/
|
||||
acceptImport: (runId: string, body: {
|
||||
items: { item_id: string; metric_id?: string; fields: string[] }[]
|
||||
expected_revision?: number; request_id?: string
|
||||
}) => post<DraftImportAcceptOut>(`/ledger/imports/${encodeURIComponent(runId)}/accept`, body),
|
||||
/** 拒绝选定字段:保持 L 不动,也不推进 B。同样按工作项身份(item_id)指认;老调用可以用 seq */
|
||||
rejectImport: (runId: string, body: {
|
||||
items: { item_id: string; metric_id?: string; seq?: number; fields: string[] }[]; note?: string
|
||||
}) => post<DraftImportRun>(`/ledger/imports/${encodeURIComponent(runId)}/reject`, body),
|
||||
/** 显式恢复:把这次导入重新排进后台,续做还没完成的工作项(已接受 / 拒绝的不动,不重复建版) */
|
||||
resumeImport: (runId: string) =>
|
||||
post<DraftImportRun>(`/ledger/imports/${encodeURIComponent(runId)}/resume`, {}),
|
||||
|
||||
// ---- K12 受限的自然语言修改(app/ledger/nlchange.py;搭建者)----
|
||||
/** 一句话 → 受限修改提案:**只读**,不落库、不新增版本;说不清就只回澄清项 */
|
||||
changeProposal: (draftId: string, body: { instruction: string; metrics?: string[]
|
||||
target?: { workflow_id?: string; card_id?: string } }) =>
|
||||
post<NlChangePreviewOut>(`${draftAt(draftId)}/change-proposal`, body),
|
||||
/**
|
||||
* 一句话改口径:默认只预览(confirm=false);**confirm=true 才按同一批操作落一版**(内部翻成一次
|
||||
* DraftPatchIn 交给现有变更服务:expected_revision / request_id / CAS / 绑定同步一条不少)。
|
||||
* 说不清时回 409 并带澄清项,一条操作都不落
|
||||
*/
|
||||
nlChange: (draftId: string, body: { instruction: string; confirm: boolean; expected_revision?: number
|
||||
request_id?: string; metrics?: string[]; target?: { workflow_id?: string; card_id?: string } }) =>
|
||||
post<NlChangeOut>(`${draftAt(draftId)}/nl-change`, body),
|
||||
}
|
||||
|
||||
@@ -257,7 +257,10 @@ export const api = {
|
||||
name: string; description?: string; graph?: GraphSpec; tags?: string[]
|
||||
origin?: { run_id: string; conversation_id?: string; turn_id?: string }
|
||||
}) => post<Workflow>('/workflows', body),
|
||||
update: (id: string, body: Partial<Workflow> & { note?: string }) =>
|
||||
/** 改工作流:带 graph 就是保存一版。expected_revision 是读到的 Workflow.version(K02 的乐观锁):对不上回
|
||||
* 409 stale_revision(另带 current_version),这时页面保留自己的编辑、也不自动重放,人确认后再按最新一版
|
||||
* 显式重试(或载入最新版本) */
|
||||
update: (id: string, body: Partial<Workflow> & { note?: string; expected_revision?: number }) =>
|
||||
patch<Workflow>(`/workflows/${id}`, body),
|
||||
remove: (id: string) => del(`/workflows/${id}`),
|
||||
duplicate: (id: string) => post<Workflow>(`/workflows/${id}/duplicate`),
|
||||
|
||||
@@ -963,6 +963,24 @@ export const SUBGRAPH_UPGRADE_HELP = '所固定的版本之后,被引用的工
|
||||
export const upgradeNewerText = (latest: number, pinned: number) =>
|
||||
`上游已有 v${latest}(固定的是 v${pinned}):发起正式运行前须在下方声明升版处置,否则正式运行将被拦截`
|
||||
|
||||
/**
|
||||
* 保存被服务端按 stale_revision 拒了(K02):同一张图有人先改过。画布上的修改原样留着(还是「未保存」),
|
||||
* 也不自动重发;页面上给两条明确的路让人自己选
|
||||
*/
|
||||
export const STALE_SAVE_TEXT = {
|
||||
banner: (base: number, current: number | null) => current == null
|
||||
? `这张图有人先改过(你基于 v${base}):画布上你的修改还在,没有替你重发`
|
||||
: `这张图有人先改过(你基于 v${base},服务端现在是 v${current}):画布上你的修改还在,没有替你重发`,
|
||||
rebase: '用最新版本再保存',
|
||||
rebaseHint: '按服务端现在这一版为基准再存一版:画布上这份成为新的一版,别人刚改的那一版留在版本历史里',
|
||||
reload: '载入最新版本',
|
||||
reloadHint: '丢掉画布上还没保存的改动,换成服务端现在这一版',
|
||||
reloadTitle: '载入最新版本?',
|
||||
reloadBody: '画布上还没保存的修改会被丢掉,换成服务端上现在这一版。',
|
||||
reloadConfirm: '载入最新版本',
|
||||
dismiss: '先不改了',
|
||||
} as const
|
||||
|
||||
/**
|
||||
* 发布前检查与自动修复:发布弹窗和问题面板的「发布前检查」共用一套说法。
|
||||
* 原则写在话里:修复只出预览、人确认了才存草稿,永远不替人发布
|
||||
|
||||
@@ -97,6 +97,13 @@ export const LEDGER_UI = {
|
||||
cancel: '取消',
|
||||
launched: '已发起对账,结果在下面',
|
||||
readOnly: '对话在回收站中,恢复后才能对账',
|
||||
/**
|
||||
* 这一项当前这个身份**发不了**(服务端没给这一项身份,只给了说明):不摆按钮,只写清是哪份口径、为什么。
|
||||
* 允许的理由只有授权这一条(应用授权里给到「使用」),不替服务端编别的原因。
|
||||
*/
|
||||
unavailable: (caliber: string) => `对账:${caliber}(当前这个身份没有发起对账的授权)`,
|
||||
unavailableHint: '要对这份口径对账,需要有它的使用授权;这里只写清差在哪,发不出请求',
|
||||
notAvailable: '这一项没有可发起对账的授权(服务端没给身份):这里只写差在哪',
|
||||
},
|
||||
/** 对账的结果卡片 */
|
||||
result: {
|
||||
@@ -333,6 +340,8 @@ export const LEDGER_UI = {
|
||||
noMetrics: '没有整理出指标',
|
||||
noMetricsBody: '文档里没有能逐字核对上引用的指标定义,可以换一份文档或补充起草要求后重来',
|
||||
synonyms: (list: string) => `又称:${list}`,
|
||||
/** 指标业务写法那一行:标签 + 说法 */
|
||||
businessValue: (value: string) => `:${value}`,
|
||||
unit: '单位',
|
||||
decimals: '小数位',
|
||||
expression: '表达式',
|
||||
@@ -356,6 +365,13 @@ export const LEDGER_UI = {
|
||||
resolveHint: '在业务上问清之后勾选对应的问题,移除后状态会跟着变',
|
||||
resolveNeed: '请先勾选已经问清的问题',
|
||||
resolved: (n: number) => `已移除 ${formatNumber(n)} 个问题`,
|
||||
/** 图上有多张可写的口径卡、又认不出唯一目标:要人去画布上确认改哪一张(K02) */
|
||||
cardAmbiguous: '这份草稿的图上有好几张可写的口径卡:请先到画布上确认要改哪一张',
|
||||
cardMissing: '这份草稿的图上看不到可写的口径卡:请到画布上核对这张图',
|
||||
/** 写入被拒(有人先改过):勾选还在、也不会自动重发,人确认后再点一次(K02) */
|
||||
writeStale: (current: number | null, base: number | null) => current == null
|
||||
? `这条口径已经被别处改过(你基于 v${base ?? '?'}):勾选的问题还在,确认后再点一次`
|
||||
: `这条口径已经被别处改过(你基于 v${base ?? '?'},服务端现在是 v${current}):勾选的问题还在,确认后再点一次`,
|
||||
dropped: '被丢弃的条目',
|
||||
droppedHint: '带不了能对照数据目录的取数,或引用无法逐字核对上的指标不留下',
|
||||
uncovered: (n: number) => `还没起草出来的指标(${formatNumber(n)} 条)`,
|
||||
@@ -409,6 +425,343 @@ export const LEDGER_UI = {
|
||||
dismissed: '已驳回,这份草稿不再出现在待办里',
|
||||
},
|
||||
|
||||
// ---- 工作台:业务规则(K04 的能力描述 + K06 的改法;只在服务端说得出能改什么时才开表单)----
|
||||
rules: {
|
||||
title: '业务规则',
|
||||
hint: '这两项是业务定义的写法。保存时服务端在同一个版本里把取数一起改过来;改不了的原样保留,并写清原因',
|
||||
fieldHelp: (help: string) => help,
|
||||
/** 这一项现在取值不一致(同一张卡上的指标写法不同):不替人选一个默认值 */
|
||||
mixed: '现在写法不一致',
|
||||
mixedHint: '保存后这些指标会统一成选中的写法',
|
||||
keep: '保持各自现在的写法',
|
||||
/** 这一项这张卡上没人声明:改不了(没有落点的取数不会被硬改) */
|
||||
fieldNone: '这张卡上的指标没有声明这一项',
|
||||
/** 保存后会变哪几条指标:指标名 + 这一项现在 → 保存后 */
|
||||
previewTitle: '保存后会变成',
|
||||
before: '现在',
|
||||
after: '保存后',
|
||||
unaffected: (n: number) => `另有 ${formatNumber(n)} 条指标没有声明这一项,这次不动它们`,
|
||||
unaffectedHint: '要改它们得先由技术侧在指标上声明这两项、并给取数加上受控绑定',
|
||||
affected: (n: number) => `会改到 ${formatNumber(n)} 条指标`,
|
||||
noChange: '还没有改动:选一个和现在不一样的写法,这里就会列出会改到哪些指标',
|
||||
save: '保存这次修改',
|
||||
saving: '正在保存…',
|
||||
saveNeedChange: '先选一个和现在不一样的写法',
|
||||
/** 保存回执 */
|
||||
saved: (version: number | null) => version == null ? '已保存' : `已保存成 v${formatNumber(version)}`,
|
||||
savedAligned: '定义和取数已经在同一个版本里改过来了',
|
||||
savedNotSynced: '定义已经存下来了,取数一个字没动',
|
||||
savedNoChange: '这次操作没有改动任何内容:图没有换版本',
|
||||
invalidated: '这张卡的内容变了:旧的试运行和验证不再算覆盖这一版,请重新试运行',
|
||||
nextStep: '下一步:按新定义重新试运行,并对一次独立样例',
|
||||
replayed: '这一次和上一次是同一个请求,服务端认得出来,没有多存一版',
|
||||
/** 基准版本过期:保留页面上的选择,不自动重发 */
|
||||
stale: (current: number | null, base: number | null) => current == null
|
||||
? `这条口径已经被别处改过(你基于 v${base ?? '?'}):你选好的写法还在,确认后再点一次「保存这次修改」`
|
||||
: `这条口径已经被别处改过(你基于 v${base ?? '?'},服务端现在是 v${current}):你选好的写法还在,确认后再点一次`,
|
||||
/** 撤销:用保存前的值构造逆操作,再存一版,不顺着一版整份覆盖 */
|
||||
undo: (n: number) => `撤销这次修改(回到 ${formatNumber(n)} 处改动之前的值)`,
|
||||
undoing: '正在撤销…',
|
||||
undone: (version: number | null) => version == null ? '已撤销这次修改' : `已撤销这次修改,现在这一版是 v${formatNumber(version)}`,
|
||||
undoHint: '撤销也是新增一版(按当前版本和新的请求键提交逆操作),不改写已经存下的历史版本',
|
||||
/** 不能改的资产:照实说为什么,并给技术待办 */
|
||||
readOnly: '这份草稿现在不能在这里改',
|
||||
unbound: '这张卡上的指标没有声明统计时间口径和退款处理:按旧资产处理,不提供修改',
|
||||
noCard: '图上看不到能改的口径卡:先在画布上确认要改哪一张',
|
||||
noRevision: '这份草稿还没有版本号:刷新页面后再改',
|
||||
noWorkflow: '这份草稿还没有取数图:起草完成或接上一次运行之后才能改业务规则',
|
||||
/** 绑定的同步状态(同步只说这两边对得上,不等于验证通过) */
|
||||
status: {
|
||||
aligned: '定义和取数已经同步',
|
||||
needs_update: '定义和取数还没同步',
|
||||
unsupported: '这条取数同步不了',
|
||||
unbound: '这张卡没有声明业务字段',
|
||||
} as Record<string, string>,
|
||||
alignedNote: '同步只说业务定义和这张取数对得上,不等于业务验证通过',
|
||||
reason: '这条为什么改不了',
|
||||
fixLabel: '技术待办',
|
||||
fix: {
|
||||
none: '不用处理',
|
||||
sync: '可以按受控模板确定性同步:保存时会把取数一起改过来',
|
||||
author: '要作者侧补或改受控绑定:这条取数里没有这个业务字段的落点,或者映射里没有这个取值',
|
||||
manual: '先由人拿主意:同一条取数上的指标说法不一致,或者取数被手工改过',
|
||||
} as Record<string, string>,
|
||||
fixNote: '这一条不受工作台影响,复杂或改不了的取数不会被字符串替换硬改',
|
||||
},
|
||||
|
||||
// ---- 工作台:验证与审阅(K05 的记录,K06 的读法)----
|
||||
validation: {
|
||||
title: '验证与审阅',
|
||||
records: '验证记录',
|
||||
empty: '还没有验证记录',
|
||||
emptyBody: '按入口字段试运行一次就会留下一条记录;带独立期望时才能判「对得上」',
|
||||
counts: (total: number, covering: number) =>
|
||||
`${formatNumber(total)} 条记录 · 覆盖当前版本 ${formatNumber(covering)} 条`,
|
||||
method: (version: number) => `比较方法 v${formatNumber(version)}`,
|
||||
/** 结论:只有「有独立期望对得上」并且「有覆盖它的认证审阅」才是验证通过 */
|
||||
verdict: {
|
||||
none: '还没有验证记录',
|
||||
stale: '现有记录不覆盖这一版',
|
||||
observed: '只记了试运行结果',
|
||||
mismatched: '和独立期望对不上',
|
||||
failed: '试运行没有成功',
|
||||
unverified: '还不能算验证通过',
|
||||
verified: '验证通过',
|
||||
rejected: '被审阅驳回',
|
||||
} as Record<string, string>,
|
||||
/** 一条记录的状态 */
|
||||
status: {
|
||||
matched: '和独立期望对得上',
|
||||
mismatched: '和独立期望对不上',
|
||||
observed: '只记了试运行结果',
|
||||
unverified: '证据不足',
|
||||
failed: '试运行没有成功',
|
||||
} as Record<string, string>,
|
||||
covers: '覆盖当前版本',
|
||||
notCovers: '不覆盖当前版本',
|
||||
/** 只有服务端明确说覆盖才算覆盖:判不了就照实说判不了,不默认成覆盖 */
|
||||
coversUnknown: '覆盖判断未知',
|
||||
coversHint: '定义、取数或绑定改过之后,旧记录留着可追,但不算覆盖这一版',
|
||||
/** 结论依据的是哪一条记录:说出来,别让人把别的记录当成这一条的结论 */
|
||||
basis: (when: string, status: string) => `结论按 ${when} 那条记录(${status})`,
|
||||
basisNone: '还没有一条记录可以下结论',
|
||||
semanticGaps: (n: number) => `其中 ${formatNumber(n)} 条指标的语义说明仍待人工确认`,
|
||||
expected: '独立期望',
|
||||
expectedNone: '这条没有独立期望:只记试运行结果,不能算验证通过',
|
||||
expectedSource: '期望来自',
|
||||
sources: {
|
||||
human_confirmed: '人工确认',
|
||||
fixture: '固定夹具',
|
||||
independent_computation: '独立计算',
|
||||
} as Record<string, string>,
|
||||
expectedHint: '期望要独立于这次试运行:人工确认、固定夹具或独立算出来的标准答案,不能抄这次的结果当答案',
|
||||
actual: '实际结果',
|
||||
ok: '对得上',
|
||||
notOk: '对不上',
|
||||
unknown: '判不了',
|
||||
noValue: '没有取到值',
|
||||
rowsHint: (rows: number | null) => rows == null ? '' : `${formatNumber(rows)} 行`,
|
||||
masked: '已遮罩',
|
||||
problems: '这一条记下的问题',
|
||||
review: '审阅',
|
||||
noReview: '还没有审阅决定',
|
||||
reviewConfirmed: '确认',
|
||||
reviewRejected: '驳回',
|
||||
reviewBy: (who: string, verified: boolean) => verified ? `由 ${who}` : `由 ${who}(自报署名,未认证)`,
|
||||
reviewScope: '确认范围',
|
||||
/** 确认范围没有盖住这条记录的全部指标:不能当成整卡通过 */
|
||||
reviewPartial: '没有盖住这条记录的全部指标:不能当整卡通过',
|
||||
reviewCovers: '这次审阅覆盖当前版本',
|
||||
reviewNotCovering: '这条不覆盖当前版本:确认了也不算覆盖这一版',
|
||||
reviewCoversUnknown: '这次审阅的覆盖判断未知',
|
||||
reviewNote: '说明(可空)',
|
||||
reviewNotePlaceholder: '例如:对过业务口径和样例来源',
|
||||
confirm: '确认这条',
|
||||
reject: '驳回这条',
|
||||
reviewing: '正在提交审阅…',
|
||||
reviewDone: (decision: string) => `已记录一次审阅:${decision}`,
|
||||
reviewScopeHint: '审阅只认服务端身份,界面代写不了审批人;同一份记录可以再审,显示的是最新一条',
|
||||
baseline: '导入基线',
|
||||
baselineKnown: (revision: number | null, metrics: number, fields: number) =>
|
||||
`有可还原的导入基线${revision != null ? `(第 ${formatNumber(revision)} 版接受)` : ''}:`
|
||||
+ `${formatNumber(metrics)} 条指标、${formatNumber(fields)} 个字段`,
|
||||
baselineUnknown: '这份草稿没有导入基线:当时被接受的导入值还原不出来,不能拿现在的内容当作它',
|
||||
baselineHint: '基线说的是「上次被接受的导入值」,人工改过这里的内容不会推进它',
|
||||
/** 确认范围没盖住整条记录时的说明:服务端按范围收回也好、页面自己按范围收回也好,都用同一句 */
|
||||
partialVerdict: (covered: string, missed: string, total: number) =>
|
||||
`这次确认盖住了 ${covered || '—'},没有盖住 ${missed}(这条记录一共 ${formatNumber(total)} 条指标):`
|
||||
+ '不能算整卡验证通过',
|
||||
/** 试运行那一块里的「这次试运行的验证记录」:只说本次那一条,旧记录不冒充本次 */
|
||||
trialRecord: '这次试运行的验证记录',
|
||||
trialWaiting: '试运行还在进行,正在等本次的验证记录',
|
||||
trialNoRecord: '这次试运行还没有留下验证记录:缺证据不能算验证通过',
|
||||
/** 试运行那一条的紧凑写法:旁边就是状态和覆盖判断,不铺开整句 */
|
||||
noExpectation: '没有独立期望',
|
||||
/** 带独立期望试运行 */
|
||||
trialWithExpect: '带独立期望试运行',
|
||||
trialWithExpectHint: '先改上面那两项业务规则、或确认现在的写法就是要验的,再填标准答案试一次',
|
||||
expectFor: (name: string) => `${name} 的期望值`,
|
||||
expectNeedAll: '要逐条给全卡指标,不能只给其中几条',
|
||||
expectSourceLabel: '期望来自',
|
||||
expectSubmit: '带期望试运行',
|
||||
expectSubmitting: '正在发起…',
|
||||
runTrial: '不带期望试运行',
|
||||
openRun: '看这次运行',
|
||||
more: (n: number) => `展开其余 ${formatNumber(n)} 条记录`,
|
||||
fieldsHint: '这里只摆指标值和验证依据,不显示取数语句、内部编号和字段路径',
|
||||
},
|
||||
|
||||
// ---- K11 增量重导入:B / L / R 三方、按字段接受 / 拒绝、人工对齐、显式恢复 ----
|
||||
imports: {
|
||||
title: '文档更新(重新读一遍文档)',
|
||||
hint: '用最新的文档重抽一遍候选,和现在的内容、上次被接受的导入值逐字段比。'
|
||||
+ '候选只是候选:你不点接受,图上和字段基线一个字节都不动',
|
||||
create: '按文档重新读一遍',
|
||||
creating: '正在重新读取…',
|
||||
started: '已开始重新读取:抽完候选会出现在下面',
|
||||
createHint: '在服务端重读这份草稿的来源文档、抽候选,再逐字段比对;不改现在的内容',
|
||||
runs: '重导入记录',
|
||||
runsEmpty: '还没有重导入记录',
|
||||
/** 一条记录:什么时候读的、已经处置了几条 */
|
||||
runLabel: (when: string, decided: number, total: number) =>
|
||||
`${when} · 已处置 ${formatNumber(decided)}/${formatNumber(total)} 条`,
|
||||
open: '看这一次',
|
||||
createdAt: (when: string) => `读过一次:${when}`,
|
||||
itemsTotal: (n: number) => `这次抽出 ${formatNumber(n)} 条候选`,
|
||||
/** run 的状态 */
|
||||
status: {
|
||||
queued: '排队中',
|
||||
running: '正在重新读取',
|
||||
succeeded: '读完了',
|
||||
partial: '读完了(有没抽全的)',
|
||||
failed: '没有读完',
|
||||
interrupted: '中断了,可以恢复',
|
||||
cancelled: '已停止',
|
||||
} as Record<string, string>,
|
||||
/** 逐格的三方状态说法 */
|
||||
state: {
|
||||
update: '无冲突更新',
|
||||
conflict: '人工修改冲突',
|
||||
new: '新增候选',
|
||||
missing: '这次没提取到',
|
||||
manual: '需要人工对齐',
|
||||
unchanged: '不变',
|
||||
} as Record<string, string>,
|
||||
stateHint: {
|
||||
update: '上次接受之后没人动过这一格:接受就取文档里的新说法',
|
||||
conflict: '你人工改过这一格,文档又给了一个新说法:接受取文档的,拒绝就留你现在的内容',
|
||||
new: '现在的内容和基线都没有这一格:文档新提出来的,可以接受',
|
||||
missing: '这次没提取到这一格(漏提取不当删除):现在的内容原样留着,不能接受',
|
||||
manual: '这一格没有可比的基线:要你人工对齐之后才能定',
|
||||
unchanged: '和现在的内容或者基线一致:不用接受',
|
||||
} as Record<string, string>,
|
||||
b: '上次被接受的导入值',
|
||||
l: '现在的内容',
|
||||
r: '这次文档里的说法',
|
||||
noCell: '没有这一格',
|
||||
/** 一格的值转成一行字:空值、空数组和结构化内容各有各的说法,不把 JSON 摆上来 */
|
||||
noValue: '没写',
|
||||
emptyValue: '(空)',
|
||||
objectValue: '(一段结构化内容)',
|
||||
citationCount: (n: number) => `${formatNumber(n)} 段引用原文`,
|
||||
/** 认不出的字段路径不摆原始路径,用一句笼统的说法 */
|
||||
otherField: '这一格',
|
||||
/** 工作项的状态(逐字段算出来的那条) */
|
||||
itemStatus: {
|
||||
pending: '还没处置',
|
||||
accepted: '已接受',
|
||||
rejected: '已拒绝',
|
||||
partial: '有漏提取的格子',
|
||||
failed: '这条没抽好',
|
||||
} as Record<string, string>,
|
||||
accept: '接受',
|
||||
reject: '拒绝',
|
||||
/** 拒绝的说明(可空):记在这一次的决定上 */
|
||||
notePlaceholder: '拒绝的说明(可空)',
|
||||
acceptSelected: (n: number) => `接受选中的 ${formatNumber(n)} 格`,
|
||||
rejectSelected: (n: number) => `拒绝选中的 ${formatNumber(n)} 格`,
|
||||
accepting: '正在接受…',
|
||||
rejecting: '正在拒绝…',
|
||||
/** 一条上所有「无冲突更新 + 新增候选」一次收掉;也是一次显式的点击 */
|
||||
acceptClean: (n: number) => `接受这条上无冲突的 ${formatNumber(n)} 格`,
|
||||
nothingSelected: '先选要接受或者拒绝的格子',
|
||||
nothingClean: '这条上没有可以直接接受的格子',
|
||||
needRevision: '这份草稿还没有版本号:刷新页面之后再改',
|
||||
missingNoDelete: '漏提取不当删除',
|
||||
/** 人工对齐:没对上、或者同名不同范围时必须由人指定 */
|
||||
align: '对齐到哪条指标',
|
||||
alignAction: '对齐',
|
||||
aligning: '正在对齐…',
|
||||
alignHint: '名字像不像不参与对齐,只认稳定身份和来源证据;机器对不上就必须由人指定',
|
||||
alignNone: '不对齐(当作新指标)',
|
||||
alignNeed: '先选要对齐到哪条指标',
|
||||
reasonLabel: '为什么这么对',
|
||||
reason: {
|
||||
metric_id: '候选带着和图上一致的稳定身份',
|
||||
evidence: '按来源证据对上了(引的是同一段原文)',
|
||||
new: '没有对得上的指标:名字相不相似不参与自动合并',
|
||||
manual: '要你来定:稳定身份对不上来源证据,或者证据对上了不止一条',
|
||||
} as Record<string, string>,
|
||||
/** 显式恢复中断的那一次 */
|
||||
resume: '恢复这次导入',
|
||||
resuming: '正在恢复…',
|
||||
resumed: '已排进后台,正在接着读',
|
||||
resumeHint: '续做还没完成的工作项;已经接受或者拒绝的不动,不会重复建版',
|
||||
unfinished: (n: number) => `还有 ${formatNumber(n)} 条没做完`,
|
||||
/** 基准版本过期:选择保留,不自动重发 */
|
||||
stale: (current: number | null, base: number | null) => current == null
|
||||
? `这条口径已经被别处改过(你基于 v${base ?? '?'}):你选好的格子还在,刷新后再点一次接受`
|
||||
: `这条口径已经被别处改过(你基于 v${base ?? '?'},服务端现在是 v${current}):你选好的格子还在,刷新后再点一次接受`,
|
||||
/** 服务端说这次导入比对的 L 已经过期(打开之后图被别处改过):按现在的 L / B 重算三方,不能拿旧 L 直接覆盖 */
|
||||
staleL: (names: string) => names
|
||||
? `这几格的当前内容和这次导入算候选时的那一版不一样了:${names}。`
|
||||
+ '已经按现在的口径把这次导入的三方重算了一遍,选好的格子还在,核对之后再点一次接受'
|
||||
: '这次导入比对的还是旧的内容(你打开之后这张卡被别处改过):已经按现在的口径把这次导入的三方重算了一遍,'
|
||||
+ '选好的格子还在,核对之后再点一次接受',
|
||||
accepted: (revision: number | null) => revision == null ? '已接受选中的格子' : `已接受选中的格子,落到 v${formatNumber(revision)}`,
|
||||
acceptedHint: '这次图和字段基线是在同一次提交里推进的:没有接受的格子不会推进基线',
|
||||
rejected: '已拒绝选中的格子:现在的内容和字段基线都没动',
|
||||
replayed: '这一次和上一次是同一个请求,服务端认得出来:没有多存一版,基线也读得回来',
|
||||
/** 字段基线覆盖到哪一步:有基线不等于整张都有 */
|
||||
coverageLabel: '字段基线的覆盖',
|
||||
coverageComplete: '这张卡的每一格都有基线',
|
||||
coveragePartial: (fields: number, metrics: number) =>
|
||||
`还没盖满这张卡:还有 ${formatNumber(fields)} 格没有基线`
|
||||
+ (metrics > 0 ? `、${formatNumber(metrics)} 条指标整条没有基线` : '')
|
||||
+ '。只有被接受的格子才往前走,没覆盖到的格子下次会按「新增候选 / 需要人工对齐」处理',
|
||||
coverageUnknown: '这一份基线读不出来(不在、或者内容与哈希不符):不能拿现在的内容当作它',
|
||||
coverageHint: '基线说的是「上次被接受的导入值」,人工改过现在的内容不会推进它',
|
||||
conflicts: (n: number) => `这次有 ${formatNumber(n)} 格要人处置(冲突、要人工对齐、漏提取)`,
|
||||
noItems: '这次没有抽出候选:可以再读一次,或者换一份文档重起草稿',
|
||||
/** 没接管到图上:导入落不到图上 */
|
||||
readOnly: '这份草稿还没有取数图:重新导入落不到图上,先起草完成或者接上一次运行',
|
||||
itemUnaligned: '这条还没对上图上的指标',
|
||||
/** 一条指标在页面上找不到名字:不摆内部编号 */
|
||||
unknownMetric: '(这条指标在页面上找不到名字)',
|
||||
fieldCount: (n: number) => `${formatNumber(n)} 格`,
|
||||
},
|
||||
|
||||
// ---- K12 受限的自然语言修改:只产出提案,确认后才落一版 ----
|
||||
nl: {
|
||||
title: '用一句话改口径',
|
||||
hint: '只认已经声明过的业务写法(统计时间口径、退款处理这类)。先看会影响什么,确认之后才落一版;'
|
||||
+ '预览本身不写任何东西',
|
||||
placeholder: '例如:订单金额按支付时间算,排除全额退款',
|
||||
preview: '预览影响',
|
||||
previewing: '正在看影响…',
|
||||
needText: '先写一句要改什么',
|
||||
/** 认可的操作:一条一行「指标 · 字段:现在 → 保存后」 */
|
||||
changeCount: (n: number) => `这句话会改到 ${formatNumber(n)} 处`,
|
||||
noChange: '这句话没有能按字段改的地方',
|
||||
now: '现在',
|
||||
after: '保存后',
|
||||
removeValue: '删掉这一项',
|
||||
noValue: '没写',
|
||||
/** 含糊的条件先澄清:一条操作都不产出 */
|
||||
clarifyTitle: '这句还说不清',
|
||||
clarifyHint: '没有产出任何修改:说清之后再预览一次',
|
||||
clarifyNoMatch: '这句话里没有能按字段改的已声明写法',
|
||||
confirm: '确认并应用',
|
||||
confirming: '正在应用…',
|
||||
confirmHint: '确认之后才按这批操作落一版(带读到的版本和请求键);预览不会写任何东西',
|
||||
needConfirm: '先预览,看清影响之后再确认',
|
||||
/** 预览的是哪一段原文:确认发的就是这一段,页面显示的(A)和实际落下的(B)不是两句话 */
|
||||
previewedAs: (text: string) => `这份影响是按这一段原文算的:「${text}」`,
|
||||
changedNotice: '输入改过了:上面还是上一次预览的结果,请重新预览之后再确认',
|
||||
needPreviewAgain: '这句话改过了:要先重新预览;确认的必须是预览里那一段原文',
|
||||
/** 服务端这次落下的操作和预览里的不是同一批:照实提示,让人到画布上核对 */
|
||||
mismatch: '服务端这次落下的操作和预览里的不是同一批:请到画布上核对这一版',
|
||||
applied: (revision: number | null) => revision == null ? '已应用这句话' : `已应用这句话,落到 v${formatNumber(revision)}`,
|
||||
invalidated: '这张卡的内容变了:旧的试运行和验证不再覆盖这一版,请重新试运行',
|
||||
failed: '这次没有改任何东西:',
|
||||
replayed: '这一次和上一次是同一个请求:没有多存一版',
|
||||
readOnly: '这份草稿还没有取数图:一句话改不了任何东西,先起草完成或者接上一次运行',
|
||||
noRevision: '这份草稿还没有版本号:刷新页面之后再改',
|
||||
/** 一句话点到一条页面上找不到的指标:不硬套,也不摆内部编号 */
|
||||
unknownMetric: '(这条指标在页面上找不到名字)',
|
||||
offerMissing: '这条指标在这张卡上找不到,没有落成修改',
|
||||
},
|
||||
|
||||
// ---- 设置:口径账本一组 ----
|
||||
settings: {
|
||||
title: '口径账本',
|
||||
|
||||
@@ -5,7 +5,7 @@ import {
|
||||
Redo2, RotateCw, Save, ShieldCheck, Square, Undo2, Variable, Wand2, XCircle,
|
||||
} from 'lucide-react'
|
||||
import clsx from 'clsx'
|
||||
import { api } from '../api/client'
|
||||
import { api, ApiError } from '../api/client'
|
||||
import { FlowCanvas } from '../canvas/FlowCanvas'
|
||||
import { Palette, PALETTE_SEARCH_ID } from '../canvas/Palette'
|
||||
import { InspectorSheet, revealField } from '../canvas/InspectorSheet'
|
||||
@@ -24,12 +24,12 @@ import { topology } from '../run/derive'
|
||||
import { EDIT_LOCK_TEXT, editLockOf, toGraph, useEditLock, useStudio } from '../store/studio'
|
||||
import { useCatalog, useOnReconnect } from '../store/catalog'
|
||||
import {
|
||||
EmptyState, ErrorState, IconButton, Spinner, isComposing, promptDialog, toast,
|
||||
EmptyState, ErrorState, IconButton, Spinner, confirmDialog, isComposing, promptDialog, toast,
|
||||
} from '../components/ui'
|
||||
import { isNetworkError } from '../lib/errors'
|
||||
import { formatClock } from '../lib/format'
|
||||
import { formatShortcut, isTypingTarget, matchShortcut } from '../lib/keys'
|
||||
import { VERSION_LABEL_TEXT, WORKFLOW_STATUS_LABEL, publishedLevelOf } from '../lib/terms'
|
||||
import { STALE_SAVE_TEXT, VERSION_LABEL_TEXT, WORKFLOW_STATUS_LABEL, publishedLevelOf } from '../lib/terms'
|
||||
import type { Workflow } from '../types'
|
||||
|
||||
// 三栏的收起状态存在这台浏览器里。读写都可能抛(隐私模式、存储被禁),抛了就用默认值
|
||||
@@ -124,6 +124,9 @@ export function StudioPage() {
|
||||
const redo = useStudio((s) => s.redo)
|
||||
const attachRun = useStudio((s) => s.attachRun)
|
||||
const analyzeNow = useStudio((s) => s.analyzeNow)
|
||||
/** 保存被拒(stale_revision)时记下的两版:横幅按它写「你基于哪一版、服务端现在是哪一版」 */
|
||||
const staleSave = useStudio((s) => s.staleSave)
|
||||
const clearStaleSave = useStudio((s) => s.clearStaleSave)
|
||||
|
||||
/** 正在按 id 去取哪张图。防止 effect 重入时重复发请求、重复弹提示 */
|
||||
const resolving = useRef<string | null>(null)
|
||||
@@ -339,21 +342,52 @@ export function StudioPage() {
|
||||
if (selectedId && selectedId !== prev && !assistantRef.current) toggleAssistant(true)
|
||||
}, [selectedId, toggleAssistant])
|
||||
|
||||
const doSave = useCallback(async (note?: string) => {
|
||||
const doSave = useCallback(async (note?: string, opts?: { expectedRevision?: number }) => {
|
||||
const s = useStudio.getState()
|
||||
if (!s.workflow || s.copilot.active) return
|
||||
setSaving(true)
|
||||
try {
|
||||
await save(note)
|
||||
await save(note, opts)
|
||||
toast.ok(note ?? s.pendingNote ? `已保存:${note ?? s.pendingNote}` : '已保存')
|
||||
void refresh()
|
||||
} catch (e) {
|
||||
toast.error(e)
|
||||
// 冲突由画布上的横幅说清(两条路也在那里),不再叠一条同样的 toast——它正好落在横幅上,两条消息会盖住彼此
|
||||
if (!(e instanceof ApiError && e.status === 409 && e.code === 'stale_revision')) toast.error(e)
|
||||
} finally {
|
||||
setSaving(false)
|
||||
}
|
||||
}, [save, refresh])
|
||||
|
||||
/**
|
||||
* 冲突横幅上的「用最新版本再保存」:以服务端现在那一版为基准再存一次。这是人明确点的一次保存(横幅也是这么写的),
|
||||
* 不是自动重放——没人点,画布上的修改就一直留着、不会自己发出去
|
||||
*/
|
||||
const saveOnLatest = useCallback(async () => {
|
||||
const s = useStudio.getState()
|
||||
if (!s.workflow) return
|
||||
const base = s.staleSave?.current ?? (await api.workflows.get(s.workflow.id)).version
|
||||
await doSave(undefined, { expectedRevision: base })
|
||||
}, [doSave])
|
||||
|
||||
/** 冲突横幅上的「载入最新版本」:丢掉画布上的改动,换成服务端现在这一版。先问一句,不静默丢弃 */
|
||||
const reloadLatest = useCallback(async () => {
|
||||
const s = useStudio.getState()
|
||||
if (!s.workflow) return
|
||||
const ok = await confirmDialog({
|
||||
title: STALE_SAVE_TEXT.reloadTitle, body: STALE_SAVE_TEXT.reloadBody,
|
||||
consequences: ['画布上还没保存的修改会丢失', '载入之后可以照最新一版重新改'],
|
||||
confirmLabel: STALE_SAVE_TEXT.reloadConfirm, danger: true,
|
||||
})
|
||||
if (!ok) return
|
||||
try {
|
||||
const fresh = await api.workflows.get(s.workflow.id)
|
||||
useStudio.getState().load(fresh)
|
||||
toast.info(`已载入服务端现在这一版(v${fresh.version})`)
|
||||
} catch (e) {
|
||||
toast.error(e)
|
||||
}
|
||||
}, [])
|
||||
|
||||
const saveWithNote = useCallback(async () => {
|
||||
const note = await promptDialog({
|
||||
title: '保存并写版本说明',
|
||||
@@ -627,6 +661,27 @@ export function StudioPage() {
|
||||
{/* 停靠栏做成挤压式而不是浮层:React Flow 的 Controls 和 MiniMap
|
||||
是绝对定位在画布容器里的,浮层会把它俩埋掉,挤压会把它俩顶上去 */}
|
||||
<main className="relative flex min-w-0 flex-1 flex-col">
|
||||
{staleSave && (
|
||||
/* 保存被拒(有人先改过同一张图):画布上的修改原样留着,也不自动重发;这里给两条明确的路 */
|
||||
<div data-stale-save className="flex flex-wrap items-center gap-2 border-b px-3 py-1.5 text-2xs"
|
||||
style={{ background: 'var(--st-waiting-soft)' }}>
|
||||
<AlertTriangle size={12} style={{ color: 'var(--warn)' }} />
|
||||
<span className="min-w-0 flex-1 truncate" title={STALE_SAVE_TEXT.banner(staleSave.base, staleSave.current)}>
|
||||
{STALE_SAVE_TEXT.banner(staleSave.base, staleSave.current)}
|
||||
</span>
|
||||
<button className="btn shrink-0" data-stale-save-rebase onClick={() => void saveOnLatest()}
|
||||
disabled={saving} title={STALE_SAVE_TEXT.rebaseHint}>
|
||||
{STALE_SAVE_TEXT.rebase}
|
||||
</button>
|
||||
<button className="btn shrink-0" data-stale-save-reload onClick={() => void reloadLatest()}
|
||||
title={STALE_SAVE_TEXT.reloadHint}>
|
||||
{STALE_SAVE_TEXT.reload}
|
||||
</button>
|
||||
<button className="btn btn-ghost shrink-0" onClick={() => clearStaleSave()}>
|
||||
{STALE_SAVE_TEXT.dismiss}
|
||||
</button>
|
||||
</div>
|
||||
)}
|
||||
<div className="relative min-h-0 flex-1">
|
||||
{loadError && loadError.id === workflowId && !workflow
|
||||
? <ErrorState error={loadError.error} onRetry={() => resolve(loadError.id)} className="h-full" />
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -67,6 +67,8 @@ export function ReconcileDialog({ runId, action, related, onClose }: {
|
||||
|
||||
const launch = async () => {
|
||||
if (options && !chosen.length) { setProblem(LEDGER_UI.reconcile.pairEmpty); return }
|
||||
// 服务端没给身份的那一项(未授权)不该走到这里:真到了也只照实说,不发一个 workflow_id/version 空着的请求
|
||||
if (!action.workflow_id || action.version == null) { setProblem(LEDGER_UI.reconcile.notAvailable); return }
|
||||
setBusy(true)
|
||||
setProblem('')
|
||||
const body: LedgerReconcileIn = { query: action.query, workflow_id: action.workflow_id, version: action.version }
|
||||
|
||||
@@ -398,11 +398,19 @@ export function LedgerPart({ runId, runClass, report, segId, segText, segLedger,
|
||||
<DiffList related={where} />
|
||||
</div>
|
||||
{action ? (
|
||||
<button type="button" className="btn btn-xs mt-1.5" disabled={readOnly}
|
||||
title={readOnly ? LEDGER_UI.reconcile.readOnly : undefined}
|
||||
onClick={() => setDialog({ action, related: where })} data-ledger-reconcile-open={r.caliber ?? ''}>
|
||||
<Scale size={11} aria-hidden /> {LEDGER_UI.reconcile.button}
|
||||
</button>
|
||||
action.available === false ? (
|
||||
// 服务端没给这一项身份(当前身份没有使用授权):只是说明,不摆按钮
|
||||
<p className="mt-1.5 text-2xs text-dim" data-ledger-reconcile-refused={r.caliber ?? ''}
|
||||
title={LEDGER_UI.reconcile.unavailableHint}>
|
||||
{LEDGER_UI.reconcile.unavailable(caliberOf(action))}
|
||||
</p>
|
||||
) : (
|
||||
<button type="button" className="btn btn-xs mt-1.5" disabled={readOnly}
|
||||
title={readOnly ? LEDGER_UI.reconcile.readOnly : undefined}
|
||||
onClick={() => setDialog({ action, related: where })} data-ledger-reconcile-open={r.caliber ?? ''}>
|
||||
<Scale size={11} aria-hidden /> {LEDGER_UI.reconcile.button}
|
||||
</button>
|
||||
)
|
||||
) : r.comparable === false ? <p className="mt-1 text-2xs text-faint">{r.reason || LEDGER_UI.step.notComparable}</p> : null}
|
||||
{!!done.length && <ReconcileResults runId={runId} items={done} data={data} original={segText} readOnly={readOnly} />}
|
||||
</div>
|
||||
|
||||
@@ -47,7 +47,10 @@ function summaryOf(data: RunLedger) {
|
||||
return { ...counts, calibers, total: labels.length }
|
||||
}
|
||||
|
||||
/** 对账的入口:每条查询、每份相关口径一项;差在哪取那条查询上的比对 */
|
||||
/**
|
||||
* 对账的入口:每条查询、每份相关口径一项;差在哪取那条查询上的比对。
|
||||
* 服务端只给「确实能发起」的那一项口径身份(available):不能发起的那几项只是说明,界面上单独写一行、不摆按钮。
|
||||
*/
|
||||
function reconcileEntries(data: RunLedger): { action: LedgerReconcileAction; related?: LedgerRelated }[] {
|
||||
return (data.actions ?? []).filter((a): a is LedgerReconcileAction => a.kind === 'reconcile').map((action) => ({
|
||||
action,
|
||||
@@ -112,11 +115,19 @@ export function LedgerTurn({ runId, runClass, done, readOnly = false }: {
|
||||
<div className="flex flex-wrap items-start gap-1.5" data-ledger-actions="">
|
||||
{issue && <IssueControl runId={runId} action={issue} slot={slot} readOnly={readOnly} />}
|
||||
{reconciles.map(({ action, related }) => (
|
||||
<button key={`${action.query}|${action.caliber}`} type="button" className="btn btn-xs" disabled={readOnly}
|
||||
title={readOnly ? LEDGER_UI.reconcile.readOnly : undefined}
|
||||
onClick={() => setDialog({ action, related })} data-ledger-turn-reconcile={action.caliber}>
|
||||
<Scale size={11} aria-hidden /> {LEDGER_UI.reconcile.turnButton(caliberOf(action))}
|
||||
</button>
|
||||
// 服务端只给「确实能发起」的那一项身份:没有身份的那些是说明,不摆按钮(也就不发 undefined 的请求)
|
||||
action.available === false ? (
|
||||
<p key={`${action.query}|${action.caliber}`} className="text-2xs text-dim"
|
||||
data-ledger-turn-reconcile-refused={action.caliber} title={LEDGER_UI.reconcile.unavailableHint}>
|
||||
{LEDGER_UI.reconcile.unavailable(caliberOf(action))}
|
||||
</p>
|
||||
) : (
|
||||
<button key={`${action.query}|${action.caliber}`} type="button" className="btn btn-xs" disabled={readOnly}
|
||||
title={readOnly ? LEDGER_UI.reconcile.readOnly : undefined}
|
||||
onClick={() => setDialog({ action, related })} data-ledger-turn-reconcile={action.caliber}>
|
||||
<Scale size={11} aria-hidden /> {LEDGER_UI.reconcile.turnButton(caliberOf(action))}
|
||||
</button>
|
||||
)
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
|
||||
@@ -3,7 +3,7 @@ import {
|
||||
addEdge, applyEdgeChanges, applyNodeChanges,
|
||||
type Connection, type Edge, type EdgeChange, type Node, type NodeChange,
|
||||
} from '@xyflow/react'
|
||||
import { api, streamCopilot, streamRun } from '../api/client'
|
||||
import { api, ApiError, streamCopilot, streamRun } from '../api/client'
|
||||
import { copilotReceipt, mergeNodeConfig, toolChangesOf } from '../canvas/copilotMerge'
|
||||
import { connectMergeInput, isQueryNode } from '../canvas/mergeInputs'
|
||||
import { connectAnalysisInput } from '../canvas/analysisItems'
|
||||
@@ -519,6 +519,11 @@ interface StudioState {
|
||||
edges: Edge[]
|
||||
selectedId: string | null
|
||||
dirty: boolean
|
||||
/**
|
||||
* 保存被服务端按 stale_revision 拒了(K02:同一张图有人先改过):记下「我基于哪一版、服务端现在是哪一版」。
|
||||
* 本地图一个字没动、dirty 仍是 true,也不会自动重发;页面上给两条明确的路:用最新版本再保存 / 载入最新版本
|
||||
*/
|
||||
staleSave: { base: number; current: number | null } | null
|
||||
/** 校验出来的 error / warning。info 级的建议不在这里,在 advice */
|
||||
issues: ValidationIssue[]
|
||||
/**
|
||||
@@ -656,8 +661,10 @@ interface StudioState {
|
||||
pasteClipboard: () => number
|
||||
selectAll: () => void
|
||||
select: (id: string | null) => void
|
||||
/** note 不传时用 pendingNote(恢复旧版本时自动填的那句) */
|
||||
save: (note?: string) => Promise<void>
|
||||
/** note 不传时用 pendingNote(恢复旧版本时自动填的那句)。opts.expectedRevision 只在「用最新版本再保存」时给 */
|
||||
save: (note?: string, opts?: { expectedRevision?: number }) => Promise<void>
|
||||
/** 「先不改了」:冲突横幅收起来(本地图照旧、还是未保存) */
|
||||
clearStaleSave: () => void
|
||||
validate: () => Promise<void>
|
||||
analyzeNow: () => Promise<void>
|
||||
undo: () => void
|
||||
@@ -1058,6 +1065,9 @@ async function saveUpgrade(set: SetFn, get: () => StudioState): Promise<boolean>
|
||||
/** 上次保存(或打开)时的图。撤销回这个样子时「未保存」要消失 */
|
||||
let savedSig = ''
|
||||
|
||||
/** 正在排队的保存:同一时刻只跑一次,⌘S 连按不会拿同一个基准版本并发发两次(K02) */
|
||||
let pendingSave: Promise<void> | null = null
|
||||
|
||||
/**
|
||||
* 把一组节点从现在的位置滑到 targets,约 320ms,结束时 done()。
|
||||
*
|
||||
@@ -1200,6 +1210,7 @@ export const useStudio = create<StudioState>((set, get) => ({
|
||||
analysisError: null,
|
||||
getViewportCenter: null,
|
||||
pendingNote: '',
|
||||
staleSave: null,
|
||||
|
||||
load: (workflow) => {
|
||||
const { nodes, edges } = workflow ? toFlow(workflow.graph) : { nodes: [] as FlowNode[], edges: [] as Edge[] }
|
||||
@@ -1237,7 +1248,7 @@ export const useStudio = create<StudioState>((set, get) => ({
|
||||
copilotConversationId: null,
|
||||
copilotMemory: { past: [], total: 0, turns: 0 },
|
||||
// 撤销栈属于这张图:撤回去撤出另一张图的节点,比没有撤销更糟
|
||||
past: [], future: [], pendingNote: '',
|
||||
past: [], future: [], pendingNote: '', staleSave: null,
|
||||
})
|
||||
if (!workflow) return
|
||||
void ensureCanvasConversation(workflow.id, set, get)
|
||||
@@ -1608,22 +1619,53 @@ export const useStudio = create<StudioState>((set, get) => ({
|
||||
set({ selectedId: id, nodes: next })
|
||||
},
|
||||
|
||||
save: async (note) => {
|
||||
const { workflow, nodes, edges, pendingNote } = get()
|
||||
if (!workflow) return
|
||||
const graph = toGraph(nodes, edges)
|
||||
const text = (note ?? pendingNote).trim()
|
||||
const updated = await api.workflows.update(workflow.id, { graph, ...(text ? { note: text } : {}) })
|
||||
savedSig = JSON.stringify(graph)
|
||||
// 请求在途时又改了的话,那部分还没存:不能把「未保存」清掉
|
||||
set({ workflow: updated, dirty: graphSig(get().nodes, get().edges) !== savedSig, pendingNote: '' })
|
||||
// 升级落到画布上之后没存上(存失败、要存时锁着),这回平常的保存(⌘S、工具栏)存上了:画布上是什么就存了什么,
|
||||
// 升级要么跟着存进去了、要么已经撤销掉了,「草稿没保存上」都不再是真的。留着的话再点「重试保存」
|
||||
// 会多存一版,版本说明还写着「升级为可追溯结构」
|
||||
const u = get().upgrade
|
||||
if (u?.status === 'ready' && upgradeUnsaved(u.apply)) set({ upgrade: null })
|
||||
save: (note, opts) => {
|
||||
// 同一时刻只跑一次保存(K02):⌘S 连按、工具栏和助手同时点,都不会拿同一个基准版本并发发两次。排在后面的
|
||||
// 那一次等前面那次回来之后再发,用的是前面那次之后 store 里的基准版本;图没变时服务端也不新增版本
|
||||
const queued = (pendingSave ?? Promise.resolve()).then(async () => {
|
||||
const { workflow, nodes, edges, pendingNote, dirty } = get()
|
||||
if (!workflow) return
|
||||
const graph = toGraph(nodes, edges)
|
||||
const text = (note ?? pendingNote).trim()
|
||||
// 没有未保存的修改(⌘S 连按的第二次、刚存完又按了一下)、也没有版本说明:没有要写的东西,不发这一趟请求。
|
||||
// 下面的收尾照旧做——画布现在这一份就是已经存着的那一份(dirty 为假),「升级没存上」这类状态该跟着清掉
|
||||
const write = dirty || !!text || opts?.expectedRevision != null
|
||||
if (write) {
|
||||
// 基准版本(K02 的乐观锁):默认用读到的 Workflow.version;「用最新版本再保存」才用服务端刚回的当前版本。
|
||||
// 已接管的资产(文档起草的口径卡)服务端要求它,别的资产也照同一条走——两个页面先后保存旧图时,后一个
|
||||
// 被拒(409 stale_revision),而不是盖掉前一个
|
||||
const base = opts?.expectedRevision ?? workflow.version
|
||||
try {
|
||||
const updated = await api.workflows.update(workflow.id, {
|
||||
graph, expected_revision: base, ...(text ? { note: text } : {}),
|
||||
})
|
||||
savedSig = JSON.stringify(graph)
|
||||
// 请求在途时又改了的话,那部分还没存:不能把「未保存」清掉
|
||||
set({ workflow: updated, dirty: graphSig(get().nodes, get().edges) !== savedSig, pendingNote: '',
|
||||
staleSave: null })
|
||||
} catch (e) {
|
||||
// 有人先改过同一张图:画布上的修改一个字不动(dirty 一直是 true),也不自动重发;只把服务端现在的版本
|
||||
// 记下来,页面上给两条明确的路让人选(用最新版本再保存 / 载入最新版本)
|
||||
if (e instanceof ApiError && e.status === 409 && e.code === 'stale_revision') {
|
||||
const told = Number((e.body as { current_version?: unknown } | undefined)?.current_version)
|
||||
set({ staleSave: { base, current: Number.isFinite(told) ? told : null }, dirty: true })
|
||||
}
|
||||
throw e
|
||||
}
|
||||
}
|
||||
// 升级落到画布上之后没存上(存失败、要存时锁着),这回平常的保存(⌘S、工具栏)存上了:画布上是什么就存了什么,
|
||||
// 升级要么跟着存进去了、要么已经撤销掉了,「草稿没保存上」都不再是真的。留着的话再点「重试保存」
|
||||
// 会多存一版,版本说明还写着「升级为可追溯结构」
|
||||
const u = get().upgrade
|
||||
if (u?.status === 'ready' && upgradeUnsaved(u.apply)) set({ upgrade: null })
|
||||
})
|
||||
// 队列只用来排队:一次失败不该把后面的保存卡住(真正的失败照旧抛给调用方去提示)
|
||||
pendingSave = queued.then(() => undefined, () => undefined)
|
||||
return queued
|
||||
},
|
||||
|
||||
clearStaleSave: () => set({ staleSave: null }),
|
||||
|
||||
/**
|
||||
* 校验 + 变量分析。名字保留 validate,因为图一变就该重算的地方有八处,
|
||||
* 都在调它。
|
||||
|
||||
@@ -243,7 +243,9 @@ export interface PlanStep {
|
||||
/**
|
||||
* 发布单(服务端 blueprints/publish_plan.plan_out)。ok:没有挡路的问题(error 级)、也没停下,能确认执行。actor 是出单的人。
|
||||
* options 是出单时定下的:first_run(发布后立即跑一次,不给时看板类为真、流程类为假)、dispositions(钉住项升版的处置)、
|
||||
* spec_hash(出单那一刻卡片内容的指纹,执行时重算,对不上回 409 plan.graph_changed;服务端自己用,界面不读)
|
||||
* spec_hash(出单那一刻卡片内容的指纹,执行时重算,对不上回 409 plan.graph_changed;服务端自己用,界面不读)、
|
||||
* workflow_revision(出单时工作流是第几版,K02:执行到「保存版本」时对不上就停下重新出单,不盖掉画布上后来的修改;
|
||||
* 界面不读)
|
||||
*/
|
||||
export interface PublishPlanRow {
|
||||
id: string
|
||||
@@ -255,7 +257,8 @@ export interface PublishPlanRow {
|
||||
/** 白话摘要:每一步一句 */
|
||||
summary: { step: PlanStepKind; text: string }[]
|
||||
problems: PlainIssue[]
|
||||
options: { first_run?: boolean; dispositions?: Record<string, Disposition>; spec_hash?: string }
|
||||
options: { first_run?: boolean; dispositions?: Record<string, Disposition>; spec_hash?: string;
|
||||
workflow_revision?: number | null }
|
||||
ok: boolean
|
||||
actor: string | null
|
||||
created_at: string | null
|
||||
|
||||
+462
-4
@@ -141,13 +141,23 @@ export interface LedgerField {
|
||||
has_default: boolean
|
||||
}
|
||||
|
||||
/** 看差多少(口径对账)这一项 */
|
||||
/**
|
||||
* 看差多少(口径对账)这一项。
|
||||
*
|
||||
* `available` 是**这一项当前这个人能不能真的发起**(服务端按同一份资产授权判:应用授权给到「使用」、比对等价、
|
||||
* 绑定没被遮;builder / admin / 关登录放行)。只有 available 为真的那一项才带着口径身份(workflow_id / version)——
|
||||
* 服务端不把身份给出去的那些只是**说明**,不是操作凭据,界面也就不该拿它去发请求(真发出去入口也会 403)。
|
||||
* 人读的部分(哪条查询、哪份口径、等级、差在哪、入口字段)照旧原样给。
|
||||
*/
|
||||
export interface LedgerReconcileAction {
|
||||
kind: 'reconcile'
|
||||
query: string
|
||||
caliber: string
|
||||
workflow_id: string
|
||||
version: number
|
||||
/** 能不能真的发起对账;false 时下面两样一定没有 */
|
||||
available: boolean
|
||||
/** 要对账的那一版口径:只有 available 为真时才有 */
|
||||
workflow_id?: string
|
||||
version?: number
|
||||
node_id?: string
|
||||
workflow_name?: string | null
|
||||
level_text: string
|
||||
@@ -521,6 +531,12 @@ export interface DraftMetric {
|
||||
dimensions?: string[]
|
||||
definition?: DraftDefinition
|
||||
open_questions?: string[]
|
||||
/**
|
||||
* K04 的业务字段:统计时间口径、退款处理。指标声明了它们,取数 SQL 上的受控绑定才跟着走;
|
||||
* 界面按 binding.editable_fields 的 value_labels 把机器值翻成给人看的说法,不直接显示这两个键名
|
||||
*/
|
||||
time_role?: string
|
||||
refund_rule?: string
|
||||
}
|
||||
|
||||
/** 草稿图的入口字段:发布后按这些字段收参数 */
|
||||
@@ -581,7 +597,7 @@ export interface DraftTrialQuery {
|
||||
|
||||
/** GET /api/ledger/drafts/{id}/trial:这次自动试运行的状态和每个指标的值;POST 同一个路径按填好的入口字段再发起一次 */
|
||||
export interface DraftTrialOut {
|
||||
validation?: QualityReport
|
||||
validation?: DraftTrialValidation
|
||||
run_id: string
|
||||
status: DraftTrialStatus
|
||||
metrics: DraftTrialMetric[]
|
||||
@@ -590,6 +606,39 @@ export interface DraftTrialOut {
|
||||
error?: string | null
|
||||
}
|
||||
|
||||
/**
|
||||
* 试跑响应里的 validation。它不是一份固定的质量报告:服务端按分支给不同的东西——成功时是质量结论
|
||||
* (status + checks),另并进这次试跑对应的**验证记录**一段(K05 的 record / covers_current / note);
|
||||
* stale、needs_input、running 这些分支可能只有其中一段,甚至只有 note(老服务端也可能什么都不给)。
|
||||
*
|
||||
* 所以按**联合形状**读:status 缺席就是「没有质量结论」,不能当成通过(也不写成未知通过);covers_current
|
||||
* 可能是 null(调用方没有当前依据),只有 === true 才算覆盖。质量结论自己走 QualityReport 的类型,
|
||||
* 由页面按 status 认全之后才交给质量报告那块画。
|
||||
*/
|
||||
export interface DraftTrialValidation {
|
||||
/** 这一段自己的格式版本(服务端新加的;认不得就照实当没有) */
|
||||
schema_version?: number
|
||||
/** 这一次执行是怎么结束的(succeeded / failed / running / needs_input / stale) */
|
||||
execution?: string
|
||||
status?: 'pass' | 'fail' | 'unknown'
|
||||
checks?: ValidationCheck[]
|
||||
/** 这次试运行对应的验证记录;没有就是 null(缺证据不能算验证通过) */
|
||||
record?: DraftValidationRecord | null
|
||||
/** 这条记录还覆不覆盖当前定义/绑定:只有 === true 才算覆盖,null 是判不了 */
|
||||
covers_current?: boolean | null
|
||||
/** 服务端就这一段的一句说明(例如「这次试运行还没有留下可对应的验证记录」) */
|
||||
note?: string
|
||||
}
|
||||
|
||||
/** 带独立期望试运行的那一份:指标要逐条给全卡指标,来源是三种之一 */
|
||||
export interface DraftExpectIn {
|
||||
metrics: Record<string, unknown>
|
||||
source?: DraftExpectationSource
|
||||
sample_id?: string
|
||||
sample_version?: string
|
||||
note?: string
|
||||
}
|
||||
|
||||
/** 被丢弃的条目和原因(含 SQL 痕迹、引用核对不上) */
|
||||
export interface DraftDropped {
|
||||
name: string
|
||||
@@ -646,10 +695,262 @@ export interface DraftGroup {
|
||||
metric_ids?: string[]
|
||||
}
|
||||
|
||||
/** 草稿图上能写的口径卡:多张时 PATCH 要指明改哪一张(card_id) */
|
||||
export interface DraftCardRef {
|
||||
id: string
|
||||
title: string
|
||||
}
|
||||
|
||||
/** 按字段改一处(K03):op 只有 set / remove,path 是白名单里的字段路径,位置由 metric_id 定,不用数组下标 */
|
||||
export interface DraftOperation {
|
||||
op: 'set' | 'remove'
|
||||
metric_id: string
|
||||
path: string
|
||||
/** 只有 set 才有:写 '' 是「声明成空」、数组整份设置;remove 不接受 value */
|
||||
value?: unknown
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- K04 业务绑定能力(服务端能力描述)
|
||||
|
||||
/** 一个能按字段改的业务定义:机器值 + 给人看的说法 */
|
||||
export interface DraftEditableField {
|
||||
field: string
|
||||
label: string
|
||||
values: string[]
|
||||
/** 机器值 → 界面上写的说法 */
|
||||
value_labels: Record<string, string>
|
||||
help: string
|
||||
}
|
||||
|
||||
/** 一个取数节点上「定义 vs 取数实现」的判定结果(aligned / needs_update / unsupported / not_declared) */
|
||||
export interface DraftBindingNode {
|
||||
node_id: string
|
||||
status: string
|
||||
reason: string
|
||||
/** 该做什么:none / sync / author / manual */
|
||||
fix: string
|
||||
declared: Record<string, string>
|
||||
values: Record<string, string>
|
||||
metrics: string[]
|
||||
binding_fingerprint?: string
|
||||
}
|
||||
|
||||
/**
|
||||
* GET /api/ledger/drafts/{id} 的 binding(K04):能按字段改哪些业务定义、允许值、现在的值、定义和取数实现的
|
||||
* 同步状态、不支持时的原因和该做什么。**不给模板和 SQL**;aligned 只说定义和实现同步,不等于验证通过。
|
||||
*/
|
||||
export interface DraftBinding {
|
||||
editable_fields: DraftEditableField[]
|
||||
/** 现在的业务值:字段 → 值(各取数节点里最先出现的那一个) */
|
||||
current: Record<string, string>
|
||||
status: 'aligned' | 'needs_update' | 'unsupported' | 'unbound' | string
|
||||
reason: string
|
||||
fix: string
|
||||
/** 这次判定涉及哪些指标(metric_id) */
|
||||
metrics: string[]
|
||||
checked: boolean
|
||||
/** 每条指标声明的业务值:metric_id → {字段: 值}(工作台按它算「改这一项影响哪几条指标」) */
|
||||
metric_values: Record<string, Record<string, string>>
|
||||
unsupported_reason?: string
|
||||
binding_fingerprints?: Record<string, string>
|
||||
nodes?: DraftBindingNode[]
|
||||
/** 只有变更回执里的那一段有:这一次在同一事务里把取数 SQL 也改过来了 */
|
||||
synced?: boolean
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- K05 / K06 验证与审阅
|
||||
|
||||
/**
|
||||
* 一条验证记录的状态。**没有 pass / verified 这种状态**:matched 只是「这一次和这份期望对得上」,
|
||||
* observed 是「跑了、取了数,但没有独立期望」,都不能说成验证通过(结论看 DraftValidationSummary.verdict)。
|
||||
*/
|
||||
export type DraftValidationStatus = 'matched' | 'mismatched' | 'observed' | 'unverified' | 'failed'
|
||||
|
||||
/** 期望来自哪里:人工确认 / 固定夹具 / 独立计算。不能拿当前 SQL 的结果抄一份当标准答案 */
|
||||
export type DraftExpectationSource = 'human_confirmed' | 'fixture' | 'independent_computation'
|
||||
|
||||
/** 验证总情况里的结论(服务端现算):verified 要「有独立期望对得上」且「有覆盖它的认证审阅」 */
|
||||
export type DraftValidationVerdict = 'none' | 'stale' | 'verified' | 'rejected' | 'mismatched' | 'failed' | 'observed' | 'unverified'
|
||||
|
||||
/** 这条记录上最新的一次审阅决定(认证主体、确认范围、所审依据) */
|
||||
export interface DraftValidationReview {
|
||||
id: string
|
||||
draft_id: string
|
||||
record_id: string
|
||||
workflow_id?: string | null
|
||||
decision: 'confirmed' | 'rejected' | string
|
||||
actor?: string | null
|
||||
/** 主体是不是认证过的(关登录时自报的署名是 false) */
|
||||
verified: boolean
|
||||
/** 确认范围:这份记录覆盖的指标,可以只确认其中一个子集 */
|
||||
scope: string[]
|
||||
basis?: Record<string, unknown>
|
||||
note?: string | null
|
||||
created_at?: string | null
|
||||
/** 这条决定还算不算覆盖当前定义/绑定 */
|
||||
covers_current?: boolean | null
|
||||
}
|
||||
|
||||
/** 这次运行交回的某一个指标的实际值:值、形状、行数、遮罩,以及和期望比出来的结果 */
|
||||
export interface DraftValidationActual {
|
||||
value?: unknown
|
||||
status?: string
|
||||
rendered?: string
|
||||
rows?: number | null
|
||||
masked?: boolean
|
||||
truncated?: boolean
|
||||
shape?: string | null
|
||||
shape_ok?: boolean | null
|
||||
/** 引擎记过「业务描述和取数条件的关系还没被证明」:待人工确认的缺口,不改这次比较的结论 */
|
||||
semantic_unverified?: boolean
|
||||
findings?: string[]
|
||||
/** 期望给的、对比的那个原值 */
|
||||
expected?: unknown
|
||||
/** 对得上 / 对不上 / 判不了(null) */
|
||||
ok?: boolean | null
|
||||
}
|
||||
|
||||
/** 这一次试跑对着比的独立期望 */
|
||||
export interface DraftValidationExpected {
|
||||
source: DraftExpectationSource | string
|
||||
metrics: Record<string, unknown>
|
||||
note?: string | null
|
||||
hash?: string
|
||||
}
|
||||
|
||||
/** GET /api/ledger/drafts/{id}/validations 的一条记录(只追加,不改写旧的) */
|
||||
export interface DraftValidationRecord {
|
||||
id: string
|
||||
draft_id: string
|
||||
workflow_id?: string | null
|
||||
version: number
|
||||
card_id: string
|
||||
metric_ids: string[]
|
||||
definition_hash?: string
|
||||
binding_fingerprints?: Record<string, string>
|
||||
semantic_hash?: string
|
||||
execution_hash?: string
|
||||
method: { version: number; note: string }
|
||||
sample: { id: string; version: string }
|
||||
inputs: Record<string, unknown>
|
||||
inputs_hash?: string
|
||||
/** 没有独立期望就是 null:只记 observed,不能算验证通过 */
|
||||
expected: DraftValidationExpected | null
|
||||
actual: Record<string, DraftValidationActual>
|
||||
status: DraftValidationStatus
|
||||
problems: string[]
|
||||
run_id?: string
|
||||
trial_id?: string
|
||||
actor?: string | null
|
||||
/** trial:试跑留下的;late:到终态时补记的 */
|
||||
origin?: string
|
||||
created_at?: string | null
|
||||
/** 还覆不覆盖**当前**定义/绑定(定义、取数或绑定改过就对不上了) */
|
||||
covers_current?: boolean | null
|
||||
review?: DraftValidationReview | null
|
||||
}
|
||||
|
||||
/** 一份草稿的验证总情况;verdict 才是结论 */
|
||||
export interface DraftValidationSummary {
|
||||
verdict: DraftValidationVerdict
|
||||
/** 拿来下结论的那条记录的状态;一条记录都没有时是 none。老服务端可能不给这一段 */
|
||||
status?: DraftValidationStatus | 'none'
|
||||
/** 只有 === true 才算覆盖当前定义/绑定;false 是不覆盖,缺字段是判不了 */
|
||||
covers_current?: boolean | null
|
||||
record_id?: string | null
|
||||
review?: DraftValidationReview | null
|
||||
/** 这次被确认到的指标(确认范围):确认范围要盖住这条记录的全部指标才算整张卡通过 */
|
||||
confirmed?: string[]
|
||||
/** 这条记录覆盖、但还没被确认的指标:非空就不算整张卡通过 */
|
||||
unconfirmed?: string[]
|
||||
/** 逐状态的条数;读数缺字段时按 0 显示,不猜 */
|
||||
counts?: { total?: number; covering?: number } & Record<string, number | undefined>
|
||||
reason: string
|
||||
/** 记录里哪些指标的语义说明仍待人工确认 */
|
||||
semantic_gaps?: string[]
|
||||
method?: { version: number; note: string }
|
||||
}
|
||||
|
||||
/**
|
||||
* 字段基线 B 覆盖到哪一步(K11 的按字段推进):complete 是整张卡每一格都有基线,partial 是还有没基线的格
|
||||
* 或整条没基线的指标,unknown 是读不出来。「有没有基线」看 status,**「整张是不是都有」看这里**,两件事不能混。
|
||||
*/
|
||||
export interface DraftFieldCoverage {
|
||||
status: 'complete' | 'partial' | 'unknown' | string
|
||||
/** 逐条指标覆盖了几格、缺哪些格 */
|
||||
metrics?: Record<string, { covered: number; expected: number; missing: string[] }>
|
||||
/** 整条都没有基线的指标 */
|
||||
uncovered_metric_ids?: string[]
|
||||
}
|
||||
|
||||
/** 字段基线 B 的状态:known 有可还原的接受导入值 / baseline_unknown 没有(不能拿当前内容冒充 B) */
|
||||
export interface DraftFieldBaseline {
|
||||
status: 'known' | 'baseline_unknown' | string
|
||||
reason?: string
|
||||
artifact_id?: string
|
||||
version?: number
|
||||
content_hash?: string
|
||||
card_id?: string
|
||||
workflow_id?: string
|
||||
accepted_revision?: number
|
||||
accepted_at?: string
|
||||
metric_ids?: string[]
|
||||
field_count?: number
|
||||
/** known 不等于完整:按字段推进出来的基线常常只覆盖卡上的一部分 */
|
||||
coverage?: DraftFieldCoverage
|
||||
source_snapshot_artifact_id?: string
|
||||
}
|
||||
|
||||
/** GET /api/ledger/drafts/{id}/validations:记录(新的在前)+ 总情况 + 字段基线状态 */
|
||||
export interface DraftValidationsOut {
|
||||
draft_id: string
|
||||
/** 老服务端可能不给这一段:显示时照实说读不到,不当成「有基线」 */
|
||||
field_baseline?: DraftFieldBaseline
|
||||
records: DraftValidationRecord[]
|
||||
summary: DraftValidationSummary
|
||||
method?: { version: number; note: string }
|
||||
}
|
||||
|
||||
/** PATCH 草稿(operations 那条路)回来的变更回执:改了什么、影响哪些指标、绑定同步到哪一步、旧验证怎么失效 */
|
||||
export interface DraftChangeReceipt {
|
||||
applied: boolean
|
||||
classification: 'definition' | 'display' | 'none' | string
|
||||
card: string
|
||||
metrics: string[]
|
||||
operations: { op: string; metric_id: string; path: string; changed: boolean }[]
|
||||
revision: number | null
|
||||
definition_hash: { before: string; after: string; changed: boolean }
|
||||
validation: { invalidated: boolean; scope: string; metrics: string[]; reason: string; next: string }
|
||||
binding: DraftBinding
|
||||
}
|
||||
|
||||
/** GET /api/ledger/drafts/{id}:payload 摊平在上层(documents / metrics / dropped / open_questions / alignment) */
|
||||
export interface CaliberDraft extends CaliberDraftSummary {
|
||||
job?: { status: string; attempt: number; error?: string | null; retryable: boolean }
|
||||
|
||||
/**
|
||||
* 这份草稿的权威口径卡(K02)。已接管的草稿(有取数图的)才有:图上一张可写的卡时就是它,多张时是下游契约
|
||||
* 声明的那一张;认不出来(多张又没有唯一目标)时是 null,改的时候要显式给 target.card_id
|
||||
*/
|
||||
card_id?: string | null
|
||||
/** 图上能写的口径卡,一张一条;页面上要人挑的时候用它 */
|
||||
cards?: DraftCardRef[]
|
||||
/** 客户端要带回来的基准版本(Workflow.version):PATCH 时当 expected_revision。老草稿没有图时为 null */
|
||||
revision?: number | null
|
||||
/**
|
||||
* K04 的业务绑定能力描述:能按字段改哪些业务定义、允许值、现在的值、定义和取数实现的同步状态。
|
||||
* 已接管的草稿才有;工作台照它决定展示哪些业务修改(逐资产启用)
|
||||
*/
|
||||
binding?: DraftBinding
|
||||
/** K05 的字段基线 B 状态:有可还原的接受导入值 / 无法还原(老草稿) */
|
||||
field_baseline?: DraftFieldBaseline
|
||||
/** K05 的验证总情况:结论、覆盖判断、最新一条、审阅;整条记录走 /validations */
|
||||
validation?: DraftValidationSummary
|
||||
/** 这次 PATCH 走 operations 时的变更回执(改了什么、影响指标、绑定同步到哪一步) */
|
||||
change?: DraftChangeReceipt
|
||||
/** 这一次 PATCH 和上次是同一个 request_id(已经写进去了,没有新增版本) */
|
||||
replayed?: boolean
|
||||
|
||||
documents?: DraftDocument[]
|
||||
metrics?: DraftMetric[]
|
||||
/** 草稿图的入口字段 */
|
||||
@@ -702,3 +1003,160 @@ export interface CaliberDraftAttachOut {
|
||||
/** 对不上已有指标名的那些,由人决定新建还是忽略 */
|
||||
warnings: string[]
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- K11 增量重导入(B / L / R 三方)
|
||||
|
||||
/**
|
||||
* 一格的三方状态(app/ledger/reimport.FIELD_STATES)。**能不能接受由状态定**:
|
||||
* update(无冲突更新)/ conflict(人工改过)/ new(新增候选)/ manual(没有可比基线,要人工对齐)能接受;
|
||||
* missing(这次没提取到)**不能**——漏提取不当删除,L 上的原值原样留着;unchanged 不用接受。
|
||||
*/
|
||||
export type DraftImportFieldState = 'update' | 'conflict' | 'new' | 'missing' | 'manual' | 'unchanged'
|
||||
|
||||
/** 一条候选指标(工作项)的状态:逐字段三方算出来的 + 人处置之后的 */
|
||||
export type DraftImportItemStatus = 'pending' | 'update' | 'conflict' | 'new' | 'manual' | 'unchanged'
|
||||
| 'partial' | 'accepted' | 'rejected' | 'failed'
|
||||
|
||||
/** 一格的三方:b 是上次被接受的导入值、l 是现在图上人工维护的值、r 是这次抽出来的候选 */
|
||||
export interface DraftImportField {
|
||||
path: string
|
||||
state: DraftImportFieldState | string
|
||||
b?: unknown
|
||||
l?: unknown
|
||||
r?: unknown
|
||||
b_present: boolean
|
||||
l_present: boolean
|
||||
r_present: boolean
|
||||
/** 人处置过没有:accepted / rejected / null */
|
||||
decided?: string | null
|
||||
/** 这一格现在能不能接受(和状态一一对应,界面按它禁不禁用按钮) */
|
||||
acceptable: boolean
|
||||
}
|
||||
|
||||
/** 这条候选对上了哪条指标、凭什么(名字像不像不参与,只认稳定身份和来源证据) */
|
||||
export interface DraftImportAlign {
|
||||
metric_id?: string
|
||||
/** metric_id(候选带着稳定身份)/ evidence(按来源证据)/ new(没对上)/ manual(要人指定) */
|
||||
mode?: string
|
||||
reason?: string
|
||||
evidence?: string[]
|
||||
live_evidence?: string[]
|
||||
/** 证据比对取自哪个:baseline(B 的引用)还是 live(当前图的引用) */
|
||||
basis?: string
|
||||
/** mode 是 manual 时,对上的候选有哪几条 */
|
||||
candidates?: string[]
|
||||
manual?: boolean
|
||||
/** 引用指向的段落没进这次提示:不能当出处,记下来 */
|
||||
invisible_citations?: unknown[]
|
||||
}
|
||||
|
||||
/** 一条工作项(一条候选指标):逐字段三方 + 人的处置 */
|
||||
export interface DraftImportItem {
|
||||
item_id: string
|
||||
seq: number
|
||||
/** 对齐到的图上指标;没对齐上时是空串 */
|
||||
metric_id: string
|
||||
/** 候选自己的身份(和图上无关) */
|
||||
candidate_id: string
|
||||
/** 持久对齐键(稳定身份 + 规范化的来源证据):重新抽之后还按它认同一条工作项 */
|
||||
align_key?: string
|
||||
/** 服务端标的「这条抽坏了」(引用一段没有给过模型的原文):它上面一律不能接受 */
|
||||
failed?: boolean
|
||||
name: string
|
||||
status: DraftImportItemStatus | string
|
||||
align: DraftImportAlign
|
||||
error: string
|
||||
accepted: string[]
|
||||
rejected: string[]
|
||||
applied_revision?: number | null
|
||||
fields: DraftImportField[]
|
||||
}
|
||||
|
||||
/** 一次导入里值得单独列出来的格子(冲突 / 要人工对齐 / 漏提取) */
|
||||
export interface DraftImportConflict {
|
||||
metric_id: string
|
||||
item_id: string
|
||||
seq: number
|
||||
name: string
|
||||
path: string
|
||||
state: string
|
||||
b?: unknown
|
||||
l?: unknown
|
||||
r?: unknown
|
||||
}
|
||||
|
||||
/**
|
||||
* 一次增量重导入(GET /api/ledger/drafts/{id}/imports、GET /api/ledger/imports/{run_id})。
|
||||
* **R 只是候选,不改 L**:工作项和冲突是后台抽出来的,真正落到图上的只有「接受选定字段」。
|
||||
*/
|
||||
export interface DraftImportRun {
|
||||
run_id: string
|
||||
draft_id: string
|
||||
workflow_id: string
|
||||
/** queued / running / succeeded / partial / failed / interrupted / cancelled */
|
||||
status: string
|
||||
error: string
|
||||
actor: string
|
||||
request_id: string
|
||||
created_at: string
|
||||
items_total: number
|
||||
items_decided: number
|
||||
source_snapshot?: Record<string, unknown>
|
||||
visible_chunk_ids?: string[]
|
||||
prompt_version?: number
|
||||
parse_version?: number
|
||||
model_id?: string
|
||||
items: DraftImportItem[]
|
||||
conflicts: DraftImportConflict[]
|
||||
}
|
||||
|
||||
/** POST /api/ledger/imports/{run_id}/accept:这一次落到哪一版、是不是重放(B 和 L 在同一次提交里推进) */
|
||||
export interface DraftImportAcceptOut extends DraftImportRun {
|
||||
applied: boolean
|
||||
replayed: boolean
|
||||
revision: number | null
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- K12 受限的自然语言修改(只产出提案)
|
||||
|
||||
/** 必须先问清的澄清项:含糊业务条件(要人指定取值)或没匹配到已声明的能力 */
|
||||
export interface NlChangeClarification {
|
||||
kind: 'ambiguous' | 'no_match' | 'missing' | string
|
||||
field?: string | null
|
||||
question: string
|
||||
options: { value: string; label: string }[]
|
||||
}
|
||||
|
||||
/**
|
||||
* 一句话产出的受限修改提案:K03 同一形状的 operations + 影响摘要(preview)+ 澄清项。
|
||||
* **只读**:不落库、不新增版本;ready 为真才谈得上应用。
|
||||
*/
|
||||
export interface NlChangeProposal {
|
||||
card: string
|
||||
ready: boolean
|
||||
operations: DraftOperation[]
|
||||
metrics: string[]
|
||||
clarifications: NlChangeClarification[]
|
||||
/** changes.summary 的同一份形状(preview 为 true、persisted 为 false);服务端没给就是 null */
|
||||
preview?: (DraftChangeReceipt & { preview?: boolean; persisted?: boolean }) | null
|
||||
/** 模型自报但不作数的键(批准、审阅这类),只是照实记下来 */
|
||||
ignored_claims?: string[]
|
||||
notes?: string[]
|
||||
}
|
||||
|
||||
/**
|
||||
* POST /api/ledger/drafts/{id}/change-proposal(只预览)的回:提案 + 这次没落库(applied / persisted 都是 false)。
|
||||
* POST …/nl-change 的 confirm=true 交回的是**草稿详情**(见 NlChangeOut),不是这个形状。
|
||||
*/
|
||||
export interface NlChangePreviewOut {
|
||||
draft_id: string
|
||||
workflow_id: string
|
||||
revision: number
|
||||
card: string
|
||||
proposal: NlChangeProposal
|
||||
applied?: boolean
|
||||
persisted?: boolean
|
||||
}
|
||||
|
||||
/** POST …/nl-change 的回:confirm=false 是 NlChangePreviewOut;confirm=true 是草稿详情(带这一次的 change 回执) */
|
||||
export type NlChangeOut = NlChangePreviewOut | (CaliberDraft & { replayed?: boolean })
|
||||
|
||||
Reference in New Issue
Block a user