如何同步 Codex / Claude 状态到 Dial Mini
连接 Dial Mini 后，Ulanzi Studio 会尝试为本机的 Codex 与 Claude Code 自动安装 Hooks。新建 Codex 或 Claude 会话并开始工作后，Ulanzi Studio 会监听 Agent 状态，并将状态同步到 Dial Mini 的按键和旋钮灯，便于判断任务是否正在运行、是否等待确认，或是否需要人工介入。
1. 开始使用
- 打开 Ulanzi Studio：确保软件已安装并正常运行。
- 连接 Dial Mini：等待 Ulanzi Studio 成功识别设备。
- 自动安装 Hooks：如果电脑已安装 Codex 或 Claude Code，Ulanzi Studio 会自动尝试安装对应 Hooks。
- 开启新会话：打开 Codex 或 Claude，新建会话并开始工作。
- 查看灯效反馈：Agent 状态发生变化时，Dial Mini 会显示对应灯效。
2. 锁屏与睡眠
锁屏
锁屏通常不影响 Agent 继续工作，状态同步一般也会继续。
睡眠
睡眠通常会暂停本地进程，Agent 与 Hooks 一般不会继续运行，Dial Mini 的状态同步也会中断。
执行长任务时，建议避免电脑自动睡眠。仅锁屏通常不会中断任务，但实际表现也会受到电脑电源设置影响。
3. 常见问题
Dial Mini 没有亮灯
可能原因包括：
- Dial Mini 未成功连接
- 灯光模式不是工作模式
- Ulanzi Studio 未运行
- Hooks 未安装成功
- 当前没有活跃会话
- 电脑已进入睡眠状态
Codex 或 Claude 正在工作，但 Dial Mini 没有反应
请检查 Ulanzi Studio 是否仍在后台运行、Hooks 是否已成功注册、当前是否为新会话或发生了状态变化，以及电脑是否已进入睡眠。
如何确认 Hooks 已安装成功
Claude Code 可在终端中使用 /hooks 查看。
Codex 可检查 ~/.codex/ 或项目 .codex/ 中的 Hooks 配置，也可在 Codex → 设置 → 钩子 → 用户配置 中查看。
为什么多个审批只显示一个呼吸灯效？
这是设计行为。Dial Mini 只表达“当前有待处理事项”，不显示待处理数量；多个审批不会叠加多个呼吸灯效。
锁屏后任务会停止吗？
一般不会。锁屏通常不影响任务继续执行。
睡眠后任务会停止吗？
一般会。睡眠通常会暂停本地进程和状态同步。
重装系统或升级客户端后不生效
请返回 Ulanzi Studio，重新执行 Hooks 安装或修复。
4. 排查步骤
- 确认 Dial Mini 已连接。
- 确认 Ulanzi Studio 正在运行。
- 确认 Codex 或 Claude 已开启新会话。
- 检查 Hooks 是否安装成功。
- 检查电脑是否进入睡眠。
- 如果仍未恢复，请重新安装或修复 Hooks。