From abb469859662c285fac758c042812e0da943728f Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Thu, 02 Jul 2026 12:02:51 +0800
Subject: [PATCH] Create slim PrivateVoice2 handoff package

---
 AGENTS.md |   38 +++++++++++++++++++++-----------------
 1 files changed, 21 insertions(+), 17 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 8173aca..54d697b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,28 +1,32 @@
 ## 项目属性
 
 项目类型：研发项目
-主要产物：Wails / Go 桌面语音输入 App
+主要产物：Wails v3 / Go 桌面语音输入 App
 
-## 1. 命令输出保护
+## 读取顺序
 
-保护上下文用量。
+如果当前工作目录在 `03-O` 内，先回到项目根入口读取：
 
-任何输出量未知或可能很大的命令，都必须限制输出字节数。
+1. `/Users/ar/Projects/PrivateVoice2/AGENTS.md`
+2. `/Users/ar/Projects/PrivateVoice2/PROJECT.md`
+3. `/Users/ar/Projects/PrivateVoice2/INDEX.md`
+4. `/Users/ar/Projects/PrivateVoice2/02-P/进度地图.md`
+5. `/Users/ar/Projects/PrivateVoice2/03-O/CODEGRAPH.md`
 
-默认安全写法：
+旧 `K2.项目管理/legacy/` 资料只作证据附件，不能作为活跃任务来源。
 
-```bash
-COMMAND 2>&1 | head -c 6000
-```
+## 路径边界
 
-## 2. 发布版本规则
+- 项目根：`/Users/ar/Projects/PrivateVoice2`
+- Git 根：`/Users/ar/Projects/PrivateVoice2/03-O`
+- 源码根：`/Users/ar/Projects/PrivateVoice2/03-O/C1.source/privatevoice.src`
+- 构建/发布候选包：`/Users/ar/Projects/PrivateVoice2/03-O/C2.builds`
+- 构建与 QA 脚本：源码内 `C1.source/privatevoice.src/scripts/`，`C3.tools/` 只放索引和迁移工具说明。
+- 会话记忆目录：`/Users/ar/Projects/PrivateVoice2/.codex-sessionhistory/`
 
-本项目声明为 `研发项目`，发布或分发安装包前默认遵守 `~/.codex/rules/release-versioning.md`；如本项目 release 文档或构建脚本另有更具体要求，以本项目规则为准。
+## 工作规则
 
-## 3. 测试通过后的默认打包规则
-
-当某一轮改动已经完成开发自测，并且 QA 验证也通过后，默认进入测试包交付流程，不需要再单独询问用户是否打包。
-
-执行打包前仍必须遵守发布版本规则：递增 patch 版本号、生成新的 `YYYYMMDD.HHMM` build 编号、更新 App 元数据与 `CHANGELOG.md`，并生成可分发的 macOS `.dmg`。
-
-如果只有开发自测通过，但 QA 尚未验证通过，则不得把该版本作为测试人员可用包交付；此时只说明当前处于待 QA 状态。
+- 统一活跃台账是 `/Users/ar/Projects/PrivateVoice2/02-P/进度地图.md`。
+- `CODEGRAPH.md` 是人工维护工程地图；自动索引或缓存不能替代它。
+- 发布、QA、签名、打包和版本冻结必须遵守项目根入口声明的全局规则路由。
+- 标准验证命令必须保持原始可执行形式，不在命令本身追加输出截断管道。

--
Gitblit v1.9.3