# 8.3.5 上架配置修正

## 用户目标

继续完成 TagLauncher macOS 8.3.5 的 App Store Connect 上架配置，但最后一步提交审核由用户手动完成。用户发现“价格与销售范围”仍像上一版一样保留付费下载风险，要求重新核对并修正。

## 已完成事项

- 在 App Store Connect 中确认 `macOS App 版本 8.3.5` 处于 `准备提交`。
- 重新保存 8.3.5 的“此版本新增内容”，把上一版未发布的累计内容一并写入。
- 核对版本页构建版本：`8.3.5 (20260702.1046)` 已绑定，上传日期为 `2026年7月2日下午12:08`，页面仍显示 `缺少出口合规证明`。
- 重新核对“价格与销售范围”：当前价格显示为 `下载`，价格明细显示 `国家或地区 (175)`，美国及可见后续地区价格均为 `$0.00` 或本币 `0.00`。
- 遵守用户要求，未点击 `添加以供审核`，未执行最终提交审核。

## 关键决策

- 8.3.5 上架前必须把 App 本体从付费下载改为免费下载；Pro 收费通过 App 内购买完成。
- App Store Connect 价格主表里 `价格：下载` 是当前免费下载状态的关键页面证据。
- 发布前不能只看版本页 metadata；必须同时核对 pricing 页面，否则会出现“新版本提交了，但用户仍需付费下载”的严重发布缺陷。

## 核心事实 / 变更快照

- 变更对象：App Store Connect 中 Taglauncher macOS App 的 8.3.5 版本 metadata 与 App 本体价格。
- 事实来源：
  - App Store Connect 页面：`https://appstoreconnect.apple.com/apps/6777149496/distribution/macos/version/inflight`
  - App Store Connect 页面：`https://appstoreconnect.apple.com/apps/6777149496/distribution/pricing`
  - Release tag：`v8.3.5-build20260702.1046`
  - Release commit：`2309264 Freeze TagLauncher 8.3.5 release artifacts`
- 变更前：
  - 用户截图显示价格页仍有付费下载风险。
  - 8.3.5 “此版本新增内容”一度只剩两行：`修复ESC退出逻辑缺陷`、`设置页面视觉设计`。
- 变更后：
  - 价格页主表显示 `价格 / 下载`。
  - 价格明细显示 `当前价格 / 下载`，`国家或地区 (175)`，美国价格 `$0.00`，可见地区价格均为 `0.00`。
  - “此版本新增内容”保存为累计说明：
    - `【Bug修复】修复ESC退出逻辑缺陷`
    - `【交互优化】编辑标签入口变得极浅—在标签上双击就能进入标签维护`
    - `【交互优化】新增支持自定义快捷按键`
    - `【交互优化】新增 taglauncher://show 唤起入口，可配合 BetterTouchTool 等工具把触控板手势映射到 TagLauncher。`
    - `【UI优化】优化设置页面视觉设计`
    - `【UI优化】优化样式 2 / 样式 3 的底部容器排版，未分类与 Mac 自带固定为底部全宽容器，减少参差空隙`
    - `【UI优化】标签颜色支持第 8 种自定义颜色`
    - `【功能优化】免费用户现在也可以保存标签列表排序，容器显示位置会被持久记住`
    - `【功能优化】修复隐藏 Dock 图标、全屏 Space、Quick Search、设置窗口等场景下的键盘焦点和窗口层级问题`
    - `【功能优化】智能初始化默认标签进一步精简，默认分类减少到 12 个`
    - `【收费方式优化】产品从收费下载模式改为免费下载，Pro 功能通过 App 内购买解锁`
- 范围边界：
  - 本轮只改 App Store Connect 配置，不改源码、不重新打包、不重新上传二进制。
  - 未点击最终 `添加以供审核`。
- 验证证据：
  - 版本页保存后 `保存` 按钮为禁用状态，`8.3.5 (20260702.1046)` 仍存在。
  - 价格页保存后 `保存` 按钮为禁用状态，页面没有 `$6.99`，主表显示 `下载`，价格明细显示 `175` 个国家或地区均为 `0.00` 价格。

## 可复用命令 / Runbook

### App Store Connect 发布前价格与版本配置复核

用途：提交审核前确认新版本不会继续沿用旧的付费下载价格，并确认发布说明与构建版本已保存。

前置条件：

- 已登录 App Store Connect。
- 目标 App：Taglauncher，Apple ID `6777149496`。
- 目标版本：`8.3.5`。
- 目标 build：`8.3.5 (20260702.1046)`。

步骤：

1. 打开版本页：`https://appstoreconnect.apple.com/apps/6777149496/distribution/macos/version/inflight`。
2. 确认页面标题为 `macOS App 版本 8.3.5`，状态为 `准备提交`。
3. 确认 `此版本的新增内容` 是累计说明，不是只剩上一版两行简短说明。
4. 确认构建版本区域已绑定 `8.3.5 (20260702.1046)`。
5. 不点击 `添加以供审核`，除非用户明确要求执行最终提交。
6. 打开价格页：`https://appstoreconnect.apple.com/apps/6777149496/distribution/pricing`。
7. 在 `价格时间表` 中确认 `价格` 显示为 `下载`。
8. 打开或查看价格明细，确认 `当前价格` 为 `下载`，`国家或地区 (175)` 下美国为 `$0.00`，其他可见国家或地区也为本币 `0.00`。
9. 如果看到 `$6.99` 或任何非零价格，不得提交审核，必须先修正价格并保存。

搜索关键词：`App Store Connect`、`Taglauncher 8.3.5`、`20260702.1046`、`价格 下载`、`$0.00`、`175 个国家或地区`、`此版本新增内容`、`添加以供审核`。

## 文件变更

- 新增本会话记录：`/Users/ar/Projects/Taglauncher-doc/chat-history/codex-sessionhistory/26.0702-Taglauncher.Coder3-8.3.5上架配置.md`
- 更新命令索引：`/Users/ar/Projects/Taglauncher-doc/chat-history/codex-sessionhistory/COMMANDS.md`

## 未决问题

- `缺少出口合规证明` 仍显示在 build 状态中，最终提交前需要在 App Store Connect 审核流程里处理。
- 最终 `添加以供审核` 由用户手动完成。

## 后续建议

- 用户提交审核前再做一次价格页复核，确认 `价格：下载` 和 `国家或地区 (175)` 的 `0.00` 明细仍然存在。
- 今后 App Store 发布检查清单中必须把价格页核对作为硬门禁，不能只核对版本页。