Joy Harness

离开键盘,
用手柄驾驭 Codex

把 DualSense / Xbox 接到 macOS 上的 Codex Desktop:鼠标、六个 Micro 任务槽、审批、按住说话,还有震动确认。

开源 · Apple Silicon · 已公证签名

看一遍就会

手柄怎么切槽、怎么批权限、怎么说话——一张视频讲清楚。

演示视频占位 · 上传后替换

在 index.html 的 #demo 上填入 data-youtube 或 data-bilibili

实体控制,完整闭环

不是快捷键模拟。任务槽和审批走 RP2040 原生 Codex Micro HID。

两根线,不接线

手柄和 Pico 都插 Mac。Joy Harness 读手柄,经串口告诉 RP2040,再由 Vendor HID 进 Codex。

  1. 01

    手柄

    DualSense / Xbox / 兼容扩展手柄,蓝牙或 USB。

  2. 02

    Joy Harness

    鼠标与系统键直达前台;Codex 动作转发到 RP2040。

  3. 03

    RP2040

    以 Codex Micro 身份出现;槽位、审批、PTT 原生送入 Codex Desktop。

DualSense controller mapping in Joy Harness
DualSense 映射一览 · Xbox 同样支持

你需要什么

软件

  • macOS 13+ · Apple Silicon
  • Codex Desktop(含 Codex Micro)
  • 辅助功能与输入监控权限

硬件

  • DualSense / Xbox 等扩展手柄
  • Raspberry Pi Pico(完整 Codex 路径)
  • 仅鼠标/快捷键可不接 Pico

装上,插上手柄

当前 Release 已 Developer ID 签名并经 Apple 公证。

校验:shasum -a 256 -c *.dmg.sha256

常见问题

一定要买 Pico 吗?

鼠标、滚动、系统快捷键和诊断台不需要。六个 Micro 槽、审批和按住说话需要 RP2040 完整链路。

支持哪些手柄?

直接支持 DualSense、DualShock 4、Xbox Series。其他扩展手柄取决于 macOS GameController 暴露的输入与震动。

会代理 Codex 吗?

不会。应用只读任务名与顺序;动作经 RP2040 原生 Vendor HID 进入 Codex Desktop,不用键盘模拟。

免费吗?

开源,直接从 GitHub Releases 下载。固件与刷写说明见仓库 README。