Ariver
2026-07-13 2d1d4ad406228ef62ab078724cb7d1556e003d01
AGENTS.md
@@ -1,28 +1,7 @@
## 项目属性
# PrivateVoice-independent-developer 03-O 局部规则
项目类型:研发项目
主要产物:Wails / Go 桌面语音输入 App
## 1. 命令输出保护
保护上下文用量。
任何输出量未知或可能很大的命令,都必须限制输出字节数。
默认安全写法:
```bash
COMMAND 2>&1 | head -c 6000
```
## 2. 发布版本规则
本项目声明为 `研发项目`,发布或分发安装包前默认遵守 `~/.codex/rules/release-versioning.md`;如本项目 release 文档或构建脚本另有更具体要求,以本项目规则为准。
## 3. 测试通过后的默认打包规则
当某一轮改动已经完成开发自测,并且 QA 验证也通过后,默认进入测试包交付流程,不需要再单独询问用户是否打包。
执行打包前仍必须遵守发布版本规则:递增 patch 版本号、生成新的 `YYYYMMDD.HHMM` build 编号、更新 App 元数据与 `CHANGELOG.md`,并生成可分发的 macOS `.dmg`。
如果只有开发自测通过,但 QA 尚未验证通过,则不得把该版本作为测试人员可用包交付;此时只说明当前处于待 QA 状态。
- 本目录是 `/Users/ar/Projects/PrivateVoice` 的 Git 根,当前分支为 `independent-developer`。
- 当前源码根:`C1.source/`;代码地图:`CODEGRAPH.md`。
- 进入源码前先读取项目根 `AGENTS.md`、`PROJECT.md`、`02-P/进度地图.md` 和本目录代码地图。
- `C2.builds/` 放本地构建和发布候选,`K2.项目管理/` 放证据与门禁,`K3.运营与发布资料/` 放独立分发资料。
- 不从 `mas` 项目复制代码、提交或任务;不在本目录保存凭据。