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