🌐 项目网站 · 二开说明与致谢 · 网站源码位于 website/。
Sapphire-CN 是基于 Sapphire 的二次开发项目，主要增加中文适配、Codex / Claude 订阅额度与第三方平台余额查询，并修复 Helper 启动连接问题。
本项目由 u7-u7/Sapphire-CN 独立维护，非上游官方网站或官方中文版；保留 Shariq Charolia 与上游贡献者署名，许可证见 LICENSE。
📦 下载 DMG · ZIP 安装包 · 发布说明与校验文件
下载优先使用阿里云 OSS 镜像，文件与 GitHub 原包 SHA-256 一致。GitHub 备用 DMG · GitHub 备用 ZIP。CN9 起应用内检查和下载更新优先使用 OSS，失败时回退 GitHub。CN6–CN8 升级 CN9 这一次仍走 GitHub，也可从镜像手动安装。
v3.0-cn.9-preview · Apple 芯片 arm64 · 项目最低 macOS 14.6 · 无需 Xcode
🛠️ CN9 新增应用内更新 OSS 优先、GitHub 回退；保留 CN8 的桌面 Codex CLI 识别修复和 CN7 的权限设置入口修复。
升级方式：CN6、CN7、CN8 用户可通过“设置 → 关于 → Sapphire 更新”获取 CN9。CN4 及更早版本、CN5 临时签名版用户需要先退出并备份原应用，再手动安装一次 CN9，迁移到团队
462JAMGP66；如 Helper 连接失败，请重新配置辅助服务并检查后台运行权限。
📦 通过 DMG 直接安装，无需 App Store。当前为 Apple Development 签名、未公证的开发预览；首次如被拦截，可按下方教程在「隐私与安全性」手动允许。其他 Mac 与整机重启尚未验收。上游原版安装包不含本分支功能。
| 功能 | |
|---|---|
| 📊 AI 额度 | Codex、Claude 订阅额度、同步状态与服务端重置时间 |
| 💰 平台余额 | DeepSeek、Sub2API、NewAPI、自定义 JSON 接口 |
| 🧩 刘海组件 | 播放信息、日历、组件排序 |
| 🖥️ 桌面工具 | 窗口管理、文件托盘、剪贴板、护眼、电池管理 |
| 🇨🇳 中文界面 | 主要界面与权限说明汉化，少量提示仍为英文 |
部分公开源码为占位实现；订阅、系统扩展等功能需额外配置。
🎵 音乐、AI 额度与专注，一屏查看（截图读数仅为示例）
- 下载：选择上方 DMG 或应用 ZIP；发布页的
Source code是源码。当前无 Intel 安装包。 - 安装：退出并备份旧版。打开 DMG，把
Sapphire.app拖到Applications；ZIP 则解压后复制完整应用。 - 打开：启动
/Applications/Sapphire.app。如被拦截，到「系统设置 → 隐私与安全性 → 仍要打开」，按提示认证并确认「打开」（详细步骤）。 - 切换中文：「系统设置 → 通用 → 语言与地区 → 应用程序」添加 Sapphire，选择「简体中文」并重启应用。
- 打开面板：按住 ⌘ Command 点击刘海，点击 ⚙️ 进入设置；默认未开启悬停展开。
安装者无需开发者会员或自行编译。应用显示 3.0-cn.9-preview，系统版本为 3.0 (9)，发布标签为 v3.0-cn.9-preview。
确认信任来源且校验一致后，遇到「无法验证开发者」等提示，可按 Apple 官方说明操作：
- 尝试打开 Sapphire，让系统显示拦截提示。
- 前往「系统设置 → 隐私与安全性」，找到 Sapphire，点击「仍要打开」。
- 由本人完成系统认证，确认「打开」。
成功允许后，macOS 会保存这份应用的打开例外。辅助功能、Helper 后台运行、钥匙串是另外的授权，按首次启动与授权处理。
按钮可能受设备管理策略限制，此流程不保证其他 Mac 可以运行。提示应用损坏或将损坏电脑时，停止打开并按 Apple 说明排查。不要关闭全局安全保护或移除应用签名。
将安装包与 SHA256SUMS.txt 放在同一目录，在该目录运行：
shasum -a 256 -c SHA256SUMS.txt已下载的文件应显示 OK；只下载一种格式时，另一项会提示文件不存在。
🔐 跟随引导授权，当前必需项为辅助功能；其他权限按功能开启。
| 权限 | 用途与位置 |
|---|---|
| 辅助功能 | 窗口管理等；「系统设置 → 隐私与安全 → 辅助功能」 |
| 后台运行 | Helper；「系统设置 → 通用 → 登录项与扩展」（旧系统为「登录项」） |
| 钥匙串 | 剪贴板密钥、查询凭据；本人在系统弹窗处理，单次「允许」后可能再次询问，「始终允许」可选 |
| 日历、通知、位置、蓝牙 | 对应功能使用时授权 |
| 屏幕录制、自动化、完全磁盘访问 | 按窗口预览、媒体控制等功能提示授权 |
需要 Helper 时：设置 → 电池 → 配置 → 安装，批准后台运行，等待首次握手（宽限期 30 秒），确认显示辅助服务已运行或 Helper Active。首次引导中的按钮叫「安装辅助服务」。
- 展开面板：⌘ 点击刘海；可在设置中启用悬停展开。
- 配置组件：⚙️ → 小组件 → 小组件可见性和顺序，启用并调整排序。
- 其他工具：在对应分类配置音乐、日历、文件托盘、剪贴板和电池等功能。
📋 剪贴板历史，快速找回复制内容
📊 在「设置 → 小组件 → 小组件可见性和顺序」启用 AI 额度，选择 5 / 15 / 30 分钟刷新。回到面板，点击额度查看详情；手动刷新仍受请求间隔与限流约束。
按 官方教程安装 Codex CLI，登录要查看额度的账户：
codex login
codex login status回到 Sapphire，关闭 Codex 第三方查询并刷新。只使用 API 密钥的账户请配置平台查询接口。详见 OpenAI 认证说明。
按 官方教程安装 Claude Code，再登录：
claude auth login
claude auth status确认 Claude Code 使用官方服务配置，在 Sapphire 关闭 Claude 第三方查询后刷新。关闭此开关不会修改 CLI 的供应商配置；登录过期需在 CLI 重新登录。
Claude Code 当前使用 DeepSeek 时会自动识别，也可手动配置。Codex、Claude 各自的第三方设置独立。
- 在「设置 → 小组件」找到「Codex · 第三方额度」或「Claude · 第三方额度」，开启查询。
- 填写平台名称、当前供应商 API 地址，选择模板并点击「应用模板」（会重填部分设置）。
- 核对 HTTPS 额度查询地址、认证方式、凭据来源。这里填余额接口；复用 CLI 凭据时，供应商地址须与 CLI 一致；使用独立凭据时，先填写查询密钥或账户令牌。
- 在「JSON 字段与重置时间」核对字段路径、数值除数和币种；未返回的字段留空。
- 点击「测试额度查询」，确认读数后点击 「保存查询设置」。
- 使用独立凭据时，再点击 「保存查询密钥」，存入钥匙串；随后回到面板刷新。
🔑 测试不会保存。独立密钥必须在设置保存后另行保存；修改地址、认证或用户编号后，可能需要重新保存密钥。
| 平台 | 配置要点 |
|---|---|
| DeepSeek | 使用可查询余额的密钥；余额不换算成 Claude 订阅百分比 |
| Sub2API | 接口与认证以供应商部署为准，模板地址可能需调整 |
| NewAPI | 账户 Access Token + User ID，不能用模型 API Key；User ID 虽标可选，此模板实际必填。默认除数 500000 须核对 |
| 自定义 JSON | 按真实响应填路径，如 data.balance、balance_infos.0.total_balance |
币种标签不代表汇率换算；服务端未返回重置时间时显示未提供。
表示后台已批准但连接失败，不代表进程没启动。依次检查：
- 等待首次验签，确认后台运行已批准。
- 确认主程序与 Helper 签名身份匹配，未改成未签名或 ad-hoc 临时签名。
- 仍无法恢复，再到「设置 → 电池 → 配置」手动「重置辅助服务」。
新版保留等待中的连接，避免短超时触发反复重连。不要连续重置或清空系统后台数据库。SAP-H2 为等待批准，SAP-H3 为文件或注册缺失。
检查是否有系统钥匙串弹窗等待本人处理；单次授权可能在下次启动再次询问。权限已开仍报错时，确认授权对象是当前 /Applications/Sapphire.app。
| 现象 | 处理 |
|---|---|
| 找不到 CLI / 未登录 | 确认 CLI 可运行、登录未过期，再重启 Sapphire |
| 第三方认证失败 | 核对令牌类型、User ID、认证方式与地址 |
| 读不到 CLI 凭据 | GUI 可能读不到终端临时环境变量；持久保存配置或改用独立查询密钥 |
| 测试成功但没更新 | 保存设置及独立密钥，等待刷新或限流冷却 |
| 数值、币种异常 | 核对 JSON 路径、除数与单位 |
「设置 → 关于 → Sapphire 更新」只接收本仓库的公开版本和预发布。CN9 起优先从阿里云 OSS 检查并下载安装包，连接或 HTTP 失败时回退 GitHub；SHA-256、归档、版本和同团队签名校验保持启用。CN6–CN8 升级 CN9 时，旧客户端仍从 GitHub 下载一次。
CN6、CN7、CN8 → CN9 支持应用内更新。 CN4 及更早版本、CN5 临时签名版用户仍需手动安装一次 CN9，迁移更新源与签名团队。完成迁移后，后续同一新团队签名版本可在应用内更新。
应用内下载使用仅包含完整应用的 -update.zip；下载后仍需本人点击「安装并重新启动」。自动检查、后台下载和更新通知可在「关于」按需配置。
- 安装包更新：退出并备份旧版 → 核对新包 → 替换「应用程序」中的应用 → 确认权限、Helper 与额度。
- 源码更新：工作区无未提交修改时运行
git pull --ff-only，使用相同身份重新构建签名后替换。签名变化可能触发重新授权。 - 卸载：退出后将应用移到废纸篓，按需关闭对应后台项；不用清空钥匙串或系统后台记录。
🛠️ 需要完整 Xcode、Git 和有效签名身份。主程序、Helper 与嵌入扩展需正确签名；未签名编译不能验证 Helper 可用。
完整命令与签名步骤见 开发指南。
🧪 开发指南包含 Helper 的 14 项 XPC 边界检查与翻译维护说明。
上游项目：cshariq/Sapphire，感谢原作者与贡献者。本二次开发分支为 u7-u7/Sapphire-CN，保留原作者与贡献者署名，遵循 AGPL-3.0；第三方资源以各自声明为准。