DockTouchBar Vibe Vibe 项目

项目简介

DockTouchBar Vibe 是一款面向"用 AI 编程 Agent 写代码的 Mac 用户"的开源 macOS 小工具，它把 MacBook Pro 上那块容易吃灰的 Touch Bar 重新变成生产力面板：在 Claude Code、Codex、Qoder、WorkBuddy、Antigravity 等 AI Agent 还在跑代码的时候，对应 App 的 Touch Bar 图标会自动变成一个像素风小屏幕播放字符雨；Agent 跑完后显示一个清晰的 "OK"，点一下就能清除提示——你再也不用切回 IDE 才能判断"这货到底干完没"。

项目分为两个独立 App 同源发布：DockTouchBar（Standard） 是经典版，把 macOS Dock 完整搬到 Touch Bar 上，点按切换、双击最小化、长按退出，常驻后台 CPU 占用 0.0%~0.8%、内存仅 29 MB、Energy Impact 0.0；DockTouchBar Vibe 是在 Standard 之上新增 AI Agent 工作状态显示的"vibe coding"版本，已包含完整 Dock 能力。两个版本只能同时跑一个（Vibe 会提示），按需选用。

核心功能

• 🎮 Touch Bar 上的实时 AI 状态：当 Claude Code / Codex 等 Agent 在某个 App 里跑任务时，该 App 在 Touch Bar 上的缩略图会变成像素风小屏幕播放字符雨；任务结束后显示 OK 提示，点击即可清除。
• 🖱 多点触控的完整 Dock：单指轻点切换 App、双击最小化、长按退出，常驻后台资源占用接近 0；空闲时图标带咖啡杯与升腾蒸汽动画，长按退出时还会按春夏秋冬四季播放像素风侧滑场景（春天奔跑的小狗、夏天帆船、秋天森林狐狸、冬天雪橇），松手可取消、动画结束触发彩蛋爆裂。
• 🧩 多 Agent 同时监控：同时开 Claude Code、Codex、WorkBuddy 时，每个 App 图标都能独立显示自己的状态，低头看 Touch Bar 就能判断谁还在忙、谁已经 OK，无需反复 Alt-tab 回对应 IDE。
• 🔌 一键配对 Agent：流程简化为「设置 → 配对智能体 → 复制提示词」三步，粘贴给 Agent 后它会自检并通过自己的 hook 或长期指令规则接入；接入前会备份配置、需要确认信任 hook 的工具会显式提示。
• 🪶 极致轻量：使用事件驱动的 App 与 Window 更新机制，常驻 24/7 后台基本无感；CPU 0.0%~0.8%、物理内存 29 MB、Energy Impact 0.0（macOS Activity Monitor 最低档）。
• 🌍 多语言 + 多平台优化：原生支持英文、简体中文、繁体中文、日文、韩文、法文、德文、西班牙文、葡萄牙文、俄文、意大利文、土耳其文共 12 种语言；同时为新旧版 macOS 都做了样式适配。

技术实现

DockTouchBar 用 Swift + AppKit 直接调用 macOS 的 Touch Bar API（NSTouchBar / DFRElement）做 UI 渲染，避免 Electron / WebKit 这类重量级框架带来的内存与能耗开销，这也是它能把常驻内存压到 29 MB、Energy Impact 0.0 的关键。状态层采用事件驱动（NSApplicationDelegate + NSWindowDidBecomeKeyNotification），只在 App 切换 / 窗口变化时才做少量进程检查，截图渲染走 macOS 的 CGWindowList API，整个后台几乎不做轮询。

Vibe 版本在 Standard 的 Touch Bar 渲染管线之上，新增了 Agent 状态协议层：Agent 端通过 hook 把「工作中 / 已完成」两类事件写到约定的本地状态文件（默认 ~/Library/Application Support/DockTouchBarVibe/），DockTouchBar Vibe 用 DispatchSource.makeFileSystemObjectSource 监听文件变化，触发 Touch Bar 图标贴图的字符雨 / OK 帧切换；配对流程则走本地 HTTP 端口 + 一次性 challenge token，避免把 Agent 的 hook 配置泄露到网络上。整套系统无云端依赖、不上传任何使用数据，配对前 Agent 必须先自检并备份原 hook 配置，符合 macOS 安全模型。

快速上手

1. 下载安装：前往 https://github.com/hooosberg/DockTouchBar/releases/tag/vibe-v1.0 下载 DockTouchBarVibe-*.dmg（或先用 Standard 版：https://github.com/hooosberg/DockTouchBar/releases/latest），把 App 拖入 Applications 并首次启动授权 Touch Bar 权限。
2. 开启 AI 状态监控：在 DockTouchBar Vibe 偏好设置里打开「智能体状态监控」开关，按提示授予"辅助功能 / 屏幕录制"权限。
3. 配对 Agent：菜单 → Setting → Pair Agent → Copy Prompt，把弹出的提示词粘贴给 Claude Code / Codex / Qoder 等 Agent，让它自检并按指引安装 hook。
4. 第一次配对会备份：Agent 配对流程会自动备份当前 hook 配置，需要你确认后才生效；信任 hook 的工具会单独弹窗再确认一次。
5. 让 Agent 跑任务：在任意 App 里启动 Claude Code / Codex 的代码生成任务，低头看 Touch Bar，对应 App 图标即开始播放字符雨；任务结束后图标显示 OK，点一下清除提示。
6. 多 Agent 并行：同时打开 Claude Code 和 Codex，各自跑任务时 Touch Bar 上两个 App 图标会独立显示状态，肉眼即可分辨谁还在忙。
7. 回退到普通 Dock：如不想看 Agent 状态，切换回 Standard 版（https://github.com/hooosberg/DockTouchBar/releases/latest）即可，两者不能同时运行。

适用人群

• 日常用 Claude Code / Codex / Qoder / WorkBuddy / Antigravity 等 AI Agent 写代码的 macOS 用户
• 拥有带 Touch Bar 的 MacBook Pro（2016-2019 款及部分 2020/2021 款）且希望重新激活这块屏幕的开发者
• 喜欢 macOS 原生体验、追求轻量后台工具、不想用 Electron 类重 UI 的极客
• 同时跑多个 AI 编程工具、需要一眼分辨「谁还在跑 / 谁已完成」的团队 Lead