diff --git a/docs/plans/INBOX.md b/docs/plans/INBOX.md index 2194bdf..71632cf 100644 --- a/docs/plans/INBOX.md +++ b/docs/plans/INBOX.md @@ -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 ` 后 `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` 覆盖逻辑与运行时地址优先级;完成后停住等待验收。 diff --git a/docs/plans/PROGRESS.md b/docs/plans/PROGRESS.md index e2cac2d..07ffc4e 100644 --- a/docs/plans/PROGRESS.md +++ b/docs/plans/PROGRESS.md @@ -22479,3 +22479,33 @@ Running Gradle task 'assembleDebug'... ``` 解读:release 合并结果静态检查零告警、481 条测试全部通过、debug APK 构建成功;release 与 main 均已推送,等待发布验收。 + +## 2026-10-20 ReelShort:K70-A 开发默认地址改为公网 + +- 前置状态:K69-A 已完成,develop 合并提交 `51c3635`。 +- 分支:`chore/dev-default-public-host` +- 功能提交:`0c6a103 chore(config): 开发默认地址改为公网 39.162.50.99` +- develop 合并提交:`ac1202c merge: 合并 K70-A 开发默认公网地址`,已推送。 +- `devHostBaseUrl` 改为 `http://39.162.50.99:8081`,注释同步说明当前默认指向公网,切换局域网时只改这一行且不带结尾斜杠。 +- 探测候选使用条件追加去重:`lanBaseUrl` 始终在前,`devHostBaseUrl` 与 `publicBaseUrl` 相同时只探测一次;未来 dev 改回独立地址时会自动恢复 lan、dev、public 三候选顺序。 +- `API_BASE_URL` 覆盖逻辑、运行时地址优先级、2 秒超时与 fallback 均未改动。 + +测试:默认地址字面量断言改为公网;并行探测、顺序、全失败及运行时优先用例的候选数量同步为两个唯一地址。 + +门禁原始输出: + +```text +$ dart analyze lib test +Analyzing lib, test... +No issues found! + +$ flutter test +00:54 +481: All tests passed! + +$ flutter build apk --debug +Running Gradle task 'assembleDebug'... + 47.6s +✓ Built build/app/outputs/flutter-apk/app-debug.apk +``` + +解读:静态检查零告警,481 条测试全部通过,debug APK 构建成功。真机验收由用户执行。