Repository navigation
docs(android): A4 收官——README 双语同步、MOBILE-PLAN 进度与 PR Template 平台化 - #29
Conversation
There was a problem hiding this comment.
一句话总结
本 PR 为 Android A4 里程碑收官,主要更新了 MOBILE-PLAN.md 进度、android/README 双语文档,并将 PR 模板平台化(macOS/Android/iOS 三端勾选项),纯文档与模板改动,未触碰任何红线。
🔴 红线 / 严重问题
未发现红线问题。但需注意以下两点:
-
PR 模板中 Android 构建命令与 AGENTS.md 第 2 节不一致(.github/pull_request_template.md:24)
- 模板新增:
cd android && ./gradlew :core:test :app:assembleDebug - AGENTS.md 第 2 节 Android 验证命令为:
cd android && ./gradlew :core:test - 建议:同步更新 AGENTS.md 第 2 节,补充
:app:assembleDebug命令,保持仓库规范与 PR 模板一致,避免贡献者困惑。
- 模板新增:
-
MOBILE-PLAN.md 中 A4 完成状态与红线 11 的 WorkManager 准入记录存在潜在不一致(MOBILE-PLAN.md:6)
🟡 建议改进
-
PR 模板边界检查项可更精确(.github/pull_request_template.md:37)
- 当前「未改变 Token 存储方式」已按平台区分(macOS UserDefaults / iOS Keychain / Android Keystore),但未提及 Windows 版(DPAPI)。
- 建议:补充 Windows 版 Token 存储方式(DPAPI),保持三端文档一致性。
-
android/README 双语版本存在轻微不一致(android/README.md 与 android/README.zh-CN.md)
- 英文版「Progress」段落使用「A5 planned (widget, store distribution)」,中文版为「A5 规划中(桌面小组件、商店分发)」——「桌面小组件」表述可能引起歧义(Android 无桌面概念)。
- 建议:中文版改为「主屏幕小组件」或「App Widget」,与 Android 平台术语一致。
🔵 小问题 / 风格
-
MOBILE-PLAN.md 进度行过长(MOBILE-PLAN.md:6)
- 单行包含 M1-M5、A1-A4 全部状态,可读性较差。建议按平台拆分为多行(macOS/iOS 一行、Android 一行),便于后续 A5 更新。
-
android/README 结构注释中「薄壳」表述(android/README.zh-CN.md:32)
app/ Compose App(薄壳)与后续列出的 MainActivity/HomeScreen/LoginScreen 等 7 个文件略显矛盾(薄壳通常指极简壳)。建议改为「Compose App(UI 层)」更准确。
-
PR 模板中 iOS 验证命令可补充(.github/pull_request_template.md:25)
- 模板仅写「
bash Scripts/run-ios-tests.sh+ 模拟器构建通过」,但 AGENTS.md 第 2 节还包含python3 Scripts/check-ios-project.py结构校验。建议补充该命令,与仓库规范完全对齐。
- 模板仅写「
审查结论
建议合并。本 PR 为纯文档与模板更新,内容准确反映了 Android A4 的实际完成状态,双语文档质量良好,未触碰任何红线。上述建议均为非阻塞性改进,可在后续 PR 中逐步完善。合并前请确认 MOBILE-PLAN.md 中 WorkManager 决策与红线 11 的引用关系(建议项 2),其余建议可择机处理。
描述
#16 文档同步(A4 收官的最后一块):让文档与代码实际状态一致。
android/README.md/android/README.zh-CN.mdbackground/(Worker+Scheduler)、notification/(LowBalanceNotifier)、MainActivity生命周期桥接说明;:core:test :app:assembleDebug,注明 PR CI 上传 debug APK 工件;MOBILE-PLAN.md.github/pull_request_template.md关联
变更类型
本地验证
边界检查
备注
bucket参数、/users/current响应新增token字段)。