technical

Run Terminal Backwrite

说明当前模块一新增的 queued-run 终态回写路径:如何把 accepted preview 写成 queued run,再由 control plane 模拟完成并落账。

Audience

开发者 / 测试

Updated

2026-03-29

Source

docs/run-terminal-backwrite.zh-CN.md

当前闭环

  • run-preview
  • accept-run
  • queued run
  • complete-run
  • accepted terminal writeback
  • explicit terminalResult
  • explicit executorArtifacts

当前写入对象

  • workflow_runs
  • workflow_run_steps
  • credit_transactions
  • audit_events
  • GET /api/runs/:runId

当前语义边界

  • accept-run 负责预留 credits 并创建 queued run
  • complete-run 负责把 queued run 推进到 accepted 并补写 terminal ledger
  • 当前是控制面模拟完成,不是浏览器执行器真正消费
  • Day 11 第十七刀已把 terminalResult 暴露给 complete-run 与 run detail,Runs 工作台可以直接显示 sink、review summary 与 field/value 列表
  • 后续真实执行器只需要复用这一条 terminal backwrite 边界,不必重做前面的收费与审计合同