1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
# docs/plans — 计划索引
> **本文件是入口。** 目录里有 17 份 `.md`（4 份是**工具/门禁依赖**，不可移动），
> 38 份历史计划已归档到 [`archive/`](archive/)。
---
## 1. 根目录计划（`docs/plans/` 下，**未归档**）
> 根目录**不等于「活跃」**。`blue25`–`blue27` 的主体已闭环却仍留在这里，原因是 `src/` 与门禁
> **按路径**引用它们（见 §4 的说明）——迁入 `archive/` 只会把一条悬空引用变成三条。
| 文件 | 内容 | 状态 |
|---|---|---|
| [`blue24.md`](blue24.md) | 帧循环 / 属性动画 / 正交状态 / 环境事实 / a11y 落地 | **主体已完成**（§10 批 0–8 与 §9 均 ✅）；**本文件仍是 BLUE24 自身后续条目的唯一入口**（§12 的 U-1…U-15），未完成项登记在那里 |
| [`blue25.md`](blue25.md) | 全控件缺陷清理 + 图标库（Material Symbols，Apache-2.0） | **42/42 闭环**（A 6 / B 3 / C 9 / D 11 / ICON-1…8 / §8 五项）；逐条证据见 [`../log/`](../log/) |
| [`blue26.md`](blue26.md) | Rustage 设计器所需的上游契约补齐（B26.01–B26.12） | **全部处置**：B26.01–B26.08、B26.10–B26.12 已实现；B26.09 的处置是**「探针完成、裁定不新增类型」**（是决定，不是未做）。随 2.8.5 发布，证据见 [`../log/log-20261011-1.md`](../log/log-20261011-1.md) |
| [`blue27.md`](blue27.md) | 统一图标设计（内容 / 描述 / 绘制分离） | **U0–U7 8/8 🟢；DoD 1–9 闭合**；RTL 布局镜像是**具名排除**（出口 = 另立独立计划，理由见其 §19.14.4）|
| [`blue28.md`](blue28.md) | 全平台平台层完整性补齐（B28.01–B28.44） | **提案，全部 `[ ]`**：含 GUI 职责边界评估（核心/可选/非目标）、166 个 `Platform` 方法审计、winit 能力清单对照、统一探针、移动输入转发、窗口属性真正应用、macOS DPI、Wayland/Web/Harmony 平台事实、环境事实、文件/外部打开、光标、IME、无障碍、显示器元数据、剪贴板富内容、拖放、移动 GUI 核心、打印、系统字体、raw-window-handle、多窗口、音频/GPU/视频/资源监视、事实矩阵与真机证据 |
> **BLUE23 已归档** → [`archive/blue23.md`](archive/blue23.md)（本轮收口：0 个 `[ ]`，
> 全部批次 ✅，5 个跟踪扫描 0 失败）。
> **两份可并行**：`blue24.md` §12 写明了三条边界——BLUE24 不登记、不依赖、不阻塞
> BLUE23 的余项。BLUE24 的批 1（帧循环）在 BLUE23 收口前就能开工。
### 计划分级
- **blue1 ~ blue23**：✅ 已完成 → 见 [`archive/`](archive/)
- **blue24**：**主体已完成**，且仍是 BLUE24 自身后续条目（§12）的唯一入口
- **blue25 / blue26 / blue27**：**主体已完成**，保留在根目录（引用原因见 §4 的说明）
- **blue28**：**提案 / 未开工**（平台层完整性，条目 B28.01–B28.44）
---
## 2. 参考文档（**不是**待办清单）
| 文件 | 是什么 | 谁在读 |
|---|---|---|
| [`principle.md`](principle.md) | 全仓工程原则（#1–#101），所有 BLUE 计划的依据 | 所有计划、`src/widget/special_widgets/code_editor/mod.rs` |
| [`codemap.md`](codemap.md) | 模块地图 | **门禁** `check_widget_kind_count.sh` |
| [`platform_capability_matrix.md`](platform_capability_matrix.md) | 平台能力矩阵（**生成物**，不手改） | **三个门禁** + `tests/blue9_r6_platform_capability_test.rs` |
| [`platform_differences.md`](platform_differences.md) | 平台差异说明 | 人读 |
| [`whitepaper.md`](whitepaper.md) | 架构白皮书 | 人读 |
| [`steps.md`](steps.md) | 阶段进度 | 人读 |
| [`custom_widget_mounting.md`](custom_widget_mounting.md) | 自绘控件挂载契约 | `src/platform/{linux,macos,windows}/canvas.rs` |
| [`harmony_integration.md`](harmony_integration.md) | Harmony 集成说明 | 人读 |
| [`research-icons.md`](research-icons.md) | 图标库调研与设计（`blue25.md` §6 与 `blue27.md` §19 的证据文件） | 人读；`src/widget/icon_registry.rs` 注释引用 |
---
## 3. 待办与受限项
| 文件 | 是什么 |
|---|---|
| [`TODO.md`](TODO.md) | 路线图待办。**当前 `[x]` 127 / `[ ]` 0 / `[~]` 0**（即无待办） |
| [`FUTURE.md`](FUTURE.md) | 环境受限项（需特定宿主才能验证）。**12 项中有 6 项已关闭**（`[x]` 6 / `[ ]` 6）|
> `TODO.md` 与 `FUTURE.md` 都不在 `docs/plans/` 的历史归档范围内：
> 前者被 `tools/check_locking.sh` / `tools/check_error_messages.py` / CI 引用，
> 后者是「受限项」的正式载体。**不要归档它们。**
---
## 4. 归档（38 份）
[`archive/`](archive/) 里的计划**全部已完成**或**已被取代**，仅供追溯。
**不要再从里面取「当前要求」**——那是 BLUE24 §9.1 要消除的失败形态
（同一件事在两处各写一半）。
> **三份已完成计划（`blue25`–`blue27`）为何不在 `archive/`（具名决定，不是遗漏）**：
> `src/render/path/parser.rs`、`src/render/path/flatten.rs`、`src/widget/icon_registry.rs` 与
> `tools/check_icon_licences.sh` **按路径**引用 `docs/plans/blue25.md` 与 `docs/plans/research-icons.md`。
> 把它们迁入 `archive/` 会把这些引用变成悬空路径——修一条、造三条，不是净改善。
> **本表逐份列名**（`tools/check_plan_archive_has_index.sh` 断言每一份都在此有一行）：
> 一个「`blue1.md` … `blue22.md`」的范围写法看起来更短，但它会让 `blue11.md` 与
> `blue13.md` 之间的文件既不在表里也不在视线里，而“中间那些是什么”恰恰是归档最该回答的。
| 归档文件 | 说明 |
|---|---|
| [`blue1.md`](archive/blue1.md) … [`blue22.md`](archive/blue22.md)、[`blue23.md`](archive/blue23.md)（逐份见下）| 历次计划主体，逐次收口 |
| `blue1.md` | BLUE1 — 控件库奠基 |
| `blue2.md` | BLUE2 — 控件扩充 |
| [`BLUE3.md`](archive/BLUE3.md) | BLUE3 — 计划主体（大写拼写，与 `blue3` 不共存） |
| [`BLUE3_R3_COMPLETION.md`](archive/BLUE3_R3_COMPLETION.md) | BLUE3 第 3 轮完成记录 |
| [`BLUE4.md`](archive/BLUE4.md) | BLUE4 — 计划主体 |
| [`BLUE5.md`](archive/BLUE5.md) | BLUE5 — 计划主体 |
| [`BLUE6.md`](archive/BLUE6.md) | BLUE6 — 计划主体 |
| [`BLUE7.md`](archive/BLUE7.md) | BLUE7 — 计划主体 |
| [`blue7_verification.md`](archive/blue7_verification.md) | BLUE7 验证记录 |
| [`blue8.md`](archive/blue8.md) | BLUE8 — 计划主体 |
| [`blue9.md`](archive/blue9.md) | BLUE9 — 计划主体 |
| [`blue10.md`](archive/blue10.md) | BLUE10 — 计划主体 |
| [`blue10_degraded_mappings_audit.md`](archive/blue10_degraded_mappings_audit.md) | 降级映射审计（BLUE10 附录） |
| [`blue10_wgpu_upgrade_evaluation.md`](archive/blue10_wgpu_upgrade_evaluation.md) | wgpu 升级评估（BLUE10 附录） |
| [`blue11.md`](archive/blue11.md) | BLUE11 — 计划主体 |
| [`blue12.md`](archive/blue12.md) | BLUE12 — 计划主体 |
| [`blue13.md`](archive/blue13.md) | BLUE13 — 计划主体 |
| [`blue14.md`](archive/blue14.md) | BLUE14 — 计划主体 |
| [`blue15.md`](archive/blue15.md) | BLUE15 — 计划主体 |
| [`blue16.md`](archive/blue16.md) | BLUE16 — 计划主体 |
| [`blue17.md`](archive/blue17.md) | BLUE17 — 计划主体 |
| [`blue18.md`](archive/blue18.md) | BLUE18 — 计划主体 |
| [`blue19.md`](archive/blue19.md) | BLUE19 — 计划主体 |
| [`blue20.md`](archive/blue20.md) | BLUE20 — 计划主体 |
| [`blue20_p3_backlog.md`](archive/blue20_p3_backlog.md) | BLUE20 P3 遗留（已并入后续计划） |
| [`blue21.md`](archive/blue21.md) | BLUE21 — 计划主体 |
| [`blue22.md`](archive/blue22.md) | BLUE22 — 计划主体 |
| [`blue23.md`](archive/blue23.md) | BLUE23 — 状态层 / 动效总线 / 层级层 / 声明式原语（附录 A 逐条收口）|
| [`cocoa_to_objc2_migration.md`](archive/cocoa_to_objc2_migration.md) | cocoa → objc2 迁移方案（已实施） |
| [`miri_audit.md`](archive/miri_audit.md) | Miri 审计（已实施） |
| [`plan.md`](archive/plan.md) | 早期总计划（已被 BLUE 系列取代） |
| [`plan copy.md`](archive/plan%20copy.md) | 早期总计划的重复副本（已废） |
| [`REFACTOR_PLAN.md`](archive/REFACTOR_PLAN.md) | 重构计划（已完成） |
| [`REFACTOR_EXECUTION_GUIDE.md`](archive/REFACTOR_EXECUTION_GUIDE.md) | 重构执行指南（已完成） |
| [`scan_round1.md`](archive/scan_round1.md) | 早期扫描第 1 轮（已被 BLUE 系列取代） |
| [`scan_round2.md`](archive/scan_round2.md) | 早期扫描第 2 轮（已被 BLUE 系列取代） |
| [`scan_round3.md`](archive/scan_round3.md) | 早期扫描第 3 轮（已被 BLUE 系列取代） |
| [`TODO.md`](archive/TODO.md) | 路线图待办的**历史快照**；现行 TODO 在 [`../TODO.md`](TODO.md) |
---
## 5. 维护规则
1. **新计划可以新建文件。**`docs/plans/blue26.md`、`blue27.md` … 均可；
一条新主题就开一份新计划，不再要求把新主题塞进 `blue24.md`。
2. **一份计划主体全部完成后**才移入 `archive/`，并**必须**在本文件 §4 补一行。
3. **下列四份文件不可移动**：`codemap.md` / `platform_capability_matrix.md` /
`TODO.md` / `principle.md` 被门禁或源码引用，移动会让门禁报红。
4. **同一件事不两处各写一半**。同一主题的两份计划允许并行（见 §1），但**同一主题**
不应在两处各写一半——这是本目录收敛的唯一目标。
### 可复跑的检查
```text
$ ls docs/plans/*.md | wc -l # 16
$ ls docs/plans/archive/*.md | wc -l # 38
$ grep -rn "docs/plans/" --include=*.rs --include=*.sh --include=*.py . | grep -v archive
# 零命中指向 archive/ 的路径（除刻意保留的历史引注）
```
### 两条元门禁（BLUE24 §9）
> `check_single_open_plan.sh` 已于 2026-09-29 **删除**（用户指令）：它把「同一主题
> 至多一份活计划」变成硬门禁，连带禁止新建 `blue25/blue26`。现已改为**目录纪律**（见 §5 第 4 条），
> 门禁本身不再存在。
本目录的收敛由**两条可运行的门禁**钉住（而不是靠习惯）：
| 门禁 | 断言 | 反向注入 |
|---|---|---|
| `tools/check_plan_archive_has_index.sh` | `archive/` 每份文件在本 README 有行；README 不引用不存在的归档 | 向 `archive/` 放一份未入索引的文件 ⇒ 变红 |
| `tools/check_gates_are_worth_running.sh` | 每个 `check_*.sh` 被 `run_all_gates.sh` 的 glob 枚举；运行预算 ≤ 45 min；每个门禁在 `gates_reverse_injection.md` 有名 | 删一行记录 / 改预算为 9999 ⇒ 各自变红 |
> `gates_reverse_injection.md` 逐门禁记录「注入什么、报什么」。尚未注入的门禁以 `—`
> 如实列出（不计入通过），元门禁会把它作为一个**数字**打印出来。