码量：AI 编程额度

iOS App 功能

1. 先确定 Mac 端可以获取到数据之后，安装 iOS App
2. 确保 iOS 设备和 Mac 上登录的 iCloud 账号是同一个
3. 首页目前最多会有 Codex 和 Claude Code 两张卡片，如果只在 Mac 上同步了一个那就只有一张卡
4. 卡片对 5 小时和每周额度各显示：剩余百分比、进度条、重置倒计时，最下面一行是数据新鲜度
5. 底部的「iCloud 同步」行显示上次读取时间或失败原因
6. 刷新时机：App 启动、每次回到前台、后台每 60 秒一次，以及下拉手动刷新
7. 右上角齿轮是提醒设置功能，确保 iOS App 授权了应用提醒和后台运行
8. 三档阈值和重置提醒都只针对「每周额度」，5 小时额度不会发任何通知，它本来就恢复得很快，逐条提醒只会变成骚扰。

iOS 小组件 长按主屏幕或锁屏 → 添加小组件 → 找到「AI 编程额度」。

• 主屏幕：小号、中号（中号多显示重置倒计时和更新时间）
• 锁屏：圆形、行内、矩形
• 添加后长按 → 编辑小组件 → 可以在 Codex / Claude 之间切换，默认是 Claude。想两个都看，就添加两个小组件。 小组件由系统决定刷新时机（大约每 15 分钟请求一次更新），不是实时的。App 收到新数据时也会主动请求刷新一次。暂时离线时它会继续显示上一次成功读到的数值，而不是变空白。

Apple Watch 手表端

1. 在 iPhone 的 Watch App 里确保码量已经安装到 Apple Watch
2. 主界面两页，用 Digital Crown 或上下滑动切换：第一页 Codex，第二页 Claude
3. 每页显示「5 小时」和「每周额度」两条：条形图读法：灰色 = 已经用掉的，彩色 = 还剩的
4. 表同时用两条通道，谁的数据新用谁的：

• iPhone 推送（快）：iPhone 一拿到新数据就推过来，几乎即时，但需要 iPhone 在附近。
• 手表自己读 iCloud（慢但独立）：每 5 分钟一次。只要手表自己联网并登录了 iCloud，即使 iPhone 不在身边、没打开过，也能更新。

手表表盘 Complication 支持圆形、表角、行内、矩形四种尺寸。 添加方式：长按表盘 → 编辑 → 选择复杂功能位置 → 找到「码量」，会看到两个预设条目：「Claude 额度」 和 「Codex 额度」，直接选想要的那个。 watchOS 11 及更早版本没有复杂功能的参数编辑界面，所以这里做成了两个预配置条目，而不是加完再进去改。

• 圆形：默认突出 5 小时额度，表盘标签补充百分比。
• 矩形：同时显示 5 小时和每周两条，以及数据新鲜度。
• 刷新由系统调度（约每 15 分钟），不要期待秒级更新；离线时继续显示上次读数。