将 PR #610 rebase 到 upstream 最新 main(解决与 #611 的冲突)

.github/workflows/release.yml

@@ -131,7 +131,7 @@ jobs:
         shell: bash
         run: python3 scripts/check_release_version.py "${{ steps.ver.outputs.version }}"
 
-      # MOC-66 发版门禁: release-notes/v<version>.md 必须已 commit 进仓库,
+      # MOC-66 发版门禁: documents/release-notes/v<version>.md 必须已 commit 进仓库,
       # 防止 notes 只注入 GitHub release body 而仓库缺文件 (MOC-65 回填 16 个
       # + v2.2.0-v2.3.1 复发 4 个的根因)。push tag 触发时 checkout 的是 tag
       # commit,等于强制 notes 在打 tag 前就进仓库。
@@ -393,7 +393,7 @@ jobs:
         shell: bash
         run: python3 scripts/check_release_version.py "${{ steps.ver.outputs.version }}"
 
-      # MOC-66 发版门禁: release-notes/v<version>.md 必须已 commit 进仓库,
+      # MOC-66 发版门禁: documents/release-notes/v<version>.md 必须已 commit 进仓库,
       # 防止 notes 只注入 GitHub release body 而仓库缺文件 (MOC-65 回填 16 个
       # + v2.2.0-v2.3.1 复发 4 个的根因)。push tag 触发时 checkout 的是 tag
       # commit,等于强制 notes 在打 tag 前就进仓库。

.gitignore

@@ -59,15 +59,10 @@ Codex-App-Transfer-Setup-*.exe
 # Claude Code harness state
 .claude/
 
-# Generated macOS icon assets (rebuilt by macos/prepare-icon.py)
-macos/assets/app-icon.icns
-macos/assets/app-icon.iconset/
-macos/assets/app-icon-prepared.png
-
 # === Local-only docs ===
 # 整个 docs/ 不入仓库(2026-05-24 决定 — Linear 跟踪 followup,GitHub release notes
-# 替代 docs/release-notes/,根目录 README + CHANGELOG + ACKNOWLEDGEMENTS + AGENTS +
-# ONBOARDING + ARCHITECTURE_PROTOCOL_GUIDE 6 文件足够公开文档)。
+# 替代 docs/release-notes/,公开文档 = 根目录 README* +
+# documents/ 下 CHANGELOG / ACKNOWLEDGEMENTS / ONBOARDING / ARCHITECTURE_PROTOCOL_GUIDE)。
 # 维护者本地可在 docs/ 放任意调研 / 历史归档 / 上游 reference / agent review 报告 /
 # wire dumps / 反馈分析 — 都不会进 remote。
 docs/
@@ -102,9 +97,15 @@ src-tauri/icons/android/
 src-tauri/icons/ios/
 
 # Codex Desktop theme 本地素材(用户私人壁纸 / 版权资源, 不入仓)
-img/codex-theme/
+documents/img/codex-theme/
 
 # Code graph: generated site output + local preview/test artifacts
 _site/
 .playwright-mcp/
 rate_drift_report.md
+
+# Codex CLI 项目级本机配置(含本机绝对路径, 不入仓)
+.codex/
+
+# Codex CLI agent 工作规范(维护者本地文件, 不入仓)
+/AGENTS.md