# 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` |