# PrivateVoice-independent-developer CODEGRAPH

最后整理：2026-07-11

## 用途

这是 PrivateVoice-independent-developer 的人工工程地图，用于减少后续代码定位成本和上下文重建成本。它记录稳定入口、模块边界、QA 入口、受保护行为和最后验证基线，不替代真实源码、测试或 QA。

当前尚未建立真实源码工程。本文件先作为工程地图入口，后续源码出现后必须持续维护。

## 计划源码根

`/Users/ar/Projects/PrivateVoice/03-O/C1.source`

## 与参考代码库的边界

- `/Users/ar/Projects/PrivateVoice/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/PROJECT.md`
- `/Users/ar/Projects/PrivateVoice/02-P/进度地图.md`
- `/Users/ar/Projects/PrivateVoice/02-P/Round00-Foundation/00-任务入口.md`
- `/Users/ar/Projects/PrivateVoice/01-I/`

## 后续维护要求

- 新增源码目录、关键文件、测试入口、构建入口后，必须补进本文件。
- 删除或重命名模块前，先更新影响面判断。
- 任何非平凡实现前，先用本文件定位相关文件，再读真实源码。