TimezoneBar

一个轻量的原生 macOS 菜单栏小工具，把某个远程时区的时间常驻在你的状态栏里。

💡 做这个项目的初衷：随时一眼看到 OpenAI / Anthropic 所在的旧金山 （America/Los_Angeles 洛杉矶时区）现在几点几分 ，知己知彼百战不殆。

最左边的 LOS 7月14日 周二 09:22 就是 TimezoneBar 显示的洛杉矶时间——刻意做得和最右边的系统时钟（本机时间 Wed Jul 15 12:22 AM）长得一模一样，只是前面多了个城市缩写。

中文 | English

点状态栏图标、选一个时区，图标就变成那个时区的实时时间——样式和系统时钟一致，但前面带一个城市缩写，一眼就能看出这不是本机时间，每分钟自动刷新：

🌐  →  选时区  →  TYO 7月1日 周三 12:11

功能

• 完整 IANA 时区列表（400+），可搜索。
• 想怎么搜就怎么搜 —— 中文城市名（东京）、英文 / IANA 名（tokyo、Asia/Tokyo）、或拼音（dongjing、beijing、jiujinshan）。
• 城市别名 —— 不是 IANA「代表城市」的城市也能搜到所属时区：旧金山/西雅图 → 洛杉矶时间，深圳/广州 → 上海时间。
• 最近使用的时区置顶显示。
• 记住你的选择，重启后自动恢复；「恢复本机时间 / 取消选择」可回到占位图标。
• 开机自动启动开关（基于 SMAppService）。
• 原生 SwiftUI，纯菜单栏（无 Dock 图标），占用极小。macOS 14+。

安装（预编译版）

1. 到 Releases 页下载对应你芯片的压缩包：
   • Apple Silicon（M1/M2/M3/…）：Mac_Silicon_TimezoneBar.zip
   • Intel：Mac_Intel_TimezoneBar.zip
   • 不确定？→ 苹果菜单 → 关于本机 → 看「芯片 / 处理器」。
2. 解压，把 TimezoneBar.app 拖进 /Applications（应用程序）。
3. 首次打开 —— 绕过 Gatekeeper。 这个 app 是 ad-hoc 签名、未经 Apple 公证（免费开源项目），首次打开会被系统拦。任选一种：
   • macOS 14 及更早：右键点 app → 打开 → 打开。
   • macOS 15（Sequoia）及以后：双击（会被拦）→ 系统设置 → 隐私与安全性 → 往下翻 → 仍要打开。
   • 终端（任意版本）：xattr -dr com.apple.quarantine /Applications/TimezoneBar.app
4. 点菜单栏的 🌐 图标选时区。想开机自启，就在面板里打开 开机自动启动。

从源码构建

需要 macOS 14+、Xcode 16 / Swift 6。

git clone https://github.com/linearuncle/timezoneBar.git
cd timezoneBar
swift run                    # 直接从源码运行
swift test                   # 跑测试
./scripts/package_app.sh     # 打包成 .app 并安装到 /Applications

开发

架构与约定见 CLAUDE.md —— 所有业务逻辑集中在单一可测的 TimezoneBarViewModel，SwiftUI 视图很薄。

许可证

MIT © 2026 linearuncle