diff --git a/docs/integration/MNEMO-PROJECT-MEMORY-BRIDGE-V1-READONLY-2026-11-07.md b/docs/integration/MNEMO-PROJECT-MEMORY-BRIDGE-V1-READONLY-2026-11-07.md new file mode 100644 index 00000000..e99dc9b3 --- /dev/null +++ b/docs/integration/MNEMO-PROJECT-MEMORY-BRIDGE-V1-READONLY-2026-11-07.md @@ -0,0 +1,49 @@ +# Mnemo 单项目记忆桥 v1:Workbench 只读反馈 + +2026-11-07,当前工作仍为 [I27/I28 CI](../M2-CI-PLAN.md)。本次只读合同与已有挂点,不接通服务、不修改配置/用户项目/旧发送工件,不作真实联调、模型质量或 Git 工程交付声明。本反馈仅保存本地,不因协调消息向其他对话发送回复。 + +已核对源文件 [Mnemo 契约](D:/Ai-project/Mnemo/docs/integration/project-memory-bridge/README.md),SHA256 与指定值逐字一致:`8bb95af9bdc2c6142c6c6c0ad3bb2c9b5a371417552bc08f881cefad7f2cc41f`。目录当前仅此 README,尚未取得共享 digest 实现/规范测试向量或消费端本次实际验证原件。协议是新增的 `mnemo.project-memory.v1`,不是已经接通的原生能力。 + +该核对是最初读取的时点观察。稍后准备只读封存时,源 README 已被并发更新,固定 SHA 核对失败即停止;新原文单独保存为 `.qa/m2-ci-2026-11-07/mnemo-project-memory-bridge-current-drift.md`,对应机器记录 `mnemo-readonly-drift.json`。未默默采用新版本或把最初观察改成当前仍一致,接入需新固定合同及共享向量后另验。 + +| 契约项 | 已有 Workbench 与需补的差异 | +| --- | --- | +| producerId + projectId | 项目已有持久 ID;服务重启 instanceId/文件路径不能作为 producerId。需单独持久 UUID 和显式单项目绑定,默认关闭。 | +| 用户确认 / candidate | 本地记忆 `status=current` 与来源核对不能单独证明用户确认。需保存确认主体/时间;模型产出只映射 candidate,不能从已有状态推断 `by=user`。经验采用有自身修订,不能混同普通记忆确认。 | +| sequence / version | 本地记忆 ID、createdAt/updatedAt 与经验修订不是桥的持久递增 sequence。需来源级事件序号、原版本与原键,并原子持久化;不得用墙上时钟或重启补造。 | +| fingerprint / manifest | `ProjectMemoryManager.list/context` 已有实际来源和工程检查指纹。只复用本次完整核对的原值;远端摘要不能充当本地 sourceFingerprint。不能复用旧 context 工件生成新 manifest。 | +| digest / 原键 lookup | README 指定规范 JSON 的 SHA256,但没有完整字段顺序、Unicode/null/遗漏规则的共享向量。接入前需固定该实现/向量 SHA;超时先按持久原键 lookup,unknown 不重发不同正文。 | +| 状态 / 删除 | 已有本地归档、expired/unverified 和来源变化检测;需新增 withdrawn/deleted 持久事件与永久墓碑关联。删除不能通过新绑定/高序号复活,旧工件仍保留其原时点内容。 | +| recall / validate | 已有 runtime 在 requestPlanner.prepare 前取得本地 projectMemory。远端需完整 manifest→recall→validate,最终核对须绑定本次物理请求及当次本地来源,召回后任何变化/到期/撤权都不使用旧远端条目。该核对不是新增模型执行审批。 | +| 标签 / 历史 | 现有 context 标为 source-checked-project-memory。远端应独立 `authorized_project_mirror`,记录 Mnemo/来源 ID、修订、摘要、授权代次及当前请求绑定,不能伪装本地核对或改写历史发送原字节。 | +| 凭据 / 存储 | 需独立桥凭据槽和引用,不能借模型 Key 或把凭据写日志、备份、请求工件。只能消费该项目接口,不扩大任务、模型、工具或费用权限。 | + +具体源码挂点为 [项目记忆](../../src/core/memory/project-memory.mjs) 的 `context` 与 [Runtime](../../src/server/runtime.mjs) 的 `memoryManager().context → requestPlanner().prepare`。已有非完整扫描返回 null 的语义可以保持;失效远端记忆同样应省略,工程修复和用户完整历史继续正常发送,不能降级到旧缓存。 + +后续独立切片需要固定共享 digest/请求响应 schema/错误分类与消费端结果,增加持久绑定、来源事件及发送前二次核对。首验收只用新合成项目与受控 HTTP,覆盖确认同步和新会话实际请求正文、候选/项目/凭据隔离、原键冲突与 unknown、变更/归档/到期/删除/撤权、recall 后变化及旧发送 SHA exact;不重放历史工程、不发送付费模型、不以测试工程提交 Git。备份/恢复及 Mnemo 147 冻结由对方实际证据另列。 + +当前证据是上述源文件固定 SHA、对应源码只读观察及本地反馈;尚无消费端联调或 Workbench 原生接入通过证据。继续原 CI 及 M3/M4 路线,历史网络/unknown、缓存/重复读/真实交付/Purge 收益结论不变。 + +## 验收后补充规范的只读接续 + +随后收到 U2-B4a 消费端补充。重新固定读取七份指定文件,全部 SHA 匹配,并在 `.qa/m2-ci-2026-11-07/mnemo-readonly-final-1/` 保存本次原字节与 `registration.json`。其中初始 `README.sent-2026-11-07.md` 的 `8bb95af9...` 也取得原副本,不再以后来变化的 README 冒充初始正文;前文最初工具读取与漂移拒绝仍保留。 + +| 本次固定原件 | SHA256 | +| --- | --- | +| README.sent-2026-11-07.md | `8bb95af9bdc2c6142c6c6c0ad3bb2c9b5a371417552bc08f881cefad7f2cc41f` | +| README.md | `777d0617f08bb30a4f1df9eb0b9d30c4ccb1246a1c1246c69846f913da24ceb7` | +| PROTOCOL.md | `7689cf34ab14d4c5608aa87ee95ea4fd4b33bb65eac46fe44be6d916d3d34379` | +| USER-GUIDE.md | `9f0e63efe7c70e25dfb8992982f16d989ea8890ddcc20c0cdd04ea572c5859d6` | +| producer-project.example.json | `c2b9d21943c67664b0495ffcccd72975ae1809c457c96d07fb76e2984eb0e494` | +| digest-vectors.json | `2ed45ff142981131b9442c76ebddc41625ee0270b4fc95a15fea5acb90bad7e0` | +| project-memory-validation.json | `ace7d420248815a4b5bb1ad28ee7466d5b84b796cbf5f84b89593fe8d5e3f1cb` | + +摘要的字段顺序、UTF-8/显式 null、ASCII 来源排序、checkedAt 排除及独立期限现在有明确规范。按原向量独立复算五组:三个 source/event 与原 JSON 字节、manifest 的排序/换核对时间、context/refs 都匹配,记录 `offline-vector-review.json`。这是只读字节分析,固定示例时间没有验证实时 freshness、旧快照期限或服务状态;未运行 Mnemo SDK/服务,也未复跑对方的 203/485/33 项和强杀验收。 + +再次核对当前源码:`ProjectMemoryManager.context` 仍只生成 `source-checked-project-memory`,含真实来源指纹/核对时间及本地条目,没有桥的来源 sequence/version/明确用户确认、连接授权代次、原键/永久墓碑。`Runtime` 的 `memoryManager().context → requestPlanner().prepare → provider.complete` 取得文档、封存请求计划并进入 Provider;发送回调只记录提醒,尚无桥的 recall/validate 绑定。这些挂点已存在,原生适配仍缺。 + +后续 B4b 需同时绑定本次完整本地来源、manifest、recall/snapshot、validate/contextDigest、Run/请求计划和实际物理发送 ID。连接描述本身不授权,正文不得从本地 `current` 推断用户确认;远端记忆独立标记 `authorized_project_mirror`。私有候选、永久墓碑、原键 unknown→lookup、续期/撤权、召回后变化、备份旧包未知删除均按新固定合同单独验。桥自身的字段/体积上限不能变成模型上下文或输出额度,也不能静默裁剪本地原正文;失效远端条目不回退旧副本,用户原对话和既往发送字节继续保持。 + +本次没有接通桥、改变工作台配置、读取凭据、请求模型、派发工程或回复源线程。仍先完成 I27/I28 CI,再按既定路线推进,Mnemo 联合验证另开新的合成范围。 + +2026-11-08 接续只复核上述本地七份固定原件与五组离线记录,首次只有 README、后续漂移拒绝和最终共享向量属于各自时点,未以当前文件替换原观察。此反馈单独提交;CI 最终冻结仍是 `4a03ec52`,文档提交不代表桥接服务或远端消费端通过。