Joy Harness
离开键盘,
用手柄驾驭 Codex
把 DualSense / Xbox 接到 macOS 上的 Codex Desktop:鼠标、六个 Micro 任务槽、审批、按住说话,还有震动确认。
看一遍就会
手柄怎么切槽、怎么批权限、怎么说话——一张视频讲清楚。
演示视频占位 · 上传后替换
在 index.html 的 #demo 上填入 data-youtube 或 data-bilibili
实体控制,完整闭环
不是快捷键模拟。任务槽和审批走 RP2040 原生 Codex Micro HID。
-
六槽 Codex Micro
LB/RB 顺序切换,LT 组合直达 1–6;短震报槽号。
-
审批与按住说话
批准 / 拒绝、yes / no;按住 Menu 说话,松开结束。录音仍由 Codex 原生完成。
-
鼠标与系统层
左摇杆指针,触控板精细瞄准,A/B/R3 键鼠;LT 层回车、复制、粘贴。
-
分级震动反馈
DualSense R2 阻力墙;Xbox Impulse Trigger;切槽与确认都有触觉回执。
-
本地诊断台
槽位、电量、RP2040、麦克风、辅助功能权限,一眼看清链路健康。
-
按键可映射
基础键、十字键、LT 层即时改映射;中英文界面,登录时启动。
两根线,不接线
手柄和 Pico 都插 Mac。Joy Harness 读手柄,经串口告诉 RP2040,再由 Vendor HID 进 Codex。
-
01
手柄
DualSense / Xbox / 兼容扩展手柄,蓝牙或 USB。
-
02
Joy Harness
鼠标与系统键直达前台;Codex 动作转发到 RP2040。
-
03
RP2040
以 Codex Micro 身份出现;槽位、审批、PTT 原生送入 Codex Desktop。
你需要什么
软件
- 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。