常见问题
从当前项目文档整理，帮助你安装和配置 Sapphire-CN。
支持哪些 Mac 和 macOS 版本？
当前安装包支持 Apple 芯片 arm64，项目最低要求为 macOS 14.6，暂不提供 Intel 安装包。其他 Mac 和整机重启场景尚未验收。
如何安装？首次打开被系统拦截怎么办？
下载 DMG，将 Sapphire.app 拖入 Applications，无需 Xcode。当前为 Apple Development 签名、未公证的开发预览；核对下载来源与校验文件后，可在系统设置 → 隐私与安全性中选择仍要打开。
如何切换为中文界面？
在系统设置 → 通用 → 语言与地区 → 应用程序中添加 Sapphire，选择简体中文并重启应用。主要界面与权限说明已汉化，少量提示仍为英文。
如何查看 Codex 和 Claude 的订阅额度？
在设置 → 小组件 → 小组件可见性和顺序中启用 AI 额度。先在 Codex CLI 或 Claude Code 登录官方账户，再关闭对应的第三方查询并刷新；只使用 API 密钥的账户需要配置平台余额查询接口。
第三方余额测试成功，为什么面板没有更新？
测试不会自动保存。确认查询结果后，先点击保存查询设置；使用独立凭据时，还需另点保存查询密钥，将凭据存入钥匙串。然后回到面板刷新，并留意请求间隔和限流。
Helper 提示 SAP-H1 怎么办？
SAP-H1 表示后台已批准但连接失败，不代表进程没有启动。先等待首次验签，确认后台运行已批准，再检查主程序和 Helper 的签名身份是否匹配；仍无法恢复时，可到设置 → 电池 → 配置中手动重置辅助服务，避免连续重置。
CN1–CN3 用户如何迁移到本项目更新源？
请先手动安装一次 CN4 或更高换源版。旧版写死了上游更新地址，不能仅靠远程发版换源；迁移后可在设置 → 关于 → Sapphire 更新中检测和下载本仓库版本，下载后仍需本人确认安装并重新启动。
与上游 Sapphire 有什么区别？所有功能都能直接使用吗？
Sapphire-CN 基于上游二次开发，主要增加中文适配、AI 额度与第三方余额查询，并修复 Helper 连接和验证码通知问题。部分公开源码仍为占位实现，订阅、系统扩展等功能需要额外配置；上游安装包不包含本分支新增功能。