ShelfU v1.11.0

ShelfU now speaks English. 现在 ShelfU 有英文界面了。

New

• Language: Settings → General → Language: Follow System (the default), 简体中文 or English. Follow System shows Chinese when your Mac's first language is Chinese and English otherwise. The switch takes effect at once, no restart.
• Dates and times follow your Mac's region and 12/24-hour setting.
• The Services menu item reads "Add to ShelfU" on English systems.
• Built on MyGo 0.7.1 and Go 1.27.3 (includes a Go security fix).

Changes

• After an update is installed, it takes effect when you choose Restart ShelfU to Finish Updating or quit ShelfU.
• The disk image attached to each release is now named shelfu-<version>-arm64.dmg; ShelfU.dmg stays as the stable download link.

新功能

• 语言： 设置… → 通用 →「语言」：跟随系统（默认）/ 简体中文 / English。跟随系统时，Mac 的第一语言是中文就显示中文，其他显示英文。切换后马上生效，不用重启。
• 日期和时间跟随 Mac 的地区和 12 / 24 小时制设置。
• 英文系统上，服务菜单项显示为 “Add to ShelfU”。
• 升级到 MyGo 0.7.1 和 Go 1.27.3（含 Go 的安全修复）。

变化

• 更新装好后，选「重新启动 ShelfU 完成更新」或退出 ShelfU 时生效。
• Release 附带的安装包改名为 shelfu-<版本>-arm64.dmg；ShelfU.dmg 仍是固定的下载链接。

ShelfU v1.10.3

• The charging notice's level bar is shorter, so it no longer slides under the notch on a MacBook.

• 充电提示里的电量条变短了，在 MacBook 上不再钻到刘海下面。

ShelfU v1.10.2

ShelfU is now a notch tool for the Mac: live activities, a Dynamic Island style, window snapping from the notch, one switch for system permissions, and Claude Code quotas read from Claude Code itself.

ShelfU 现在是住在 Mac 刘海里的工具：实时活动、灵动岛样式、拖窗口到刘海分屏、一个开关开好系统权限，Claude Code 额度直接从 Claude Code 读取。

New

• Live activities: plugging in the charger, full and low battery, Bluetooth headphones (with AirPods levels when macOS reports them) and browser downloads show in the notch. Several downloads that finish together share one notice; a click puts them all on the tray. Each one can be turned off in Settings → 实时活动.
• Dynamic Island style: on a display without a notch ShelfU floats as a small black island; on a MacBook choose it in Settings → General → 刘海样式. Hold the island and drag it anywhere — it stays where you let go on each display; 恢复默认位置 brings it back.
• Arrange windows from the notch: drag a window by its title bar toward the notch and drop it on left half, full, right half or a third. Needs Accessibility.
• One switch for system permissions: Settings → 系统权限 walks you through Full Disk Access, Accessibility and Screen Recording. With Full Disk Access, dragging files in from Downloads, Desktop, Documents or iCloud Drive no longer asks for access.
• AI usage: the Claude Code quota now comes from your installed Claude Code (/usage), so it matches what Claude Code shows, including per-model weekly limits. Quotas show what is used by default; switch to what is left in Settings → AI 用量 → 额度显示. The last reading is kept across restarts, and an account limit is shown as it is.
• A gear for Settings and a new tray glyph.

新功能

• 实时活动： 插电、充满、电量低、蓝牙耳机连接（系统给出时显示 AirPods 电量）和浏览器下载都会在刘海里提示。同时下载完的几个文件合成一条提示，点一下全部放进托盘。每一项都能在 设置… →「实时活动」里关掉。
• 灵动岛样式： 没有刘海的屏幕上 ShelfU 是一颗悬浮的小黑岛；MacBook 上可以在 设置… → 通用 →「刘海样式」里选。按住小岛可以拖到任意位置，每块屏幕分别记住；「恢复默认位置」让它回到顶部。
• 拖窗口到刘海分屏： 拖着窗口标题栏往刘海走，放到左半、全屏、右半或 1/3 格子里。需要「辅助功能」权限。
• 一个开关开好系统权限： 设置… →「系统权限」按顺序带你开「完整磁盘访问」「辅助功能」「屏幕录制」。开了完整磁盘访问后，从「下载」「桌面」「文稿」或 iCloud 云盘拖文件进来不再弹窗。
• AI 用量： Claude Code 的额度改为运行你装好的 Claude Code 的 /usage 读取，和 Claude Code 显示的一致，也包括按模型的每周额度。额度默认显示「已用」，可在 设置… → AI 用量 →「额度显示」改成「剩余」。上次的结果跨重启保留；额度用完会直接显示。
• 设置按钮换成齿轮，托盘换了新图标。

ShelfU v1.10.1

New app icon. 新的 App 图标。

Coming from Shelf

• The first time ShelfU opens, it copies your saved items from ~/Library/Application Support/Shelf/ to ~/Library/Application Support/ShelfU/. The old folder stays as it was; delete it once everything is there.
• Updating inside Shelf: after the update is installed, open Shelf from Applications. It renames itself to ShelfU.app and opens as ShelfU.
• Installing from ShelfU.dmg: quit Shelf and move Shelf.app to the Trash first.
• macOS treats ShelfU as a new app: turn its system permissions (Accessibility, Screen Recording) and Open at login on again.

从 Shelf 升级

• ShelfU 第一次打开时，会把 ~/Library/Application Support/Shelf/ 里的内容复制到 ~/Library/Application Support/ShelfU/。旧文件夹保持原样，确认内容都在以后可以删掉。
• 在 Shelf 里应用内更新： 更新装好后，在“应用程序”里打开 Shelf。它会自己改名为 ShelfU.app 并以 ShelfU 打开。
• 用 ShelfU.dmg 安装： 先退出 Shelf，把 Shelf.app 移到废纸篓。
• macOS 会把 ShelfU 当成新应用：系统权限（辅助功能、屏幕录制）和「开机时自动启动」要重新打开一次。

