docs(release): plan exact schema2 migration and result-preserving rollback
This commit is contained in:
@@ -54,3 +54,5 @@
|
||||
- 本次提交前辅助索引核对误猜专项快照名`inputs-before.json`,实收ENOENT并以exit1停止,未继续提交。按实际证据文件名核对后再提交;这是辅助读取错误,不改原专项统计或产品。
|
||||
- 必要CI专项辅助记录器首命令id误含`.mjs`被既有仅字母/数字/横线守卫拒绝,尚未启动任何测试。原helper/已创建输入保留,另存check-2用稳定数字id后再执行;不更改产品记录器或放宽守卫。
|
||||
- 运行时/研究/任务广告修复已限定提交`87ca0751`,暂存字节与22项专项冻结输入逐SHA一致。提交前八图/八DOM SHA和PNG实际尺寸复核通过,最新两张原生图本次再次实看;两轮记录PID均不存在、TCP65462/62009重新实收拒绝,只观察自有QA端口。提醒/导航/截帧最终代码语法与CI pipeline8/8通过,来源SHA前后一致,`requireLoadedModelCard`仅记录语义更名;下一限定提交后以最终已提交源码另起真正干净Windows全套。
|
||||
- 提醒/导航/截帧与本次进展已提交`4a03ec52`;最终干净`run-windows-mw6lllq7-33d6c439`从此commit导出1376输入(源码ZIP5105901字节),真正npm ci40965ms、新venv/带哈希依赖、显式镜像Electron/官方checksum30666ms与build7013ms均通过,全部146文件正在运行。随后Mnemo只读文档单独提交`1a9c51b1`,没有改变最终已冻结的程序/测试输入,不以当前文档HEAD冒称其冻结来源。
|
||||
- 独立预读M3时误猜旧core-database、model-attempt-store/request-ledger-store路径且使用PowerShell不展开的storage通配路径,rg实际读取报错;改为`rg --files`列出的storage/ledger输入及`install-manager.mjs`,仅规划观察,未写安装/存储实现或正式数据。
|
||||
|
||||
@@ -0,0 +1,29 @@
|
||||
# M3:统一发行、schema2 迁移与保留结果的回退
|
||||
|
||||
2026-11-08,承接 [官方优先路线](DEVELOPMENT-ROADMAP-OFFICIAL-FIRST.md) 和 [I27/I28 CI](M2-CI-PLAN.md)。当前最终 Windows CI 从 `4a03ec52` 运行中;本文件准备下一批的实施和验收,不宣称迁移、安装或正式部署已经通过。正式状态仍仅引用 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),不以本计划代替原生接入或联合验收。
|
||||
Reference in New Issue
Block a user