Repository navigation
Releases
刘海岛 v1.0.4 · 更顺手的拖入接收
拖入接收更方便
- 拿起文字、图片或文件并持续拖拽约 0.35 秒后，刘海岛会主动提供接收入口。
- 新增“光标旁悬浮卡”：接收卡固定出现在拖拽起点旁，只需移动很短距离即可存入。
- 保留“刘海下拉色卡”，可在菜单的“拖入接收入口”中随时切换两种方式。
- 修复三指拖拽可能无法识别的问题，鼠标拖拽和触控板三指拖拽统一使用系统拖拽粘贴板判断。
动画与稳定性
- 拖入展开首帧只绘制形状和接收提示，文件卡片、缩略图与菜单栏扫描延后处理。
- 减少一次同步窗口重绘，并调整弹簧阻尼与响应时间，降低展开时的卡顿与过度回弹。
- 接收入口会避开屏幕边缘和光标本身，支持副屏与负坐标布局。
- 本机构建可通过
.local-signing-identity固定开发证书，避免重复构建后辅助功能授权失效。
安装与兼容性
需要 macOS 14 或更新版本。下载 NotchIsland-1.0.4-universal.dmg，退出旧版后，将“刘海岛”拖到“应用程序”替换安装。
分发包包含 Apple Silicon（arm64）和 Intel（x86_64）架构；Intel 部分经过交叉编译，未在 Intel 实机验证。
分发签名方式沿用 v1.0.3 的 ad-hoc 签名。更新后如辅助功能开关已开启却不生效，请退出应用，在系统设置的辅助功能列表移除旧条目，再添加“应用程序”中的刘海岛并授权、重新启动。
验证
102 项测试通过；通用构建、代码签名、版本信息、许可证文件与 DMG 镜像校验通过。
SHA-256：1ceee55e948ab73a54f310f1635b7cef23bc705ad3b63dd800e9595e7c60ac0
刘海岛 v1.0.3 · 文件内容悬浮预览
文件悬浮预览现在可以看到内容
- Word、PDF 等系统支持预览的文件，悬浮窗改为显示与刘海岛卡片一致的内容缩略图，通常为文档首页。
- 文档预览区域加大，并单独请求高分辨率缩略图，便于查看页面内容。
- 不支持内容预览的格式仍回退到文件图标；双击卡片可用默认程序打开完整文件。
- 更新中英文使用说明，以及文档预览窗口尺寸测试。
安装与兼容性
需要 macOS 14 或更新版本。下载 NotchIsland-1.0.3-universal.dmg，退出旧版后，将「刘海岛」拖到「应用程序」替换安装。
分发包包含 Apple Silicon（arm64）和 Intel（x86_64）架构；Intel 部分经过交叉编译，未在 Intel 实机验证。
本次仅更新文件内容预览，分发签名方式沿用 v1.0.2 的 ad-hoc 签名。更新后如辅助功能开关已开启却不生效，请退出应用，在系统设置的辅助功能列表移除旧条目，再添加「应用程序」中的刘海岛并授权、重新启动。
验证
90 项测试通过；通用构建、代码签名和 DMG 镜像校验通过。
刘海岛 v1.0.2 · 稳定悬浮预览 + 图片与文件预览
更新内容
- 修复文本悬浮提示时有时无的问题：改用独立预览窗口，停留约 0.3 秒显示，同一卡片内移动不再反复重置计时。
- 新增图片悬浮预览：显示等比例大图，使用独立的大尺寸缩略图缓存。
- 新增文件悬浮预览：放大显示文件图标，同时展示文件名与大小。
- 快速切换卡片、滚动、拖拽、打开右键菜单或收起刘海岛时，及时取消旧预览，避免显示错误条目或残留窗口。
- 修正卡片可见区域的命中边界和预览窗口尺寸，支持屏幕边界定位。
长文本预览最多显示 18 行，双击卡片可用默认程序查看完整内容。
验证
- 90 项自动化测试通过，包含悬停计时、卡片裁剪、窗口尺寸、屏幕定位和缩略图缓存隔离。
- 使用独立测试数据检查了文本、图片和文件图标的预览渲染。
- 分发包为 arm64 + x86_64 通用二进制；Intel 部分经过交叉编译，未在 Intel 实机验证。
安装
需要 macOS 14 或更新版本。下载 NotchIsland-1.0.2-universal.dmg，退出旧版，再将镜像中的「刘海岛」拖进「应用程序」替换。
延续现有版本的 ad-hoc 签名；更新后如果菜单栏图标功能提示权限失效，请在「系统设置 → 隐私与安全性 → 辅助功能」中重新授权。
刘海岛 v1.0.1 · 通用二进制 + 文本拖出兼容性
这个版本主要解决什么
Intel 机型不用再自己编译了。 发布包改成通用二进制（arm64 + x86_64），下载下来两种机型都能直接跑。需要说明的是：作者手上只有 Apple Silicon 机器，Intel 那一半只做过交叉编译，没有实机验证，遇到问题请提 Issue。
从刘海岛拖出文本，在更多应用里能落下去了。 之前只注册了默认的文本表示，一些原生控件和老式应用不读 public.utf8-plain-text，只请求 public.plain-text 或 UTF-16，富文本编辑器则优先要 RTF/HTML，结果是拖过去什么都没有。现在同时提供 text / plain-text / UTF-8 / 两种 UTF-16 / RTF / HTML，由接收方按自己支持的类型协商。
新功能
「空闲时显示」偏好（菜单栏 → 空闲时显示）。可以让岛在鼠标离开后停在悬停态，实时功耗和暂存数量一直可见，而不是缩回原生刘海。默认仍是「收起（原生刘海）」，行为和以前一致。
修复
- 全屏应用退出后，选了「悬停」的用户不会再被卡在收起态——之前要手动划过刘海才恢复。
public.utf16-plain-text不再错误地带上 BOM。这个 UTI 约定是主机字节序且不带 BOM，之前和public.utf16-external-plain-text共用了同一份带 BOM 的数据，走这条分支的接收方会在正文开头多出一个不可见的 U+FEFF。- 辅助功能授权提示补充了说明：ad-hoc 签名下每次更新签名都会变，系统会当成新应用，需要先关掉开关再重新打开，然后重启应用。
项目本身的一些变化
- 补了 80 个单元测试，覆盖刘海几何计算、粘贴板解析、暂存存储、powermetrics 输出解析、文本拖拽编码。
- 加了 GitHub Actions CI，每次推送都会构建、跑测试、打包
.app，并校验发布包确实是双架构。 - LICENSE 恢复成标准 MIT 文本，GitHub 现在能正确识别（之前显示为 Other）。第三方声明仍在 THIRD-PARTY-LICENSES.md。
- 新增 CONTRIBUTING.md 和 issue/PR 模板。
- 开了讨论区：不确定是不是 bug、想问怎么用，去讨论区比开 Issue 合适。
安装
下载 NotchIsland-1.0.1-universal.dmg，打开后把「刘海岛」拖进「应用程序」。首次打开若被系统拦截，在访达里右键点击应用 → 打开。
仍是 ad-hoc 签名，所以更新后需要到「系统设置 → 隐私与安全性 → 辅助功能」里重新授权（先关掉旧的开关再打开）。
需要 macOS 14 或更新版本。
刘海岛 v1.0.0
把 MacBook 的刘海变成一个多功能岛：文件中转、找回被遮挡的菜单栏图标、实时功耗监测。
本版本起项目更名为「刘海岛 / NotchIsland」，此前叫「中转站 / NotchShelf」。
如果你装过旧版本，建议先把旧的 NotchShelf.app 删掉再安装。
安装
- 下载下方的
NotchIsland-1.0.0-arm64.dmg - 打开后把 NotchIsland 拖进「应用程序」文件夹
- 首次打开若被系统拦截，在访达里右键点击应用 → 选择「打开」
装好后菜单栏会出现一个托盘图标，鼠标移到刘海上即可展开面板。
系统要求
- macOS 14 或更高版本
- Apple Silicon（arm64），Intel 机型请从源码自行编译
主要功能
- 文件中转：拖文件进刘海暂存，切到任意应用再拖出来。拖出为复制语义，不会移走原件
- 剪贴板：
⌃⌥C手动存入，也可开启自动收存，文本与链接会渲染成便签卡片 - 菜单栏图标：找回被刘海挤掉的状态栏图标，点一下弹出它原本的菜单（需辅助功能权限）
- 功耗监测：悬停即看整机功耗，内置电量环、续航估计、逐应用能耗排名与 24 小时历史
权限说明
文件中转和全局快捷键不需要任何权限。菜单栏图标功能需要「辅助功能」权限；屏幕录制为可选，仅用于把控制中心模块显示成真实图标。
隐私
完全离线运行，没有任何网络请求、遥测或更新检查。所有数据只保存在本机的 ~/Library/Application Support/NotchIsland/ 下。自动收存剪贴板默认关闭。
已知限制
- 本地 ad-hoc 签名，会触发 Gatekeeper 提示；重新安装后可能需要重新授予辅助功能权限
- 暂无自动更新，新版本需手动下载