Files
Agent-Workbench/docs/M3-RELEASE-PLAN.md
T
Agent Workbench Dev 2f2b459c18
Official contracts and Windows source CI / windows-source (push) Has been cancelled
docs(release): record 1.25.13 delivery and verified GitAtlas push
2026-11-11 03:45:59 +08:00

36 lines
6.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# M3:统一发行、schema2 迁移与保留结果的回退
2026-11-11 更新:M3+B4b 已作为 1.25.13 正式交付,来源35a6d6d9,独立1399输入/30编译、实际Inno11/11、F跨版7/7及Mnemo两端工程验收通过;唯一正式Setup成功,原PID63892及全部原数据保持,公开新增字段单独核验,正式四图和final通过。见[发行验收](QA-MNEMO-RELEASE-1.25.13.md)与[机器身份](mnemo-1.25.13-release-identity.json)。源码/验收1e309700已普通增量推送且远端/fetch逐SHA一致,见[回执](gitatlas-mnemo-1.25.13-push.json);下方未发行段落为历史。兼容恢复仍为同源程序副本,真实Mnemo生产绑定/语义及Purge收益未验证。
后续接续更新:在M3源码/隔离验收后,B4b已按明确授权实现默认关闭的Mnemo单项目记忆桥并完成25项工程证据及最后相关104/104,见[B4b验收](QA-B4B-MNEMO-NATIVE.md)。M3+B4b仍未提交或统一发行,不改变本计划步骤5的最终产品身份、源码/程序/安装器及独立安装要求;下方“B4b只登记”是M3原收尾时点。
2026-11-08收尾:步骤1–4的源码及隔离验收已完成,见[验收与回顾](QA-M3-MIGRATION-RECOVERY.md)及[机器记录](m3-migration-recovery-2026-11-08.json)。最后1117输入/30编译独立clean依赖重建exact,相关82/82、实际F载荷7/7、两端各5组通过;原失败与未知保持。兼容recovery为同源编译的另一副本,未证明回到不同旧业务版本。当前未提交,按本轮约束不自动Git交付/发行/正式升级;步骤5的最终commit、版本、源码/程序包/InnoSetup及正式安装仍待,不将本轮称为M3统一发行完成。B4b只登记接续、不自动切换。
2026-11-08,承接 [官方优先路线](DEVELOPMENT-ROADMAP-OFFICIAL-FIRST.md) 和 [I27/I28 CI](M2-CI-PLAN.md)。最终 Windows CI 从 `4a03ec52` 自然完成146文件1222/1222及实际两端7组4图,[验收](QA-M2-CI-OFFICIAL-CONTRACTS.md)已封存;远端runner/job尚未验证。下文保留立项时的基线、实施顺序与结束条件;当前完成范围以上方收尾和验收为准。正式状态仍仅引用 F 的历史记录,不进行新的 health 查询。
本批源码发行不包含用户项目或运行数据。安装和回退验证另用新建合成项目、独立安装/数据目录与本次记录的端口;正式激活在独立载荷和跨版验收完成后才进入发行步骤,不自动续跑旧实验或用户任务,不读取/复制真实模型 Key。
## 立项时确认的问题
原[安装器](../src/core/desktop/install-manager.mjs) 的 `snapshotPersistentData` 核对原表全部行与工件,激活后按完整快照相等判断。这会拒绝合法新增的请求账本表和迁移标记;本轮已按精确增量修复,原行核对继续保留。
[请求账本](../src/core/models/request-ledger.mjs) 在事务中增加 `model_attempts`、索引、`modelAttemptLedger` 并提升 user_version 为 2,原 `modelAttempts` metadata 字节保持。[存储](../src/core/storage/state-database.mjs) 的新读法投影完整账本;旧 schema1 程序不具备这些读写语义,fresh open 也会拒绝 schema2。
[热升级](../src/server/hot-upgrade.mjs) 和现有 `rollbackInitialization` 只证明“初始化后没有新增或修改结果”的失败可撤销。新处理器产生记录后,它明确拒绝删账本,不能把这条守卫去掉来制造旧版回退成功。
## 实施与验证顺序
1. 固定最后通过 CI 的产品/测试/构建输入、原 F 载荷及新合成 schema1 基线,保存安装指针、宿主身份、全部表行和工件、原 metadata 与合成凭据字节。先独立复现现有安装器对合法迁移的拒绝,保留原操作记录。
2. 为候选声明精确的迁移身份和增量:来源/目标 schema、对应源码、原账本 metadata SHA、逐条 legacy_position 和 current/initial payload SHA、新表/索引及标记。安装器只接受这一已核验迁移;原有表行、原工件、原配置字节仍逐项核对。覆盖少行/重复归属/同长度篡改/未知标记/额外表/错误 schema/并发变化;失败不自动重发请求。
3. 区分两个回退场景。尚无新结果的初始化失败继续验证原宿主、指针和数据 exact 撤销;已产生结果的回退必须保持 schema2 和完整账本,选择具备 schema2 读写能力的恢复载荷。未经适配的原 schema1 载荷不作为后者的可用回退目标,不能通过降 schema、删新行或覆写旧 metadata 适配它。
4. 在实际安装载荷中完成 schema1→schema2 激活,用本机受控供应商产生新的成功、原上游错误和 unknown 请求记录,再实际切换恢复载荷。核对新旧 initial/current 原字节、全部当前行和工件、宿主/Provider 保持及重复工具执行为零;随后真正关闭并重启,验证完整读取/分页/导出以及下一次请求继续写入同一账本。热状态能读不能代替 fresh open 通过。
5. 冻结最终版本和产品 commit,独立生成源码包、程序包、安装器及清单;新干净构建、实际跨版安装与回退、关键 wire、网页/隐藏 Electron 核心路径分别通过后,封存并提交。正式安装再核原数据/配置/工件和公开凭据存在状态,保留原错误;源代码发布与这一步的数据保持核对分开记录。
## 结束条件与保持事项
每阶段通过相关验证后限定提交;输入变化重新验证受影响范围,文档变化不重复程序全套。恢复载荷的来源、版本、兼容范围必须先冻结并实际验证,目前尚未实现或选择发行编号。若回退事实不完整,保留原错误和当前数据并如实记录未验证,不把删除数据写成恢复。
默认 unrestricted/passthrough/preserve 和持久 ask/auto/full 不变。这里的安装数据保持与用户要求的无本地模型额度分别处理,不新增任务逐步审批。GitAtlas 本地 CI 与远端 runner/job 分别记录;本批不安装持久 runner。
M4 新真实官方/代理基线在统一发行之后另冻;W/AD/AE/AG 网络与 unknown、重复读取普遍收益、R/W v2 真机剔除边界以及 Purge 收益 unknown 继续保持。Mnemo 仍只有 [固定原件只读登记](integration/MNEMO-PROJECT-MEMORY-BRIDGE-V1-READONLY-2026-11-07.md),不以本计划代替原生接入或联合验收。