docs(GOV-004): 封存强制推送验证结果

docs(GOV-004): 强制提交后同步 Gitea
docs(GOV-004): 制定强制推送实施计划
2026-08-12 18:44:30 +08:00 · 2026-08-12 18:43:17 +08:00 · 2026-08-12 18:38:46 +08:00 · 2026-08-12 18:36:23 +08:00 · 2026-08-12 18:34:05 +08:00 · 2026-08-12 18:33:09 +08:00
41 changed files with 911 additions and 13 deletions
@@ -15,14 +15,15 @@
 4. Git 提交必须使用中文 Conventional Commit，并带功能编号；禁止英文摘要和含糊提交信息。
 5. 代码必须为关键业务逻辑、数据口径、异常恢复和架构取舍提供准确的中文注释；禁止无意义逐行注释。
 6. 文件按稳定职责拆分，不以追求“原子化”为目的过度拆分。优先保证普通开发者能够连续阅读完整业务流程。
-7. 不使用 GitHub。当前只使用本地 Git，远程仓库仅在用户安装 Gitea 后配置。
-8. 禁止提交密钥、真实凭据、生产数据、`.env` 和 GitNexus 本地索引。
+7. 不使用 GitHub。本项目唯一远程仓库为项目级配置的 Gitea `https://git.foximao.com/FoXiMao/a-share-analysis.git`；禁止修改 Git 全局配置或影响其他项目。
+8. 禁止提交密钥、密码、访问令牌、生产数据、`.env` 和 GitNexus 本地索引；凭据不得写入远程 URL、文档、脚本或命令参数。
 9. 开发完成后必须先通过代码 Review 和开发规范符合性 Review，再进入发布；Review 结论和问题处置必须写入功能档案。
+10. 每次提交验证通过后必须立即推送当前分支到项目 Gitea；本次新建标签必须单独推送。推送失败时任务不得标记完成，禁止强推或自动覆盖未知远程提交。

 <!-- gitnexus:start -->
 # GitNexus — Code Intelligence

