Repository navigation
Releases: diguike/KeepMyMacAwake
Release list
KeepMyMacAwake 0.5.0 — 暖阳配色
换上暖阳配色的 0.5.0 体验版：更亮、更活泼，不再是一片黑。
变化
- 暖阳配色：主色取自作者头像的橙色
#FF6A2B，搭配社区色卡中常见的奶油色与杏色。页面为奶油白，状态卡为杏色渐变，大号数字用深棕色；深色模式为暖棕色调。 - 橙色只用在需要你操作的地方：开始按钮、选中的场景、开关与滑块；剩余时间刻度从琥珀色渐变到橙色，运行中的状态圆点带一点光晕。
- 提示更易读：白底上的警告小字改用加深的橙色，“可以合盖”等提示使用深棕色。
- 新图标：橙色底、白色杯子与热气、奶油色月牙。
- README 展示图已更新为新配色。
安装与升级
macOS 14+，Apple Silicon / Intel 通用包。DMG 打开后将 App 拖到“应用程序”；ZIP 解压后放入“应用程序”。包内附中文安装说明，SHA256SUMS.txt 可核对下载完整性。
从旧版升级：先在旧版“设置”里点“卸载后台组件…”（0.2.x 为“停止并移除组件”），确认成功后替换 App，打开新版后在合盖场景点“安装后台组件”。本机实测从 0.4.0 升级后原有系统授权会保留；如果系统再次要求，请本人用触控 ID 或密码确认。
当前使用 Apple Development 证书签名，尚未经过 Apple 公证，仍为 Pre-release。首次下载可能被 macOS 阻止；确认来自本官方仓库后，按 Apple 官方说明 到“系统设置 → 隐私与安全性”选择“仍要打开”。
验证
- 本机 66 项 XCTest 执行，65 项通过、1 项按需截图测试跳过；通用 App/helper 严格签名、DMG 校验与只读挂载、ZIP 解包检查通过。
- 在本机安装版上实测：从 0.4.0 卸载后台组件并升级，重新安装后台组件后显示“已连接”；真实窗口中开关、选中场景与开始按钮为橙色；设置页显示 0.5.0；菜单栏面板内容正确。
- PR #11 及合并后 main 的 Linux、macOS、Windows x64/ARM64 CI 全部通过。
- 本次只改界面与图标，没有改动保持唤醒和合盖逻辑，也没有进行新的物理合盖测试；不同机型的完整合盖验收仍在进行，详见 docs/status.md。
请放在通风处使用。本应用只负责让 Mac 保持唤醒，不判断 AI 任务是否完成。
KeepMyMacAwake 0.4.0 — 更克制、更精致
重新打磨的 0.4.0 体验版：更克制的配色、更少的文字、更像一款精致的原生 Mac 软件。
变化
- 中性配色：暖灰底、白色卡片、细边框与轻阴影；主按钮和选中状态用近黑色，开关为石墨灰。颜色只表示状态：绿色运行中，橙色警告，红色睡眠设置未恢复。深色模式同样适配。
- 数字为主的状态区：大号细体数字显示剩余或已运行时间（如“6 小时 28 分”），下方是细刻度条；未开启时直接显示这次将运行多久。
- 更少的文字：去掉标语、重复的状态徽章、使用须知卡和成功提示；说明移到悬停提示里，消息区只显示需要你处理的问题。停止原因改为简短短语，如“时间到”“电源已断开”。
- 菜单栏面板：右上角圆形图标按钮（更多选项、设置、退出）；运行中显示时段、电源、网络、散热，合盖时显示后台组件状态。
- 控制窗口：高度随内容自动收放；运行中显示只读的“本次会话”信息；合盖授权就在合盖开关下方；卸载后台组件前会确认。
- 新图标：石墨黑配白色杯子。
- 修正：读不到网络或电量时的停止原因文案；确认框等系统文字显示为中文。
安装与升级
macOS 14+，Apple Silicon / Intel 通用包。DMG 打开后将 App 拖到“应用程序”；ZIP 解压后放入“应用程序”。包内附中文安装说明，SHA256SUMS.txt 可核对下载完整性。
从旧版升级：先在旧版“设置”里卸载（0.2.x 为“停止并移除组件”）后台组件，确认成功后替换 App，打开新版后在合盖场景点“安装后台组件”。本机实测升级后原有系统授权会保留；如果系统再次要求，请本人用触控 ID 或密码确认。
当前使用 Apple Development 证书签名，尚未经过 Apple 公证，仍为 Pre-release。首次下载可能被 macOS 阻止；确认来自本官方仓库后，按 Apple 官方说明 到“系统设置 → 隐私与安全性”选择“仍要打开”。
验证
- 本机 66 项 XCTest 执行，65 项通过、1 项按需截图测试跳过；通用 App/helper 严格签名、DMG 校验与只读挂载、ZIP 解包检查通过。
- 在本机安装版上实测：从 0.3.1 卸载后台组件并升级，重新连接后台组件；控制窗口随内容自动收放；卸载确认框显示中文并可取消；菜单栏面板内容正确。
- PR #9 与 PR #10 的 Linux、macOS、Windows x64/ARM64 CI 全部通过。
- 本次没有进行新的物理合盖测试；不同机型的完整合盖验收仍在进行，详见 docs/status.md。
请放在通风处使用。本应用只负责让 Mac 保持唤醒，不判断 AI 任务是否完成。
KeepMyMacAwake 0.3.0 — 全新界面与菜单栏信息面板
界面全新设计的 0.3.0 体验版：更好看、用词更准确，并新增菜单栏信息面板。
新功能与改进
- 菜单栏信息面板：点击菜单栏杯子图标，即可查看剩余或已运行时间、开始时刻、规则、电源与电量、网络、散热状态、合盖组件和上次结束原因；也能直接切换场景、开始、停止或延长 15 分钟。图标用空杯 / 实心杯 / 警示三角区分状态。
- 控制窗口重新设计：状态卡集中显示剩余时间、预计结束和电源/网络/散热；场景改为两列卡片并附一句用途说明；每个开关都写明效果；开始、停止、延长固定在底部；窗口高度随屏幕自适应。浅色、深色模式均已适配。
- 打开即可使用：去掉首次“开始使用”拦截页，改为可关闭的“使用须知”卡片。
- 用词更准确：统一使用“保持唤醒”“未开启”“睡眠”（macOS 中文里 sleep 是睡眠，休眠是另一回事）；屏幕模式改为“允许熄屏 / 屏幕常亮 / 调暗常亮”；“热压力”改为“散热状态”。已保存的场景和设置继续有效，无需重新配置。
- 上次结果更易读：拆成“上次结束 + 原因”和“时间段 · 运行时长”两行，并在本机跨重启保留。
- 包含源码 0.2.2 中尚未发布的改进：可选的结束通知（默认关闭）、“有网时”改名为“外出合盖”、未签名构建不再尝试连接已安装的后台组件。
安装与升级
macOS 14+，Apple Silicon / Intel 通用包。DMG 打开后将 App 拖到“应用程序”；ZIP 解压后将 App 放入“应用程序”。包内附中文安装说明，SHA256SUMS.txt 可核对下载完整性。
从 0.2.x 升级：先在旧版“设置”中点击“停止并移除组件”，确认恢复完成后替换 App，打开新版后在合盖场景点击“安装后台组件”。本机实测升级后原有系统授权会保留；如果系统再次要求，请本人用触控 ID 或密码确认。
当前使用 Apple Development 证书签名，尚未经过 Apple 公证，仍为 Pre-release。首次下载可能被 macOS 阻止；确认来自本官方仓库后，按 Apple 官方说明 到“系统设置 → 隐私与安全性”选择单 App 的“仍要打开”。公司电脑若不允许该操作，请遵循管理员策略。
验证
- 本机 65 项 XCTest 执行，64 项通过、1 项按需截图测试跳过；通用 App/helper 严格签名、DMG 校验与只读挂载、ZIP 解包检查通过。
- 在本机安装版上实际操作：从 0.2.1 卸载后台组件并升级，重新注册后台组件并连接；从菜单栏面板开启一次普通会话，确认剩余时间、预计结束、系统断言和菜单栏倒计时，停止后断言释放；“设置…”会先收起面板再打开设置页。
- 远端 PR CI 与 合并后的 main CI 均通过：Linux、macOS 与 Windows x64/ARM64 全部任务。
- 本次没有进行新的物理合盖测试。作者此前自用时合盖可用，不同机型的完整合盖验收仍在进行，详见 docs/status.md。
请放在通风处使用。本应用只负责让 Mac 保持唤醒，不判断 AI 任务是否完成。
KeepMyMacAwake 0.2.1 — 修复界面周期性闪动
修复界面周期性闪动的 0.2.1 体验版。
- 后台检查不再切换“正在处理”或短暂禁用按钮；相同状态不重复刷新界面。
- 延迟返回的后台状态不会覆盖刚完成的开始、停止或恢复操作。
- 夜间遮罩复用原有窗口，重复屏幕通知不再撤掉重建；停止后的排队通知不会重新变暗。
- 保持每秒本地保护和每五秒后台心跳，计时与安全保护继续工作。
macOS 14+，Apple Silicon / Intel 通用包。DMG 打开后将 App 拖到 Applications；ZIP 解压后将 App 放入“应用程序”。包内附中文安装说明。SHA256SUMS.txt 可用于核对下载完整性。
升级前在旧版设置中点击“停止并移除组件”，确认恢复完成后替换 App，再重新安装／检查授权。合盖组件需要目标 Mac 本人批准。
验证：arm64 与本机 Rosetta x86_64 各 49 项 XCTest 通过，其中 7 项为本轮新增回归。通用 App/helper 严格签名、DMG 校验与只读挂载、ZIP 解包检查通过。物理合盖及另一台 Mac 的完整兼容性仍待验收。
当前使用 Apple Development 证书签名，尚未 Apple 公证，仍为 Pre-release。首次下载可能被 macOS 阻止；确认来自本官方仓库后，按 Apple 官方说明 到“系统设置 → 隐私与安全性”选择单 App 的“仍要打开”。公司电脑若不允许该操作，请遵循管理员策略。
源码与实际验证记录：docs/status.md。
远端验证：PR CI 与 合并后的 main CI 均通过：Linux 32 项测试、macOS 49 项测试与双架构构建。
KeepMyMacAwake 0.2.0 — macOS 通用体验版
可下载的 0.2.0 体验版，用于在另一台 Mac 上试用。安装包与源码均在本仓库，发布源提交 2845ada。这是开发签名的 Pre-release，尚未经过 Apple 公证。
下载与安装
- 推荐下载 KeepMyMacAwake-0.2.0-macOS-universal.dmg（约 2.1 MB），打开后把 App 拖到 Applications。
- 也可下载 ZIP（约 1.7 MB），解压后把 App 放入“应用程序”。
- macOS 14 或更新版本；App 和后台组件都包含 Apple Silicon arm64 / Intel x86_64。
- 中文安装说明和 MIT 许可证已放入两种包内；SHA256SUMS.txt 可核对下载完整性。
首次打开
本包使用 Apple Development 证书签名，严格签名校验通过，但默认 Gatekeeper 评估不通过；它不是已公证的正式安装包。确认下载自本仓库后，按 Apple 官方说明，尝试打开 App，再到“系统设置 → 隐私与安全性”使用针对该 App 的“仍要打开”，完成本人确认。无需关闭全局安全保护或删除下载隔离属性。公司管理的 Mac 可能禁止该例外，届时遵循管理员策略。
体验功能
原生菜单栏杯子图标和独立控制窗口，支持日常、夜间、接电合盖、有网时四个场景；定时／永久保活、三种屏幕模式、续时 15 分钟、电量／网络／热状态保护、登录启动与偏好保存。重启只保存偏好，不自动续跑保活会话。
合盖模式需要在目标 Mac 单独批准后台活动：App → 接电合盖 → 安装／检查授权或打开系统授权 → 系统设置／通用／登录项与扩展 → 启用 KeepMyMacAwake，并使用触控 ID 或登录密码认证。等 App 显示“后台组件已连接”，先开盖测试 1 分钟及停止恢复，再测试物理合盖。
验证与范围
- 42 项 Mac 原生／逻辑测试和 32 项 Linux 逻辑测试已通过；x86_64 的同一 42 项测试也在 Apple Silicon 上通过 Rosetta 运行成功（不是物理 Intel 机验收）。
- 本版本 CI #38051967579 的 Linux 测试、Mac 测试和双架构 release 构建全部通过。
- 双架构 App／helper 签名、最低系统版本、DMG 校验与只读挂载、ZIP 解包后的完整签名均已检查。
- 普通保活、真实计时到期、夜间遮罩撤销、续时和设置保存已在本机操作验证。
- 物理合盖、另一台 Mac、强杀 helper／重启／卸载的系统级矩阵尚待完成；不把模拟测试计作这些项目通过。
- 夜间柔光采用临时画面遮罩，不调节硬件背光；网络条件是可用路径，不保证远端服务可达。请保持通风，勿在放入包内时开启合盖保活。