| | |
|---|
| | | # C1.source/AGENTS.md - 源码目录规则 |
|---|
| | | |
|---|
| | | 适用于 `/Users/ar/Projects/Aligner/03-O/C1.source`。 |
|---|
| | | 适用于 `/Users/ar/Projects/Aligner2/03-O/C1.source`。 |
|---|
| | | |
|---|
| | | ## 当前事实 |
|---|
| | | |
|---|
| | | - 本目录是 SwiftPM 源码根目录。 |
|---|
| | | - 本目录不是 Git 根目录；Git 命令在 `/Users/ar/Projects/Aligner/03-O` 下执行。 |
|---|
| | | - 本目录不是 Git 根目录；Git 命令在 `/Users/ar/Projects/Aligner2/03-O` 下执行。 |
|---|
| | | - App 名：`Aligner`。 |
|---|
| | | - Bundle ID：`com.ar.Aligner`。 |
|---|
| | | - 最低 macOS：`26.0`。 |
|---|
| | | - 最低 macOS：`14.0`。 |
|---|
| | | - 当前产品入口：只有 `quickSwitch`。 |
|---|
| | | - 默认 Quick Switch 快捷键：`Option+Tab`。 |
|---|
| | | |
|---|
| | | ## 读取顺序 |
|---|
| | | |
|---|
| | | 1. `/Users/ar/Projects/Aligner/AGENTS.md` |
|---|
| | | 2. `/Users/ar/Projects/Aligner/PROJECT.md` |
|---|
| | | 3. `/Users/ar/Projects/Aligner/GLOSSARY.md` |
|---|
| | | 4. `/Users/ar/Projects/Aligner/03-O/README.md` |
|---|
| | | 5. 当前任务相关的 Round / 架构文档 |
|---|
| | | 6. UI 修改时读 `/Users/ar/Projects/Aligner/DESIGN.md` |
|---|
| | | 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` |
|---|
| | | |
|---|
| | | ## 代码边界 |
|---|
| | | |
|---|
| | |
|---|
| | | - 过滤幽灵窗口和非任务系统浮层。 |
|---|
| | | - 全屏 App 窗口必须可发现。 |
|---|
| | | - 永远不要吞掉或阻挡 `Command+Option+Esc` Force Quit。 |
|---|
| | | - 非平凡 Quick Switch 改动前，先读 `CODEGRAPH.md` 中对应 node，再读 node 指向的源码和 QA。 |
|---|
| | | - 用户要求“冻结版本”时，必须在打 tag 前更新并校验 `CODEGRAPH.md`。 |
|---|
| | | |
|---|
| | | ## 验证 |
|---|
| | | |
|---|
| | | 从 `/Users/ar/Projects/Aligner/03-O/C1.source` 执行： |
|---|
| | | 从 `/Users/ar/Projects/Aligner2/03-O/C1.source` 执行： |
|---|
| | | |
|---|
| | | ```bash |
|---|
| | | swift build 2>&1 | head -c 6000 |
|---|
| | | swift test 2>&1 | head -c 6000 |
|---|
| | | set -o pipefail; swift build 2>&1 | head -c 6000 |
|---|
| | | set -o pipefail; swift test 2>&1 | head -c 6000 |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | 打包时执行： |
|---|
| | | |
|---|
| | | ```bash |
|---|
| | | /Users/ar/Projects/Aligner/03-O/C3.tools/package-app.sh 2>&1 | head -c 6000 |
|---|
| | | set -o pipefail; /Users/ar/Projects/Aligner2/03-O/C3.tools/package-app.sh 2>&1 | head -c 6000 |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | 如果不能运行验证，说明具体原因和剩余风险。 |
|---|