-This project is indexed by GitNexus as **a-share-analysis** (301 symbols, 326 relationships, 0 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
+This project is indexed by GitNexus as **a-share-analysis** (432 symbols, 458 relationships, 0 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.

 > If any GitNexus tool warns the index is stale, run `npx gitnexus analyze` in terminal first.

@@ -2,6 +2,17 @@

 本项目采用语义化版本。功能级变化请从 `docs/features/` 按功能编号追溯。

+## 0.0.3 - 2026-08-12
+
+- 将当前分支推送设为每次提交后的强制步骤，新标签采用精确推送。
+- 将远程同步成功加入完成定义，明确失败留痕、禁止强推和远程引用核对规则。
+- GOV-004 取代 GOV-003 的“只接入、不主动推送”历史规则，但保留原档案用于追溯。
+
+## 0.0.2 - 2026-08-12
+
+- 配置仅作用于本项目的 Gitea 远程仓库和凭据隔离策略。
+- 明确密码不入文档、不入配置、不入 Git 历史，以及推送需再次获得用户明确授权。
+
 ## 0.0.1 - 2026-08-12

 - 增加 PRD 与开发后 Review 强制门禁。
@@ -28,4 +28,13 @@ The first implementation slice is the market overview screen in `web/`.
 npm run governance:start -- FEAT-MO-001 market-overview
 ```

-当前只使用本地 Git。Gitea 安装完成后再按治理文档配置远程仓库。
+## 项目仓库
+
+- Gitea：<https://git.foximao.com/FoXiMao/a-share-analysis>
+- 远程名：`origin`
+- 配置范围：仅当前项目的 `.git/config`，不修改 Git 全局配置。
+
+凭据不写入仓库、文档或远程 URL。首次需要认证时由 Git 调用 macOS Keychain
+安全保存；详细规则见 [Git 与 Gitea 规范](docs/governance/version-control-and-gitea.md)。
+
+验证通过的中文提交必须立即同步当前分支到 Gitea；本次创建的版本标签单独同步。远程同步失败时，开发任务保持未完成状态。
@@ -1 +1 @@
-0.0.1
+0.0.3
@@ -0,0 +1,17 @@
+# 设计
+
+## 配置边界
+
+Git 仓库级配置存放在本项目 `.git/config`，天然不被提交，也不会作用于同一台机器上的其他项目。远程 URL 只包含协议、主机、所有者与仓库名，不嵌入用户名密码。
+
+## 凭据处理
+
+选择 macOS 原生 `osxkeychain` 凭据助手，避免明文凭据。设置 `credential.useHttpPath=true`，使 `git.foximao.com` 下不同仓库可以按 URL 路径隔离凭据；项目账号作为非敏感标识保存在本地仓库配置和治理文档中。
+
+## 授权边界
+
+远程接入分为两种权限：只读检查属于本次配置验证；推送会改变外部状态，需要用户另行明确授权。因此本次只执行非交互 `ls-remote`，不推送 `main` 或标签。
+
+## 文档边界
+
+文档记录可复现配置，但只引用密码的安全管理规则，不记录密码本身。这样既满足项目可追溯性，也避免秘密随克隆、备份和历史版本扩散。
@@ -0,0 +1,10 @@
+# GitNexus 开发后结果
+
+- 执行：`npx gitnexus analyze`。
+- 提交前工作区索引：349 个节点、375 条关系、5 个集群、0 条执行流程。
+- 提交后最终索引：361 个节点、387 条关系、5 个集群、0 条执行流程。
+- 最终增量分析：4 个已修改文件、0 个新增文件、0 个删除文件；其余 77 个文件行复用既有索引。
+- 索引提交：`b69023e`。
+- 状态：up-to-date。
+
+本功能没有修改生产代码、函数调用关系或业务流程。新增节点主要来自 GOV-003 功能档案和版本控制文档标题。提交后再次分析用于把索引锚定到确定提交，而不是只保留工作区快照。
@@ -0,0 +1,26 @@
+# GitNexus 开发前基线
+
+- 功能编号：GOV-003
+- 记录时间：2026年8月12日 GMT+8 18:28:00
+- 分支：main
+- 基线提交：7c7190998b6d
+
+## 工作区
+
+```text
+(干净)
+```
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/12/2026, 6:27:10 PM
+Indexed commit: 7c71909
+Current commit: 7c71909
+Status: ✅ up-to-date
+```
+
+## 后续人工分析
+
+在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。
@@ -0,0 +1,10 @@
+# GitNexus 前后对比
+
+| 项目 | 开发前 | 开发后 | 变化 |
+|---|---:|---:|---:|
+| 节点 | 301 | 361 | +60 |
+| 关系 | 326 | 387 | +61 |
+| 集群 | 5 | 5 | 0 |
+| 执行流程 | 0 | 0 | 0 |
+
+节点和关系增长来自 Gitea 治理说明及完整功能档案；没有新增或改变业务执行流程。变更检测风险为低，与开发前影响预估一致。最终索引已锚定实现提交 `b69023e`。
@@ -0,0 +1,8 @@
+# GitNexus 变更检测
+
+- 命令：`npx gitnexus detect-changes --repo a-share-analysis --scope all`。
+- 最终暂存区识别范围：24 个文件、51 个文档符号。
+- 受影响流程：0。
+- 风险等级：低。
+
+初次对未暂存变化检测到 7 个既有文件、14 个符号；完整暂存后，GOV-003 新建档案也被纳入检测，最终扩大为 24 个文件、51 个符号。纯文本版本文件和 Changelog 另外通过 `git status`、`git diff --stat` 和完整必备文件门禁核对。
@@ -0,0 +1,8 @@
+# GitNexus 开发前影响分析
+
+- 查询主题：`Gitea local remote version control configuration`。
+- 主要关联：`docs/governance/version-control-and-gitea.md`、`docs/index.md`、`VERSION`、`AGENTS.md` 和 `README.md`。
+- 符号影响检查：`getRequiredFeatureFiles` 只有 1 个直接上游依赖 `finish.mjs`，不参与执行流程，风险为低。
+- 实际变化以文档和 Git 仓库级配置为主，不修改生产代码、API、数据库或前端页面。
+- 预计影响：版本控制入口说明、开发代理约束、版本号和 GOV-003 功能档案。
+- 风险控制：不修改全局配置、不保存密码、不执行推送；修改后重新索引并执行变更检测。
@@ -0,0 +1,10 @@
+# 实施计划
+
+1. 执行开发前 GitNexus 更新、查询和影响分析。
+2. 核对当前远程、本地配置和全局配置基线。
+3. 添加 `origin`，使用 `--local` 设置凭据隔离和默认推送目标。
+4. 通过非交互 `git ls-remote origin` 验证只读连通性。
+5. 更新版本控制规范、代理约束、README、文档索引与版本记录。
+6. 保存 PRD、设计、测试、GitNexus 前后对比和回退说明。
+7. 执行治理测试、敏感信息检查、配置边界检查和双 Review。
+8. 以中文提交封存，并建立本地 `v0.0.2` 标签；不推送。
@@ -0,0 +1,17 @@
+id: GOV-003
+name: 项目专用 Gitea 远程仓库
+slug: gitea-local-remote
+status: released
+owner: project
+created_at: 2026-08-12
+prd: prd.md
+requirements: requirements.md
+design: design.md
+implementation_plan: implementation-plan.md
+gitnexus_before: gitnexus/before.md
+gitnexus_after: gitnexus/after.md
+gitnexus_comparison: gitnexus/comparison.md
+code_review: review/code-review.md
+standards_review: review/standards-review.md
+implementation_commit: b69023e
+release: v0.0.2
@@ -0,0 +1,37 @@
+# 项目专用 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 和回退档案完整。
@@ -0,0 +1,20 @@
+# 测试结果
+
+## 结果摘要
+
+- `npm run test:governance`：5 个测试通过，0 个失败。
+- `GIT_TERMINAL_PROMPT=0 git ls-remote origin`：退出码 0；远程是空仓库，返回引用为空。
+- fetch 与 push URL：均精确匹配指定 Gitea 仓库。
+- 项目级配置：`osxkeychain`、路径隔离、账号和默认推送目标全部匹配设计。
+- 全局边界：全局 `credential.helper` 和 `remote.pushDefault` 仍未设置。
+- 凭据模式扫描：未发现带用户名密码的 URL、密码赋值或令牌赋值。
+- `git diff --check`：通过。
+
+## 诊断与修正
+
+1. 测试计划最初写成不存在的 `npm test`，执行时因缺少脚本失败；检查 `package.json` 后修正为项目实际提供的 `npm run test:governance`，复测通过。
+2. GitNexus 变更检测最初未指定仓库；本机存在多个索引时工具拒绝猜测。增加 `--repo a-share-analysis` 后成功；最终暂存区结果为 24 个文件、51 个符号、0 条流程，风险为低。
+
+## 完成门禁
+
+双 Review 完成后执行 `npm run governance:finish -- GOV-003 gitea-local-remote`，退出码为 0。门禁确认完整功能档案和两份固定 `passed` Review 均已就绪。
@@ -0,0 +1,3 @@
+# 视觉验证
+
+本功能只修改 Git 仓库级配置和治理文档，不改变界面、样式或交互，因此视觉验证不适用。
@@ -0,0 +1,9 @@
+# 发布说明
+
+## v0.0.2
+
+- 实现提交：`b69023e`。
+- 为当前项目配置指定 Gitea `origin`，不影响其他项目。
+- 使用 macOS Keychain 与仓库路径隔离策略管理未来认证凭据。
+- 增加远程接入、授权边界、验证和回退文档。
+- 本版本只建立远程连接，不推送本地提交或标签。
@@ -0,0 +1,9 @@
+# 工程需求
+
+- 远程名固定为 `origin`，地址固定为 `https://git.foximao.com/FoXiMao/a-share-analysis.git`。
+- 使用 `git config --local` 写入凭据助手、路径隔离、账号和默认推送目标。
+- 不调用 `git config --global`，验证前后全局相关配置一致。
+- 不将密码传给 Shell 命令，也不把密码写入仓库文件或 `.git/config`。
+- 使用非交互、只读的 `git ls-remote origin` 检查网络与仓库可达性。
+- 未取得单独明确授权时，不运行 `git push`。
+- 更新根目录入口、治理规范、文档索引、版本和完整功能档案。
@@ -0,0 +1,31 @@
+# 配置与文档 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 基线提交：`7c71909`
+- 实现提交：`b69023e`
+- 审查范围：项目级 Gitea 远程、凭据隔离、治理文档和回退方案
+- 日期：2026-08-12
+
+## PRD 与设计符合性
+
+实现满足六项验收标准：远程 URL 正确；凭据设置仅位于 `.git/config`；全局配置未变化；密码没有进入文档、配置或历史；只读连通性成功；功能档案完整。
+
+## 发现与处置
+
+| 严重程度 | 发现 | 处置 |
+|---|---|---|
+| Important | 用户提供了密码，但写入文档或命令会形成长期泄露面 | 文档只保存基础地址、账号和仓库 URL；密码不落盘，由 Keychain 在未来交互认证时接管 |
+| Important | 使用全局凭据配置会影响其他项目 | 全部使用 `git config --local`，并验证相关全局项保持未设置 |
+| Minor | 初始测试计划引用了不存在的 `npm test` | 改用仓库实际的 `npm run test:governance` 并复测 5/5 通过 |
+| Minor | GitNexus 多仓库环境无法自动选择索引 | 显式增加 `--repo a-share-analysis`，变更检测成功 |
+
+## 验证
+
+- 远程只读连接、fetch/push URL 和四项本地配置断言全部通过。
+- 全局配置边界断言通过。
+- 凭据模式扫描与 `git diff --check` 通过。
+- GitNexus 最终暂存区检测 24 个文件、51 个符号、0 条流程，风险为低。
+- 没有执行 `git push`，未改变 Gitea 远程仓库内容。
+
+最终结论：passed
@@ -0,0 +1,24 @@
+# 开发规范符合性 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 实现提交：`b69023e`
+- 日期：2026-08-12
+
+## 检查结果
+
+- [x] 开发前执行治理启动命令并保存 GitNexus 基线。
+- [x] PRD、工程需求、设计、实施计划、测试计划和回退说明一致。
+- [x] 修改仅涉及项目级 Git 配置和治理文档，没有过度拆分生产代码。
+- [x] 基础地址、账号和仓库 URL 可追溯，密码和令牌未进入仓库。
+- [x] Git 全局配置没有修改，不影响其他项目。
+- [x] 未配置 GitHub，唯一远程为用户指定 Gitea。
+- [x] 没有未经授权推送外部状态。
+- [x] 治理测试、配置断言、敏感信息扫描和 GitNexus 变更检测通过。
+- [x] 本功能无界面变化，视觉验证已合理标记为不适用。
+
+## 不符合项与处置
+
+没有未解决的 Critical 或 Important 不符合项。两项执行期错误均属于测试命令选择问题，已修正文档并以成功复测关闭。
+
+最终结论：passed
@@ -0,0 +1,13 @@
+# 回退说明
+
+本功能的运行时影响仅限当前项目 `.git/config`。如需解除接入，在本项目根目录执行：
+
+```bash
+git remote remove origin
+git config --local --unset credential.helper
+git config --local --unset credential.useHttpPath
+git config --local --unset credential.username
+git config --local --unset remote.pushDefault
+```
+
+若 Keychain 已在后续交互式认证中保存凭据，再使用“钥匙串访问”按 `git.foximao.com` 删除对应项。文档和版本记录通过新的中文修复提交回退；不得改写已共享历史。本次未执行推送，因此远程不存在需要回滚的外部提交。
@@ -0,0 +1,9 @@
+# 测试计划
+
+- 检查 `origin` 的 fetch/push URL 精确匹配指定仓库。
+- 检查四项 Git 配置来自 `--local` 作用域。
+- 检查全局凭据助手和默认推送目标仍保持未设置。
+- 使用 `GIT_TERMINAL_PROMPT=0 git ls-remote origin` 验证远程只读连通性。
+- 搜索仓库文件、暂存区 diff 和远程 URL，确认不存在密码或凭据 URL。
+- 运行 `npm run test:governance` 和 `npm run governance:finish -- GOV-003 gitea-local-remote`。
+- 本功能不改变页面，视觉验证标记为不适用并说明原因。
@@ -0,0 +1,78 @@
+# 提交后强制推送 Gitea 设计规格
+
+- 功能编号：GOV-004
+- 规格版本：0.1
+- 状态：approved_for_review
+- 日期：2026-08-12
+
+## 背景与目标
+
+本地提交如果没有同步到远程，无法实现跨设备备份、Gitea 审阅和可靠的版本追溯。本功能把推送从“需要逐次授权的可选动作”改成项目开发流程的固定完成条件。
+
+目标是：每次本地提交在验证通过后立即同步当前分支；创建版本标签后同步该标签；任何推送失败都会阻止任务被报告为完成。
+
+## 方案比较
+
+### 方案 A：按变化精确推送（采用）
+
+- 普通提交执行 `git push origin <当前分支>`。
+- 创建新标签后执行 `git push origin <标签名>`。
+- 优点：只同步本次明确产生的引用，行为可预测，不会意外发布其他本地标签。
+- 代价：分支和标签需要分别执行推送。
+
+### 方案 B：每次提交推送分支及全部标签
+
+- 执行 `git push origin <当前分支> --tags`。
+- 优点：命令较少。
+- 缺点：可能把尚未准备发布的历史或实验标签一并推送，不采用。
+
+### 方案 C：仅发布时批量推送
+
+- 多个本地提交积累到版本发布时再统一同步。
+- 优点：减少远程交互次数。
+- 缺点：提交期间缺少远程备份，也不符合“提交后需要推送”的要求，不采用。
+
+## 强制流程
+
+1. 完成测试、构建、Review、GitNexus 变更检测和敏感信息检查。
+2. 创建符合中文 Conventional Commit 的本地提交。
+3. 获取当前分支名，执行 `git push origin <当前分支>`。
+4. 如果本次创建了标签，再执行 `git push origin <标签名>`。
+5. 使用 `git status -sb` 或远程引用检查，确认本地分支与远程分支一致。
+6. 把提交 SHA、推送目标、推送结果和标签结果写入功能档案。
+7. 只有分支及本次新建标签全部推送成功后，任务才可以标记完成。
+
+## 失败处理
+
+- 认证、网络、分支保护或服务器错误发生时，保留本地提交和标签，不删除、不改写历史。
+- 将任务状态标为“推送失败/未完成”，记录失败命令、时间和不包含凭据的错误摘要。
+- 修复原因后重复同一个精确推送命令；禁止使用 `--force`、`--force-with-lease` 或绕过保护规则。
+- 远程出现未知提交导致非快进失败时，先获取并检查差异，不自动 rebase、merge 或覆盖远程。
+- 密码和令牌继续由 macOS Keychain 管理，禁止写入文档、脚本、远程 URL、命令参数和 Git 历史。
+
+## 配置与作用域
+
+- 唯一允许的推送远程是当前项目 `.git/config` 中的 `origin`。
+- 推送前必须验证 `origin` 仍为 `https://git.foximao.com/FoXiMao/a-share-analysis.git`。
+- 禁止修改 Git 全局配置，禁止影响其他项目，禁止新增 GitHub 远程。
+- 本规则适用于业务代码、治理文档、规格、Review 修正和版本封存等所有提交。
+
+## 文档变更范围
+
+- `AGENTS.md`：把提交后推送改为代理强制要求。
+- `docs/governance/development-workflow.md`：把推送加入开发后流程和完成定义。
+- `docs/governance/version-control-and-gitea.md`：记录标准命令、失败处理和验证方法。
+- `README.md`：简述项目提交会同步到 Gitea。
+- `docs/features/GOV-004-mandatory-gitea-push/`：保存 PRD、需求、实施计划、测试、Review、GitNexus 前后对比、发布和回退证据。
+
+GOV-003 是当时“只接入、不推送”的历史决策记录，保持原文不变；GOV-004 作为后续决策明确取代其推送授权规则，保证历史可追溯。
+
+## 验收标准
+
+- 所有现行入口规范不再包含“默认不推送”或“逐次取得用户授权”的冲突要求。
+- 规范明确普通提交推当前分支、新标签单独推送、失败不算完成、禁止强推。
+- `main` 的本地历史同步到 `origin/main`。
+- 已有版本标签 `v0.0.0`、`v0.0.1`、`v0.0.2` 同步到远程。
+- GOV-004 的提交和后续封存标签也按相同规则同步。
+- 全局 Git 配置保持不变，敏感信息扫描无发现。
+- 治理测试、完成门禁和 GitNexus 前后检测通过。
@@ -0,0 +1,10 @@
+# GitNexus 开发后结果
+
+- 执行：`npx gitnexus analyze`。
+- 开发后工作区索引：426 个节点、452 条关系、5 个集群、0 条执行流程。
+- 实现提交后索引：432 个节点、458 条关系、5 个集群、0 条执行流程。
+- 增量分析：6 个已修改文件、17 个新增文件、0 个删除文件；75 个未变化文件行复用既有索引。
+- 最终索引提交：`2a16e9f`。
+- 状态：up-to-date。
+
+本功能没有修改生产代码、函数调用关系或业务执行流程。实现提交后再次分析，最终索引已锚定到确定提交。
@@ -0,0 +1,26 @@
+# GitNexus 开发前基线
+
+- 功能编号：GOV-004
+- 记录时间：2026年8月12日 GMT+8 18:35:43
+- 分支：main
+- 基线提交：4b390d998909
+
+## 工作区
+
+```text
+(干净)
+```
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/12/2026, 6:34:06 PM
+Indexed commit: 4b390d9
+Current commit: 4b390d9
+Status: ✅ up-to-date
+```
+
+## 后续人工分析
+
+在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。
@@ -0,0 +1,10 @@
+# GitNexus 前后对比
+
+| 项目 | 开发前 | 实现提交后 | 变化 |
+|---|---:|---:|---:|
+| 节点 | 361 | 432 | +71 |
+| 关系 | 387 | 458 | +71 |
+| 集群 | 5 | 5 | 0 |
+| 执行流程 | 0 | 0 | 0 |
+
+增长来自 GOV-004 的规格、实施计划、现行治理入口和追溯档案。执行流程保持为 0，符合开发前“只影响治理文档与远程同步流程”的预估。最终索引锚定实现提交 `2a16e9f`。
@@ -0,0 +1,9 @@
+# GitNexus 变更检测
+
+- 初次工作区命令：`npx gitnexus detect-changes --repo a-share-analysis --scope all`。
+- 初次识别：7 个既有文件、16 个文档符号。
+- 最终暂存区识别：21 个文件、44 个文档符号。
+- 受影响流程：0。
+- 风险等级：低。
+
+完整暂存后使用 `--scope staged` 将 GOV-004 新建档案纳入检测；最终结果仍为 0 条受影响流程、低风险。
@@ -0,0 +1,9 @@
+# GitNexus 开发前影响分析
+
+- 查询主题：`mandatory push after commit Gitea workflow`。
+- 主要关联：GOV-003 功能档案、`docs/governance/version-control-and-gitea.md`、`docs/governance/development-workflow.md`、`AGENTS.md`、`README.md` 和文档索引。
+- 查询没有返回业务执行流程，说明变化不触及前端、后端、数据任务或运行时调用链。
+- 本次不修改函数、类或方法，因此不存在需要符号级上游影响分析的生产代码目标。
+- 预计影响：开发完成定义、远程同步授权规则、标签发布规则、版本号和治理档案。
+- 风险：文档冲突可能让代理继续遵循旧规则；通过限定扫描现行治理入口并保留 GOV-003 为历史记录解决。
+- 外部状态风险：推送改变 Gitea；用户已经明确授权，并要求此后把推送设为固定开发步骤。
@@ -0,0 +1,169 @@
+# 提交后强制推送 Gitea 实施计划
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 将每次验证通过的本地提交和本次新增版本标签精确推送到项目专用 Gitea，并把推送成功设为任务完成条件。
+
+**Architecture:** Git 仍使用当前项目 `.git/config` 中唯一的 `origin`，不增加脚本服务或全局配置。流程层通过现行治理文档、代理入口和 GOV-004 功能档案强制执行“验证—提交—推送—远程核对”，GOV-003 保持为历史决策，由 GOV-004 明确取代其推送规则。
+
+**Tech Stack:** Git、Gitea、macOS Keychain、Markdown、GitNexus、Node.js 治理门禁。
+
+## Global Constraints
+
+- 远程固定为 `https://git.foximao.com/FoXiMao/a-share-analysis.git`，作用域仅限当前项目。
+- 不修改 Git 全局配置，不新增 GitHub 远程。
+- 普通提交只推送当前分支；新标签只推送本次创建的标签。
+- 推送失败时任务不得标记完成，且禁止任何形式的强推。
+- 密码和令牌不得进入文件、远程 URL、命令参数或 Git 历史。
+- 每次提交必须使用中文 Conventional Commit，并在提交后立即推送。
+
+---
+
+### Task 1: 固化产品与工程规则
+
+**Files:**
+- Create: `docs/features/GOV-004-mandatory-gitea-push/prd.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/requirements.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/test-plan.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/gitnexus/impact-plan.md`
+- Modify: `docs/features/GOV-004-mandatory-gitea-push/implementation-plan.md`
+
+**Interfaces:**
+- Consumes: 已确认的 `design.md` 和 GitNexus 开发前基线。
+- Produces: 可由完成门禁和 Review 逐条验证的功能需求。
+
+- [ ] **Step 1: 编写 PRD 与工程需求**
+
+明确当前分支推送、新标签精确推送、失败阻断完成、禁止强推、凭据安全和现有历史标签同步六类验收项。
+
+- [ ] **Step 2: 编写测试及影响计划**
+
+列出治理测试、冲突文本扫描、远程 URL、远程分支 SHA、远程标签集合、全局配置边界和敏感信息扫描命令。
+
+- [ ] **Step 3: 核对规格覆盖**
+
+运行：
+
+```bash
+rg -n "当前分支|新标签|推送失败|禁止强推|Keychain|v0.0.0|v0.0.1|v0.0.2" docs/features/GOV-004-mandatory-gitea-push
+```
+
+预期：所有约束均能从设计、PRD、需求或测试计划定位。
+
+### Task 2: 更新现行治理入口
+
+**Files:**
+- Modify: `AGENTS.md`
+- Modify: `README.md`
+- Modify: `docs/governance/development-workflow.md`
+- Modify: `docs/governance/version-control-and-gitea.md`
+- Modify: `docs/index.md`
+- Modify: `CHANGELOG.md`
+- Modify: `VERSION`
+
+**Interfaces:**
+- Consumes: Task 1 的验收要求。
+- Produces: 对所有后续代理和开发者生效的强制推送规范。
+
+- [ ] **Step 1: 更新代理入口和开发流程**
+
+删除“推送需逐次授权”的现行条款，加入提交后立即推送、标签精确推送、失败阻断完成和禁止强推。
+
+- [ ] **Step 2: 更新 Gitea 操作规范**
+
+记录 `git push origin <当前分支>`、`git push origin <标签名>`、远程 SHA 验证、错误留痕和安全重试规则。
+
+- [ ] **Step 3: 更新索引和版本记录**
+
+新增 GOV-004 文档入口，将版本提升到 `0.0.3` 并记录规则变化。
+
+- [ ] **Step 4: 验证不存在现行冲突**
+
+运行：
+
+```bash
+rg -n "不得主动.*推送|只有用户明确要求.*推送|本地提交和标签完成后仍不得自动推送" AGENTS.md README.md docs/governance
+```
+
+预期：无匹配。GOV-003 历史档案允许保留旧规则。
+
+### Task 3: 补齐验证、Review 与发布档案
+
+**Files:**
+- Create: `docs/features/GOV-004-mandatory-gitea-push/manifest.yaml`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/gitnexus/after.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/gitnexus/detected-changes.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/gitnexus/comparison.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/qa/test-results.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/qa/visual-qa.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/review/code-review.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/review/standards-review.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/release-notes.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/rollback.md`
+
+**Interfaces:**
+- Consumes: Task 2 的文档 diff 和远程同步结果。
+- Produces: GOV-004 完成门禁所需的全部追溯文件。
+
+- [ ] **Step 1: 执行本地验证**
+
+运行：
+
+```bash
+npm run test:governance
+git diff --check
+npx gitnexus analyze
+npx gitnexus detect-changes --repo a-share-analysis --scope all
+```
+
+预期：5 个治理测试通过、diff 无空白错误、GitNexus 状态最新且风险为低。
+
+- [ ] **Step 2: 扫描敏感信息和全局配置边界**
+
+对仓库文件与暂存 diff 扫描凭据 URL、密码和令牌赋值；确认全局 `credential.helper` 与 `remote.pushDefault` 未被本功能修改。
+
+- [ ] **Step 3: 编写双 Review 和完成档案**
+
+两份 Review 必须逐条对应 PRD，处理所有 Important 问题，并以固定行 `最终结论：passed` 结束。
+
+- [ ] **Step 4: 运行完成门禁**
+
+运行：
+
+```bash
+npm run governance:finish -- GOV-004 mandatory-gitea-push
+```
+
+预期：退出码为 0。
+
+### Task 4: 提交、推送并核对远程
+
+**Files:**
+- Modify: `docs/features/GOV-004-mandatory-gitea-push/manifest.yaml`
+- Modify: `docs/features/GOV-004-mandatory-gitea-push/qa/test-results.md`
+- Modify: `docs/features/GOV-004-mandatory-gitea-push/release-notes.md`
+
+**Interfaces:**
+- Consumes: 通过 Task 3 完成门禁的暂存区。
+- Produces: 与本地 `main` 和版本标签一致的 Gitea 远程引用。
+
+- [ ] **Step 1: 创建中文实现提交并推送**
+
+```bash
+git commit -m "docs(GOV-004): 强制提交后同步 Gitea"
+git push origin main
+```
+
+预期：`origin/main` 指向新提交。
+
+- [ ] **Step 2: 同步既有标签**
+
+分别推送 `v0.0.0`、`v0.0.1` 和 `v0.0.2`，不使用 `--tags`。
+
+- [ ] **Step 3: 封存版本并推送**
+
+回填实现提交，创建中文封存提交并推送；创建带注释 `v0.0.3` 标签，再单独推送该标签。
+
+- [ ] **Step 4: 最终远程核对**
+
+比较 `git rev-parse main` 与 `git ls-remote origin refs/heads/main`；逐一比较四个本地标签与远程 peeled tag 提交，确认工作区干净、GitNexus 索引最新。
@@ -0,0 +1,17 @@
+id: GOV-004
+name: 提交后强制推送 Gitea
+slug: mandatory-gitea-push
+status: released
+owner: project
+created_at: 2026-08-12
+prd: prd.md
+requirements: requirements.md
+design: design.md
+implementation_plan: implementation-plan.md
+gitnexus_before: gitnexus/before.md
+gitnexus_after: gitnexus/after.md
+gitnexus_comparison: gitnexus/comparison.md
+code_review: review/code-review.md
+standards_review: review/standards-review.md
+implementation_commit: 2a16e9f
+release: v0.0.3
@@ -0,0 +1,44 @@
+# 提交后强制推送 Gitea PRD
+
+- 功能编号：GOV-004
+- PRD 版本：0.1
+- 状态：approved
+- 日期：2026-08-12
+
+## 问题
+
+项目此前只要求保存本地提交，是否推送需要逐次确认。这会导致本地版本与 Gitea 长期不一致，使远程备份、跨设备读取、历史审阅和版本回退缺少可靠依据。
+
+## 目标
+
+- 每次验证通过的本地提交立即推送当前分支。
+- 本次创建的新标签在分支推送成功后单独推送。
+- 推送失败时任务保持未完成，并提供安全、可审计的重试路径。
+- 让提交、远程分支、标签和功能档案保持可核对的一致关系。
+
+## 非目标
+
+- 不自动推送其他本地分支或非本次创建的标签。
+- 不使用强推，不自动合并、rebase 或覆盖未知远程提交。
+- 不新增 GitHub、CI、Webhook 或 Gitea 服务端配置。
+- 不修改全局 Git 配置，不影响其他项目。
+
+## 用户流程
+
+开发者完成验证与 Review 后创建中文提交，随即把当前分支推送到项目 `origin`；若同时发布版本，则精确推送新标签。系统核对远程 SHA 并在功能档案中记录结果。任何环节失败都保留本地状态，解决原因后重试，不能对外宣称完成。
+
+## 验收标准
+
+- 现行规范明确普通提交只推当前分支，新标签只推本次创建的标签。
+- 现行规范明确推送成功属于完成定义，失败必须留痕并阻断完成。
+- 现行规范禁止 `--force`、`--force-with-lease`、自动覆盖或自动改写远程历史。
+- `origin/main` 与最终本地 `main` SHA 一致。
+- 既有 `v0.0.0`、`v0.0.1`、`v0.0.2` 以及新 `v0.0.3` 标签均能从远程读取并对应本地标签提交。
+- 凭据继续由 macOS Keychain 管理，仓库和提交历史无密码或令牌。
+- 全局 Git 配置保持不变，治理门禁和 GitNexus 变更检测通过。
+
+## 风险
+
+- 远程网络或认证故障会延迟任务完成，但不会破坏本地提交。
+- 分支保护或远程出现未知提交时可能拒绝推送；必须停下检查，不得绕过保护。
+- 将所有标签批量推送可能发布未批准标签，因此只允许精确推送指定标签。
@@ -0,0 +1,26 @@
+# 测试结果
+
+## 本地验证
+
+- `npm run test:governance`：5 个测试通过，0 个失败。
+- `git diff --check`：通过。
+- 现行推送规则冲突扫描：无匹配。
+- `origin` push URL：精确匹配项目 Gitea。
+- 项目配置：Keychain、路径隔离、账号和默认推送目标均符合设计。
+- 全局边界：全局 `credential.helper` 和 `remote.pushDefault` 保持未设置。
+- 敏感信息扫描：未发现凭据 URL、密码赋值或令牌赋值。
+- GitNexus：426 个节点、452 条关系、5 个集群、0 条流程；变更风险为低。
+- GitNexus 最终暂存区：21 个文件、44 个符号、0 条流程，风险为低。
+- `npm run governance:finish -- GOV-004 mandatory-gitea-push`：退出码 0，完整档案和双 Review 门禁通过。
+
+## 诊断记录
+
+初次冲突扫描命中新规范中的否定说明“不再逐次请求推送授权”。该文本并未要求逐次授权，但会让机器扫描误报，因此改写为“用户已授予本项目持续推送权限”；同一扫描复测无匹配。
+
+## 远程同步
+
+- 设计提交 `757d8ab` 已推送，首次建立 `origin/main`。
+- 计划提交 `2d2502c` 已推送，并验证远程 `main` 与本地 SHA 一致。
+- 实现提交 `2a16e9f` 已推送，远程 `main` SHA 与本地一致。
+- 既有 `v0.0.0`、`v0.0.1`、`v0.0.2` 已分别精确推送；远程 peeled tag 提交与本地标签提交一致。
+- `v0.0.3` 在封存提交后创建、精确推送并执行最终引用核对。
@@ -0,0 +1,3 @@
+# 视觉验证
+
+本功能只修改 Git/Gitea 流程与治理文档，不改变页面、样式、图表或交互，因此视觉验证不适用。
@@ -0,0 +1,10 @@
+# 发布说明
+
+## v0.0.3
+
+- 实现提交：`2a16e9f`。
+- 把当前分支推送设为每次提交后的固定完成步骤。
+- 本次创建的新标签采用精确推送，禁止用 `--tags` 批量发布其他标签。
+- 推送失败将阻断任务完成，并禁止强推或自动覆盖未知远程历史。
+- 增加远程 SHA 核对与功能档案留痕要求。
+- GOV-004 取代 GOV-003 的旧推送授权规则，历史档案保持不变。
@@ -0,0 +1,13 @@
+# 工程需求
+
+- 提交前必须完成测试、构建或适用性说明、双 Review、GitNexus 变更检测及敏感信息检查。
+- 提交信息必须使用中文 Conventional Commit 并包含功能编号。
+- 提交后读取当前分支名，执行 `git push origin <当前分支>`。
+- 创建新标签后执行 `git push origin <标签名>`，禁止使用 `--tags` 代替精确推送。
+- 推送完成后比较本地分支 SHA 与 `git ls-remote origin refs/heads/<当前分支>`。
+- 标签核对必须解析带注释标签指向的提交，而不是只比较标签对象 SHA。
+- 推送失败时保留本地提交，记录不含凭据的错误摘要并阻断任务完成。
+- 禁止 `--force`、`--force-with-lease`、自动 rebase、自动 merge 和覆盖未知远程引用。
+- 唯一远程必须是本项目 `.git/config` 中的指定 `origin`，不得修改全局 Git 配置。
+- 密码和令牌只能由系统 Keychain 管理，不得进入项目文件、Git URL、命令参数和 Git 历史。
+- GOV-003 保留原始历史文本；现行推送规则以 GOV-004 和治理入口为准。
@@ -0,0 +1,35 @@
+# 配置与文档 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 基线提交：`4b390d9`
+- 设计提交：`757d8ab`
+- 计划提交：`2d2502c`
+- 实现提交：`2a16e9f`
+- 审查范围：强制推送流程、远程核对、失败处理、版本同步和功能档案
+- 日期：2026-08-12
+
+## PRD 与设计符合性
+
+现行规范已经覆盖当前分支立即推送、新标签精确推送、失败阻断完成、禁止强推、远程 SHA 核对、Keychain 凭据边界和功能档案留痕。GOV-003 保持原文，GOV-004 明确取代其旧推送授权规则。
+
+## 发现与处置
+
+| 严重程度 | 发现 | 处置 |
+|---|---|---|
+| Important | 原 `AGENTS.md` 和开发流程仍要求逐次获得推送授权，与用户新要求冲突 | 现行入口统一改为持续授权和提交后强制推送，并增加冲突文本扫描 |
+| Important | 批量 `--tags` 可能发布无关标签 | 明确只允许 `git push origin <本次标签名>`，并把禁止 `--tags` 写入规范 |
+| Important | 推送失败后自动强推、合并或 rebase 可能破坏未知远程历史 | 明确失败阻断完成、先检查差异以及禁止强推和自动改写 |
+| Minor | 新规范中的否定句触发冲突扫描误报 | 改为肯定式持续授权声明，复测无冲突匹配 |
+
+## 验证
+
+- 5 个治理测试通过，`git diff --check` 通过。
+- 现行规则冲突扫描和敏感信息扫描通过。
+- Git 配置仅位于当前项目，全局相关配置保持未设置。
+- GitNexus 最终暂存区检测为 21 个文件、44 个符号、0 条流程、低风险。
+- 设计和计划两次提交均已按新规则推送并核对远程 `main`。
+
+实现提交和标签引用将在创建后按规范精确推送，不存在阻断提交的 Review 问题。
+
+最终结论：passed
@@ -0,0 +1,25 @@
+# 开发规范符合性 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 实现提交：`2a16e9f`
+- 日期：2026-08-12
+
+## 检查结果
+
+- [x] 用户批准设计规格后才进入实施。
+- [x] 开发前运行治理启动、GitNexus 查询并保存基线。
+- [x] PRD、工程需求、设计、计划、测试和回退说明一致。
+- [x] GOV-003 历史原文未被篡改，后续决策通过 GOV-004 追溯。
+- [x] 现行入口没有相互冲突的推送授权规则。
+- [x] 未修改生产代码，没有不必要的代码拆分或依赖变化。
+- [x] 未配置 GitHub，唯一远程仍为项目专用 Gitea。
+- [x] 未修改 Git 全局配置，密码和令牌未进入仓库。
+- [x] 治理测试、文档检查、GitNexus 和敏感信息扫描通过。
+- [x] 界面没有变化，视觉验证合理标记为不适用。
+
+## 不符合项与处置
+
+没有未解决的 Critical 或 Important 不符合项。最终分支和标签同步属于提交后的发布步骤，将通过远程引用比较闭环。
+
+最终结论：passed
@@ -0,0 +1,12 @@
+# 回退说明
+
+本功能已经把 `main` 同步到共享 Gitea，因此不得使用 reset、强推或删除共享提交回退。
+
+如果强制推送规则需要撤销：
+
+1. 创建新的治理功能编号并说明撤销原因。
+2. 使用中文修复提交恢复治理入口文字，不修改 GOV-004 历史档案。
+3. 通过完整测试、Review 和 GitNexus 门禁后正常推送修复提交。
+4. 已共享的 `v0.0.3` 标签不得移动或删除；使用新的补丁版本表达修正。
+
+认证或网络故障不需要回退本地提交。保留提交，修复连接后重试精确推送；禁止将密码写入诊断记录。
@@ -0,0 +1,13 @@
+# 测试计划
+
+- 运行 `npm run test:governance`，要求 5 个治理测试通过、0 个失败。
+- 运行 `git diff --check`，要求无空白错误。
+- 扫描 `AGENTS.md`、`README.md` 和 `docs/governance/`，要求不存在“默认不推送”或“逐次授权后才能推送”的现行冲突文本。
+- 检查 `git remote get-url --push origin` 精确等于指定 Gitea 仓库。
+- 比较 `git rev-parse main` 与远程 `refs/heads/main` SHA。
+- 分别解析本地和远程 `v0.0.0`、`v0.0.1`、`v0.0.2`、`v0.0.3` 指向的提交并比较。
+- 检查全局 `credential.helper` 和 `remote.pushDefault` 与 GOV-004 开始前一致。
+- 扫描仓库文件和暂存区，要求没有凭据 URL、密码赋值或令牌赋值。
+- 运行 `npx gitnexus analyze` 和指定仓库的 `detect-changes`，记录节点、关系、流程和风险。
+- 运行 `npm run governance:finish -- GOV-004 mandatory-gitea-push`，要求退出码为 0。
+- 本功能不修改页面，视觉验证标记不适用并说明原因。
@@ -60,7 +60,9 @@ npm run governance:finish -- FEAT-MO-001 market-overview
 9. 任一 Review 为 `changes_required` 时，返回开发阶段；修复后重跑相关测试、GitNexus开发后分析和 Review。
 10. 两项 Review 均为 `passed` 后，更新发布说明、回退说明、变更记录和版本号。
 11. 使用中文 Conventional Commit 提交。
-12. 提交后执行 `npx gitnexus status`；若状态过期，再运行 `npx gitnexus analyze`。
+12. 提交后立即将当前分支推送到项目专用 Gitea `origin`；如果本次创建了标签，再精确推送该标签。
+13. 比较本地与远程分支 SHA，并将提交、推送目标和结果写入功能档案。推送失败时保留本地提交，任务状态保持未完成。
+14. 提交后执行 `npx gitnexus status`；若状态过期，再运行 `npx gitnexus analyze`。

 ## 6. 完成定义

@@ -76,6 +78,7 @@ npm run governance:finish -- FEAT-MO-001 market-overview
 - 开发规范符合性 Review 结论为 `passed`。
 - 发布说明和回退方法可执行。
 - 中文提交已关联功能编号。
+- 当前分支和本次新建标签已推送到 `origin`，功能档案保存远程核对结果。

 ## 7. 提交流程

@@ -95,6 +98,20 @@ docs(GOV-001): 建立工程治理与追溯规范

 一次提交应表达一个完整意图，但不为了追求小提交把同一功能切成无法独立理解的碎片。

+提交后推送当前分支：
+
+```bash
+git push origin "$(git branch --show-current)"
+```
+
+如果本次创建了标签，只推送该标签：
+
+```bash
+git push origin <本次标签名>
+```
+
+禁止使用 `--force`、`--force-with-lease` 或 `--tags` 代替精确推送。推送失败时不得宣称任务完成；应记录不含凭据的错误摘要，排查后重试同一精确命令。
+
 ## 8. 发布与回退

 - 使用语义化版本和带注释 Git Tag。
@@ -2,7 +2,17 @@

 ## 1. 当前策略

-当前只使用本地 Git，不配置 GitHub、不创建 GitHub Actions，也不向任何第三方远程仓库推送。用户安装 Gitea 后，再显式配置 `origin`。
+本项目使用本地 Git 和用户自建 Gitea，不使用 GitHub，也不创建 GitHub Actions。
+
+| 配置项 | 值 |
+|---|---|
+| Gitea 基础地址 | `https://git.foximao.com/` |
+| 项目账号 | `FoXiMao` |
+| 唯一远程仓库 | `https://git.foximao.com/FoXiMao/a-share-analysis.git` |
+| 远程名 | `origin` |
+| 配置作用域 | 当前项目 `.git/config` |
+
+密码不属于项目文档。它不得出现在仓库文件、Git 历史、远程 URL、脚本或命令参数中；首次认证时由 Git 凭据助手请求，并交由 macOS Keychain 保存。

 ## 2. 分支与提交

@@ -18,18 +28,94 @@
 git config core.hooksPath .githooks
 ```

-## 3. Gitea 接入
+## 3. Gitea 项目级接入

-Gitea 安装并创建空仓库后，由用户确认地址，再执行：
+在本项目根目录执行以下项目级配置：
+
+```bash
+git remote add origin https://git.foximao.com/FoXiMao/a-share-analysis.git
+git config --local credential.helper osxkeychain
+git config --local credential.useHttpPath true
+git config --local credential.username FoXiMao
+git config --local remote.pushDefault origin
+```
+
+`credential.useHttpPath=true` 让同一 Gitea 域名下不同仓库按路径区分凭据；所有设置使用 `--local`，只写入本项目不可提交的 `.git/config`。禁止使用 `git config --global` 配置本项目账号、凭据助手或默认推送目标。
+
+只读连通性检查：
+
+```bash
+GIT_TERMINAL_PROMPT=0 git ls-remote origin
+```
+
+首次需要写权限时，在交互式终端推送并输入凭据：

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

-建议在 Gitea 中保护 `main`：禁止强推、要求状态检查通过、要求变更说明关联功能编号。未得到用户提供的地址和授权前，任何代理不得自行添加远程或推送。
+首次认证完成后，凭据由 macOS Keychain 管理。GOV-004 起，用户已授予本项目持续推送权限，验证通过的提交必须立即推送。建议在 Gitea 中保护 `main`：禁止强推、要求状态检查通过、要求变更说明关联功能编号。

-## 4. 版本与标签
+## 4. 提交后强制推送
+
+普通提交只推送当前分支：
+
+```bash
+git push origin "$(git branch --show-current)"
+```
+
+本次创建版本标签时，在分支推送成功后精确推送该标签：
+
+```bash
+git push origin <本次标签名>
+```
+
+不得使用 `git push --tags` 替代精确标签推送，避免发布其他未确认标签。不得使用 `--force` 或 `--force-with-lease`。
+
+分支推送后核对远程 SHA：
+
+```bash
+current_branch="$(git branch --show-current)"
+git rev-parse "$current_branch"
+git ls-remote origin "refs/heads/$current_branch"
+```
+
+两条结果必须指向相同提交。带注释标签核对时，应比较标签最终指向的提交，而不是标签对象本身。
+
+如果认证、网络、分支保护或非快进检查导致推送失败：
+
+1. 保留本地提交和标签，不删除、不 amend、不重写历史。
+2. 记录失败命令、时间和不包含凭据的错误摘要，将任务标记为未完成。
+3. 先获取并审查远程差异；禁止自动 merge、rebase、强推或覆盖未知提交。
+4. 解决原因后重试同一个精确推送命令，并重新核对远程引用。
+
+提交 SHA、远程分支、推送结果和本次标签结果必须写入对应功能档案。
+
+## 5. 配置检查与移除
+
+检查当前项目和全局配置的边界：
+
+```bash
+git remote -v
+git config --local --get credential.helper
+git config --local --get credential.useHttpPath
+git config --global --get-all credential.helper
+git config --global --get remote.pushDefault
+```
+
+如需解除本项目 Gitea 接入，执行：
+
+```bash
+git remote remove origin
+git config --local --unset credential.helper
+git config --local --unset credential.useHttpPath
+git config --local --unset credential.username
+git config --local --unset remote.pushDefault
+```
+
+上述操作只影响本项目。Keychain 中已保存的凭据需要在“钥匙串访问”中按 `git.foximao.com` 单独删除。
+
+## 6. 版本与标签

 发布使用带注释标签，例如：

@@ -38,3 +124,5 @@ git tag -a v0.1.0 -m "发布市场综合概览 v0.1.0"
 ```

 标签必须指向通过验证的提交。应用回退优先选择既有标签和不可变构建产物，而不是重新拼装旧版本。
+
+本规范的强制推送规则由 GOV-004 建立，并取代 GOV-003 中“只接入、不主动推送”的历史规则；GOV-003 原文保留用于审计当时决策。
@@ -26,5 +26,7 @@
 - [GOV-001：工程治理基线](features/GOV-001-engineering-governance/manifest.yaml)
 - [FEAT-MO-001：市场综合概览](features/FEAT-MO-001-market-overview/manifest.yaml)
 - [GOV-002：PRD 与 Review 门禁](features/GOV-002-prd-review-gates/manifest.yaml)
+- [GOV-003：项目专用 Gitea 远程仓库](features/GOV-003-gitea-local-remote/manifest.yaml)
+- [GOV-004：提交后强制推送 Gitea](features/GOV-004-mandatory-gitea-push/manifest.yaml)

 功能档案是需求、设计、代码、测试、版本和回退之间的唯一正式关联入口。
Author	SHA1	Message	Date
FoXiMao	d1e54dcdca	docs(GOV-004): 封存强制推送验证结果	2026-08-12 18:44:30 +08:00
FoXiMao	2a16e9f7d1	docs(GOV-004): 强制提交后同步 Gitea	2026-08-12 18:43:17 +08:00
FoXiMao	2d2502c9f6	docs(GOV-004): 制定强制推送实施计划	2026-08-12 18:38:46 +08:00
FoXiMao	757d8ab6a5	docs(GOV-004): 明确提交后强制推送设计	2026-08-12 18:36:23 +08:00
FoXiMao	4b390d9989	docs(GOV-003): 封存 Gitea 接入验证结果	2026-08-12 18:34:05 +08:00
FoXiMao	b69023e3f8	docs(GOV-003): 配置项目专用 Gitea 远程仓库	2026-08-12 18:33:09 +08:00
@@ -1 +1 @@
 .0.1
 .0.3