壶中天 v0.2.0

壶中天（Gourd）是 macOS 上的刘海工作台：把屏幕顶部那一小块做成命令面板——媒体、日历、待办、系统状态、文件暂存、快捷启动与自建小工具都收在这里，一切功能可开关。本仓库是 Atoll（GPL-3.0）的修改版本。

这是 v0.2.0（2026-10-12）。自 v0.1.0 起累计 105 个提交：首页 v5 三带改版 + 首页与日历的轻量交互 + 一批可读性与安装可靠性修复。

安装

要求 macOS 26（Tahoe）及以上、Apple 芯片（arm64）。

方式一 · DMG：下载 Gourd-0.2.0.dmg，打开后把「壶中天」拖进「应用程序」。

应用未公证（本项目不付费走 Apple 开发者计划），所以第一次打开会被 Gatekeeper 拦下——放行一次即可，之后不再拦：

1. 双击「壶中天」，出现「Apple 无法验证其是否包含恶意软件」这类提示时，点完成；
2. 打开系统设置 → 隐私与安全性，往下滚到「安全性」一栏，点「仍要打开」；
3. 输入密码确认，再双击一次就进去了。

第 1 步不能跳：只有先试过一次、被拦下，「仍要打开」按钮才会出现在系统设置里。

方式二 · 命令行（装完不弹任何提示）：从浏览器下载的包会被打上隔离标记，curl 不会——这条路绕开了上面整段。

curl -fsSL https://raw.githubusercontent.com/cmeng-CM/Gourd/main/install.sh | bash

脚本只做五件事：判断架构 → 下载 → 校验 SHA256 → 拷进「应用程序」→ 清理；不写系统目录、不改系统设置。全文就在上面那个链接里，可以先读再跑。装指定版本：| bash -s -- v0.2.0。

应用是菜单栏小工具（没有 Dock 图标）：鼠标移到屏幕顶部中间即展开。

校验

附件的 SHA256（也可下载 SHA256SUMS 用 shasum -a 256 -c SHA256SUMS 自行校验）：

5a09bb38423c98065759cdfdb3de0903356da50d08e0697fd08e98e6f1a7a335  Gourd-0.2.0.dmg

这一版改了什么

首页 v5：三带结构

• 环境带（第一排）：音乐 / 前台应用 / 系统读数（CPU·内存·GPU 三行读数）。
• 今天带（第二排，宿主直渲）：日期 · 农历 · 节假日 + 工作日剩余一行 + 下一个日程与倒计时。
• 可变流：今日清单与通知并排，其余块按你的顺序换行。
• 全宽日历行与「镜子块」退出首页：月历入口仍在面板「日历」页；镜子改由顶栏按钮弹一块面板内浮动镜子。

首页与日历的轻量交互

• 首页今日清单全量滚动（不再按容量截断）；待办圈可独立完成，失败保留原状。
• 日历右栏改成列表 / 详情 / 编辑三页互相替换（不再叠浮层、不再钉住），长备注可读到底。
• 岛内处理普通日程：改标题 / 起止 / 全天 / 地点 / 备注，保存回到真实详情、失败保留输入；删除需原地确认；新增支持指定日期与目标日历。
• 一份内存草稿：返回暂存、脏稿取消要确认、切页 / 收回 / 锁屏不丢、单稿冲突三选；普通退出给「保存并退出 / 放弃并退出 / 取消」。
• 重复、分离、会议邀请、生日与只读日历一律不在岛内改删，转系统应用完整维护。

通知

• 首页通知块的列表不再裁剪：全部已保留通知进块内滚动区。
• 表头新增**「清除」**——与面板同一个动作：只从岛上移除，系统通知中心一条不动。
• 已关闭集合在通知库被重建（记录号回退）时自愈，不再静默吃掉新通知。
• 标题口径按画出来的条数说，不再与列表总数对不上。

尺寸与观感

• 日历页整体等比放大 20%（一个旋钮派生全部尺寸），面板高度随之长高。
• 首页今日块与通知块等分。
• 浅色模式下面板日历页看不清已修：星期行等「次要」文字原先用固定中灰，在玻璃底上对比度归零，现改为白系并收成具名常量。
• 浮动镜子打开后关不掉已修：浮动镜子原先压住顶栏那枚按钮，现在让开顶栏行高，再点一次可收起。
• 面板切 tab 高度平滑（笔记列表档与剪贴板页按内容自动贴合，编辑档保持固定）。

修复

• 前台应用「点了没反应」：窗口最小化 / 在别的空间 → 激活并还原；一个窗口都没有、或窗口停在已断开的显示器上 → 重新打开；并补上应用启动 / 退出的观察者。
• 锁屏 / 收回 / 退出时的草稿保护：失焦暂停改为「无聚合输入才暂停」，实际取消旧计时器，锁屏遍历关闭所有屏幕。

安装与分发

• tools/build.sh --install 装完会对 /Applications/壶中天.app 补一次 LaunchServices 重新登记——少了这一步，应用可能起成没有 UI 会话的实例（菜单栏无图标、退不掉）。

使用手册

安装、权限清单、界面速览、每一项设置的逐项说明（默认值、互斥与灰显条件）、组件页与各模块、快捷键、常见问题、更新与卸载：

• 用户手册
• 设置参考
• 组件页与各模块
• 常见问题

说明与已知限制

• 未公证：首启需按上面第 2~3 步手动放行。开发与发布全程本机完成，不走公证流程。
• 没有应用内更新：关于页的「检查更新」不可用——升级用新 DMG 覆盖安装、或重跑一遍命令行安装脚本即可；偏好、权限、登录项都不会丢。
• 权限按需给：通知列表要完全磁盘访问、镜子要摄像头、计时器同步要辅助功能。功能全是本地实现，本项目不新增出站请求、不上传数据（歌词与锁屏天气按各自开关联网）；缺权限只是对应功能降级，不会崩溃。
• 只出 Apple 芯片（arm64）构建，Intel 机器当前不支持。
• 界面语言：主体为中文；少数上游页面/项保留英文（例如「控制」页的材质下拉、「实时活动」页的 Notification HUD 一节）。
• 「扩展」页是上游的第三方扩展通道：没有 App 使用时那一页是空的，属正常。
• 面板过窄时首页块按序从尾部丢弃（条尾 ＋N）——拉宽面板即可。
• 界面验收口径：首页与日历的交互项以作者在真机上人工逐项复核为准，已于 2026-10-12 完成。日历交互的自动化 UI 套件（16 例）不在验收门内（作者明确不再要求跑自动化）；其代码保留在仓库、环境可用时仍可运行，本机受测试 Runner 初始化超时限制未跑通（见 docs/39 的 D-26）。
• 浅色外观 + 玻璃底下，白字在接近纯白的壁纸/窗口区域仍有对比度上限——本版已把面板内文字统一到白系，仍属已知边界。
• 日历页日格宽度由面板宽决定，放大只作用于高度与字号（格子是 57 × 36，不是正方形）。

许可

GPL-3.0-or-later（沿用上游）。应用工程 fork 自 Ebullioscopic/Atoll（GPL-3.0，基线 v2.3.3-beta.3），其内嵌的 boring.notch 署名与全部上游版权声明原样保留（见仓库的 LICENSE / NOTICE）。本项目与 Atoll 项目及其维护者无隶属关系，也未获其背书。