docs(plans): 留痕 K72 develop 同步 release 与 main

2026-10-20 22:27:31 +08:00
1 parent 0b2709339e
commit d1aaf2e5c0
@@ -1,66 +1,36 @@
 # INBOX

-## [已处理] K71-A 首页深色底部导航补齐安全区底色
+## [已处理] K72-A 把 develop 同步到 release/v1.0.0，再同步 main

-### 现象
+### 背景

-首页 feed（深色）下，底部导航**下方**的系统安全区（iOS Home Indicator 条 / Android 手势条区域）
-颜色与首页背景不一致：会透出窗口底色或模糊内容，看上去有一条浅色/发灰的边。
+`develop` 在 K69-A 之后新增了两个批次：

-### 根因
+- K70-A `0c6a103` / `ac1202c`：开发默认地址改为公网 `39.162.50.99:8081`
+- K71-A `66e9062` / `1dbc3ac`：首页深色底部导航补齐安全区底色

-`lib/core/widgets/app_bottom_nav.dart`：
+需要把这批改动发布到 `release/v1.0.0`，随后同步到 `main`。

-```dart
-ClipRect(
-  child: BackdropFilter(
-    filter: ImageFilter.blur(...),
-    child: SafeArea(
-      top: false,
-      child: Container(height: navHeight, color: 0xE6000000, ...),
-    ),
-  ),
-)
-```
+### 仓库现状

-`SafeArea` 的底部内边距在 `Container` 之外，没有任何填充色；深色模式下导航条本身也是
-`0xE6000000` 半透明叠在窗口底色上，所以「导航条 + 下方安全区」都跟首页的纯黑背景不一致。
+- `develop`：`1dbc3ac`（最新，工作区干净）
+- `release/v1.0.0`：`0cb57d0`（K69-A 时与 develop 内容一致）
+- `main`：`8bb365d`（K69-A 时与 release 内容一致）
+- 预期无冲突（release/main 与 develop 分叉点之后 develop 只有线性新增）。

-### 目标
+### 任务

- 首页 feed（`dark: true`）：底部导航条与下方安全区整体为纯黑 `Colors.black`，
-  与首页背景一致，不再透出模糊/白底。
- 浅色模式（剧场/创作/我的、其它页面）：保持现有玻璃模糊 + 0.95 透明观感不变。
-
-### 实现
-
-`lib/core/widgets/app_bottom_nav.dart` 的 `build`：
-
- 深色分支：
-  - `ColoredBox(color: Colors.black)` 包住 `SafeArea(top: false, child: 导航条 Container)`
-  - 导航条 `Container` 的底色改为 `Colors.black`（不再 `0xE6000000`），保留顶部 `Colors.white12` 分隔线
-  - 不再使用 `BackdropFilter`（背后是窗口底色，模糊没有意义）
- 浅色分支：原样保留 `ClipRect + BackdropFilter + SafeArea + backgroundColor.withValues(alpha: 0.95)`
- `barKey` 仍挂在 `navHeight` 的导航条 `Container` 上，总高度在无安全区时为 `AppDimens.navHeight`
-
-### 测试
-
- 现有 `test/home/app_bottom_nav_test.dart` 的高度断言（无安全区 = navHeight）必须继续通过
- 新增用例：`dark: true` 且 `MediaQuery` 底部安全区为 34 时，
-  1. `AppBottomNav` 总高度 = `navHeight + 34`
-  2. 最外层 `ColoredBox`（或等价背景）颜色为 `Colors.black`
-
-### 验收
-
- 门禁：`dart analyze lib test` 零告警、`flutter test` 全过、`flutter build apk --debug` 成功。
- 真机自查：首页底部导航与其下方手势条区域为同一种纯黑，无浅色边。
-
-### Git
-
- 从 `develop` 拉 `fix/home-nav-safe-area-color`。
- 提交：`fix(home): 首页深色底部导航补齐安全区底色`，作者 `Zhou Weidong <502333560@qq.com>`。
- `--no-ff` 合回 `develop` 并 push；`FruitServer/docs/plans/PROGRESS.md` 追加 K71-A 留痕。
+1. `git fetch origin`
+2. `git checkout release/v1.0.0 && git merge --no-ff origin/develop`
+   - 如出现冲突，一律采用 develop 版本，并在 PROGRESS 记录冲突文件。
+3. 门禁：`dart analyze lib test` 零告警、`flutter test` 全过、`flutter build apk --debug` 成功。
+4. push `release/v1.0.0`。
+5. `git checkout main && git merge --no-ff origin/release/v1.0.0`，push `main`。
+   若 main 受保护导致 push 被拒，不要强推，停下记录原因。
+6. `FruitServer/docs/plans/PROGRESS.md` 追加 K72-A 留痕（两个合并 hash、冲突说明、门禁输出）。

 ### 约束

- 全程中文；禁止 `git add -A`；不改浅色模式观感与其它页面；完成后停住等待验收。
+- 全程中文；禁止 `git add -A`、禁止 `git push --force`；不改 `develop`。
+- 合并提交作者 `Zhou Weidong <502333560@qq.com>`。
+- 完成后停住等待验收。
@@ -22539,3 +22539,30 @@ Running Gradle task 'assembleDebug'...
 ```

 解读：静态检查零告警，482 条测试全部通过，debug APK 构建成功。真机验收由用户执行。
+
+## 2026-10-20 ReelShort：K72-A develop 同步 release 与 main
+
+- 初始状态：`origin/develop` 为 `1dbc3ac`，`origin/release/v1.0.0` 为 `0cb57d0`，`origin/main` 为 `8bb365d`。
+- release 合并提交：`182b7e3 merge: 将 develop 同步到 release/v1.0.0`，作者 `Zhou Weidong <502333560@qq.com>`，已推送 `0cb57d0..182b7e3`。
+- release 合并无冲突，自动合入 K70-A 默认公网地址与 K71-A 导航安全区底色共 5 个文件。
+- main 合并提交：`6ae9e8e merge: 将 release/v1.0.0 同步到 main`，作者 `Zhou Weidong <502333560@qq.com>`，已推送 `8bb365d..6ae9e8e`。
+- main 正常推送成功，未触发保护分支拒绝，全程未使用 force push。
+- 工作区外部存在 Xcode 自动重排的 `ios/Runner/Base.lproj/Main.storyboard` 未暂存改动，未进入 release/main 合并提交，也未擅自还原。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test
+00:57 +482: All tests passed!
+
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'...
+   5.2s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+解读：release 合并结果静态检查零告警、482 条测试全部通过、debug APK 构建成功；release 与 main 均已推送，等待发布验收。