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

标签必须指向通过验证的提交。应用回退优先选择既有标签和不可变构建产物，而不是重新拼装旧版本。