Files
a-share-analysis/docs/governance/version-control-and-gitea.md
T

1.3 KiB

Git 与 Gitea 规范

1. 当前策略

当前只使用本地 Git,不配置 GitHub、不创建 GitHub Actions,也不向任何第三方远程仓库推送。用户安装 Gitea 后,再显式配置 origin

2. 分支与提交

  • main 始终保持可验证和可回退。
  • 普通功能使用 feature/<功能编号>-<短名称>
  • 修复使用 fix/<功能编号>-<短名称>
  • 提交必须符合中文 Conventional Commit,仓库通过 .githooks/commit-msg检查。
  • 禁止强推共享 main,禁止使用破坏历史的回退方式处理已共享版本。

首次克隆后执行:

git config core.hooksPath .githooks

3. Gitea 接入

Gitea 安装并创建空仓库后,由用户确认地址,再执行:

git remote add origin <用户提供的Gitea仓库地址>
git push -u origin main

建议在 Gitea 中保护 main:禁止强推、要求状态检查通过、要求变更说明关联功能编号。未得到用户提供的地址和授权前,任何代理不得自行添加远程或推送。

4. 版本与标签

发布使用带注释标签,例如:

git tag -a v0.1.0 -m "发布市场综合概览 v0.1.0"

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