# 2026-06-24 AppStore 输入法 Round0

## 用户目标

- 将 App Store 输入法路线拆成五轮 todo。
- 在 `codex/appstore-ime-2.1.28` 独立 worktree 内开始推进 Round 0。
- 保持与多语种分支隔离，不从多语种分支合并实验代码。

## 工作位置

- Worktree：`/Users/ar/Projects/PrivateVoice/.worktrees/appstore-ime-2.1.28`
- 分支：`codex/appstore-ime-2.1.28`
- 起点：`v2.1.28-build20260614.0102-appstore-launchfix`

## 已完成

- 创建五轮计划：
  - `02-P-NBL/appstore-ime/plan.md`
  - `02-P-NBL/appstore-ime/round-0/todo-list.md`
- 补充工程地图：
  - `CODEGRAPH.md`
- 创建 Round 0 最小 `InputMethodKit` 固定文本 PoC：
  - `privatevoice.src/inputmethod/round0-fixed-text/`
- PoC 行为：
  - 构建独立 input method `.app`。
  - 处理输入法内部快捷键 `Control + .`。
  - 尝试向当前 text input client 提交固定文本 `PrivateVoice Round 0 fixed text`。
  - 不接入 Wails 主链路、ASR、全局热键、剪贴板模拟上屏。
- 增加稳定脚本：
  - `build.sh`
  - `verify-no-forbidden-symbols.sh`
  - `install-for-user.sh`
  - `enable-and-select-for-user.sh`
  - `uninstall-for-user.sh`
- 自动验证通过：
  - 构建通过。
  - `codesign --verify --deep --strict` 通过。
  - 静态扫描未发现 `AXIsProcessTrusted*`、`AXUIElement*`、`CGEventTapCreate`、`CGEventPost`、模拟键盘注入等符号。
  - 已安装到 `~/Library/Input Methods/PrivateVoiceRound0InputMethod.app`。
  - 系统 TIS API 可发现、启用并选择该输入源。

## 当前 commit

- Commit：`bbd7cd1fe8f63977865d5ac08380b0c82060a840`
- Message：`Add App Store input method Round 0 PoC`

## 未完成

- 真实文本框人工验证仍未完成：
  - TextEdit
  - Safari 或 Chrome
  - VS Code
- 需要用户或后续人工 QA 在已选择 `PrivateVoiceRound0InputMethod` 输入源后，打开真实文本框，按 `Control + .`，确认是否插入固定文本。
- 人工验证过程中还需观察是否出现 Accessibility 或 Input Monitoring 权限弹窗；预期不应出现。

## 当前 go/no-go

```text
Round 0 自动门禁：GO
Round 0 完整门禁：等待真实文本框人工验证
```