PopBar

PopClip 风格的 macOS 划词工具条。选中文本 → 光标旁弹出浮动工具条 → 一键执行动作。

纯 Swift / AppKit 实现,无第三方依赖,单二进制约 200 KB,无 Xcode 也能构建(只需 Command Line Tools)。

划词检测 取词 浮条 动作
───────── ───────── ───────── ─────────
全局鼠标监听 → AX API 读选区 → 非激活 NSPanel → 内置动作
(mouseUp + (失败则模拟 ⌘C (orderFront- + 扩展插件
 拖选/双击判断) 并恢复剪贴板) Regardless) (url/shell/applescript)

支持两种扩展格式,放入 ~/Library/Application Support/PopBar/Extensions/ 即可(菜单栏 → 重新加载扩展):

1. PopBar 原生格式(.popext)

MyPlugin.popext/
├── manifest.json # 必需
├── icon.png # 可选
└── run.sh # type=shell 时

// URL 型:{text} 替换为 URL 编码后的选中文本
{ "name": "DeepL", "type": "url",
 "url": "https://www.deepl.com/translator#auto/zh/{text}" }
// Shell 型:选中文本通过环境变量 POPBAR_TEXT 传入
{ "name": "转大写", "type": "shell", "script": "run.sh" }

2. PopClip 官方扩展(.popclipext)兼容

可直接安装 popclip.app/extensions 的扩展包:

• 配置解析:Config.plist / Config.json / 简单结构的 Config.yaml(多个共存时合并)
• 动作类型:
  • url(*** 占位符)
  • shell script file(POPCLIP_TEXT 环境变量、interpreter 字段)
  • applescript / applescript file({popclip text}、{popclip option x} 占位符替换)
  • JavaScript / TypeScript 模块(Config.js / Config.ts):JavaScriptCore 执行,实现了 PopClip JS API 常用子集(defineExtension、popclip.input.text/html/markdown、pasteText/copyText/openUrl/showText、showSuccess/showFailure、点击瞬间的真实 modifiers、util.sleep/getRandomValues 等);TypeScript 首次使用时自动下载官方编译器(约 8MB,仅一次),转译结果按内容哈希缓存
• 图标:支持文件 / symbol: / 文本图标 / iconify:(通过 icons.popclip.app 渲染,与 扩展目录网页 同款,首次下载后本地缓存)
• options 取默认值,requirements 中的 option-x=y 按默认值筛选动作
• 暂不支持:扩展设置界面、网络 API(popclip.fetch)、签名校验

1. 双击安装:下载 .popclipextz / .popextz 后右键 → 打开方式 → PopBar,确认后自动解压安装
2. 拖放安装:把压缩包或扩展文件夹直接丢进 Extensions 目录,下次加载时自动解压
3. 网页一键安装:网页放链接 popbar://install?url=<HTTPS 下载地址>,点击唤起 PopBar 确认安装

• 菜单栏常驻(无 Dock 图标),随时打开扩展目录 / 重载扩展
• 开机自启动开关(SMAppService,出现在 系统设置 → 登录项)
• 辅助功能授权后自动生效,无需重启 App

1. 下载 Releases 中的 PopBar.app.zip,解压后拖入 /Applications
2. 首次打开会被 Gatekeeper 拦截(自签名应用):右键 App → 打开,或在 系统设置 → 隐私与安全性 中点"仍要打开"
3. 按提示授予 辅助功能 权限(系统设置 → 隐私与安全性 → 辅助功能 → 打开 PopBar 开关)
4. 选中任意文字试试

git clone https://github.com/<you>/PopBar.git && cd PopBar
./build.sh # 编译 → 组装 .app → 签名 → 安装到 /Applications → 启动

build.sh 默认用名为 PopBar Code Signing 的自签名证书签名(保证 TCC 授权在更新后不失效)。没有该证书时可改成 ad-hoc 签名:把脚本里的 IDENTITY 改为 -。

要求 macOS 15+(系统翻译用到 Translation 框架)。首次使用翻译时按提示下载离线语言模型(英语、简体中文)。

设计上空闲时零轮询:

• 划词检测是事件驱动的全局鼠标监听,只在"拖选超过 4pt、双击或 Shift+点击"后才尝试取词(优先 AX API,含 web area 子元素的有限递归查找;失败才模拟 ⌘C 且会恢复剪贴板)
• 翻译浮窗的鼠标位置检测(0.25s)只在浮窗可见期间运行,关闭即停
• 辅助功能授权轮询(2s)只在未授权时运行,授权后立即停止
• 工具条的自动隐藏计时器为 6 秒一次性触发

• shell / AppleScript 型扩展可以在你的电脑上执行任意代码,只安装信任来源的扩展;所有安装路径都会弹确认框,网络安装强制 HTTPS
• 密码框等安全输入字段无法取词(系统保证),也不会弹条
• App 未开沙盒(辅助功能 API 的要求),不会出现在 Mac App Store

Sources/
├── main.swift # 入口(菜单栏 accessory app)
├── AppDelegate.swift # 权限引导、菜单、扩展安装入口、开机自启动
├── SelectionMonitor.swift # 划词检测 + 双路取词(AX / ⌘C)
├── PopupPanel.swift # 非激活浮动工具条
├── Actions.swift # 内置动作:复制 / 翻译 / Claude
├── TranslatePanel.swift # 系统离线翻译浮窗(Translation 框架)
├── PluginManager.swift # .popext 加载 + 压缩包自动解压
├── PopClipSupport.swift # PopClip .popclipext 兼容层
└── PluginInstaller.swift # popbar:// 一键安装 + 本地包安装

MIT