docs: review Mnemo evidence mapping and preserve missing evidence semantics

This commit is contained in:
Agent Workbench Dev
2026-11-06 16:07:08 +08:00
parent 01377b24c0
commit 2e85423c8e
3 changed files with 32 additions and 0 deletions
@@ -0,0 +1,28 @@
# Mnemo工程证据消费协议只读反馈
D第二切片已提交`01377b24`后,只读审阅Mnemo的`docs/integration/engineering-bridge/README.md`及`bundle.example.json`,并对照其`apps/engine/engineering-evidence.ts`和当前Workbench报告/页面原契约。没有修改Mnemo源码、启动其服务、读取旧私人运行或凭据、运行新模型/工程/Git,也没有向其他对话发消息。
README SHA-256为`9cea6d15542b6ec354509a77a59b893d3f3cddec946206a7ae4241ddd1025c39`,合成包为`8600f248b586a44d8dc1b1bd08c4c692a8eedc31627fa46e588a34830ae2fdc4`。独立离线复算其3份工件UTF-8字节、SHA、四项归属及Git commit对象头SHA-1均匹配;只证明样例自洽。收据`.qa/reminder-readback-d/mnemo-protocol-review.json`。没有做双方真实联合验收。
`mnemo.engineering-evidence.v1`是Mnemo消费包,不是Workbench已实现的原生导出或入站委托。当前报告的明确子集可以映射;包内一致、生产者身份、当前工程事实和业务质量分开,现有unknown/失败不改标,这一方向一致。
| 包内字段/类别 | Workbench真实来源 | 映射与缺项语义 |
| --- | --- | --- |
| identity四个ID | 原artifact所属projectId/sessionId/taskId/runId | 报告JSON仅有project.id/task.id/runId,sessionId须取原工件账本,不按名称补猜。外层重复归属必须仍是原事实。 |
| producer.instanceRef | 未来显式固定的生产者命名空间 | Workbench暂无跨产品可信实例标识。PID与宿主进程instanceId不适合作为跨重启固定导入键,不冒充认证身份。 |
| reportArtifactId / delivery-report | 原delivery-report JSON工件 | 使用原字节,不把Session/export或旧脱敏投影冒充原报告。消费者只选字段不等于生产者可以重序列化后沿用原SHA。 |
| lifecycle / status | engineering-delivery v1原字段 | final仅指快照结束,失败Run/in_progress/needs_*仍保留。旧版缺lifecycle须待核对,不能补成completed。 |
| check-log | checks[].results[].logArtifactId与logSha256 | 绑定原sourceFingerprint;stale、失败、空指纹、缺日志分别保留。未要求测试与未提供检查不能混同为工程失败,也不能补签通过。 |
| browser-report | browser-result原工件(内容browser-execution v1) | 外层kind映射为browser-report,内容不改。jobId、sourceFingerprint、status、原断言/cleanup、截图引用分别核对。当前未请求页面的真实status是not_requested,样例not_required不是要求生产者改写。 |
| screenshot | browser-screenshot PNG原字节 | PNG头/尺寸/字节SHA可映射;原计划、步骤、构建与browser-binding未覆盖,故不等于Workbench完整页面核验,更不证明业务通过。 |
| git-commit | 将来显式导出的git cat-file commit原字节 | Workbench报告不默认保存原commit对象。缺对象保持待核对;不能重做提交或只用commit文字补签。对象SHA不验证tree内容、当前HEAD/索引或创建进程。 |
| diff / source | 显式选取且原归属明确的工件 | 不抓取报告中的任意本机路径/URL,不引入原提示、私有上下文或执行权限。包内字节一致不证明补丁可应用或源码可重建。 |
有两处兼容边界须在自动适配前确定:
1. Workbench的报告是Task汇总,checks/browserChecks可能来自同Task的多个Run;Mnemo当前包要求所有工件同一runId,页面正文也必须等于包runId。不能把旧Run工件盖成当前Run。首版只选单Run自足报告,或者保留原报告并省略无法同Run装入的引用、明确缺项;若要完整多Run消费,双方另扩版本/归属规则。尤其不能剔除失败检查后把Task总体改标为通过。
2. Mnemo的512KiB/16工件/单工件256KiB是消费包约束。真实报告、日志或PNG可能超出;自动导出须报告unsupported/omitted及原因,不能截断/缩图后沿用原SHA、悄悄丢失败或宣称全部导入。原产品执行和模型透传不因此增加额度限制。
当前Mnemo会把缺日志/对象/截图显示为pending,类别/摘要/归属不符拒绝,能保留已报告失败。此有限核对与Workbench当前源码/检查计划/要求修订/浏览器计划/Git文件及非目标索引的完整核验仍有差别。新增reminderObservations可被其子集消费忽略,不据此新增模型收益结论。
下一协议开发仍需分别解决:显式选择与脱敏导出、稳定实例命名空间、同Task多Run引用、缺项清单、实际字节来源、调用方范围与撤销、委托幂等/取消/unknown恢复,最后再另冻双方真实联合验收。此次不新建会话或自动化。原AE/AD、历史网络失败、unknown用量和AG/Purge收益unknown保持。
@@ -1,5 +1,7 @@
# Workbench 只读证据接续
补充:D阶段安全提交后已只读核对Mnemo新`mnemo.engineering-evidence.v1`消费包;字段映射、单Run与Task汇总差异、超限缺项及未实现边界见[新协议反馈](MNEMO-ENGINEERING-EVIDENCE-REVIEW-2026-11-06.md)。合成字节/对象自洽不等于双方真实验收,旧样例原字节不改。
已阅读 Mnemo 的 `2026-11-06-model-research-review.md` 和 `model-bridge/README.md`。本条仅本地反馈,不向其他对话发送消息,不执行联合模型或新工程。三产品权限、认证、记忆和费用独立;不要求 Mnemo 继承 Workbench 全局完整历史或完全访问偏好。
当前有本地 Session/export、Task/Run、变更、检查、页面及 Git 工件读取,execution/export schemaVersion 为 1;**尚无面向受托调用方的稳定版本化只读服务或入站委托契约**。现有 Host/Origin/token 是本地访问控制,不能充当远程受托身份;出站 Harness SDK 也不等于入站服务。入站版本协商、调用方资源范围、幂等受理、游标恢复及撤销隔离仍待独立开发。
+2
View File
@@ -1981,3 +1981,5 @@ D API首轮调用的共享bundle来自哈希修复前,故提醒原文已发送
D独立候选首轮缺hot-upgrade/host-launcher导致宿主登记拒绝,api-round-2保持;candidate-2补齐原必需输入后HTTP1+Runtime12共13/13通过,源码35/35通过,网页7组通过。已实际查看1440设置与390回读截图。复核后再补不可变context-plan归属核对及JSON/Markdown报告的独立提醒事实,未将提醒解决判为业务交付。
D第二切片收口:实际Electron7组同样通过,0页面错误/真实模型;相关95/95及最后补强后的candidate-3独立23/23通过(534输入,server2023af85)。网页/Electron原后端a33704da不冒称最后补强,最终发行载荷另验。已复核默认关闭、实际fetch提交与wire SHA、不可变计划/原B/工具回读、开关/取消/故障隔离及报告单列;原失败不改。准备定向提交,安全边界后只读核对Mnemo新证据消费协议,再准备1.25.10独立发行。
01377b24安全边界后只读核对Mnemo新消费协议及实际解析子集,独立复算合成包3工件/四ID/Git原对象头摘要通过。反馈明确Task汇总多Run与单Run包不完全兼容、容量超限必须显式缺项、会话ID取原工件、原字节不重序列化;未操作Mnemo源码/服务/旧私人运行或真实模型,未发跨线程消息。接续1.25.10发行。