Repository navigation
壶中天 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 拦下——放行一次即可,之后不再拦:
- 双击「壶中天」,出现「Apple 无法验证其是否包含恶意软件」这类提示时,点完成;
- 打开系统设置 → 隐私与安全性,往下滚到「安全性」一栏,点「仍要打开」;
- 输入密码确认,再双击一次就进去了。
第 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 项目及其维护者无隶属关系,也未获其背书。