edit | blame | history | raw

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；完成后更新本图与证据路径。