📖 用户手册

CoderPulse 是面向独立开发者的 App Store「早报 + 警报」工具，常驻 Mac 菜单栏。所有数据都用你自己的 App Store Connect API 密钥直连苹果，不经过开发者的任何服务器。iOS / Apple Watch 伴侣可只读查看仪表盘。

1. 安装与启动

从 App Store 下载安装。首次启动后，CoderPulse 图标会出现在 Mac 菜单栏右侧。

• 菜单栏面板：点击菜单栏图标打开仪表盘浮窗，再次点击或点击窗外关闭。
• 设置窗口：点击面板中的齿轮图标，或按 ⌘, 打开独立设置窗口。
• 登录时启动：在「设置 → 通用」中开启「登录时启动」。

2. Demo 模式

未接入 ASC 账号时，应用默认以 Demo 模式运行，展示示例销量、评论和审核状态数据。你可以完整体验仪表盘的所有界面，无需任何配置。接入真实账号后 Demo 模式自动关闭。

3. 接入 App Store Connect

在「设置 → 账号」中通过三步向导完成接入：

1. 生成 API 密钥：登录 App Store Connect → 用户与访问 → 集成 → App Store Connect API，生成一把密钥（角色选 Admin 或 Finance），下载 .p8 文件并记下 Key ID 和 Issuer ID。
2. 填入三要素：Issuer ID、Key ID，以及导入 .p8 私钥文件（支持直接粘贴或从文件导入）。
3. 校验并接入：点击「校验并接入」，CoderPulse 会尝试拉取你的 App 列表以验证密钥有效性。

密钥只存于本机钥匙串，不会发送给开发者。开启 iCloud 钥匙串后，密钥可加密同步到你的其他 Apple 设备，换设备时可「从 iCloud 恢复账号」一键接入。

接入后，在「账号」页勾选要关注的 App，取消勾选即可停止监控（数据保留不删除）。

4. 供应商编号（销量需要）

评论和审核状态只需 API 密钥即可获取。要查看销量数据，还需在账号页补填「供应商编号」：

• 登录 App Store Connect →「销售和趋势」，编号在页面左上角（约 8 位数字）。
• 填入后按回车或切换到其他输入框，应用会自动拉取近期销量。

5. 菜单栏仪表盘

点击菜单栏图标打开浮窗面板，包含以下区域：

• 昨日概览：三张指标卡——昨日下载、昨日收入、7 日下载，含环比涨跌箭头（绿涨红跌）。
• 近 30 天下载趋势：迷你柱状图，昨日柱高亮，虚线标注均值。
• 版本状态：每个 App 各平台最新版本及其审核状态（在架 / 审核中 / 被拒等），点击展开可查看审核历史时间线。提审时自动保留在架旧版。
• 最新评论：最新 50 条评论流，按星级着色（绿 ≥4 / 黄 3 / 红 ≤2），点击展开全文，支持跳转 ASC 网页回复。

菜单栏图标可配置徽标显示：仅图标 / 昨日下载数 / 昨日收入（在「设置 → 通用」中切换）。

6. 通知与警报

在「设置 → 通知」中配置：

• 新评论通知：可选「全部评论」「仅 ≤3 星」或「关闭」。
• 每日早报：设置推送时间（6:00–12:00 之间），到点推送昨日销量与评论摘要。需 Pro。
• 审核状态通知：始终开启，不可关闭——App 审核状态每次变化都会 100% 捕获并推送。
• 测试通知：可在通知设置中发送一条测试通知，确认系统通知权限正常。

免费版不发送真实警报，但可接收测试通知。升级 Pro 后全部通知开启。

7. 轮询与刷新

Pro 版按设定频率（5 / 15 / 60 分钟，在「设置 → 通用」中配置）自动轮询 ASC API。免费版需在面板中手动点击刷新按钮。

8. 免费版与 Pro 版

购买为一次性付费、终身有效。换设备或重装后，在「设置 → Pro」中点击「恢复购买」即可找回授权。

9. iOS / Watch 伴侣

iPhone 和 Apple Watch 上的 CoderPulse 为只读伴侣，供你随时查看仪表盘数据：

• iPhone：打开 App 查看昨日下载、收入、7 日下载、最新评论与版本状态。
• Apple Watch：抬腕即可查看昨日下载、收入与最新评论摘要。数据通过 WatchConnectivity 从 iPhone 推送。

账号配置在 Mac 端完成，iOS / Watch 端无需重复配置。Universal Purchase 一次购买，三端通用。

10. 常见问题

Q：为什么销量是「昨天」的？
苹果的销售与趋势报告隔日生成（约太平洋时间早上 8 点），这是苹果对所有第三方工具的统一限制。

Q：我的密钥安全吗？
密钥存于设备钥匙串，不会发送给开发者。开启 iCloud 钥匙串时，密钥通过苹果的端到端加密在设备间同步。详见隐私政策。

Q：销量不显示？
需要「供应商编号」以及角色为 Admin 或 Finance 的密钥。评论与审核状态用较低权限的密钥即可。供应商编号在 ASC「销售和趋势」页面左上角（约 8 位数字）。填入编号后应用会自动拉取近期销量。

Q：.p8 文件和推送证书的 .p8 一样吗？
不一样。务必使用「App Store Connect API」密钥，不是 APNs 推送密钥——两者都是 .p8 格式，但完全不通用。

Q：换了 Mac，账号还在吗？
开启 iCloud 钥匙串后，账号凭据会自动同步到新设备。在「设置 → 账号」中使用「从 iCloud 恢复账号」即可一键恢复。

Q：如何断开账号？
在「设置 → 账号」底部点击「断开并清除本机数据」，将移除本机所有缓存数据及 iCloud 同步的账号。此操作不可撤销。

11. 意见反馈

这个 App 由独立开发者维护，你的每一条使用意见、Bug 和功能建议都会被认真对待。欢迎随时联系 selfren@163.com。

反馈问题时附上 App 版本号（「设置 → 关于」中可见）与系统版本，能更快定位问题。