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

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 <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` 覆盖逻辑与运行时地址优先级；完成后停住等待验收。

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 构建成功。真机验收由用户执行。