壶中天 v0.5.0

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

这是 v0.5.0（2026-10-28）。本版一件事：系统门槛从 macOS 26 降到 macOS 15（Sequoia）——此前在 15.x 上安装会在启动时被系统弹「不能与此版本的 macOS 配合使用」拒绝，现在起 15.x 可正常安装运行；液态玻璃相关观感在 15 上自动降级为核心功能无感的普通模糊。

安装

要求 macOS 15（Sequoia）及以上、Apple 芯片（arm64）（液态玻璃观感需 macOS 26，低版本自动降级为带圆角的普通模糊）。

方式一 · DMG：下载 Gourd-0.5.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.5.0。

方式三 · 自己构建（需要 Xcode）：sh tools/build.sh --install

应用是菜单栏小工具（没有 Dock 图标）：鼠标移到屏幕顶部中间即展开；右键面板（展开或折叠都行）有「设置 / 退出」。

校验

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

9b12ec867a7f5a2fbb7b899f7fa6fedf67ec7a051dbc67b17a38cb1ad4281feb  Gourd-0.5.0.dmg

这一版改了什么

支持 macOS 15 起

• 此前的问题：15.x（如 Sequoia 15.6）安装 v0.3.0 / v0.4.0 后，启动被系统拒绝——「应用程序『壶中天』的这个版本不能与此版本的 macOS 配合使用」（应用声明了最低 macOS 26）。
• 现在：安装声明的最低系统与二进制最低系统均降为 15.0。26 专属的液态玻璃一族 API 在代码里本就全部有守卫（Debug 一直按 14.6 编译），Release 按 15.0 编译零可用性错误。
• 观感降级：面板背景 / 通知浮层的「液态玻璃」在 15 上自动回落为带圆角的普通模糊（本版补了圆角，此前是矩形模糊）；OSD 与锁屏的 liquid 选项在 26 以下不可选。核心功能不受影响。
• 命令行安装加系统版本门：低于 macOS 15 现在会先明确提示「需要 15.0 及以上」，而不是装完才在启动时被拒。
• 升级注意：从 0.3.x 直接升上来的用户，AI 日程生成的 API Key 需要在「设置 → 集成 → AI 模型」重输一次（0.4.0 起密钥改存本机文件）。

文档

• **图文使用手册（单文件 HTML，含截图）**挂进仓库与 README：在线预览（图片内嵌、可离线传阅）；截图中涉及的个人信息已做模糊处理，启动台配图为演示数据。
• README 功能段对齐当前形态（首页三带、AI 日程生成、会议一键入口、通知浮层分屏、屏幕歌词取词）。

使用手册

安装、权限清单、界面速览、每一项设置的逐项说明、组件页与各模块、快捷键、常见问题、更新与卸载：

• 图文使用手册（HTML，含截图）
• 用户手册
• 设置参考
• 常见问题

说明与已知限制

• macOS 15 上没有 Liquid Glass：液态玻璃相关观感自动降级（见上）；这是系统差异，不是故障。
• 15.x 真机复核状态：本版在开发机（macOS 27）通过全部既有门禁（950 条单元测试 0 失败、Release 构建与出厂复核）；15.x 的支持建立在逐项可用性守卫与组件内降级链之上，尚未在 15.x 真机逐项复核——遇到问题请提 issue。
• 未公证：首启需按上面第 2~3 步手动放行。开发与发布全程本机完成，不走公证流程。
• 没有应用内更新：关于页的「检查更新」不可用——升级用新 DMG 覆盖安装，或重跑一遍命令行安装脚本即可；偏好、权限、登录项都不会丢。
• 权限按需给：通知列表要完全磁盘访问、镜子要摄像头、计时器同步要辅助功能。功能全是本地实现，本项目不新增出站请求、不上传数据（AI 生成、歌词与锁屏天气按各自开关联网）；缺权限只是对应功能降级，不会崩溃。
• 只出 Apple 芯片（arm64）构建，Intel 机器当前不支持。
• 界面语言：主体为中文；少数上游页面/项保留英文（例如「控制」页的材质下拉）。
• 浅色外观 + 玻璃底下，白字在接近纯白的壁纸/窗口区域仍有对比度上限——面板内文字已统一到白系，仍属已知边界。
• 通知浮层默认只在主屏：想上外接显示器，点通知块表头那颗开关（或去设置 → 实时活动 → 通知浮层）。

许可

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

壶中天 v0.4.0

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

这是 v0.4.0（2026-10-28）。自 v0.3.0 起累计 7 个提交：日程解析改为模型直出（AI Key 迁移到文件凭据）、日历编辑按入口分叉与保存简化，以及通知块表头的外接显示器快捷开关。

