# 项目专用 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 和回退档案完整。