# 2026-07-01 Git 噪声清理

## 用户目标

用户不希望后续每轮都被反复提醒“无关脏文件”和“旧 Release 删除状态”，希望本轮查清这些文件是什么，并从 Git 管理或状态输出中收敛掉。

## 当前起点

- 分支：`codex/x-asr-experiment-2.1.29`
- 起点状态包含：
  - 5 个已修改文档 / 规则文件。
  - 33 个 tracked `Release/` 文件删除状态。
  - 大量未跟踪的 `.worktrees/`、`.codex/`、`Release/`、`X-运营资料/`、`privatevoice.src/build/*` 产物。

## 已完成事项

- 将本地 worktree、Codex 临时目录、Release 产物、构建缓存、QA 输出和运营素材加入 `.gitignore`。
- 使用 `git rm -r --cached Release` 将旧 `Release/` 目录从 Git 索引移除，但保留磁盘文件。
- 将之前真实存在的项目文档 / 规则更新作为单独 commit 固定。
- 最终 `git status --short --untracked-files=normal` 无输出。

## 核心事实 / 变更快照

- 新增 commit：`ddbd0b7` `Stop tracking local release artifacts`
  - `.gitignore` 新增忽略：
    - `/.codex/`
    - `/.worktrees/`
    - `/Release/`
    - `/X-运营资料/`
    - `privatevoice.src/build/deps/`
    - `privatevoice.src/build/local-build-logs/`
    - `privatevoice.src/build/macappstore*/`
    - `privatevoice.src/build/qa/`
    - `privatevoice.src/build/windows-preview/`
    - `privatevoice.src/build/*.log`
  - 从 Git 索引移除 62 个历史 Release 元数据 / 日志文件。
- 新增 commit：`b00e64d` `Record project documentation updates`
  - 固定 `AGENTS.md` 出口合规 / 会话保存规则。
  - 固定 README 语言模型说明。
  - 固定 X-ASR 真实实时上屏报告。
  - 固定 App Store 审核拒绝与打包返工复盘文档。

## 验证结论

执行并通过：

```bash
git status --short --untracked-files=normal
git check-ignore -v Release/01-证书/证书.p12 .worktrees/windows-preview-2.1.38 privatevoice.src/build/windows-preview/PrivateVoice-Dictation-2.1.38-build20260629.2014-windows-amd64-preview.zip 'X-运营资料' .codex/session-history/2026-06-09-重读规则.md privatevoice.src/build/deps/onnxruntime-official/onnxruntime-osx-arm64-1.23.2.tgz
```

结果：

- `git status --short --untracked-files=normal` 无输出。
- `git check-ignore -v` 确认 release 证书、worktree、Windows zip、运营资料、`.codex` 和 build deps 均被 `.gitignore` 命中。

## 未决问题

- 本轮没有删除磁盘上的 `Release/`、`.worktrees/`、`X-运营资料/` 或构建产物；只是让它们不再污染源码 Git 状态。
- 如果未来希望释放磁盘空间，需要另开清理任务，逐个确认哪些目录可以归档或删除。

## 后续建议

- 后续发布包、证书、QA 截图和构建缓存默认留在本地，不进入源码 Git。
- 如果某个 release manifest 需要长期留档，应保存到 `.codex-sessionhistory/` 或专门的发布复盘文档，而不是放回 `Release/` 跟踪。