Files
Agent-Workbench/docs/MNEMO-PROJECT-MEMORY-BRIDGE.md
Agent Workbench Dev 1e3097004e
Official contracts and Windows source CI / windows-source (push) Has been cancelled
test(release): accept 1.25.13 installation and Mnemo bridge
2026-11-11 03:45:07 +08:00

3.5 KiB

Mnemo 单项目记忆桥

这是默认关闭的可选项目记忆来源,沿用工作台的项目记忆入口。它共享用户明确确认的来源修订;不改变模型输出、上下文透传、累计额度、完整历史或持久执行权限,也不新增工程执行审批。

连接和共享

  1. 打开工具箱 → 项目记忆 → Mnemo 项目记忆桥。核对界面显示的生产者和项目 ID,在 Mnemo 为这一组合创建明确授权的项目绑定。
  2. 填写 Mnemo 根地址、项目绑定 ID 和本次项目凭据,再启用并保存。公网使用 HTTPS,本机可用 loopback HTTP;地址不能带路径、查询、跳转或内嵌凭据。凭据保存后输入框清空,仅在当前宿主内存保留。重启或恢复后需重新授权,不会从备份自动恢复授权。
  3. 选择一条来源,核对完整正文、来源、工程指纹和到期时间;展开“查看完整来源修订与摘要”可看所有纳入确认摘要的字段。勾选核对后,可以提交候选或确认并共享。候选不会进入后续模型请求;确认针对所显示的确切修订,旧页面不能确认服务端的新修订。
  4. 核对该来源的同步回执。只有已确认、来源仍匹配、未到期且收到提交回执的条目,才可能成为后续请求的远端来源。本地记忆和远端来源分开记录。

“每次选入的桥记忆条数”只控制这一可选来源的整条选择,不限制用户消息、本地记忆原文或模型能力。桥协议不能接收的材料明确不入桥,本地原文保留;工作台不会截短材料后假称完整同步。

回执与异常

任务记录 → 请求上下文 → Mnemo 记忆来源,可查看本次 Run、请求计划、来源序号和远端修订、召回摘要、实际选入摘要,以及每个物理请求的核对和发送状态。桌面可打开完整召回、所选来源和发送前核对工件;伴随手机页显示同次项目授权范围内的摘要和回执。

每次物理尝试重新核对来源并校验快照;召回两条、选入一条时两份摘要和 refs 分别保留。来源变化、到期、撤权、服务错误或校验失败时省略远端记忆,原任务继续。已经发送的请求不会因桥错误重发;发送前发现选择失效时保留旧计划,再准备一次不含远端记忆的原任务。

同步结果未知时使用“查询原键”,核对已持久保存的原同步键。未明确核对前不会换键重送。模型请求已接收但响应断线仍按原账本记为 unknown;桥接收器的记录不能把模型账本补签为成功,也不补造费用。

可撤回共享或永久删除桥来源。永久删除保留墓碑,清除桥中可恢复的同步包正文;本地原记忆与过去已发送的请求工件保留。续期、同目录旧备份恢复和更高序号不能复活已知墓碑。该操作不宣称已删除任何外部系统的历史副本。

已知边界

核对证明来源声明和当时的内容一致,不认证记忆结论正确,也不授予工程执行权限。跨系统 validate 和模型发送无法保证原子性。当前工程验收采用新本机合成项目及受控 HTTP 接收器;真实生产 Mnemo 绑定、真实模型质量、长期 7/30/90 天效果、物理手机和 Purge 收益分别待验。记忆桥已随 1.25.13 正式发行并激活,默认关闭;见发行验收。连接实际 Mnemo 仍需按上方入口填写该项目在 Mnemo 已授权的地址、绑定和凭据。