ShelfU v1.10.0

ShelfU is the new name of Shelf, with a new app icon and menu-bar icon.

Coming from Shelf

• The first time ShelfU opens, it copies your saved items from ~/Library/Application Support/Shelf/ to ~/Library/Application Support/ShelfU/. The old folder stays as it was; delete it once everything is there.
• Updating inside Shelf: after the update is installed, open Shelf from Applications. It renames itself to ShelfU.app and opens as ShelfU.
• Installing from ShelfU.dmg: quit Shelf and move Shelf.app to the Trash first.
• macOS treats ShelfU as a new app: turn its system permissions (Accessibility, Screen Recording) and Open at login on again.

从 Shelf 升级

• ShelfU 第一次打开时，会把 ~/Library/Application Support/Shelf/ 里的内容复制到 ~/Library/Application Support/ShelfU/。旧文件夹保持原样，确认内容都在以后可以删掉。
• 在 Shelf 里应用内更新： 更新装好后，在“应用程序”里打开 Shelf。它会自己改名为 ShelfU.app 并以 ShelfU 打开。
• 用 ShelfU.dmg 安装： 先退出 Shelf，把 Shelf.app 移到废纸篓。
• macOS 会把 ShelfU 当成新应用：系统权限（辅助功能、屏幕录制）和「开机时自动启动」要重新打开一次。

v1.9.1

修复：

• 在剪贴板页清空，托盘里的截图和图片不会再一起消失；两页的「清空」和「移除」都只影响当前这一页
• 连续截图到剪贴板（⌃⇧⌘3 / ⌃⇧⌘4）时，每一张都会收进托盘和剪贴板，不再漏掉
• 页面顶部只显示页面名，不再显示数量；切换页面时图标位置不变
• AI 用量的更新时间移到刷新按钮旁边

提醒：从 1.8.0 或 1.9.0 更新上来不需要重新授权。

v1.9.0

新面板：

• 两级灵动岛：点刘海先弹出一个小岛（播放器 + 页面图标），点图标才展开成页面；所有页面同一尺寸（420 × 250），比以前小一半左右，不会挡住菜单栏右边的图标
• 新「主页」：自由摆放的小组件画布（音乐、保持唤醒、AI 用量、最近文件、剪贴板最新），长按编辑、改尺寸、拖到空格、从目录加回、拖出面板固定到桌面
• 音乐小组件：可以拖动进度跳转、直接调系统音量
• 工具页只放动作卡；AI 用量页一屏看全（额度双圈 + 本机用量柱图），悬停看 Token 与费用的细分
• 正在播放、转换进度、保持唤醒变成左上角的小胶囊
• 切页更流畅；列表滚动到边缘逐行渐进模糊
• 框选文字和「识别文字并复制」的结果会记进剪贴板页，来源显示「框选文字」

修复：

• 面板只有画出来的部分接收点击，旁边的菜单栏照常可点
• 屏幕录制授权不会被误清
• 布局文件自动迁移，旧布局保留

提醒：从 1.8.0 更新上来不需要重新授权；从 1.7.0 或更早更新需要用「开启系统权限」再开一次。

v1.8.0

改进：

• 正在播放：放音乐时把鼠标移到刘海上，刘海只向左右各长出一小截（左边封面、右边音频条），不再向下弹出大播放器挡住窗口；点一下展开托盘，用上方的播放条控制
• 系统权限统一入口：右键菜单栏图标 →「开启系统权限」，或 设置… → 系统权限 →「全部开启」，按顺序打开「辅助功能」（刘海拖放保护）和「屏幕录制」（框选文字），最后一键重新打开 Shelf
• 更新后保留授权：从这个版本起，以后的更新不再需要重新开启这两项权限

提醒：从 1.7.0 或更早的版本更新到 1.8.0 时，需要用「开启系统权限」再开一次；之后的更新会保留。

v1.7.0

新功能：

• 工具页：刘海多了「工具」一页，放动作卡和小组件卡。点按动作卡处理托盘里选中的项目，也可以把文件拖到卡片上；长按卡片编辑、排序、增删
• 固定到桌面：编辑时把卡片拖出面板，它会留在桌面上；松在屏幕左右边缘会收成窄条，鼠标或拖着文件靠近时展开
• 框选文字：按 ⌃⌥O 在屏幕上框一块区域，里面的文字在本机识别后直接复制（需要「屏幕录制」权限）

改进：

• 剪贴板始终记录，设置里不再有「记录复制的内容」开关
• 设置窗口标题居中（感谢 @danieldy888）

v1.6.0

新功能：

• 拖到刘海直接处理：拖着文件靠近刘海，面板展开后上方是「放入托盘」，下方按文件类型出现动作格——图片可以压缩到 1 MB、转成 PDF、转 JPEG / PNG，PDF 可以转 Word 或每页存成图片，压缩包可以解压，其他文件可以打成 zip，都可以隔空投送。结果放进托盘，原文件不动
• 截图里的文字可以搜索：剪贴板里的截图和图片会在本机识别文字（不联网），按 ⌃⌥V 搜索时也能搜到
• 识别文字并复制：右键一张图片 →「识别文字并复制」

改进：

• 刘海展开改为灵动岛式的弹性动效，列表上下边缘渐进模糊
• 面板收着时，完成提示从刘海里长出一截显示结果
• 拖拽时只在刘海附近接收文件