docs(plans): 记录 K14 客户端文档回执

docs/plans/PROGRESS.md

@@ -2793,6 +2793,104 @@ b762289..f95325d  develop -> develop
 
 ---
 
+## 2026-10-17 K14 客户端文档
+
+### 30.1 范围与依据
+
+叙述：重写客户端 README，新增任务清单和文件说明。只改 ReelShort 的三份文档，
+不改代码、specs、后端或 Web。
+
+核对依据：
+
+- `pubspec.yaml`、`pubspec.lock`
+- `lib/` 与 `test/` 实际目录
+- `lib/core/data/remote/**` 实际调用
+- `FruitServer/docs/api-phase1.md` 章节
+- `FruitServer/docs/plans/PROGRESS.md` 已完成批次
+
+客户端分支：`docs/k14-client-docs`，基线 `f95325d`。
+
+### 30.2 接口与目录核对
+
+Flutter 版本：
+
+```text
+$ flutter --version
+Flutter 3.47.7 • channel stable
+Tools • Dart 3.13.5 • DevTools 2.60.0
+```
+
+接口路径：
+
+```text
+$ rg -o "'/app/[^']+'" lib/core/data/remote -g '*.dart' | sort -u | wc -l
+      26
+```
+
+按 HTTP 方法和重复 URL 逐项统计为 31 个方法级调用。README 已按账号、内容、
+观看记录、收藏、下载、互动和公告分组列出。
+
+### 30.3 文档内容
+
+`ReelShort/README.md`：
+
+- 印尼市场定位、技术栈、目录概览；
+- 实际接口清单；
+- Android USB、Android 模拟器、iOS 和 debug 运行时地址；
+- iOS foundation 2.5.6、SPM 恢复、Android libdartjni 处理；
+- 门禁命令、测试命名和当前边界。
+
+`ReelShort/docs/TASKS.md`：
+
+- K1-K13 批次表；
+- K4、支付/金币、搜索、下载落盘待办；
+- 未确认范围标「需核对」，未编造提交号。
+
+`ReelShort/docs/FILES.md`：
+
+- 目录树、关键文件职责、test 结构；
+- `app_localizations*.dart`、`*.g.dart`、build、ephemeral 等生成物标注为勿手改。
+
+仓库 `.gitignore` 包含 `/docs/`。本轮只对新增的两个 docs 文件使用
+`git add -f`，没有修改 `.gitignore`。
+
+### 30.4 门禁
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+```
+
+```text
+$ flutter test
+00:20 +309 ~1: All tests passed!
+```
+
+解读：文档改动未误改代码；309 项通过，1 项联调测试因服务未启动跳过。
+
+### 30.5 Git
+
+```text
+5a28845 docs(client): 重写 README 并补充任务与文件说明
+213c86e docs(client): 修正已接接口数量说明
+9fe62d1 merge: 合并 K14 文档接口统计修正
+f95325d..9fe62d1  develop -> develop
+```
+
+主提交、修正提交和最终合并的 author/committer 均为
+`Zhou Weidong <502333560@qq.com>`。
+
+### 30.6 文档验收
+
+1. 打开 `ReelShort/README.md`，按表中命令可完成 Android USB、iOS 和 debug
+   运行时地址配置。
+2. 打开 `ReelShort/docs/TASKS.md`，能区分已合入功能与待办/需核对事项。
+3. 打开 `ReelShort/docs/FILES.md`，能定位核心配置、数据层、页面、测试和生成物。
+4. 文档中的接口路径与 `lib/core/data/remote/` 一致。
+
+---
+
 ## 2026-10-17 iOS 构建阻塞：固定 shared_preferences_foundation 2.5.6
 
 ### 25.1 现象与根因