Ariver
2026-07-12 3797b4105ecd1f5af071a337dd67718cd3776c0d
chore(independent-developer): initialize split project metadata
4 files modified
7 files added
429 ■■■■ changed files
AGENTS.md 40 ●●●● patch | view | raw | blame | history
C1.source/AGENTS.md 24 ●●●●● patch | view | raw | blame | history
C1.source/CODEGRAPH.md 49 ●●●●● patch | view | raw | blame | history
CODEGRAPH.md 115 ●●●● patch | view | raw | blame | history
K1.业务知识/README.md 13 ●●●●● patch | view | raw | blame | history
K2.项目管理/QA地图.md 54 ●●●● patch | view | raw | blame | history
K2.项目管理/QA成果地图.md 23 ●●●●● patch | view | raw | blame | history
K2.项目管理/README.md 14 ●●●●● patch | view | raw | blame | history
K2.项目管理/新窗口接手指南.md 59 ●●●● patch | view | raw | blame | history
K2.项目管理/研发交付验收流程.md 23 ●●●●● patch | view | raw | blame | history
K2.项目管理/项目经理-经验与教训.md 15 ●●●●● patch | view | raw | blame | history
AGENTS.md
@@ -1,35 +1,7 @@
## 项目属性
# PrivateVoice-independent-developer 03-O 局部规则
项目类型:研发项目
主要产物:Wails v3 / Go 桌面语音输入 App
## 读取顺序
如果当前工作目录在 `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/` 资料只作证据附件,不能作为活跃任务来源。
## 路径边界
- 项目根:`/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/` 只保存旧项目迁移压缩摘要,不得作为新项目常规主题汇编落点。
## 工作规则
- 统一活跃台账是 `/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、签名、打包和版本冻结必须遵守项目根入口声明的全局规则路由。
- 标准验证命令必须保持原始可执行形式,不在命令本身追加输出截断管道。
- 本目录是 `/Users/ar/Projects/PrivateVoice-independent-developer` 的 Git 根,当前分支为 `independent-developer`。
- 当前源码根:`C1.source/`;代码地图:`CODEGRAPH.md`。
- 进入源码前先读取项目根 `AGENTS.md`、`PROJECT.md`、`02-P/进度地图.md` 和本目录代码地图。
- `C2.builds/` 放本地构建和发布候选,`K2.项目管理/` 放证据与门禁,`K3.运营与发布资料/` 放独立分发资料。
- 不从 `mas` 项目复制代码、提交或任务;不在本目录保存凭据。
C1.source/AGENTS.md
New file
@@ -0,0 +1,24 @@
# AGENTS.md - PrivateVoice-independent-developer 源码区规则
本目录是 PrivateVoice-independent-developer 当前旧基线的源码根目录。
## 必读
涉及源码、测试、构建、模块边界或非平凡实现时,先读:
1. `/Users/ar/Projects/PrivateVoice-independent-developer/AGENTS.md`
2. `/Users/ar/Projects/PrivateVoice-independent-developer/PROJECT.md`
3. `/Users/ar/Projects/PrivateVoice-independent-developer/03-O/README.md`
4. `/Users/ar/Projects/PrivateVoice-independent-developer/03-O/CODEGRAPH.md`
5. 当前 Round 的产品定义、技术方案和验收文档
6. 涉及 UI 时读 `/Users/ar/Projects/PrivateVoice-independent-developer/DESIGN.md`
## 代码规则
- 只实现当前任务直接需要的代码。
- 复用系统能力和现有模块,不为一次性需求创建抽象层。
- 不把输入资料中的功能直接当成已确认需求。
- Git 命令默认在 `/Users/ar/Projects/PrivateVoice-independent-developer/03-O` 执行,而不是本目录。
- 新增或移动源码后,同步更新上级 `../CODEGRAPH.md`。
- 构建、测试、QA 脚本优先放到 `../C3.tools/`,除非工程工具链要求必须随源码放置。
- 自动图谱结果只能辅助定位,不能替代对真实源码、测试和 QA 证据的回读。
C1.source/CODEGRAPH.md
New file
@@ -0,0 +1,49 @@
# PrivateVoice-independent-developer CODEGRAPH
最后整理:2026-07-11
## 用途
这是 PrivateVoice-independent-developer 的人工工程地图,用于减少后续代码定位成本和上下文重建成本。它记录稳定入口、模块边界、QA 入口、受保护行为和最后验证基线,不替代真实源码、测试或 QA。
当前尚未建立真实源码工程。本文件先作为工程地图入口,后续源码出现后必须持续维护。
## 计划源码根
`/Users/ar/Projects/PrivateVoice-independent-developer/03-O/C1.source`
## 与参考代码库的边界
- `/Users/ar/Projects/PrivateVoice-independent-developer/01-I/p.refNN.<name>/` 可保存开源项目、外部代码库和关键代码逻辑,供后续参考、对齐和分析。
- 参考代码库不是当前项目源码,不能直接登记为本文件的模块事实。
- 只有经过 `02-P/` 当前 Round 分析并被采纳的技术结论,才回写到本文件。
## 使用规则
- 非平凡实现前,先读本文件,再读本文件指向的源码和 QA 入口。
- 用户可见行为、状态模型、模块边界、构建入口或 QA 入口稳定变化后,更新本文件。
- 如后续启用 `03-O/.codebase-memory/`,其结果只能辅助定位,不替代人工工程地图。
## 计划模块
| 模块 | 责任 | 计划位置 | 状态 |
| --- | --- | --- | --- |
| AppShell | App 生命周期、入口、菜单或窗口管理 | 待定 | 未创建 |
| CoreDomain | 核心业务能力和用户任务模型 | 待定 | 未创建 |
| SystemIntegration | 系统能力、权限、快捷键或自动化集成 | 待定 | 未创建 |
| UI | 窗口、菜单栏、设置页或交互界面 | 待定 | 未创建 |
| Persistence | 偏好设置、状态、用户配置持久化 | 待定 | 未创建 |
| DiagnosticsAndQA | 诊断信息、QA 辅助入口 | 待定 | 未创建 |
## 当前事实来源
- `/Users/ar/Projects/PrivateVoice-independent-developer/PROJECT.md`
- `/Users/ar/Projects/PrivateVoice-independent-developer/02-P/进度地图.md`
- `/Users/ar/Projects/PrivateVoice-independent-developer/02-P/Round00-Foundation/00-任务入口.md`
- `/Users/ar/Projects/PrivateVoice-independent-developer/01-I/`
## 后续维护要求
- 新增源码目录、关键文件、测试入口、构建入口后,必须补进本文件。
- 删除或重命名模块前,先更新影响面判断。
- 任何非平凡实现前,先用本文件定位相关文件,再读真实源码。
CODEGRAPH.md
@@ -1,99 +1,34 @@
# CODEGRAPH
# PrivateVoice-independent-developer CODEGRAPH
## Project
最后整理:2026-07-11
- Product: Wails v3 / Go desktop dictation app.
- Git root: `/Users/ar/Projects/PrivateVoice/03-O`.
- Source root: `/Users/ar/Projects/PrivateVoice/03-O/C1.source/privatevoice.src`.
- Current branch purpose: R221 recovery freeze for `2.2.2 build20260703.0335`, restoring reviewed `2.2.1` fixes into the current active source and producing four real-user test candidate packages.
- Protected behavior: existing macOS App Store, local DMG, Monterey compatibility, Windows preview, model download safety, and paste/clipboard protection must not be changed without a scoped task and QA plan.
## 工程范围
## Automatic Codebase Memory
- 项目根:`/Users/ar/Projects/PrivateVoice-independent-developer`
- Git 根:`/Users/ar/Projects/PrivateVoice-independent-developer/03-O`
- 分支:`independent-developer`
- 源码冻结基线:`a075aec123e1f7118f138738f196c2995aa96f98`;项目初始化元数据提交见 `git log`。
- 基线标签:`v2.2.2-build20260703.0335-real-user-test`
- 源码根:`/Users/ar/Projects/PrivateVoice-independent-developer/03-O/C1.source/privatevoice.src`
- 自动图谱:`/Users/ar/Projects/PrivateVoice-independent-developer/03-O/.codebase-memory/`;只辅助定位。
- Status: `enabled`.
- Tool: `codebase-memory-mcp` 0.8.1.
- Current project name after path unification: `Users-ar-Projects-PrivateVoice-03-O`.
- Current artifact note: `.codebase-memory/artifact.json` must record project `Users-ar-Projects-PrivateVoice-03-O` before each freeze / release package.
- Shared artifact: `.codebase-memory/graph.db.zst`; metadata: `.codebase-memory/artifact.json`.
- Scope: `/Users/ar/Projects/PrivateVoice/03-O`.
- Refresh command: `codebase-memory-mcp cli index_repository '{"repo_path":"/Users/ar/Projects/PrivateVoice/03-O"}'`.
- Current `indexed_at`, commit, node count, and edge count are recorded in `.codebase-memory/artifact.json`.
- Excluded by indexer: `.git`, `K3.运营与发布资料/legacy-运营资料/PrivateVoice-26.0604上架`, `K3.运营与发布资料/legacy-运营资料/运营文档`, `C1.source/privatevoice-2.2.1-recovered.src`, `C1.source/privatevoice.src/frontend/dist`, `C1.source/privatevoice.src/frontend/node_modules`.
- Query example after regenerating graph from Git root: `codebase-memory-mcp cli search_graph '{"project":"Users-ar-Projects-PrivateVoice-03-O","query":"model registry","limit":5}'`.
- This automatic graph is an exploration aid only; it does not replace source reading, tests, QA evidence, or this `CODEGRAPH.md`.
- Refresh rule: regenerate `.codebase-memory/` before each source freeze, version freeze, formal rollback-capable test package, or release package; daily Coder work-in-progress changes do not force a refresh.
- Freeze record requirement: record the refresh command, `.codebase-memory/artifact.json` path, indexed commit, freeze commit, and whether the two commits match or differ only by `.codebase-memory/` artifact updates.
## 核心入口
## Core Entrypoints
- 启动与应用 wiring:`C1.source/privatevoice.src/main.go`、`app.go`。
- macOS 文字输出:`C1.source/privatevoice.src/internal/input/paste_darwin.go`。
- 音频:`C1.source/privatevoice.src/internal/audio/recorder.go`。
- macOS 热键:`C1.source/privatevoice.src/internal/hotkey/hotkey_darwin.go`。
- 本地 ASR:`C1.source/privatevoice.src/internal/engine/engine_darwin.go`。
- 本地 DMG:`C1.source/privatevoice.src/scripts/build-local-macos.sh`。
- Developer ID / notarization:`C1.source/privatevoice.src/scripts/build-release-macos.sh`。
- `C1.source/privatevoice.src/main.go`: process startup, data migration, logger, single-instance guard.
- `C1.source/privatevoice.src/app.go`: Wails app wiring, settings window, tray, recorder, hotkey loop, ASR init, paste orchestration.
- `C1.source/privatevoice.src/embed.go`: embeds frontend assets and app/tray icons.
## 当前基线保护
## Language And Model Registry
- 本项目当前只代表 2.2.2 / 20260703.0335 旧代码;不得把后续 MAS AX router、MAS sandbox 实验或 2.2.3 改造直接复制进来。
- 既有 macOS、Windows preview、模型下载安全、paste/clipboard 保护行为未经独立任务和 QA 计划不得改动。
- Developer ID 直接输入、签名、公证、安装、更新与回滚是后续独立任务,不得从历史文档直接宣称已完成。
- `C1.source/privatevoice.src/internal/model/profile.go`: model and language IDs, model profile shape, install status types.
- `C1.source/privatevoice.src/internal/model/registry.go`: language profile order, model profiles, language profiles, and normalization.
- `C1.source/privatevoice.src/internal/modelselection/selection.go`: resolves current language and model, including manual-model fallback.
- Round 6 Cantonese path:
  - Language ID: `yue-HK`, displayed as `粤语`.
  - Default model: `sensevoice-yue-2025-09-09`.
  - Backend: SenseVoice with `LanguageParam="yue"`.
  - The Cantonese language profile intentionally has no upgrade models, so Qwen3-ASR and X-ASR are not shown as Cantonese-specific options.
## 自动图谱与维护
## Platform Modules
- Audio: `C1.source/privatevoice.src/internal/audio/recorder.go`
- Hotkey:
  - macOS: `C1.source/privatevoice.src/internal/hotkey/hotkey_darwin.go`
  - Windows: `C1.source/privatevoice.src/internal/hotkey/hotkey_windows.go`
- Text input:
  - macOS: `C1.source/privatevoice.src/internal/input/paste_darwin.go`
  - Windows: `C1.source/privatevoice.src/internal/input/paste_windows.go`
- ASR engine:
  - macOS: `C1.source/privatevoice.src/internal/engine/engine_darwin.go`
  - Windows: `C1.source/privatevoice.src/internal/engine/engine_windows.go`
  - Linux: `C1.source/privatevoice.src/internal/engine/engine_linux.go`
- Overlay:
  - macOS: `C1.source/privatevoice.src/internal/overlay/overlay_darwin.go`
  - Windows: `C1.source/privatevoice.src/internal/overlay/overlay_windows.go`
## Windows Preview Scope
- Windows preview supports `SenseVoice` only.
- Non-SenseVoice models remain visible in settings but are disabled through `model.IsModelSupportedInCurrentBuild`.
- Windows unsupported reason: `windows_preview_unsupported`.
- Windows overlay remains native Win32/GDI+, with a larger translucent spectrum-style capsule indicator for recording states.
- Build script: `C1.source/privatevoice.src/scripts/build-windows-preview.sh`.
- Evidence verifier: `C1.source/privatevoice.src/scripts/verify-windows-qa-evidence.sh`.
## macOS Package Scope
- Local DMG script: `C1.source/privatevoice.src/scripts/build-local-macos.sh`.
- Universal DMG script: `C1.source/privatevoice.src/scripts/build-local-macos-universal.sh`.
- Monterey compatibility script: `C1.source/privatevoice.src/scripts/build-local-macos-monterey.sh`.
- Developer ID / notarization script: `C1.source/privatevoice.src/scripts/build-release-macos.sh`.
- Mainline macOS local packages keep `LSMinimumSystemVersion=14.0`.
- Monterey-compatible packages remain a separate build line.
## Standard Verification Commands
Run from `C1.source/privatevoice.src`:
```bash
npm --prefix frontend run build
go test ./...
GOOS=windows GOARCH=amd64 CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc CXX=x86_64-w64-mingw32-g++ go test -exec=/usr/bin/true ./...
./scripts/build-windows-preview.sh
./scripts/build-local-macos.sh arm64
./scripts/build-local-macos.sh x86_64
./scripts/build-local-macos-universal.sh
./scripts/verify-windows-qa-evidence.sh /path/to/qa-evidence-YYYYMMDD-HHMMSS.zip
```
## Known Gaps
- Windows runtime QA must still be performed on Windows 10/11 hardware before calling Windows stable.
- macOS 2.2.2 real-user test DMGs are locally signed and not notarized.
- Monterey compatibility was not revalidated for the 2.2.2 package set.
- Independent-site sales still need Developer ID release packaging, download page, authorization/activation, update strategy, support path, release manifest, and rollback policy.
- 生成命令:`codebase-memory-mcp cli index_repository '{"repo_path":"/Users/ar/Projects/PrivateVoice-independent-developer/03-O"}'`
- `CODEGRAPH.md` 是人工代码地图;每次源码冻结、版本冻结或发布候选前更新并记录 indexed commit。
K1.业务知识/README.md
New file
@@ -0,0 +1,13 @@
# K1.业务知识
本目录保存长期有效的产品、领域和系统行为知识。
适合放入这里的内容:
- PrivateVoice-independent-developer 长期产品决策。
- 用户任务、领域规则、系统能力和限制。
- 可复用的错误文案、验收口径和领域知识。
- 长期有效的技术约束、状态模型和系统行为知识。
- `成果地图.md` 中索引到的稳定成果和事实源。
不放 Round 过程记录;过程记录留在 `02-P/`。
K2.项目管理/QA地图.md
@@ -1,48 +1,14 @@
# QA 地图
# PrivateVoice-independent-developer QA 地图
## 当前 QA 结论
## 当前边界
迁移接收验证与产品 QA 结论必须区分。
- 当前代码仅是 `v2.2.2 / 20260703.0335` 旧基线,不代表 Developer ID 改造或公证已完成。
- 未来 QA 必须覆盖 Developer ID 签名、公证、安装、自动输入、剪贴板恢复、错误目标保护、更新与回滚。
- 本迁移没有重新运行构建、测试、签名、公证或真实设备 QA。
- 迁移接收验证:由 `接收验证记录.md` 记录。
- Round 6 产品 QA:已有会话和 release manifest 证明基础自动化/包校验通过。
- Windows 真机 QA:仍未由本迁移补跑。
- 官网正式发布 QA:仍未完成 notarization、下载页、授权/激活、更新和回滚链路验证。
## 责任入口
## 标准源码验证
从 `03-O/C1.source/privatevoice.src` 执行:
```bash
npm --prefix frontend run build
go test ./...
GOOS=windows GOARCH=amd64 CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc CXX=x86_64-w64-mingw32-g++ go test -exec=/usr/bin/true ./...
```
## 包验证
从 `03-O/C2.builds/PrivateVoice-Dictation-2.2.0-build20260702.0303` 执行:
```bash
shasum -a 256 -c SHA256SUMS.txt
hdiutil verify 'PrivateVoice-Dictation-2.2.0-build20260702.0303-macos-arm64.dmg'
hdiutil verify 'PrivateVoice-Dictation-2.2.0-build20260702.0303-macos-x86_64.dmg'
hdiutil verify 'PrivateVoice-Dictation-2.2.0-build20260702.0303-macos-universal.dmg'
unzip -t 'PrivateVoice-Dictation-2.2.0-build20260702.0303-windows-amd64-preview.zip'
```
## Windows QA 入口
在 Windows preview 包解压后运行:
```text
RUN-WINDOWS-QA.cmd
```
收回 evidence zip 后,在源码根执行:
```bash
./scripts/verify-windows-qa-evidence.sh /path/to/qa-evidence-YYYYMMDD-HHMMSS.zip
```
只有出现 `WINDOWS_QA_EVIDENCE_PASS`,才能声称 Windows preview evidence 通过。
- 当前活跃任务:`02-P/进度地图.md`。
- 代码地图:`03-O/CODEGRAPH.md`。
- 旧版 QA / 发布证据仅作为 `02-P/X-Archived/` 历史材料。
- 任何新 QA 必须形成证据并回报 independent-developer PMO,不得回写 MAS 台账。
K2.项目管理/QA成果地图.md
New file
@@ -0,0 +1,23 @@
# PrivateVoice-independent-developer QA 成果地图
最后整理:2026-07-11
## 当前状态
PrivateVoice-independent-developer 尚未建立真实源码工程,本文件先作为未来 QA 门禁和验证入口的总地图。
## 当前已建立入口
| 类型 | 路径 | 状态 |
| --- | --- | --- |
| 当前验收口径 | `02-P/Round00-Foundation/04-QA与验收.md` | 已建立 |
| 工程地图入口 | `03-O/C1.source/CODEGRAPH.md` | 已建立 |
| 构建产物根 | `03-O/C2.builds/` | 已建立 |
| 工具脚本根 | `03-O/C3.tools/` | 已建立 |
## 后续应补
- 真实构建命令
- 真实测试命令
- 首个 QA 脚本入口
- 主 UI / 主流程 / 数据层 / 发布前检查门禁
K2.项目管理/README.md
New file
@@ -0,0 +1,14 @@
# K2.项目管理
本目录保存长期有效的项目管理、协作、复盘和交付经验。
适合放入这里的内容:
- PrivateVoice-independent-developer 项目级 SOP。
- QA 门禁和验证地图。
- 阶段复盘。
- 交付验收经验。
- 新 Agent / 新 session 接手指南。
- 多角色协作规则的项目特例。
不复制全局规则;全局规则只在本项目有特例时才补充说明。
K2.项目管理/新窗口接手指南.md
@@ -1,52 +1,27 @@
# 新窗口接手指南
## 接手目标
从 `/Users/ar/Projects/PrivateVoice` 文件系统接手项目,不依赖旧长会话上下文。`PrivateVoice2` 只是迁移期间旧命名,不再作为当前路径。
# PrivateVoice-independent-developer 新窗口接手指南
## 必读顺序
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/02-P/事件地图.md`
6. `/Users/ar/Projects/PrivateVoice/03-O/CODEGRAPH.md`
7. `/Users/ar/Projects/PrivateVoice/03-O/K2.项目管理/迁移资产清单.md`
1. `/Users/ar/Projects/PrivateVoice-independent-developer/AGENTS.md`
2. `/Users/ar/Projects/PrivateVoice-independent-developer/PROJECT.md`
3. `/Users/ar/Projects/PrivateVoice-independent-developer/02-P/进度地图.md`
4. `/Users/ar/Projects/PrivateVoice-independent-developer/02-P/事件地图.md`
5. `/Users/ar/Projects/PrivateVoice-independent-developer/03-O/CODEGRAPH.md`
6. `/Users/ar/Projects/PrivateVoice-independent-developer/03-O/K2.项目管理/迁移资产清单.md`
## 当前事实快照
## 接手事实
- 当前工作不是继续旧会话,而是从新项目文件接手。
- 源码根:`03-O/C1.source/privatevoice.src`
- 当前基线:`v2.2.0-build20260702.0303-real-user-test`
- Round 6 粤语实现和四包候选已完成。
- Windows preview 与官网正式发布仍有缺口。
- Git 根:`/Users/ar/Projects/PrivateVoice-independent-developer/03-O`
- 分支:`independent-developer`
- 代码基线:`a075aec1` / `v2.2.2-build20260703.0335-real-user-test`
- 当前任务只从 `/Users/ar/Projects/PrivateVoice-independent-developer/02-P/进度地图.md` 领取。
- MAS 是另一项目,不共享工作树、任务或发布结论。
## 接手自检命令
## 接手自检
```bash
cd /Users/ar/Projects/PrivateVoice/03-O
git status --short --branch
git diff --check
cd C1.source/privatevoice.src
npm --prefix frontend run build
go test ./...
git -C /Users/ar/Projects/PrivateVoice-independent-developer/03-O status --short --branch
git -C /Users/ar/Projects/PrivateVoice-independent-developer/03-O diff --check
```
## 不迁移内容
- 原始长会话正文。
- 旧 worktree。
- 旧构建包全集。
- 证书目录。
- node_modules、dist、构建缓存和用户级缓存。
## 成功判定
新窗口只读新项目文件后,应能说明:
- 项目是什么。
- 当前做到哪里。
- Git 根、源码根、QA 入口和发布入口在哪里。
- 下一步需要谁决策。
- 哪些材料是 legacy,不可直接作为当前任务来源。
涉及源码、构建、QA 或发布时,再按 `CODEGRAPH.md` 和项目全局规则执行对应门禁;本迁移没有运行构建或发布。
K2.项目管理/研发交付验收流程.md
New file
@@ -0,0 +1,23 @@
# PrivateVoice-independent-developer 研发交付验收流程
最后整理:2026-07-11
## 标准链路
```text
目标对齐
  -> 当前 Round 包
  -> 技术方案
  -> 实现
  -> 代码审核
  -> QA
  -> 发布准备
  -> 用户 / Owner 验收
```
## 规则
- 不跳过 `02-P/进度地图.md` 直接派工。
- 不跳过技术方案直接进入非平凡实现。
- 不跳过 QA 直接进入发布准备。
- 交付结论必须落在文档,而不是只留在会话中。
K2.项目管理/项目经理-经验与教训.md
New file
@@ -0,0 +1,15 @@
# PrivateVoice-independent-developer 项目经理-经验与教训
最后整理:2026-07-11
## 当前状态
项目尚处初始化阶段,暂无长期有效经验教训。
## 后续记录范围
- 计划失真原因
- 交接失败原因
- 文档入口失效原因
- 规则树冗余或缺口
- 哪些流程在真实执行中有效,哪些只是纸面结构