文档: 新增 Git 使用说明

docs/Git使用说明.md

@@ -0,0 +1,74 @@
+# Git 版本管理使用说明（Gitea）
+
+> 代码已托管在 Gitea，Web 界面可看历史、diff、回滚。
+> **仓库地址**：https://git.ruiguo.wang/wangruiguo/OnebotCatalog.git
+> **Web 界面**：https://git.ruiguo.wang
+
+---
+
+## 一、日常提交（改动后存一版）
+
+```bash
+git add -A
+git commit -m "说明这次改了什么"
+git push
+```
+
+三步搞定：暂存 → 提交（本地留档）→ 推送（上传到服务器备份）。
+
+## 二、看历史 / 看改了啥
+
+```bash
+git log --oneline          # 提交列表（短格式）
+git log -p                 # 每次提交的详细改动
+git status                 # 当前有哪些文件改动未提交
+git diff                   # 具体改了什么内容
+```
+
+**更直观**：直接浏览器打开 https://git.ruiguo.wang 看，图形化看历史、diff、每个文件。
+
+## 三、回滚（改坏了想退回）
+
+```bash
+# 1. 查看历史，找到要退回的版本号（commit 前 7 位）
+git log --oneline
+
+# 2. 退回到某个版本（保留后续改动在工作区）
+git checkout <版本号> -- <文件名>
+
+# 3. 整个仓库回到某个版本（危险，会丢弃之后所有提交，慎用）
+git reset --hard <版本号>
+```
+
+**最安全**：在 Web 界面找到旧版本的某个文件 → 直接下载覆盖，再 commit。
+
+## 四、新电脑拉取代码
+
+```bash
+git clone https://git.ruiguo.wang/wangruiguo/OnebotCatalog.git
+```
+
+之后改代码提交推送即可，和上面的日常提交一样。
+
+---
+
+## ⚠️ 重要：哪些文件不入 git（.gitignore 已配好）
+
+以下大文件**不会**上传到 Gitea（版本管理只存代码和文档）：
+
+- PDF、Excel、报价单
+- STEP/STP/IGES/STL 数模文件（4138 个，体积大）
+- exe/dll 编译产物、.opc 数据包
+- 图片（手册页 PNG 等）
+
+**这些大文件靠其他方式备份**（如直接拷盘/群晖同步），git 只管"代码 + 文档 + 配置"。
+
+---
+
+## 五、常见问题
+
+| 问题 | 解决 |
+|---|---|
+| push 报认证失败 | 用 Gitea 账号密码登录，或用 SSH 地址 `ssh://git@git.ruiguo.wang:40846/wangruiguo/OnebotCatalog.git` |
+| 提示 ROOT_URL 不匹配 | 用 `https://git.ruiguo.wang` 访问，不要用 IP 访问 |
+| 忘了提交了哪些 | `git status` + `git log` |