# PrivateVoice-MAS CODEGRAPH

最后整理：2026-07-11

## 工程范围

- 项目根：`/Users/ar/Projects/PrivateVoice-MAS`
- Git 根：`/Users/ar/Projects/PrivateVoice-MAS/03-O`
- 分支：`mas`
- 源码冻结基线：`015f1089ea875a153dd2a18ef42c25145d4868f5`；项目初始化元数据提交见 `git log`。
- 源码根：`/Users/ar/Projects/PrivateVoice-MAS/03-O/C1.source/privatevoice.src`
- 当前验证基线：`2.2.3 / build 20260711.1807`
- 自动图谱：`../.codebase-memory/`；它只辅助定位，不替代本地图。

## 核心入口

| 区域 | 入口 |
| --- | --- |
| Wails / 生命周期 | `privatevoice.src/main.go`、`privatevoice.src/app.go` |
| 语音输出路由 | `privatevoice.src/internal/textoutput/router.go`、`router_appstore_darwin.go` |
| Accessibility | `privatevoice.src/internal/axinput/axinput_darwin.go` |
| 剪贴板 fallback | `privatevoice.src/internal/axinput/clipboard_fallback_darwin_test.go`、text output service/router |
| 设置与 fallback UI | `privatevoice.src/frontend/src/components/settings/GeneralPage.svelte`、`TextOutputFallbackPanel.svelte` |
| MAS 构建 | `privatevoice.src/scripts/build-macappstore-pkg-macos.sh` |

## 受保护行为

- MAS direct AX 只做 best-effort；不能把 focused-element 失败误报为成功。
- 可靠输出路径是写入最新文本后自动触发受保护 `Cmd+V`；显式 fallback 仍然需要安全目标判断。
- Terminal / shell / console / terminal-role 目标不得自动写入、粘贴或执行命令。
- 日志和 UI 不记录 transcript、target、method、message、窗口标题或文档标题。

## QA / 发布入口

- QA 与发布证据：`../K2.项目管理/`、`../K3.运营与发布资料/` 及根 `02-P/X-Archived/`。
- 当前项目不从 independent-developer 项目领取源码或任务。
- 非平凡实现前先读取本文件、项目根入口和 `02-P/进度地图.md`；完成后更新本图与证据路径。