安装

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

方式一 · DMG：下载 Gourd-0.4.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.4.0。

应用是菜单栏小工具（没有 Dock 图标）：鼠标移到屏幕顶部中间即展开；右键面板（展开或折叠都行）有「设置 / 退出」。

校验

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

bce67d970eb716166d112a05522abce5cb2653e5a6efc2cbfe5ca6b4c4cce091  Gourd-0.4.0.dmg

这一版改了什么

日历与 AI

• 日程解析改为模型直出：原文直接交给模型，模型返回规范字段（标题 / 日期 / 起止 / 全天 / 地点 / 链接 / 时区），代码不再按固定语法硬校验——原文可以是任意格式；思考模式关闭，生成更快。
• AI Key 改存文件凭据：只存在本机 ~/Library/Application Support/Gourd/AICredentials/（目录 0700、文件 0600），生产路径不再读钥匙串。从旧版升级注意：第一次生成若提示「未配置凭据」，到「设置 → 集成 → AI 模型」重新输入一次 API Key 即可，之后不再有钥匙串弹框。仓库与发布产物永不包含密钥。
• 编辑按入口分叉：从首页今天带进的编辑，「返回」与「保存」后都回首页；从日历面板进的照旧回月历。
• 「下午三点」不再丢时刻：只有时刻、没有日期时，时刻保留、锚到参考日，只确认日期——不再退回表单的默认整点。
• 保存简化：「确认日期 / 确认时间」阻断按钮与「改为手工填写」移除；保存只看标题非空 + 目标日历，日期时间在表单里自己核对。编辑页底部按钮重做（取消浅底、保存为主）。
• 会议识别修订：化小易 / 华为标签识别为华为云会议；没有会议内容不再默认贴腾讯。

通知

• 表头「外接显示器」快捷开关：直连设置页「在外接显示器上也显示」同一颗开关——通知块表头一键翻转，下一条通知即生效，不用进设置。

其他

• 首页今天带「+」直达日历新建页；启动台快捷启动支持拖动排序。
• 安装脚本：退出旧实例按 quit → SIGTERM → SIGKILL 逐级降级并校验（不再出现「装成功、跑的还是旧进程」）；--install 装完自动启动。

使用手册

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

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

说明与已知限制

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

许可

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

壶中天 v0.3.0

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

这是 v0.3.0（2026-10-16）。自 v0.2.0 起累计 111 个提交：通用 AI 独立配置 + 日历面板第二轮（一张表单 + 显式生成 + 列表行就地操作）+ 会议入口 + 桌面歌词取词，以及首页 / 通知 / 今天带的一批尺寸与观感修订。

安装

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

方式一 · DMG：下载 Gourd-0.3.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.3.0。

应用是菜单栏小工具（没有 Dock 图标）：鼠标移到屏幕顶部中间即展开；右键面板（展开或折叠都行）有「设置 / 退出」。

校验

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

35134fc91aaea111394c4fdce11cb79a00bc3e54630a01e395c8384a2b576822  Gourd-0.3.0.dmg

这一版改了什么

通用 AI 独立配置

• 供应商 / 接口地址 / 密钥 / 模型分开配置，本机模型与各家兼容接口走同一条契约；密钥只进系统钥匙串。
• 日程生成止于可确认的草稿：生成失败只留一行原因 + 重试 + 「改为手工填写」，不会动你已经写好的内容。

面板日历第二轮

• 编辑 / 新增统一成一张两列表单：目标日历与全天 / 起止 / 地点与链接并排，标题与备注整宽。
• **显式「生成」**取代此前的 800ms 自动解析（⌘↩ 同效）——输入不会被后台悄悄改写。
• 列表行整行点开浮窗，行内可直接编辑与删除（删除需原地确认）。
• 编辑页与列表卡片字号 +3；编辑档高度按档自适应，三种入口都一屏放完、不出滚动条。

会议入口一键直达

• 识别出会议号后出面一枚 22pt 按钮直接打开（华为 cloudlink / 腾讯 wemeet 深链），右键给其余动作（最多 4 项，含入会密码）。
• 多个候选不猜——只在唯一配对时才给出一键入口。

桌面歌词

• 先读本机播放器自己的歌词缓存，再走候选查询阶梯（歌手别名 / 团体后缀 / 多歌手 / 歌名版本标注 / 只按歌名 + 时长吻合）。
• 词库的**瞬时故障不再被当成「这首歌没有歌词」**缓存下来（稍后自动重试一次，点歌词键也会立刻再问）。
• 首页音乐块的封面点一下 = 打开正在播放的那个音乐软件。

