macOS 端用户指南
啵灵日程 macOS 版的核心用法都在这里。读完大概 5 分钟，足够你把日子安排得明明白白。
在用 iPhone？跳到 iOS 端用户指南。
第一次打开
下载安装啵灵日程后第一次启动，会弹出引导卡片带你过一遍核心功能。建议跟着走完，免得错过一些藏起来的入口。
走完引导后，需要登录啵灵账号才能进入主界面（v1.1.0 暂不提供本地离线模式，登录是必需的）。账号统一在 auth.boling.fun 注册和管理：点登录按钮 → 跳到浏览器走 SSO → 完成后浏览器自动回跳回 app。
登录后你的事项会自动云同步，换设备登录同一个账号即可看到一致数据。
主界面布局
左侧栏 + 主区。
侧栏有两个顶级入口：
- 日历视图：含周视图和月视图（在主区 header 里切换）
- 待办清单：所有不带时间的事项
侧栏下半部分是日历分组列表（用颜色区分），下方是用户卡片 + 设置入口（齿轮）。
侧栏可以收起——点左上角的侧栏图标，主区会扩到全宽；想再展开点回去。
创建事项
三种方式，按场景选：
方式 1：⌘N 标准创建窗
按 ⌘N，弹出完整的创建窗：标题、日期、时间（可设全天）、所属日历、提醒、重复规则、备注。适合需要详细配置的事项。
方式 2：在视图里 inline 创建
不同视图操作方式不一样：
- 周视图：双击空白的时间格
- 月视图：单击任意日期格 → 弹 popover → 在 popover 里 inline 输入
- 待办视图：顶部有个常驻输入栏，敲一句回车即创建到今天；行间双击也能就地创建
视图里 inline 创建出来的事项默认只带标题和日期/时间，后续可以再编辑补充。
方式 3：⌃Space 全局快速添加（最有特色）
按 ⌃Space（默认热键，可在设置改），不管你在什么 app 里都能召出一个浮窗。
输入一句自然语言，比如：
明天下午三点开会周五晚上 8 点和朋友吃饭，海底捞下周一上午 10 点交报告
回车，AI 自动识别出日期、时间、地点、标题，弹一张预览卡让你确认。点击确认才会真的写入；不满意可以取消重来。
更进一步，一次性描述多个：
周三下午三点开会、周五晚上和朋友吃饭、下周一上午交报告
AI 会拆成多条独立事项一起预览。
AI 解析功能可在「设置 → 智能 → AI 自然语言识别」开关里关掉。关闭后
⌃Space输入的整句会直接作为标题落到今天，不向任何外部服务发送文本。
多日历分组
事项可以归属到不同的「日历」里，每个日历独立颜色，方便区分工作 / 生活 / 学习等场景。
侧栏「日历」section：
- 未分类：固定首行。新建事项时不选所属日历就归这里。可以右键设为「默认」
- 你的日历：每条一行，左边圆点是颜色，右边的实心 ✓ / 空心圆 表示「显示中 / 已隐藏」
- 顶部
+按钮新建日历（命名 + 选颜色） - 右键任一日历行：编辑（改名/改色）、删除（默认日历不让删）
显示控制：点行右侧的圆点/勾切换"显示/隐藏"——隐藏后该日历下所有事项暂时从主视图消失，再点回来恢复。每条独立控制（不是单选）。
提醒
ItemEditor 里有「提醒」字段，可选：
- 不提醒（默认）
- 事件开始时
- 5 分钟前
- 15 分钟前
- 1 小时前
- 1 天前
到点会通过 macOS 系统通知弹出。首次设提醒时系统会问你要不要授权通知权限，允许即可。授权情况可在「系统设置 → 通知 → 啵灵日程」里查看/调整。
全局快捷键速查
| 快捷键 | 功能 |
|---|---|
⌃Space |
全局快速添加（可在设置改） |
⌘1 |
周视图 |
⌘2 |
月视图 |
⌘3 |
待办视图 |
⌘T |
回到今天 |
⌘N |
新建事项 |
⌘, |
打开设置窗口 |
⌘W |
关闭主窗口（app 留后台，⌃Space 仍可召出） |
⌘Q |
完全退出 |
⌘W 关闭主窗口后，app 不会真退出——这是为了让 ⌃Space 全局热键随时可用。要彻底关掉用 ⌘Q。
设置
两种入口：
- 侧栏底部齿轮按钮 → 在主区显示设置页（带「返回」回主视图）
- 系统标准快捷键
⌘,→ 弹独立 Settings 窗
里头分了 4 块：
偏好
- 时区：默认跟随系统，可手动选常用的几个（北京、香港、东京、纽约、UTC 等）
- 一周起始：周一 / 周日
- 快速添加快捷键：点录制框 → 按下任何组合即重绑
⌃Space那个全局热键。留空 = 禁用 - 默认视图：app 启动时打开哪个（周 / 月 / 待办）
- 外观：跟随系统 / 浅色 / 深色
智能
- AI 自然语言识别：开 / 关。下方一行小字说明 + 引用《隐私政策》§2.3 节
账号
- 你的用户 ID（可复制）
- 打开 auth.boling.fun 链接管理账号
- 退出登录
关于
- 当前版本 + build 号
- 检查更新（DMG 版有，Mac App Store 版没有——MAS 走系统统一更新）
- 后端 URL（便于排查）
- 用户协议、隐私政策链接
- 反馈与帮助 → 发邮件：会唤起系统邮件 app，预填版本/系统信息，发到
developer@boling.fun - 开源致谢（GRDB / KeyboardShortcuts / Sparkle）
同步与登录
登录啵灵账号后：
- 本机所有改动会推到云端
- 启动时拉取云端变化合并到本地
- 离线时正常使用，再次联网后自动同步
- 同一账号在不同 Mac 登录会看到一致数据
登出不会删本机数据；重新登录同一账号会自动合并云端 + 本地差异。
自动更新
- DMG 版通过 Sparkle 后台静默检查；有新版会弹"检查到更新"对话框，由你决定何时安装
- Mac App Store 版走 App Store 自带的更新机制，由系统统一管理
⚠️ DMG 版的早期 build（5/6/7）有自动更新 bug，需要手动下载最新 DMG装一次"洗"成好版本，之后就能正常自动更新了。详见 版本更新。