CueSpec v0.3.0 — Mac 版

适用：macOS 15.0 或更新版本。安装包含 Apple Silicon 与 Intel 两种架构；
目前实际运行验证在 Apple Silicon Mac 上，Intel 尚未经实机验收。

安装
1. 解压 CueSpec-0.3.0-build20-macOS-universal.zip。
2. 退出旧 CueSpec，将解压得到的 CueSpec.app 拖入 Applications（应用程序），确认替换。
3. 从“应用程序”打开 CueSpec。不要直接在下载目录中长期运行。
4. 从屏幕顶部小岛打开额度面板，点击标题栏齿轮进入设置；也可按 Command + ,。

本安装包使用 Shenzhen Sparock Intelligent Technology Co., Ltd. 的
Developer ID Application 发行证书签名，含 Apple 安全时间戳。
应用已通过 Apple 公证，并附带公证票据；Gatekeeper 检查通过。
全新电脑首次安装尚未验证，无需关闭 Gatekeeper、SIP 等系统保护。
Apple 官方说明：https://developer.apple.com/developer-id/

首次使用
- Codex 任务功能需要同一用户会话中运行 Codex 桌面应用。
- 按设置提示授予麦克风，以及需要的辅助功能 / 输入监控权限。
- 语音模型在应用内按需下载，约 374 MB；准备完成后可在本机转写中英文。
- DeepSeek 文字整理需要可用的 CueSpec Server 地址和账号；安装包不包含服务端、
  测试账号或任何用户凭据。默认本机测试地址不是公共线上服务。
- Enter 发送回复，Command + Enter 换行。语音文字先进入草稿，核对后再发送。

任务与提醒
- 实时列表显示当前进行中、待回应、等待重试及未读完成提醒；历史状态过期的会话可在所有任务查看。
- 设置中可切换简洁 / 详细任务说明；任务详情和选择卡片沿用原界面。
- 完成提醒可逐条或批量清除；不会删除会话，也不会清除待回应问题。
- 清除后重启不重复提醒，同一会话下一轮完成会重新提示；不与 Codex 同步已读。

已知问题与范围
- 部分菜单栏环境下，右上角 CueSpec 图标不显示；小岛内有设置入口。
- 同会话发送依赖 Codex 非公开桌面 IPC，Codex 升级可能影响兼容性。
- 异步问题可在小岛选择或填写答案，再点击“提交回答”；同步问答仍需回原会话。
- 输入文字与光标的自然行高修正已通过隔离检查，仍需用户实际视觉确认。
- 双屏拔插、睡眠唤醒、长时间使用与全新系统安装仍有待补充实机验收。
- 本包只包含 Mac 客户端；Windows、iPhone、Android 不在本次交付内。

更新与回退
本版使用 https://updates.cuespec.ai/appcast.xml 自动检查更新。默认后台下载，
在你主动退出 CueSpec 时安装；设置、额度面板可主动检查并更新。
0.2.1 及更早版本没有自动升级器；此前使用 GitHub 更新源的本机版本，
也需要按上面的安装步骤手动替换一次。之后使用 R2 更新源。
草稿和语音状态保存在 ~/Library/Application Support/CueSpec；
账号凭据在系统钥匙串中。替换应用不需要删除这些数据。
若从个人开发签名版本升级到此公司发行签名包，系统可能要求重新授权麦克风、
辅助功能或钥匙串访问；按实际系统提示处理，不要删除原有资料。
若辅助功能开关已开，但 CueSpec 仍显示未允许，请在系统设置移除旧 CueSpec
授权条目，再添加 /Applications/CueSpec.app 并开启；旧签名的授权可能无法匹配新版。
回退前保留旧应用，并备份上述用户数据目录；不要同时运行多个版本。

校验
本版文件位于 https://updates.cuespec.ai/v0.3.0-build20/ 。
从同一路径下载 ZIP、Mac-install.txt、release-notes.txt、appcast.xml、
build-info.json、SHA256SUMS，放在同一目录，运行：shasum -a 256 -c SHA256SUMS。
build-info.json 记录源代码提交、版本、构建号和安装包 SHA-256。

第三方许可位于 CueSpec.app/Contents/Resources/Notices。