本目录用于存档 @antv/l7-source 包的渐进式重构记录，便于后续持续推进与回溯。
| 文档 | 说明 |
|---|---|
| PLAN.md | 完整重构路线图（阶段 0–7），含现状诊断、优先级矩阵、风险缓解 |
| PROGRESS.md | 进度记录（按提交/PR 倒序），每步重构的「改了什么 / 怎么验证 / 风险」 |
| BACKLOG.md | 遗留问题、待优化项、已发现问题但本轮未处理 |
| ADR/ | 关键架构决策记录（按需新增） |
- 起始日期：2026-07-20
- 合并状态：PR #2882 已合并到
master（merge commitcd654c1，2026-07-23） - 当前阶段：阶段 0–6 全部落地并合并；阶段 7（class 层级 / pipeline / geojsonvt-decoder）为可选长期项
- 文档同步：API 文档
source.{zh,en}.md已补全新公开方法与兼容性说明（commit1831635）；本轮再补兼容性 / 弃用提示 + 修 en 文档 embed 引用 - 测试基线：jest source 133 + layers 57 passed 1 skipped = 零回归；tsc source 0 / layers 229（基线）
- 进度概览：见 PROGRESS.md 顶部
- 行为等价优先：每个阶段先保证现有 spec 通过，再考虑行为优化
- 对外 API 完全向后兼容：内部重构用 delegate / getter 别名 / re-export 转发，
ISource接口与本包公共导出不动 - 小步快跑：每个阶段拆成独立可 merge 的 PR，配 changeset
- 先清理后优化：阶段 0 做零风险清理，阶段 1+ 才动结构
- 文档先行：每步重构先在
PROGRESS.md登记，再写代码
后续接手时：
- 读
PLAN.md了解整体路线 - 读
PROGRESS.md顶部「下一步」字段，知道当前应该做什么 - 读
BACKLOG.md了解已知遗留问题，避免重复发现 - 完成一步后，更新
PROGRESS.md与BACKLOG.md