docs(plans): 留痕 K70 开发默认公网地址

This commit is contained in:
Zhou Weidong committed 2026-10-20 21:56:50 +08:00
1 parent c2974957ba
commit b5f1699240
2 files changed
+59 -28

No files matched your search

+29 -28
View File
@@ -1,39 +1,40 @@
# INBOX
## [已处理] K69-A 把 develop 合入 release/v1.0.0,再合入 main
## [已处理] K70-A 开发默认地址改为公网 39.162.50.99
### 背景
### 需求
当前 `develop` 已包含 K64~K68 全部改动(原生开屏、启动预取、清理、接口地址锁定),
需要发布到 `release/v1.0.0`,随后同步到 `main`。
开发调试阶段默认连公网服务:`http://39.162.50.99:8081`(不带结尾斜杠,避免与请求路径拼接出双斜杠)。
### 仓库现状
### 现状
- `develop`:最新,含 K68-A(`51c3635`)。
- `origin/release/v1.0.0`:落后 develop 很多;另有 3 个 release 专属提交
`3d0e080`、`814b2c0`、`35364c9`。
- `origin/main`:当前停在 `5c174b0`(PR #1,内容等于旧版 release)。
- 工作区干净。
`lib/core/config/app_config.dart`:
### 任务
- `devHostBaseUrl = 'http://192.168.31.187:8081'`(真机默认地址)
- `lanBaseUrl = 'http://127.0.0.1:8081'`(`adb reverse` 环回)
- `publicBaseUrl = 'http://39.162.50.99:8081'`
- `_probeCandidates = [lanBaseUrl, devHostBaseUrl, publicBaseUrl]`
1. `git checkout -B release/v1.0.0 origin/release/v1.0.0`
2. `git merge --no-ff origin/develop`
预期冲突文件(预览):
- `lib/core/config/app_config.dart`
- `lib/main.dart`
- `test/config/server_endpoint_test.dart`
**冲突处理:以上三个文件一律采用 develop 版本**(`git checkout --theirs <file>` 后 `git add`),
因为 K65~K68 已重构启动探测与编译期地址优先级,release 分支旧的默认地址改动不再适用。
其它文件如出现冲突,同样优先采用 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 被拒绝,不要强推,停下并在 PROGRESS 记录原因。
6. `FruitServer/docs/plans/PROGRESS.md` 追加 K69-A 留痕:两个合并提交 hash、冲突解决说明、门禁输出。
### 改动
1. `devHostBaseUrl` 改为 `'http://39.162.50.99:8081'`,同步更新上方文档注释
(说明当前默认指向公网,换网络时改这一行)。
2. `_probeCandidates` 去重(保留 `lanBaseUrl` 在前、其次 `devHostBaseUrl`、再 `publicBaseUrl`),
避免改完后重复探测同一地址;不改变探测顺序语义与超时。
3. 测试 `test/config/server_endpoint_test.dart` 第 66 行的字面量断言同步改为
`'http://39.162.50.99:8081'`;其余使用常量的断言无需改动。
### 验收
- `adb reverse` 存在时仍优先走 `127.0.0.1`;不存在时走公网。
- 门禁:`dart analyze lib test` 零告警、`flutter test` 全过、`flutter build apk --debug` 成功。
### Git
- 从 `develop` 拉 `chore/dev-default-public-host`。
- 提交:`chore(config): 开发默认地址改为公网 39.162.50.99`,作者 `Zhou Weidong <502333560@qq.com>`。
- `--no-ff` 合回 `develop` 并 push;`FruitServer/docs/plans/PROGRESS.md` 追加 K70-A 留痕。
### 约束
- 全程中文;禁止 `git add -A`;禁止 `git push --force`;不动 `develop`。
- 合并提交作者统一 `Zhou Weidong <502333560@qq.com>`。
- 完成后停住等待验收。
- 全程中文;禁止 `git add -A`;不改 `API_BASE_URL` 覆盖逻辑与运行时地址优先级;完成后停住等待验收。