From 538a7df258b4832c6dc020f51cc5be0429ad587d Mon Sep 17 00:00:00 2001
From: Zhou Weidong <502333560@qq.com>
Date: Sat, 17 Oct 2026 22:59:07 +0800
Subject: [PATCH] =?UTF-8?q?docs(plans):=20=E4=B8=8B=E5=8F=91=20K14=20?=
 =?UTF-8?q?=E5=AE=A2=E6=88=B7=E7=AB=AF=E6=96=87=E6=A1=A3=E4=BB=BB=E5=8A=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/plans/INBOX.md | 69 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 68 insertions(+), 1 deletion(-)

diff --git a/docs/plans/INBOX.md b/docs/plans/INBOX.md
index 1de0960..04a8f8f 100644
--- a/docs/plans/INBOX.md
+++ b/docs/plans/INBOX.md
@@ -20,7 +20,74 @@
 
 ---
 
-## [已处理·待用户验收] 2026-10-17 | K13 运行时服务器地址设置（仅 debug）
+## [待处理] 2026-10-17 | K14 客户端文档：README + 任务清单 + 文件说明
+
+**用户指令（2026-10-17）**：「现在更新客户端 readme 任务清单 及文件说明」。
+
+> 只改 `ReelShort` 仓库文档，不改代码、不改 specs、不改后端/Web。
+> 内容必须基于当前实际代码与已交付事实，**禁止编造**；不写任何密钥/账号。
+
+### 一、现状（实测）
+
+- `ReelShort/README.md` 仅 50 行，是原型阶段说明，已明显过时：
+  - 仍写“本地演示评论”“互动数据保存在本机”，实际 K3 已接后端评论/点赞/举报；
+  - 未提分类、通知、下载授权、克莱因蓝主题、印尼语默认、运行时服务器地址设置；
+  - 未写门禁命令、iOS SPM 兼容注意事项、USB 调试方式。
+- `ReelShort` 无 `docs/` 目录，没有任务清单与文件说明。
+- `lib` 现有 105 个 Dart 文件，目录：`core/{config,data/{models,remote,repositories,services},formatting,platform,theme,widgets}`、`l10n`、`pages/{auth,discover,downloads,drama_detail,favorites,home,interaction,mine,notices,player,watch_records}`。
+
+### 二、本批范围（3 份文档）
+
+#### K14-A 重写 `ReelShort/README.md`
+
+至少包含：
+
+1. 项目定位：面向印尼市场的短剧 App（Flutter）。
+2. 技术栈：Flutter 3.47 / Dart 3.13、Provider、dio、video_player、shared_preferences、flutter_localizations（en/zh/id）。
+3. 目录结构概览（core 三层 + pages + l10n + test）。
+4. 已接后端接口清单（按契约分组，**以代码实际调用为准**）：账号、首页/发现/分类/详情、播放、观看记录/收藏、下载授权 8 接口、互动（评论/点赞/举报）、公告。
+5. 运行方式：
+   - Android USB：`adb reverse tcp:8081 tcp:8081` + `flutter run -d <device> --dart-define=API_BASE_URL=http://127.0.0.1:8081`；
+   - iOS：`flutter run -d <udid> --dart-define=API_BASE_URL=http://<MacIP>:8081`；
+   - **debug 下可在「我的 → 设置 → 服务器地址」运行时修改**（K13），换网络不必重编。
+6. 环境注意：
+   - Xcode 16.2 / Swift 6.0.3 与 `shared_preferences_foundation 2.5.6` 的固定原因（2.6.0 需 Swift 6.1）；
+   - iOS SPM 报 `Missing package product` 时的恢复步骤（清 DerivedData、`flutter pub get`、`xcodebuild -resolvePackageDependencies`）；
+   - Android `libdartjni.so` 加载失败时卸载重装。
+7. 门禁命令：`dart analyze lib test`、`flutter test`、`flutter build apk --debug`；测试命名约定。
+8. 当前边界：下载不落盘/不续传/不离线播放；无搜索接口；通知无已读态。
+
+#### K14-B 新增 `ReelShort/docs/TASKS.md`
+
+表格形式，列：批次 / 范围 / 状态 / 关键提交或契约章节 / 备注。至少覆盖：
+
+- K1 详情+播放+进度+收藏；K2 分类/记录/收藏页/下载授权；K3 评论/点赞/举报/分享；K5 克莱因蓝主题+印尼语；K6 登录页+底部导航+震动；K7 轮播+站内通知；K8 登录页视觉；K9 首页网格；K10 空态；K11 3 列+全部首位；K12 去标题+空态重做；K13 运行时服务器地址。
+- 待办：K4 账号剩余（Google 登录需凭据）、B1 支付/金币、搜索（契约缺失）、下载落盘（另立批次）。
+- 状态以 `develop` 实际合并情况为准，不确定的标注「需核对」，不要编造提交号。
+
+#### K14-C 新增 `ReelShort/docs/FILES.md`
+
+- 目录树（到两级），每目录一句话职责。
+- 关键文件表：`lib/core/config/app_config.dart`、`server_endpoint`（如已实现）、`core/data/remote/*`、`repositories/*`、`services/*`、`core/theme/*`、`core/widgets/empty_state.dart`、`pages/*/`、`l10n/*.arb`。
+- `test/` 结构说明（按模块目录）。
+- 只写实际存在的文件；生成物（`*.g.dart`、`app_localizations*.dart`）标注为生成、勿手改。
+
+### 三、约束
+
+- 中文书写，简洁准确；不使用 AI 腔（“赋能/一站式/旨在”等）。
+- 不泄露任何密钥、账号、服务器凭据。
+- 只新增/修改 `README.md`、`docs/TASKS.md`、`docs/FILES.md`；不删既有内容以外的文件。
+- 提交作者与提交者统一 `Zhou Weidong <502333560@qq.com>`。
+
+### 四、门禁与 Git
+
+- 文档改动仍需 `dart analyze lib test` 与 `flutter test` 通过（确认未误改代码）。
+- 从干净 `develop` 拉 `docs/k14-client-docs`；完成后 `git merge --no-ff` 回 `develop` 并 push；不动 `main`。
+- 在 `FruitServer/docs/plans/PROGRESS.md` 追加「叙述 + 命令 + 原始输出 + 解读」，完成后停住写回执。
+
+---
+
+## [待处理] 2026-10-17 | K13 运行时服务器地址设置（仅 debug）
 
 **用户反馈（2026-10-17，已重复 3 次）**：每次 Codex 门禁构建出的 APK 不带 `--dart-define`，App 就回退到 `http://jiangdeMacBook-Air.local:8081`，真机不可用。