diff --git a/README.md b/README.md
index c82a5c6..1af6437 100644
--- a/README.md
+++ b/README.md
@@ -120,7 +120,7 @@ make gen-i18n   # 生成 lib/i18n/strings.g.dart
 make run-dev
 ```
 
-> 首次运行前请阅读 [docs/setup-project.md](docs/setup-project.md) 完成环境配置。
+> 详细配置步骤（dart-defines / 包名 / 签名）请参阅 [docs/setup-project.md](docs/setup-project.md)。
 
 ---
 
@@ -147,7 +147,8 @@ make run-dev
 ├── docs/
 │   ├── setup-project.md            # 完整项目配置指南
 │   ├── setup-android.md            # Android Flavor / 签名详细配置
-│   └── setup-ios.md                # iOS Scheme / CocoaPods / 签名详细配置
+│   ├── setup-ios.md                # iOS Scheme / CocoaPods / 签名详细配置
+│   └── architecture.md             # 数据流 / 认证流 / 错误链 / 拦截器链 ASCII 架构图
 ├── CLAUDE.md                       # AI 辅助开发上下文（技术栈 / 规范 / 零容忍规则）
 ├── Makefile                        # 常用命令
 ├── pubspec.yaml                    # 依赖（含版本锁定 dependency_overrides）