docs: README 补全

AIStudyApp/README.md

@@ -136,6 +136,79 @@ Clean Build 之前先：
 rm -rf ~/Library/Developer/Xcode/DerivedData/AIStudyApp-*
 ```
 
+## 环境配置
+
+### Debug 模式（本地开发）
+
+Debug 构建自动连接本地 API（`http://127.0.0.1:3000`），通过 `Debug.xcconfig` 配置：
+
+```
+API_BASE_URL = http://127.0.0.1:3000
+```
+
+Info.plist 已配置 ATS 豁免 localhost。
+
+### Release 模式（生产）
+
+Release 构建连接生产 API（`https://api.longde.cloud`）。
+
+### 切换 API 地址
+
+编辑 `AIStudyApp/Config/Debug.xcconfig` 中的 `API_BASE_URL`。
+
+## Rust FFI 集成
+
+知习跨平台文档内核 `zhixi-document-runtime` 通过 UniFFI 生成 Swift 绑定。
+
+### 构建流程
+
+```bash
+# 在 zhixi-document-runtime 仓库
+cd zhixi-document-runtime
+./scripts/build-ios.sh
+
+# 生成的 Swift 文件复制到 iOS 项目
+# → AIStudyApp/Core/FFI/zhixi_document_core.swift
+```
+
+### 集成功能
+
+- 文件类型检测
+- Markdown / TXT / EPUB 解析
+- PDF 阅读位置管理
+- 图片元数据提取
+- 阅读时长事件
+- 全文搜索和笔记锚点
+
+详见 `zhixi-document-runtime/docs/ios-integration.md`
+
+## App Store 提审
+
+提审相关文档见 `ios-projects/docs/`：
+- App Store 提审清单
+- Firebase 集成
+- Rust FFI 更新
+- 阅读信息集成
+
+## 依赖
+
+| 依赖 | 用途 |
+|------|------|
+| SwiftUI | UI 框架 |
+| Firebase | 推送通知 / Analytics（可选） |
+| zhixi-document-runtime | 跨平台文档内核（Rust FFI） |
+
+## 调试日志
+
+所有 `print()` 输出使用 `[PageName]` 前缀标记页面来源：
+
+```swift
+print("[ImportPage] 文件导入完成")
+print("[AIChat] 消息发送: \(message)")
+```
+
+在 Xcode Console 中可通过前缀过滤日志。
+
 ## 最近修复记录
 
 ### 2026-05-19 — NavigationStack 迁移 + Dynamic Type