本目录存放 mega2 的竞品差距分析文档：以某个外部项目为参照系，分析 mega2 的能力缺口、应坚守的边界与应拒绝的方向。
| 目录 | 职责 | 与本目录的边界 |
|---|---|---|
docs/plan/ |
路线图与可执行任务卡（plan-long.md 的 PT-* + 日期计划） |
唯一的排期入口。 本目录只产出候选与依据，不排期、不占用 PT-* 编号 |
docs/refactoring/ |
内部改进方案（contract / config / vault / mail / notification 等） | 面向已确定要做的内部重构；本目录面向是否要做的外部对照 |
docs/manuel/ |
面向使用者的说明 | 无重叠 |
移植 vs 对照：plan-long.md 的长期目标是「把 Mega 项目的 Rust 后端能力完整移植到 mega2」，Mega 是移植来源与契约基线，不是竞品。本目录的参照对象是 Mega 之外的外部项目；凡本目录提出的、超出 Mega 移植范围的方向，必须在文档内**显式标注为「Mega 之外的新方向」**并说明为什么值得偏离，不得伪装成移植项。
- 只分析，不排期。 本目录的文档产出的是候选与依据。任何条目进入路线图都必须按
plan-long.md§路线图维护 的规则重新立项，并给出竞品 revision/path、mega2 缺口、价值、风险、依赖与最小切入点。 - 不占用
PT-*编号空间。 每份文档使用自己的内部编号（如delta.md的ME-A*/ME-B*/ME-C*），编号一经引用不重编；被推翻的条目改标注为「已实现 / 已替代 / 不采纳」并保留理由，不删除。 - 事实基线优先。 每份文档必须以当前 checkout 的源码、测试与文档为事实基线，并在开头的「事实校准」中记录 mega2 的
git HEAD、版本与核对日期；竞品侧必须记录 revision 或版本快照。历史计划、竞品的历史描述只能作为线索。 - 一手来源留档。 竞品若有本地 checkout，记录其路径与 revision；若无（闭源/私测），必须在附录列出一手来源清单与抓取日期，并写明后续复核的快照规则，使不持有二手材料的读者也能独立核对。
- 不与已登记决策冲突。 提出建议前必须核对
plan-long.md已登记的「不采纳」条目与各日期计划的「非目标」段；冲突时须写成对既有决策的显式挑战（走 ADR revisit 流程），不得当作新发现。 - 对照不等于跟进。 每份文档都应包含「应坚守 / 不跟进」的一组结论，并给出理由；只列缺口不列边界的对照文档不完整。
- 文档不宣称实现完成。 同
docs/plan/README.md规则 6：落地时每个建议都必须先刷新源码锚点，再按任务卡验收。
| 文件 | 参照对象 | 校验时间 | 状态 |
|---|---|---|---|
delta.md |
Delta / DeltaDB（Zed Industries；客户端 + 云同步中枢，0.1.1-nightly，邀请制私测，无本地 checkout） |
2026-08-27（mega2 git HEAD 0836675 / v0.3.5） |
当前（首版）。19 条建议：A 组 5（与既有规划契合）/ B 组 6（Mega 之外的新方向）/ C 组 8（应坚守、不跟进）；另含 3 处 CL 模型断裂的源码级发现，其中 2 处不在任何日期计划的覆盖范围内 |
该文档的结论中有两类需要落到 docs/plan/，尚未立项：
- 正确性前置（建议先于
plan-20260827.md开工）：ME-A1的两场景实测批次（根路径 CL merge 后 main 的 parent 归属；update_branchno-op 分支的静默回退推论）与ME-A2的两项决策（update_branch是否纳入MC-04写集、no-op 分支的语义）。二者只做「提出问题 + 跑实测 + 做决策」时不涉及新工程；一旦选中需要迁移的出口，其落地是新工程，须另行排期。 - 新方向的唯一瓶颈：
ME-B1（Bot 成为一等 Cedar principal）。建议与plan-long.mdPT-03§目标范围中的 repo/path 级 push ACL 合并评估（依据是目标范围段，不是PT-03表格行——该行与plan-20260812.md的非目标声明存在冲突，见delta.mdME-B6）。
文档内 §7「待复核清单」按优先级列出了成稿时未能实测闭合的项，其中第 1 项（no-op rebase 的静默回退）标注为「强推理，待实测复现」，附六步复现步骤。