把 Codex 放到键盘旁:Touch Bar 成为 AI 编程助手的轻量入口实验

开发者用 Swift 把 Codex 的额度、用量和最近对话状态放进 MacBook Touch Bar,在 30pt 高的空间里试验 AI 编程助手的轻量入口。这个非官方工具并不追求复杂功能,而是试图减少频繁切窗带来的上下文断裂。

一篇来自掘金的开发者实验文章,展示了如何把 Codex 的部分运行状态放进 MacBook Touch Bar。作者用 Swift 编写了 Codex Touch Bar 工具:当 Codex 位于前台时,Touch Bar 会变成一个高约 30pt 的迷你面板;切到其他应用,面板隐藏并恢复系统控制条。

该项目基于 MIT 协议,从 Daytimeflow/codex-touchbar-usage 二次开发,属于非官方社区作品,与 OpenAI 没有隶属关系。它针对的不是复杂功能,而是开发者使用 AI 编程助手时反复出现的细碎动作:查额度、看状态、点开最近对话。这些信息很短,但获取路径往往较长,窗口切换会不断打断当前思路。

为什么是 Touch Bar

作者并不否认 Touch Bar 的争议:手感、误触、苹果不再更新等问题都客观存在。但在 MacBook Pro 上,它仍是离键盘最近的一块屏,手不用离开主键区,视线只需上移 2 厘米。对频繁查看 Codex 状态的人来说,这两厘米可以减少一次切窗口的动作成本。

真正消耗开发者的,往往不是单次查询花费的三五秒,而是一天几十次切换后,回到编辑器重新接上下文的过程。作者想要的也不是更复杂的仪表盘,而是一个“不用主动去查、抬头就能看见”的轻量入口。

三条数据链各自降级

实现上,面板没有做统一数据源,而是让三条链路独立刷新、独立降级,再在渲染层合并。额度与用量信息通过 Codex 的 app-server 获取:工具启动子进程,用 JSON-RPC 发送初始化和读取请求,响应按 id 分发,id == 2 对应额度,id == 3 对应 token 用量。若 10 秒内没有结果,就按超时处理,等待下一轮 30 秒后的刷新。

解析器需要兼容不同版本的结构,既识别 5小时 / 1周 等旧标签,也识别 1周 / Spark 等新标签。如果请求失败,界面会展示缓存中的旧数字,而不是空白。

最近对话列表来自 ~/.codex/state_5.sqlite。工具以只读方式打开数据库,将忙碌超时设为 100ms,拿不到锁就放弃本轮读取,避免与 Codex 抢锁。查询会过滤归档、空标题和子线程,按最近活跃排序取 50 条,点击后通过 codex://threads/<id> 交给系统打开。

  • 蓝点:根据近期事件推测任务仍在进行。
  • 绿点:最近一次任务完成。
  • 灰点:状态未知。

状态点并非来自实时接口,而是读取每条对话对应的 rollout 文件末尾 256KB,从后往前查找事件。若 task_started 后超过 120 秒没有收尾事件,也会被标记为未知。作者强调,这不是实时状态接口,只能用于快速扫视。

30pt 画布与私有 API 的取舍

界面使用 NSTouchBar、NSCustomTouchBarItem 和自绘 NSView,画布为 720×30pt。额度环、票券、时钟、倒计时数字和对话标题都用 Core Graphics 绘制,因为在 30pt 高度下,系统控件的边距会占用过多空间。

常驻显示是项目的关键难点。公开 API 无法在其他应用前台时显示自定义 Touch Bar 面板,作者因此调用私有方法,并通过 NSSelectorFromString、responds(to:) 和 perform 判断接口是否存在。若系统接口变化,程序会静默失效,而不是崩溃。

刷新也被拆成不同节奏:本地读取更频繁,远程额度请求更克制,倒计时每秒更新。为防止旧结果覆盖新状态,程序使用自增 generation 丢弃过期响应,并把同步 I/O 移出主线程。作者称,在其机器上,3 秒一轮的轮询没有可感知掉帧,但这属于主观体验,未做帧率测量。

安装门槛与工作流意义

项目提供 Release 包和源码两种方式。Release 包为 CodexTouchBarUsage-v0.2.1-universal.zip,适配 Apple Silicon 与 Intel;安装前需校验 .sha256,安装后会注册 LaunchAgent com.local.codex-touchbar-helper 并登录自启。源码安装则需要 Xcode Command Line Tools 或完整 Xcode。

作者同时提示,安装包未经过 Apple 公证,使用临时签名,macOS 可能阻止运行;校验和只能证明文件未损坏,不能证明发布者身份。私有 API 也可能在系统更新后失效,常见表现是面板不再出现。

这个实验的价值,不在于让 Touch Bar 重新成为主流交互区,而在于它把 AI 编程助手的状态信息压缩到开发者手边。围绕 AI 编程助手的体验优化,不只是回答质量,也包括如何减少一次窗口切换、如何保留当前编码上下文、如何让辅助信息不打断主工作流。

Codex Touch Bar 展示了一种社区式的答案:用一个小工具、有限的数据源和明确的降级策略,把助手变成更轻的状态层。它也提醒开发者,这类非官方扩展虽然贴近个人工作流,但仍要面对私有接口、状态推断和签名安全等现实边界。

原创文章,作者:点点,如若转载,请注明出处:https://www.dian8dian.com/ba-codex-fang-dao-jian-pan-pang-touch-bar-cheng-wei-ai-bian

Like (0)
点点的头像点点
Previous 1天前
Next 18小时前

相关推荐