# Pro 状态重置排查

## 用户目标

检查本机测试脚本为何不能通过 `launchctl unsetenv TAGLAUNCHER_QA_PRO_STATE`、退出并重新打开 TagLauncher 来去除会员状态、回到免费态。

## 已完成事项

- 按项目规则读取 `CODE_GOVERNANCE.md`、`CODEGRAPH.md` 和相关调试 / QA / 代码治理规则。
- 确认 `/Applications/TagLauncher.app` 为 `8.2.8`，build `20260630.0128`，与当前 HEAD/tag 对应。
- 确认 `launchctl getenv TAGLAUNCHER_QA_PRO_STATE` 已为空，但运行中的 TagLauncher 旧进程仍携带 `TAGLAUNCHER_QA_PRO_STATE=pro`。
- 确认源码中 `TAGLAUNCHER_QA_PRO_STATE` 支持 `free|pro|legacyPro`；unset 只表示恢复真实权益状态，不等于强制免费。
- 按项目 QA 脚本的进程清理方式重启 App，并使用 `launchctl setenv TAGLAUNCHER_QA_PRO_STATE free` 启动新进程。

## 关键结论

- 原三行脚本失效的直接原因是旧 TagLauncher 进程没有在 `open` 前真正退出，导致 `open` 复用了仍携带 `TAGLAUNCHER_QA_PRO_STATE=pro` 的旧进程。
- 从当前代码语义看，如果测试目标是强制免费态，应使用 `TAGLAUNCHER_QA_PRO_STATE=free`；`unsetenv` 只适合恢复 StoreKit / legacy / cache 推导出的真实权益状态。

## 文件变更

- 未修改 App 源码、构建脚本或 QA 脚本。
- 新增本会话记录：`.codex-sessionhistory/2026-06-30-Pro状态重置.md`。

## 当前环境变更

- 当前运行的 `/Applications/TagLauncher.app` 新进程已重新启动。
- 新进程环境为 `TAGLAUNCHER_QA_PRO_STATE=free`。

## 未决问题

- 尚未把这段更稳的免费态重置命令沉淀成项目 QA 脚本或文档。

## 后续建议

- 若需要长期复用，新增一个专门的本机 QA helper，例如 `Scripts/reset_pro_state_for_qa.sh free|pro|legacyPro|real`，避免手写 quit/open 时再次复用旧进程。