diff --git a/scripts/setup-git.sh b/scripts/setup-git.sh
new file mode 100644
index 0000000..fa4a4ef
--- /dev/null
+++ b/scripts/setup-git.sh
@@ -0,0 +1,10 @@
+#!/bin/bash
+# ChildHood 项目 Git 初始化配置
+# 每台机器 clone 后运行一次: bash scripts/setup-git.sh
+
+cd "$(git rev-parse --show-toplevel)" || exit 1
+
+# 中文路径兼容 —— 防止 UBT 解析 git status 时因八进制转义崩溃
+git config --local core.quotepath false
+
+echo "[setup-git] core.quotepath=false 已设置"