NotchNotes 是一款原生 macOS 刘海笔记应用。将鼠标移到或点击屏幕顶部，即可快速记录 Markdown 笔记、暂存文件或防止 Mac 自动休眠。
下载包同时支持 Apple Silicon 和 Intel，要求 macOS 14 或更高版本。
- 解压
NotchNotes.zip，将NotchNotes.app移入“应用程序”。 - 首次启动时右键点击应用，选择“打开”。
- 如果 macOS 仍然拦截，请前往“系统设置 → 隐私与安全性”，点击“仍要打开”。
当前公开构建使用临时签名，尚未经过 Apple 公证，因此首次启动会出现安全提示。正式免提示分发需要 Developer ID Application 证书和 Apple 公证。
启动后，将鼠标移到或点击屏幕顶部中央。可直接记录 Markdown 笔记；将文件拖入底部暂存区即可快速取用，再拖到 Finder、应用或网页上传区。暂存区只保留文件引用，不会移动或删除原文件。
如果顶部触发区影响菜单栏操作，可点击菜单栏的 NotchNotes 图标打开笔记，再在编辑器的齿轮菜单中选择 Menu Bar Only。此模式会隐藏顶部触发区，停用顶部悬停、点击和拖入唤起；点击菜单栏图标仍可打开笔记、使用文件暂存区，按 Esc 或 ⌘W 收起。设置会在重启后保留，也可随时切回 Hover 或 Click。
笔记和暂存记录保存在本机，不会因覆盖安装应用而删除。
swift run NotchNotes./Scripts/package-app.sh
open dist.noindex/NotchNotes.app脚本会生成 Apple Silicon + Intel 通用应用、ZIP 附件和 SHA-256 校验文件。正式签名和公证时可设置：
SIGN_IDENTITY="Developer ID Application: Your Name (TEAMID)" \
NOTARY_PROFILE="notary-profile" \
./Scripts/package-app.sh- 每次推送
main，GitHub Actions 会先运行测试，再构建通用应用，并自动覆盖latestRelease。 - 官网下载按钮固定指向
releases/latest，因此不需要手动修改下载地址。 - 推送
v*版本标签时，仍会生成对应的版本快照 Release。 - 官网由 GitHub Pages 读取
main分支的docs目录，页面修改推送后会自动部署。
如果测试或构建失败，Release 不会被覆盖，用户仍会下载上一份验证通过的版本。
- Swift + AppKit：浮层、窗口层级、屏幕定位和顶部触发行为。
- SwiftUI：笔记和文件暂存界面。
- UserDefaults：轻量本地数据存储。
- MarkdownEngine：Markdown 编辑和内嵌图片。