ChildHood/docs/GIT-GUIDE-LITE.md

Git 快速参考（AI 用）

从 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）

切换远程地址：

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