首页 · 通知 · 今天带

• 首页底部留白归可变流：原本空着的那 20pt 里，12pt 给通知与今日两块（变高、贴到面板下缘之上）、8pt 留作缝；面板高度不变。
• 今天带「下一个」段居中：两侧的缝等宽（改前富余全落在右侧）。
• 通知浮层默认只上主屏：设置页新增「在外接显示器上也显示」开关，改设置下一条通知即生效。
• 面板右键菜单加「退出」（菜单栏图标关掉时的唯一退出入口）。
• 设置页「通知浮层」一节此前是英文直显，本版补齐中英双语。

修复

• 日历草稿假提示：打开一条日程、一个字不改就回到月历，列表顶部不再冒出「有未保存的日程 · 继续编辑」（离开编辑档时没改过的稿直接丢掉，改过的照旧留着）。
• 歌词层被拖出屏幕后找不回来：显示前夹回屏内。
• 编辑 / 新增档整个期间不再被自动收起打断。

使用手册

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

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

说明与已知限制

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

许可

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

壶中天 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 项目及其维护者无隶属关系，也未获其背书。

壶中天 v0.1.0

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

这是 v0.1.0（2026-10-08 重发）。对外只保留这一个版本号：首发 0.1.0 之后的打包与安装渠道修正（原先单独发过一次 0.1.1，已撤下）与随后的面板修复都收在这一版里。

安装

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

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

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

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

第 1 步不能跳：只有先试过一次、被拦下，「仍要打开」按钮才会出现在系统设置里。
（上一版说明里写的「右键 → 打开」在 macOS 15 之后已经不可用，本版说明已改正。）

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

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

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

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

校验

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

93e39ba128192eb7a07ff48e4885bcf0f04395c3e143b46c225e548bfee816cb  Gourd-0.1.0.dmg

这一版改了什么

装上就能用（原 0.1.1 的内容）

• 安装说明改正：删掉了「右键 → 打开」——macOS 15 起 Apple 移除了这个绕过入口，而本应用要求 macOS 26，用户系统上根本没有这条路。现在统一写「系统设置 → 隐私与安全性 → 仍要打开」。
• 新增命令行安装：curl 下载的包不带隔离标记，首启不会弹任何提示；脚本会先校验 SHA256 再安装，校验不过就中止、什么都不落。
• 出厂包不再带调试权限（get-task-allow），并补齐 SHA256SUMS 供校验。
• 系统要求由包自身强制：上一版的包在系统层面声明的最低版本比实测低，旧系统可能装上之后才出问题；这一版起在启动前就会明确挡下。

面板修复（0.1.1 之后）

• 切页高度单步到位：自适应高度下「启动台 → 首页」这类切换不再出现「面板不退、底下空一片」——高度账本的槽位口径改为「这一页的自然内容高」（ADR-0015）。
• 笔记列表页与剪贴板页贴内容：卡片网格计入自然高，面板跟着卡片收（实测 682 → 302 / 240）；笔记编辑档保持固定高度。
• 通知页：页脚那两三行通道说明收成页头下方一行（只在有通知时出现），空态只剩「暂无通知」。
• 组件设置：「面板组件」节里的笔记行可上下移动；新增**「功能组件」**节收「只有开关、在面板 tab 条上没有位置」的元素（剪贴板 / 取色器 / 非「标签页」档的计时器）。
• 笔记编辑器底色跟随「外观 → 面板背景」，不再写死黑底。

使用手册

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

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

说明与已知限制

• 未公证：首启需按上面第 2~3 步手动放行。开发与发布全程本机完成，不走公证流程。
• 没有应用内更新：关于页的「检查更新」不可用——升级用新 DMG 覆盖安装、或重跑一遍命令行安装脚本即可；偏好、权限、登录项都不会丢。
• 权限按需给：通知列表要完全磁盘访问、镜子要摄像头、计时器同步要辅助功能。功能全是本地实现，本项目不新增出站请求、不上传数据（歌词与锁屏天气按各自开关联网）；缺权限只是对应功能降级，不会崩溃。
• 只出 Apple 芯片（arm64）构建，Intel 机器当前不支持。
• 界面语言：主体为中文；少数上游页面/项保留英文（例如「控制」页的材质下拉、「实时活动」页的 Notification HUD 一节）。
• 「扩展」页是上游的第三方扩展通道：没有 App 使用时那一页是空的，属正常。
• 面板过窄时首页块按序从尾部丢弃（条尾 ＋N）——拉宽面板即可。

许可

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