DESKTOP-2K5TJI4\admin
103 lines
2.6 KiB
Markdown
103 lines
2.6 KiB
Markdown
# Git 快速参考（AI 用）
|
||
|
||
> 从 [GIT-GUIDE.md](GIT-GUIDE.md) 精简。完整规范见原文。
|
||
|
||
---
|
||
|
||
## 分支策略
|
||
|
||
**轻量 Feature Branch** — 单人开发，`main` 永远可玩可编译。
|
||
|
||
| 分支 | 前缀 | 生命期 | 说明 |
|
||
|---|---|---|---|
|
||
| 主线 | `main` | 永久 | 稳定版本，不直接在上面开发 |
|
||
| 功能 | `feature/` | 合并后删 | 新系统、新功能 |
|
||
| 修复 | `fix/` | 合并后删 | Bug 修复 |
|
||
| 原型 | `prototype/` | 实验完即删 | 技术验证，随便写 |
|
||
| 发布 | `release/` | 永久 | 从 main 切出，版本标记 |
|
||
|
||
**命名规则：** `<类型>/<小写连字符描述>`
|
||
```
|
||
feature/player-movement fix/camera-clipping release/v0.1
|
||
```
|
||
|
||
**流程：**
|
||
1. 从 `main` 拉分支 → 2. 开发并提交 → 3. 测试通过后合并回 `main` → 4. 删除分支
|
||
|
||
---
|
||
|
||
## 提交规范
|
||
|
||
**格式：** `<type>(<scope>): <中文描述>`
|
||
|
||
- subject ≤ 50 字符，中文描述，技术术语保留英文
|
||
- body 可选，每行 ≤ 72 字符
|
||
|
||
**Type（必选）：**
|
||
|
||
| Type | 用途 |
|
||
|---|---|
|
||
| `feat` | 新功能 |
|
||
| `fix` | Bug 修复 |
|
||
| `art` | 美术资源 |
|
||
| `level` | 关卡/场景 |
|
||
| `audio` | 音效/音乐 |
|
||
| `bp` | 蓝图逻辑 |
|
||
| `refactor` | 重构（不改功能） |
|
||
| `config` | 项目/引擎配置 |
|
||
| `docs` | 文档 |
|
||
| `wip` | 进行中（未完成） |
|
||
|
||
**Scope（可选，常用）：**
|
||
`player` `enemy` `combat` `ui` `camera` `inventory` `dialogue` `quest` `save` `audio` `animation` `ai` `level` `vfx`
|
||
|
||
**示例：**
|
||
```
|
||
feat(player): 实现角色跳跃和二段跳
|
||
fix(camera): 修复穿墙时摄像机卡顿问题
|
||
bp(enemy): 实现巡逻-追击-攻击状态机
|
||
wip(crafting): 合成系统UI初步框架
|
||
config: 启用Nanite和Lumen
|
||
```
|
||
|
||
---
|
||
|
||
## UE5 注意事项
|
||
|
||
- 蓝图与 C++ 分开提交
|
||
- `.uasset` / `.umap` 无法 diff → commit message 必须写清改了什么
|
||
- 不提交 `Binaries/` `Intermediate/` `Saved/` `.vs/`
|
||
|
||
---
|
||
|
||
## 版本号
|
||
|
||
`v主版本.次版本.修订号` — 主版本=里程碑，次版本=新系统，修订号=小修
|
||
|
||
---
|
||
|
||
## 远程仓库
|
||
|
||
**SSH 地址**：`ssh://sc-gitea@micecola.top:2223/starmen1265/ChildHood.git`
|
||
|
||
> ⚠️ 用户名是 `sc-gitea`（非默认 `git`），端口是 `2223`（非默认 22）
|
||
|
||
**切换远程地址**：
|
||
```bash
|
||
git remote set-url origin ssh://sc-gitea@micecola.top:2223/starmen1265/ChildHood.git
|
||
```
|
||
|
||
**SSH config**（`~/.ssh/config`）：
|
||
```
|
||
Host gitea micecola.top
|
||
HostName micecola.top
|
||
Port 2223
|
||
User sc-gitea
|
||
IdentityFile ~/.ssh/id_ed25519_gitea
|
||
IdentitiesOnly yes
|
||
```
|
||
|
||
**内网地址**（家里用）：`ssh://sc-gitea@192.168.1.22:2223/starmen1265/ChildHood.git`
|
||
|
||
完整规范见 → [GIT-GUIDE.md](GIT-GUIDE.md)
|