docs: harness 工程文档

README.md

@@ -0,0 +1,30 @@
+# 明缘进阶场 Android 客户端
+
+「明缘进阶场」的 Android 客户端，与 `wechat-backend`（明缘进阶场 API）配套。采用 Kotlin + Jetpack Compose + Hilt + Retrofit + Room + DataStore + Navigation 的现代多模块架构，参考 Google Now in Android 官方示例。
+
+## 项目状态
+
+当前处于**基础建设阶段**：多模块骨架、约定插件、版本目录、验证脚本与 CI 均已就绪；各 feature 模块为空占位，尚未接入真实后端。详见 [docs/progress.md](docs/progress.md)。
+
+## 快速开始
+
+```bash
+./gradlew :app:assembleDebug        # 构建调试 APK
+./gradlew test testDebugUnitTest    # 运行单元测试
+bash scripts/verify.sh              # 完整验证
+```
+
+## 技术栈
+
+- **UI**：Jetpack Compose + Material 3
+- **架构**：多模块（app / core / feature）、MVVM、单向数据流（StateFlow）
+- **依赖注入**：Hilt（KSP）
+- **网络**：Retrofit + OkHttp + kotlinx-serialization
+- **本地存储**：Room + DataStore
+- **导航**：Navigation Compose
+- **构建**：Gradle 约定插件（build-logic）+ 版本目录（version catalog）
+- **质量**：Spotless/ktlint + Android Lint + 自定义架构检查
+
+## 文档
+
+架构、规范、测试、部署与决策记录见 [AGENTS.md](AGENTS.md) 的文档地图，或直接浏览 [docs/](docs/)。