diff --git a/玩值开发文档/8、部署/Gitea同步说明.md b/玩值开发文档/8、部署/Gitea同步说明.md
new file mode 100644
index 0000000..39010b8
--- /dev/null
+++ b/玩值开发文档/8、部署/Gitea同步说明.md
@@ -0,0 +1,42 @@
+# 玩值电竞 App → Gitea 同步说明
+
+> 仓库已投屏到 Gitea：**https://open.quwanzhi.com:3000/fnvtk/wzdj**  
+> 本地有更新会自动/手动推送到该仓库。
+
+## 一、远程与分支
+
+| 远程名 | 地址 | 说明 |
+|:---|:---|:---|
+| `origin` | https://github.com/fnvtk/wzdj.git | GitHub 主仓 |
+| `gitea` | https://open.quwanzhi.com:3000/fnvtk/wzdj.git | Gitea 镜像（投屏目标） |
+
+当前默认分支：`main`。
+
+## 二、自动同步（推荐）
+
+- **每次 commit 后**：已配置 `post-commit` 钩子，自动执行 `git push gitea main`，把最新提交推到 Gitea。
+- 若推送失败（如网络/SSL），可稍后手动执行下面「手动同步」。
+
+## 三、手动同步
+
+在项目根目录执行：
+
+```bash
+# 方式一：只推送（已有提交）
+git push gitea main
+
+# 方式二：先提交再推送（有未提交变更时）
+bash "玩值开发文档/8、部署/sync_to_gitea.sh"
+```
+
+## 四、SSL/TLS 问题说明
+
+若本机出现 `error:1404B42E:SSL routines:ST_CONNECT:tlsv1 alert protocol version`：
+
+- 在**能访问 Gitea 的网络环境**下再执行 `git push gitea main`（如公司网络、或配置好代理的终端）。
+- 或使用已配置 OpenSSL 的 Git（如 `brew install git` 后用 `/usr/local/bin/git`）再试。
+
+## 五、检查是否已同步
+
+- 打开：https://open.quwanzhi.com:3000/fnvtk/wzdj  
+- 查看最新提交时间与本地 `git log -1` 一致即表示已同步。
diff --git a/玩值开发文档/8、部署/sync_to_gitea.sh b/玩值开发文档/8、部署/sync_to_gitea.sh
new file mode 100755
index 0000000..64b76b1
--- /dev/null
+++ b/玩值开发文档/8、部署/sync_to_gitea.sh
@@ -0,0 +1,23 @@
+#!/bin/bash
+# 玩值电竞 App → Gitea 同步（有变更则提交并推送）
+# 在项目根目录执行：bash 玩值开发文档/8、部署/sync_to_gitea.sh
+
+set -e
+REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+cd "$REPO_ROOT"
+REMOTE="gitea"
+BRANCH="$(git branch --show-current)"
+
+# 可选：代理（若直连 Gitea 失败）
+# export HTTPS_PROXY=http://127.0.0.1:7897 HTTP_PROXY=http://127.0.0.1:7897
+
+git add -A
+if git diff --cached --quiet 2>/dev/null; then
+    echo "[sync_to_gitea] 无变更，仅推送已有提交..."
+else
+    COMMIT_MSG="🔄 玩值电竞App 同步 $(date '+%Y-%m-%d %H:%M')"
+    git commit -m "$COMMIT_MSG"
+    echo "[sync_to_gitea] 已提交：$COMMIT_MSG"
+fi
+git push "$REMOTE" "$BRANCH"
+echo "[sync_to_gitea] 已推送到 gitea/$BRANCH → https://open.quwanzhi.com:3000/fnvtk/wzdj"