diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..f38a9a7
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,44 @@
+# ============================================================
+#  YouleGames Cocos Creator Monorepo · .gitignore
+# ============================================================
+
+# ---------- 操作系统 / 编辑器 ----------
+.DS_Store
+Thumbs.db
+desktop.ini
+*~
+*.swp
+
+# ---------- 日志 ----------
+*.log
+npm-debug.log*
+yarn-error.log*
+
+# ---------- Node 依赖 ----------
+**/node_modules/
+
+# ---------- Cocos Creator 工程生成物（可由编辑器重建，勿入库） ----------
+# 适用于 cocoscreator_projects/ 下所有工程
+**/library/
+**/temp/
+**/local/
+**/build/
+**/native/
+**/profiles/
+
+# ---------- 子游戏共享框架的 junction（指向 YouleNexus 真源，按机器重建） ----------
+# 由 scripts/setup-links 在每台机器上重建，不入库
+games/*/assets/framework
+games/*/assets/framework.meta
+
+# ---------- cocos-creator-mcp 扩展：本地依赖与构建产物 ----------
+# clone 后在该目录跑 `npm install && npm run build` 重新生成
+cocoscreator_projects/YouleNexus/extensions/cocos-creator-mcp/node_modules/
+cocoscreator_projects/YouleNexus/extensions/cocos-creator-mcp/dist/
+
+# ============================================================
+#  说明：以下内容【应当】入库，勿忽略——
+#   - 各工程 assets/ settings/ package.json .creator/
+#   - docs/ projects/（旧 HTML5 模板与子游戏源码）
+#   - scripts/ templates/game-seed/
+# ============================================================