新增文档说明

.gitignore

@@ -18,8 +18,16 @@ web-build/
 .metro-health-check*
 expo-env.d.ts
 
-# 原生构建产物（prebuild / pod / build）
-client/ios/
+# 原生构建产物
+# - iOS：为了支持 Widget 开发，需要提交 ios 工程与扩展源码；但忽略 Pods/build/用户配置等大体积或机器相关目录
+client/ios/build/
+client/ios/Pods/
+client/ios/DerivedData/
+client/ios/xcuserdata/
+client/ios/**/xcuserdata/
+client/ios/.xcode.env.local
+
+# - Android：当前阶段仅做客户端 iOS 侧能力，android 仍保持忽略
 client/android/
 
 # iOS/Android 证书与密钥
@@ -33,3 +41,6 @@ client/android/
 # 环境变量（本地）
 .env.local
 .env*.local
+
+# 防止把 client 内部的独立 git 备份目录提交进来
+client/.git.backup/