dsh-airpod-control
通过 HeadOrbit 使用 AirPods 头部手势控制 DeepSeek Harness：点头 = 允许/确认，摇头 = 拒绝/下一个选项。提供菜单栏应用的一键安装程序。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:fishcg/dsh-airpod-control#4c3e4a026c245b7a6dc080b93c9b4738a051ea63Airpod Control 以 dsh-airpod-control 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
用 AirPods 的头部动作回答 DeepSeek Harness 里的两件事，同一套手势：
| 场景 | 点头 | 摇头 |
|---|---|---|
| 权限许可（approval） | 允许（allowed-once） | 拒绝 |
模型提问（ask_user_question，3 个以上选项） | 确认当前项 | 切到下一项 |
手势由 HeadOrbit（AirPods 头部追踪的 macOS 菜单栏 App）识别， 经本机回环 HTTP 送到这个插件。插件在这里做了四件事：
~/Applications/HeadOrbit.app，端口和 token 全自动，用户不用手填。dsh plugin --profile desktop add dsh-airpod-control
--profile换成你实际在用的那个（桌面版默认desktop，dsh web是web）。 npm 包：https://www.npmjs.com/package/dsh-airpod-control，当前版本0.2.0。
想改代码就从源码装：
git clone https://github.com/fishcg/dsh-airpod-control.git ~/dsh-airpod-control
dsh plugin --profile desktop add link:~/dsh-airpod-control
装完重启 DSH，打开任意会话，右下角会出现「用点头 / 摇头回答 DSH」的卡片，点一下即可：
~/Applications不想点卡片也可以一条命令：
curl -s -X POST "http://127.0.0.1:<port>/dsh-airpod-control/setup/run" | jq
共享 token 也不需要手填：配置里留空时会自动生成一份，落在 ~/.dsh-airpod-control/token
（0600），安装器会把同一个值写进 HeadOrbit。
首次使用前请戴好 AirPods（Pro / 3 / 4 / Beats 等支持头部追踪的型号），并在 HeadOrbit 设置里确认「已连接」。
手势和网页按钮同时有效，谁先到算谁的：插件认领请求时也调用 next()，卡片照常渲染，
你在页面上点「允许」和做一个手势是在赛跑。没有回答者时 DSH 本来就是 fail closed，本插件不改变这个性质。
官方的语音输入插件（dsh-experimental-voice-input-bundle）没有快捷键，只能点输入框旁边那个麦克风。
本插件的浏览器半区补了一个：按住 ← 或 → 开始录音，松开结束并转录（长按 260ms 才启动，快速点一下还是正常移动光标），文字照常落进输入框草稿。
⌃Space 该干什么还是什么（只找得到按钮时才会拦截按键）。下面是一段 5 秒的真机录屏——审批卡片弹出后点一次头，卡片自动收起、命令随即执行（摇头就是「拒绝」）：
首次打开时右下角会自动出现安装卡片（左）；装好后审批卡片长这样（右）：
| 一键安装引导 | 审批卡片 |
|---|---|
| 查看图片 | 查看图片 |
在 profile 的 cordis.patch.yml 里覆盖（都有安全默认值）：
| 键 | 默认 | 说明 |
|---|---|---|
enabled | false | 关着的时候什么都不注册，等于没装 |
token | '' | 共享密钥。留空则自动生成到 ~/.dsh-airpod-control/token（0600）；非空时以配置为准。请求需带 X-HeadOrbit-Token |
nodAllows | true | false 则反过来：摇头＝允许、点头＝拒绝 |
claimQuestions | 'auto' | 'off' 则完全不接模型的提问，只回答权限许可 |
timeoutMs | 600000 | 审批没人理时的兜底（按拒绝结算） |
questionTimeoutMs | 600000 | 提问没人理时的兜底（工具返回 pending，不是跳过） |
requireHeadOrbit | true | false 时不看心跳、永远抢答（只建议自测时用） |
aliveWindowMs | 6000 | HeadOrbit 多久没轮询就当它不在线 |
debounceMs | 200 | 两次手势之间的最小间隔 |
全部挂在 /dsh-airpod-control 前缀下，复用宿主已有的 webServer 路由（因此只听 127.0.0.1）。
除 Host / 同站检查之外，都需要 X-HeadOrbit-Token；标了免 token 的那几个是给浏览器半区用的，
只读且不含会话内容。
| 方法 | 路径 | 用途 |
|---|---|---|
GET | /state | { waiting, kind, label, question?, deadlineAt, canAnswer, headOrbit, ... }，HeadOrbit 靠它决定要不要发手势，同时它本身就是心跳 |
GET | /health | 自检：{ ok, hasToken, hasApprovalAnswerer, hasQuestionAnswerer, headOrbitAlive, answered, ignored }（不回报 token 本身） |
GET | /events | 最近的事件流水，排查用 |
GET | /last-decision | 免 token：最近一次手势/按键结算了哪个请求（浏览器半区据此撤卡片） |
GET | /cursor | 免 token：当前光标落在第几项（只回序号与那一项的文字） |
GET | /setup | 免 token：{ app: { installed, running }, bridge, alive, tokenConfigured, last, running } |
POST | /setup/run | 免 token：下载 + 安装 + 写配置 + 启动 + 等心跳；{ reinstall?: true }，返回逐步状态 steps[] |
POST | /setup/motion | 免 token：打开系统设置的「动作与健身」隐私页 |
POST | /gesture | { "gesture": "nod" | "shake", "ttlMs": 2000, "requestId"?: "q1" } |
POST | /answer | { "decision": "allow" | "reject" | "select:N", "requestId"?: "q1" }，没有耳机时的等价入口 |
/state 里 kind 是 "approval" 或 "question"；等提问时 question 会带上题目与选项
（{ requestId, label, count, questions, deadlineAt, cursor }）。浏览器半区拿 question.cursor
在网页卡片上把「现在点头会选中哪一项」圈出来。带 requestId 的调用是网页卡片回的答案，
id 对不上会得到 409 { stale: true }。
$ curl -s -H "X-HeadOrbit-Token: $TOKEN" http://127.0.0.1:$DSH_WEB_PORT/dsh-airpod-control/health
{"ok":true,"plugin":"dsh-airpod-control","version":"0.2.0","hasToken":true,"hasApprovalAnswerer":true,"hasQuestionAnswerer":true,"headOrbitAlive":true,"headOrbitWindowMs":6000,"waiting":false,"waitingKind":null,"answered":3,"ignored":0}
端口就是 DSH 自己的 GUI 端口（dsh web 启动时打印的那个）；插件不开新端口。
X-HeadOrbit-Token，
所以本机别的进程即使能访问这个端口也伪造不了答案。/setup* 是免 token 的（浏览器拿不到 token），因此只接受回环 Host + 同站请求；
它做的都是固定参数的本机动作（defaults / ditto / open），请求内容不会进 shell。
装上之后任何本机进程仍然可以调它重装 —— 这在能读你用户目录的进程面前不算新增权限。cd dsh-airpod-control
node --test test/plugin.test.js # 45 个用例，手写假宿主，不需要真 DSH
覆盖：审批允许/拒绝/超时/取消、提问（两选项与多选项光标）、请求竞态、token 与 Host/同站校验、
自动生成 token、/setup 状态、卡片撤除的依据（/last-decision）、手势去抖等。
fishcg/HeadOrbit-dsh 的 latest release（ad-hoc 签名、未公证），
安装后会自动去掉 quarantine 属性；签名/公证版本后续再补。