1.5 KiB
1.5 KiB
项目专用 Gitea 远程仓库 PRD
- 功能编号：GOV-003
- PRD 版本：0.1
- 状态：approved
- 日期：2026-08-12
问题
项目已有可追溯的本地 Git 基线，但尚未关联用户自建 Gitea。接入过程中必须避免把项目凭据扩散到其他仓库，或把密码写入可提交文件和 Git 历史。
目标
- 将当前项目的
origin指向指定 Gitea 仓库。 - 所有 Git 设置只作用于当前项目，不修改全局配置。
- 使用系统钥匙串保存未来交互式认证产生的凭据，并按仓库路径隔离。
- 在治理文档中记录地址、账号、配置、验证和回退方法。
非目标
- 本次不向远程推送任何提交或标签。
- 不在项目内保存密码或访问令牌。
- 不配置 Gitea Actions、Webhook、分支保护或持续集成服务端规则。
- 不修改其他项目的 Git 配置。
用户流程
项目维护者可以从文档确认唯一远程地址和项目账号；代理和开发者使用项目级配置进行读取。首次获得明确推送授权后，维护者在交互式终端完成认证，凭据由 macOS Keychain 管理。
验收标准
git remote -v的 fetch/push 均为指定仓库。- 项目级凭据助手为
osxkeychain，credential.useHttpPath为true。 - 全局凭据助手与默认推送目标保持修改前状态。
- 无密码进入文档、远程 URL、Git 配置或 Git 历史。
git ls-remote origin可以建立只读连接。- PRD、设计、测试、Review 和回退档案完整。