| | |
|---|
| | | ## 项目属性 |
|---|
| | | # PrivateVoice-MAS 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-MAS` 的 Git 根，当前分支为 `mas`。 |
|---|
| | | - 当前源码根：`C1.source/`；代码地图：`C1.source/CODEGRAPH.md`。 |
|---|
| | | - 进入源码前先读取项目根 `AGENTS.md`、`PROJECT.md`、`02-P/进度地图.md` 和本目录代码地图。 |
|---|
| | | - `C2.builds/` 放本地构建和发布候选，`K2.项目管理/` 放证据与门禁，`K3.运营与发布资料/` 放 MAS 渠道资料。 |
|---|
| | | - 不从 `independent-developer` 项目复制代码、提交或任务；不在本目录保存凭据。 |
|---|
