Files
Agent-Workbench/docs/MODEL-REQUEST-LEDGER.md

4.9 KiB
Raw Permalink Blame History

完整请求账本

模型中心的请求账本保存全部现有请求,支持前后页、历史连接/结果/原文筛选、刷新、完整范围导出以及原请求/响应下载。每页默认 50 条是展示分页,不是模型输出额度或保存上限。旧版本已经删去且没有原件的记录不能由迁移补造。

保存与原始来源

model_attempts 位于原 workbench.sqlite,用递增 seq 区分每一条记录。旧 metadata.modelAttempts 在一次事务中完整迁入;原 metadata 的文字和 SHA256 保持不变。重复的旧尝试 ID 分别保存,不因 ID 相同合并或删除。详情按序号读取;只按歧义 ID 读取时要求核对原序号。

每条保存当前 payload、最初 initial_payload、双方 SHA256 和旧数组位置。正常进度只更新所属当前尝试,未变化的记录不产生提交。连接、模型、协议、pool、项目、会话、Task、Run、request 身份不能被移到另一份记录;已有另一份保存进展时不覆盖。用量 raw、未报告/unknown、上游原错及原请求/响应工件引用保持原值。

重启后仅把仍为 running 的尝试记为 unknown,并保存核对原因;不重发请求、不重复工具,也不补造真实计费。初始记录继续保留重启前的状态。

账本协议版本是 1;采用它的 SQLite 数据库版本是 2。数据库版本只在账本迁移事务成功时提升,公开诊断返回实际版本。以前只支持 schema 1 的程序不能重新打开 schema 2 并把旧 metadata 误当全部历史。失败的同步处理器接续只可撤销经过核对、尚无新结果的初始化迁移;已有新增/变化记录、SHA 或归属变化时不删除账本。

旧 ModelHub.attempts 及 storage.meta('modelAttempts') 在新程序里仍可取得完整兼容视图,但普通请求不全量加载或回写数组。直接 SQL 读取原 metadata 的旧实验驱动只看到其冻结历史;不改写、重跑旧实验,新驱动应使用以下接口。正式安装的数据迁移和跨版本回退仍按 M3 单独验收。

查询接口

接口沿用当前工作台的连接凭据和本机来源核对,不发出模型请求。

路径 返回
GET /api/model-center/attempts 当前页、每条序号/当前与初始 SHA、完整保存数、范围数和下一页游标
GET /api/model-center/attempts/<sequence> 本条当前记录与初始记录、来源和双方 SHA
GET /api/model-center/attempts/export 当前筛选范围的全部 NDJSON 记录

筛选参数为 connectionId、sessionId、taskId、runId、status、model、protocol、query。query 查原记录文字,百分号与下划线按文字处理。重复/无效参数会指出本机查询错误。已删除或关闭的历史连接仍可在现有账本中选择;读取失败保留所选连接、结果和搜索文字。

分页另接受正整数 limit 与 cursor,没有固定最大页额度。游标绑定本次账本身份、全部筛选和序号上界,后续新请求不会挤进原页。页上的运行中字段仍可能更新,尤其状态筛选的结果可能变化;这是序号范围分页,不是不可变字段快照。游标范围或来源变化时刷新即可取得新范围,不能跨连接/筛选混用。

/api/model-center 继续提供最近 100 条兼容预览,同时返回真实 attemptCount、是否还有历史及增量保存方式。完整账本不依赖这个预览范围。运行巡检也使用真实保存数。

完整导出

导出使用独立只读 SQLite 连接和读事务固定记录/字段快照,期间新请求与进度更新不影响已开始的导出。服务端逐条等待实际写入回调,不因缓冲区已清空而继续等待不存在的 drain。接收端关闭或写入失败时释放快照,不发送伪完成结尾;没有完整 footer 的片段不能当作完整导出。

NDJSON 每行末尾是 LF:

  1. header:格式 orven-model-attempts-ndjson、协议版本、筛选、序号上界、预期条数、来源和 includesInitialReceipts: true。
  2. 每条 attempt:序号/来源/SHA 引用、完整当前 item 和完整 initial.item/initial.sha256。
  3. footer:complete: true、实际条数、所有 attempt 行含 LF拼接的 recordLinesSha256。

核对 header/实际/footer 数量、每条当前与初始 JSON 的 SHA,以及所有记录行的 SHA。原始工件正文不嵌入这个导出,继续按所保存的 session/工件 ID/SHA 从原入口下载。浏览器客户端取得完整文件后下载 Blob;Electron 使用真实 DownloadItem,验收选择自有路径,Windows 保存对话框另未验证。未以这项功能宣称大规模客户端流式落盘、总体性能或真实供应商缓存收益。

实现和验收见 切片计划 与 阶段验收。历史真实模型失败、网络异常、unknown 用量、重复读取和 Purge 收益 unknown 均不改变。