From 14a1efc86d0295be3a0d3fe1ebe7b8080266da2d Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Mon, 13 Jul 2026 16:23:44 +0800
Subject: [PATCH] docs: clean Aligner migration metadata
---
K2.项目管理/QA成果地图.md | 8 +-
K1.业务知识/设计成果地图.md | 4
.gitignore | 1
K1.业务知识/README.md | 13 ++++
C3.tools/README.md | 11 +++
K2.项目管理/新窗口接手指南.md | 37 ++++++------
C1.source/AGENTS.md | 30 +++++----
C1.source/CODEGRAPH.md | 14 ++--
K2.项目管理/研发交付验收流程.md | 8 +-
K3.运营与发布资料/README.md | 15 +++++
K2.项目管理/README.md | 14 ++++
11 files changed, 107 insertions(+), 48 deletions(-)
diff --git a/.gitignore b/.gitignore
index 3cd86d2..c6f8bcc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
.DS_Store
+._*
# SwiftPM
.build/
diff --git a/C1.source/AGENTS.md b/C1.source/AGENTS.md
index 52f9d10..f06c82c 100644
--- a/C1.source/AGENTS.md
+++ b/C1.source/AGENTS.md
@@ -1,11 +1,11 @@
# C1.source/AGENTS.md - 源码目录规则
-适用于 `/Users/ar/Projects/Aligner2/03-O/C1.source`。
+适用于 `/Users/ar/Projects/Aligner/03-O/C1.source`。
## 当前事实
- 本目录是 SwiftPM 源码根目录。
-- 本目录不是 Git 根目录；Git 命令在 `/Users/ar/Projects/Aligner2/03-O` 下执行。
+- 本目录不是 Git 根目录；Git 命令在 `/Users/ar/Projects/Aligner/03-O` 下执行。
- App 名：`Aligner`。
- Bundle ID：`com.ar.Aligner`。
- 最低 macOS：`14.0`。
@@ -14,13 +14,15 @@
## 读取顺序
-1. `/Users/ar/Projects/Aligner2/AGENTS.md`
-2. `/Users/ar/Projects/Aligner2/PROJECT.md`
-3. `/Users/ar/Projects/Aligner2/GLOSSARY.md`
-4. `/Users/ar/Projects/Aligner2/03-O/README.md`
-5. `/Users/ar/Projects/Aligner2/03-O/C1.source/CODEGRAPH.md`
-6. 当前任务相关的 Round / 架构文档
-7. UI 修改时读 `/Users/ar/Projects/Aligner2/DESIGN.md`
+1. `/Users/ar/Projects/Aligner/AGENTS.md`
+2. `/Users/ar/Projects/Aligner/PROJECT.md`
+3. `/Users/ar/Projects/Aligner/00-H/初心与Go-No-Go.md`
+4. `/Users/ar/Projects/Aligner/02-P/plan-progress.markdown`
+5. `/Users/ar/Projects/Aligner/GLOSSARY.md`
+6. `/Users/ar/Projects/Aligner/03-O/README.md`
+7. `/Users/ar/Projects/Aligner/03-O/C1.source/CODEGRAPH.md`
+8. 当前任务相关的 Round / 架构文档
+9. UI 修改时读 `/Users/ar/Projects/Aligner/DESIGN.md`
## 代码边界
@@ -42,19 +44,21 @@
## 验证
-从 `/Users/ar/Projects/Aligner2/03-O/C1.source` 执行：
+从 `/Users/ar/Projects/Aligner/03-O/C1.source` 执行：
```bash
-set -o pipefail; swift build 2>&1 | head -c 6000
-set -o pipefail; swift test 2>&1 | head -c 6000
+swift build
+swift test
```
打包时执行：
```bash
-set -o pipefail; /Users/ar/Projects/Aligner2/03-O/C3.tools/package-app.sh 2>&1 | head -c 6000
+/Users/ar/Projects/Aligner/03-O/C3.tools/package-app.sh
```
+如需限制终端输出，使用执行工具的输出上限或写入日志文件，不在标准验证命令后追加截断管道。
+
如果不能运行验证，说明具体原因和剩余风险。
## 修改规则
diff --git a/C1.source/CODEGRAPH.md b/C1.source/CODEGRAPH.md
index e84b87b..ef59f7f 100644
--- a/C1.source/CODEGRAPH.md
+++ b/C1.source/CODEGRAPH.md
@@ -6,7 +6,7 @@
这是 Aligner 自维护的轻量工程地图，用来减少后续任务的代码定位成本和上下文重建 token。它不是完整架构文档，也不是自动生成的调用图；它只记录稳定入口、影响面、QA 入口和已保护行为。
-Aligner2 同时维护两类代码地图：
+Aligner 同时维护两类代码地图：
- `codegraph`：人工维护的本文件，记录模块边界、关键入口、受保护行为、QA 入口和最后验证基线。
- `codebase-memory`：`codebase-memory-mcp` 生成的自动代码知识图谱，保存到 `../.codebase-memory/graph.db.zst`，用于查询调用链、影响面、死代码候选和架构概览。
@@ -27,12 +27,12 @@
- 最近本地验收候选包：`0.1.12 / 20260625.2320`
- 最后冻结前验证：2026-06-28，`swift build`、`swift test`、`round015-entitlement-fixture-qa.sh`、`round1-main-ui-qa.sh` 通过；主 UI QA 日志目录 `/tmp/aligner-round01-main-ui-qa-20260628_210821`。
- 发布事实：`0.1.12` 是本地 QA 候选代码冻结 / rollback baseline；不是正式官网 release，Developer ID、notarization、staple、Gatekeeper、macOS 14 Phase C、下载源和正式发布 manifest 仍未闭环。
-- Git 根目录：`/Users/ar/Projects/Aligner2/03-O`
-- SwiftPM 根目录：`/Users/ar/Projects/Aligner2/03-O/C1.source`
-- codebase-memory 共享产物：`/Users/ar/Projects/Aligner2/03-O/.codebase-memory/graph.db.zst`
-- codebase-memory 项目名：`Users-ar-Projects-Aligner2-03-O`
-- codebase-memory 索引范围：`C1.source`、`C3.tools`
-- codebase-memory 当前规模：`3988` nodes / `12382` edges
+- Git 根目录：`/Users/ar/Projects/Aligner/03-O`
+- SwiftPM 根目录：`/Users/ar/Projects/Aligner/03-O/C1.source`
+- codebase-memory 共享产物：`/Users/ar/Projects/Aligner/03-O/.codebase-memory/graph.db.zst`
+- codebase-memory 当前状态：stale；`03-O/.codebase-memory/artifact.json` 仍指向旧项目名 `Users-ar-Projects-Aligner2-03-O` 和 commit `1fea9bfc8a7639bb3573a7cf2a449ab55065ab9e`，不得作为当前代码事实源。
+- codebase-memory 预期索引范围：`C1.source`、`C3.tools`
+- codebase-memory 旧产物规模：`3988` nodes / `12382` edges
## 更新触发
diff --git a/C3.tools/README.md b/C3.tools/README.md
new file mode 100644
index 0000000..73ff986
--- /dev/null
+++ b/C3.tools/README.md
@@ -0,0 +1,11 @@
+# C3.tools
+
+本目录保存 Aligner 的构建、诊断、QA 和发布辅助脚本。
+
+## 规则
+
+- 工具脚本必须服务于当前源码和交付流程。
+- QA、打包、发布辅助脚本优先放这里，而不是散落在源码目录或构建产物目录。
+- 脚本新增或改名后，如影响工程入口，更新 `../C1.source/CODEGRAPH.md`。
+- 如脚本成为长期 QA / 发布门禁入口，同步更新 `../K2.项目管理/QA成果地图.md` 或相关交付流程文档。
+- 临时一次性脚本用完后记录结论，不沉淀为长期工具。
diff --git "a/K1.\344\270\232\345\212\241\347\237\245\350\257\206/README.md" "b/K1.\344\270\232\345\212\241\347\237\245\350\257\206/README.md"
new file mode 100644
index 0000000..ed99430
--- /dev/null
+++ "b/K1.\344\270\232\345\212\241\347\237\245\350\257\206/README.md"
@@ -0,0 +1,13 @@
+# K1.业务知识
+
+本目录保存长期有效的产品、领域和系统行为知识。
+
+适合放入这里的内容：
+
+- Aligner 长期产品决策。
+- 用户任务、领域规则、系统能力和限制。
+- 可复用的错误文案、验收口径和领域知识。
+- 长期有效的技术约束、状态模型和系统行为知识。
+- `成果地图.md` 中索引到的稳定成果和事实源。
+
+不放 Round 过程记录；过程记录留在 `02-P/`。
diff --git "a/K1.\344\270\232\345\212\241\347\237\245\350\257\206/\350\256\276\350\256\241\346\210\220\346\236\234\345\234\260\345\233\276.md" "b/K1.\344\270\232\345\212\241\347\237\245\350\257\206/\350\256\276\350\256\241\346\210\220\346\236\234\345\234\260\345\233\276.md"
index a01afa5..c4806af 100644
--- "a/K1.\344\270\232\345\212\241\347\237\245\350\257\206/\350\256\276\350\256\241\346\210\220\346\236\234\345\234\260\345\233\276.md"
+++ "b/K1.\344\270\232\345\212\241\347\237\245\350\257\206/\350\256\276\350\256\241\346\210\220\346\236\234\345\234\260\345\233\276.md"
@@ -1,4 +1,4 @@
-# Aligner2 设计成果地图
+# Aligner 设计成果地图
> 状态：迁移初稿
> Owner：设计总监
@@ -29,7 +29,7 @@
## 3. 关键设计证据
-建议随 Aligner2 保留或索引的关键证据：
+建议随 Aligner 保留或索引的关键证据：
- `02-P/Round01-QuickSwitch-MVP/02.ui设计稿/1.quick-switch-light-glass-v2-effect-20260527.png`
- `02-P/Round01-QuickSwitch-MVP/02.ui设计稿/2.quick-switch-dark-v3-effect-20260527.png`
diff --git "a/K2.\351\241\271\347\233\256\347\256\241\347\220\206/QA\346\210\220\346\236\234\345\234\260\345\233\276.md" "b/K2.\351\241\271\347\233\256\347\256\241\347\220\206/QA\346\210\220\346\236\234\345\234\260\345\233\276.md"
index 6f601e7..0c3ce87 100644
--- "a/K2.\351\241\271\347\233\256\347\256\241\347\220\206/QA\346\210\220\346\236\234\345\234\260\345\233\276.md"
+++ "b/K2.\351\241\271\347\233\256\347\256\241\347\220\206/QA\346\210\220\346\236\234\345\234\260\345\233\276.md"
@@ -1,4 +1,4 @@
-# Aligner2 QA 成果地图
+# Aligner QA 成果地图
> 状态：迁移初稿
> 用途：让新 QA / 新 Agent 快速知道有哪些门禁、脚本、证据和风险。
@@ -77,16 +77,16 @@
| `0.1.3 / 20260620.1337` | historical tagged candidate | 旧 Git HEAD / tag 基线 |
| `0.1.12 / 20260625.2320` | frozen local QA baseline | tag `v0.1.12-build20260625.2320`，本地 manifest `sourceStatus=clean`；不是正式官网 release |
-## 5. Aligner2 接收 QA 结果
+## 5. Aligner 接收 QA 结果
2026-06-28 已完成本地接收验证：
```bash
-cd /Users/ar/Projects/Aligner2/03-O/C1.source
+cd /Users/ar/Projects/Aligner/03-O/C1.source
swift build
swift test
-cd /Users/ar/Projects/Aligner2/03-O
+cd /Users/ar/Projects/Aligner/03-O
C3.tools/round015-entitlement-fixture-qa.sh
C3.tools/round1-main-ui-qa.sh
```
diff --git "a/K2.\351\241\271\347\233\256\347\256\241\347\220\206/README.md" "b/K2.\351\241\271\347\233\256\347\256\241\347\220\206/README.md"
new file mode 100644
index 0000000..02b4fd7
--- /dev/null
+++ "b/K2.\351\241\271\347\233\256\347\256\241\347\220\206/README.md"
@@ -0,0 +1,14 @@
+# K2.项目管理
+
+本目录保存长期有效的项目管理、协作、复盘和交付经验。
+
+适合放入这里的内容：
+
+- Aligner 项目级 SOP。
+- QA 门禁和验证地图。
+- 阶段复盘。
+- 交付验收经验。
+- 新 Agent / 新 session 接手指南。
+- 多角色协作规则的项目特例。
+
+不复制全局规则；全局规则只在本项目有特例时才补充说明。
diff --git "a/K2.\351\241\271\347\233\256\347\256\241\347\220\206/\346\226\260\347\252\227\345\217\243\346\216\245\346\211\213\346\214\207\345\215\227.md" "b/K2.\351\241\271\347\233\256\347\256\241\347\220\206/\346\226\260\347\252\227\345\217\243\346\216\245\346\211\213\346\214\207\345\215\227.md"
index 5b4be04..f8457d7 100644
--- "a/K2.\351\241\271\347\233\256\347\256\241\347\220\206/\346\226\260\347\252\227\345\217\243\346\216\245\346\211\213\346\214\207\345\215\227.md"
+++ "b/K2.\351\241\271\347\233\256\347\256\241\347\220\206/\346\226\260\347\252\227\345\217\243\346\216\245\346\211\213\346\214\207\345\215\227.md"
@@ -1,10 +1,10 @@
-# Aligner2 新窗口接手指南
+# Aligner 新窗口接手指南
-> 用途：验证 Aligner2 是否能让新电脑、新 session、新 Agent 不依赖旧长会话接上工作。
+> 用途：验证 Aligner 是否能让新电脑、新 session、新 Agent 不依赖旧长会话接上工作。
## 1. 接手目标
-接手者只读取 Aligner2 项目内文件，应该能回答：
+接手者只读取 Aligner 项目内文件，应该能回答：
- 项目是什么，当前产品重点是什么。
- 当前做到哪，哪些是已完成成果，哪些仍在进行。
@@ -17,15 +17,16 @@
根目录 `AGENTS.md` 是唯一入口；本指南不另设独立读取顺序。新窗口接手时按 `AGENTS.md` 的顺序执行：
1. `PROJECT.md`
-2. `02-P/plan-progress.markdown`
-3. `02-P/角色协作宪章.md`
-4. `03-O/K2.项目管理/新窗口接手指南.md`
-5. `GLOSSARY.md`
-6. `INDEX.md`
-7. 就近的 `AGENTS.md`
-8. `03-O/C1.source/CODEGRAPH.md`
-9. `DESIGN.md`
-10. 当前任务相关的 `02-P/` 下有效 Round / PRD / QA / 架构文档
+2. `00-H/初心与Go-No-Go.md`
+3. `02-P/plan-progress.markdown`
+4. `02-P/角色协作宪章.md`
+5. `03-O/K2.项目管理/新窗口接手指南.md`
+6. `GLOSSARY.md`
+7. `INDEX.md`
+8. 就近的 `AGENTS.md`
+9. `03-O/C1.source/CODEGRAPH.md`
+10. `DESIGN.md`
+11. 当前任务相关的 `02-P/` 下有效 Round / PRD / QA / 架构文档
不得从旧长会话、旧 `GTD.md` 或历史 Round TODO 直接领取活跃任务。
@@ -33,9 +34,9 @@
| 项 | 当前值 |
| --- | --- |
-| 工作区 | `/Users/ar/Projects/Aligner2` |
-| Git 根目录 | `/Users/ar/Projects/Aligner2/03-O` |
-| SwiftPM 根目录 | `/Users/ar/Projects/Aligner2/03-O/C1.source` |
+| 工作区 | `/Users/ar/Projects/Aligner` |
+| Git 根目录 | `/Users/ar/Projects/Aligner/03-O` |
+| SwiftPM 根目录 | `/Users/ar/Projects/Aligner/03-O/C1.source` |
| 当前产品重点 | Quick Switch / 快捷三栏 |
| 当前迁移基线 | 旧 Aligner dirty 工作树已冻结为本地 QA 候选 rollback baseline |
| 最新本地候选 | `0.1.12 / 20260625.2320` |
@@ -61,12 +62,12 @@
## 5. 接手自检命令
```bash
-cd /Users/ar/Projects/Aligner2/03-O
+cd /Users/ar/Projects/Aligner/03-O
git status --short --branch
git diff --check
codebase-memory-mcp cli list_projects '{}'
-cd /Users/ar/Projects/Aligner2/03-O/C1.source
+cd /Users/ar/Projects/Aligner/03-O/C1.source
swift build
swift test
```
@@ -97,7 +98,7 @@
已验证：
-- 能说明 Aligner2 的迁移目的、当前产品重点、Git / SwiftPM 根目录。
+- 能说明 Aligner 的迁移目的、当前产品重点、Git / SwiftPM 根目录。
- 能识别 `plan-progress.markdown` 是唯一活跃任务入口。
- 能说明角色边界和不可踩踏规则。
- 能定位 `CODEGRAPH.md`、`codebase-memory`、QA 成果地图和接收验证记录。
diff --git "a/K2.\351\241\271\347\233\256\347\256\241\347\220\206/\347\240\224\345\217\221\344\272\244\344\273\230\351\252\214\346\224\266\346\265\201\347\250\213.md" "b/K2.\351\241\271\347\233\256\347\256\241\347\220\206/\347\240\224\345\217\221\344\272\244\344\273\230\351\252\214\346\224\266\346\265\201\347\250\213.md"
index e1714ea..dd28df2 100644
--- "a/K2.\351\241\271\347\233\256\347\256\241\347\220\206/\347\240\224\345\217\221\344\272\244\344\273\230\351\252\214\346\224\266\346\265\201\347\250\213.md"
+++ "b/K2.\351\241\271\347\233\256\347\256\241\347\220\206/\347\240\224\345\217\221\344\272\244\344\273\230\351\252\214\346\224\266\346\265\201\347\250\213.md"
@@ -2,8 +2,8 @@
> 状态：当前有效
> 建立日期：2026-05-30
-> 适用范围：Aligner2 每个涉及代码实现、脚本实现、构建产物或用户可见行为变更的开发事项。
-> 任务记录入口：`/Users/ar/Projects/Aligner2/02-P/plan-progress.markdown`
+> 适用范围：Aligner 每个涉及代码实现、脚本实现、构建产物或用户可见行为变更的开发事项。
+> 任务记录入口：`/Users/ar/Projects/Aligner/02-P/plan-progress.markdown`
## 流程定义
@@ -61,8 +61,8 @@
## 当前配套依据
-- `/Users/ar/Projects/Aligner2/02-P/plan-progress.markdown`：统一活跃任务、状态、阻塞和验收证据入口。
-- `/Users/ar/Projects/Aligner2/02-P/AGENTS.md`：过程文档规则，要求测试计划和验收记录写入当前 Round 的 QA 区域，长期流程经验沉淀到 `03-O/K2.项目管理/`。
+- `/Users/ar/Projects/Aligner/02-P/plan-progress.markdown`：统一活跃任务、状态、阻塞和验收证据入口。
+- `/Users/ar/Projects/Aligner/02-P/AGENTS.md`：过程文档规则，要求测试计划和验收记录写入当前 Round 的 QA 区域，长期流程经验沉淀到 `03-O/K2.项目管理/`。
- `/Users/ar/.codex/rules/qa-workflow.md`：QA 通用规则，要求覆盖真实用户节奏、窗口层级、过渡过程和可复核证据。
- 当前 Round 的 PRD / QA / 架构文档：定义本轮范围、验收口径和具体测试矩阵。
diff --git "a/K3.\350\277\220\350\220\245\344\270\216\345\217\221\345\270\203\350\265\204\346\226\231/README.md" "b/K3.\350\277\220\350\220\245\344\270\216\345\217\221\345\270\203\350\265\204\346\226\231/README.md"
new file mode 100644
index 0000000..f465c80
--- /dev/null
+++ "b/K3.\350\277\220\350\220\245\344\270\216\345\217\221\345\270\203\350\265\204\346\226\231/README.md"
@@ -0,0 +1,15 @@
+# K3.运营与发布资料
+
+本目录保存 Aligner 的官网、商店、营销、支持和法务资料。
+
+## 子目录
+
+- `Website/`：官网页面、素材、站点脚本
+- `AppStoreConnect/`：渠道元数据、审核说明、商店材料
+- `Marketing/`：营销图、演示图、传播素材
+- `Support-Legal/`：支持、隐私、协议、法务资料
+
+## 规则
+
+- 运营与发布资料不与源码、过程文档混放。
+- 渠道资料和法务资料只有进入稳定使用后，才在此长期维护。
--
Gitblit v1.9.3