Files
MapLibreParticleLab/recoder_step.md

36 lines
3.9 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.
# recoder_step.md — MapLibre 上游升级实施流水记录
> 中文追加式记录。每个已完成/阻塞阶段记录事实、commit、当前状态与下一步;不覆盖旧记录。仅适用于隔离升级分支,不代表正式版本发布。
## 2026-10-09 / STEP-104 / Gate 0
- 用户确认目标:以官方新版 Native 为底座重放自研 Particle + RenderSegment,并建立可重复升级流程。
- 执行模型:GPT-6.1 Sol / High(待实际会话核实);RDC 负责独立构建和验收。
- 升级分支:`upgrade/android-native-13.6.1-20261009`,独立 Mac worktree。
- 官方新基线:Android Native `13.6.1`,commit `c7506d6aff3800e946f89e1a51432fc22d1a6534`。
- 旧扩展来源:发布 .21 `630ec657687bad4200c059bbccbb950d9c6f7ce9`;审计文档闭环 `b433775348373b10fba02dc0e1f728bacd72f9e7`。
- 当前状态:官方代码已检出,尚未移植自研修改,尚未编译,尚未发布。
- 下一步:与旧扩展历史三方合并;逐项处理路径重命名、Renderer 接口及模块注册,不覆盖官方修复。
## 2026-10-09 / STEP-104 / 源码冲突处理批次 1
- 实际执行模型与档位:`gpt-6.1-sol / high`,已核对本会话 `turn_context`,RDC 亦独立确认。
- 基线:HEAD `e4c7af7c401aebc0fdb9d85309ad781e328baff4`;RDC 已启动 merge,MERGE_HEAD `b433775348373b10fba02dc0e1f728bacd72f9e7`,初始 76 个 index 未合并路径。
- 完成:对三方内容做路径/namespace 归一后合并,保留官方新增内容与 .21 扩展;24 个 Field/Ingress 文件搬到 `mln`,删除旧 `include/mbgl/shaders/shader_manifest.hpp`,在官方新 manifest 注册两个扩展 shader。
- 完成:Particle/WeatherColor override、普通/隐藏清理/粒子 Fast Path update 入口传入官方新增 PaintParameters;Retained key/revision viewport 使用同帧 renderableSize,不恢复已删除 backendSize。
- 完成:官方 CustomMVTVector factory 与 RasterArray factory 并存;新 source 的 retained reuse 保守退回 live;官方 ErrorScope、symbol error 转发、commandBuffer 所有权及 .21 资源清理/observer teardown 均保留。
- 当前问题:源码写入后的静态完整性仍在核查;index 76 路径尚待 RDC 审查并暂存,不能把文本清理声称为 Git merge 完成。全部 build/link/codegen/GTest/Jest/设备检查 NOT RUN。
- 下一步:检查构建清单、shader 注册、JNI 和未迁移引用,再交付 RDC Native OpenGL 编译 Gate。
- 关联 commit:沿用启动 checkpoint `e4c7af7c40`;本批次未 commit,按用户新指令由 RDC 分批审查、暂存与提交。
## 2026-10-09 / STEP-104 / Gate 1:真实三方合并 checkpoint
- 执行器:GPT-6.1 Sol / High,实际会话 `turn_context` 已通过 RDC 核实;Codex 编辑源码,RDC 完成 Git index 与提交。
- 官方第一父:`e4c7af7c401aebc0fdb9d85309ad781e328baff4`,其父为官方 Android Native `c7506d6aff3800e946f89e1a51432fc22d1a6534`。
- 旧扩展第二父:`b433775348373b10fba02dc0e1f728bacd72f9e7`(Particle .21 + UPSTREAM-001 文档)。
- RDC 实际运行 Git 三方合并,76 个未合并路径;Codex 处理新旧目录映射及 Renderer/Source/Shader/JNI 接口,RDC 验证工作树冲突标记 0、index 未合并条目 0。
- 新合并提交:`f8378fd7113c4d230500f0b82902d2356907f4a9`,message `merge(upgrade): port particle extensions onto official native 13.6.1 (unverified)`。
- 代码路径的 `git diff --cached --check` PASS;整个 merge 的 `git diff --cached --check` 不通过,但仅涉及 3 份来自 .21 的**原样历史文档**既有尾随空格,未改写历史文档。
- 已完成:合并树可提交、官方修复与自研层/Source/Particle/RenderSegment 并存;**尚未编译、链接、运行、Android GPU 验证及 iOS 验证**。
- 下一步:RDC 以官方 Android 新树独立配置/精确编译;若失败保留首个真实错误并按明确范围修正或停止。