41 lines
1.3 KiB
Markdown
41 lines
1.3 KiB
Markdown
# Git 与 Gitea 规范
|
|
|
|
## 1. 当前策略
|
|
|
|
当前只使用本地 Git，不配置 GitHub、不创建 GitHub Actions，也不向任何第三方远程仓库推送。用户安装 Gitea 后，再显式配置 `origin`。
|
|
|
|
## 2. 分支与提交
|
|
|
|
- `main` 始终保持可验证和可回退。
|
|
- 普通功能使用 `feature/<功能编号>-<短名称>`。
|
|
- 修复使用 `fix/<功能编号>-<短名称>`。
|
|
- 提交必须符合中文 Conventional Commit，仓库通过 `.githooks/commit-msg`检查。
|
|
- 禁止强推共享 `main`，禁止使用破坏历史的回退方式处理已共享版本。
|
|
|
|
首次克隆后执行：
|
|
|
|
```bash
|
|
git config core.hooksPath .githooks
|
|
```
|
|
|
|
## 3. Gitea 接入
|
|
|
|
Gitea 安装并创建空仓库后，由用户确认地址，再执行：
|
|
|
|
```bash
|
|
git remote add origin <用户提供的Gitea仓库地址>
|
|
git push -u origin main
|
|
```
|
|
|
|
建议在 Gitea 中保护 `main`：禁止强推、要求状态检查通过、要求变更说明关联功能编号。未得到用户提供的地址和授权前，任何代理不得自行添加远程或推送。
|
|
|
|
## 4. 版本与标签
|
|
|
|
发布使用带注释标签，例如：
|
|
|
|
```bash
|
|
git tag -a v0.1.0 -m "发布市场综合概览 v0.1.0"
|
|
```
|
|
|
|
标签必须指向通过验证的提交。应用回退优先选择既有标签和不可变构建产物，而不是重新拼装旧版本。
|