diff --git a/client/ios/.gitignore b/client/ios/.gitignore
new file mode 100644
index 0000000..ba86799
--- /dev/null
+++ b/client/ios/.gitignore
@@ -0,0 +1,2 @@
+# 嵌入式 libbox 框架由 scripts/build-libbox.sh 本地构建，不入 git（体积大、可复现）
+**/Frameworks/Libbox.xcframework/