两部分，
一起完成输入。

这不等于安装包损坏。当前 Windows 正式安装包可能显示未知发布者提示。只从 EasyInput 官方入口下载，确认产品名为 EasyInput 后按 Windows 提示继续；不要从网盘或第三方下载站获取安装包。

关闭主窗口会把 EasyInput 留在 macOS 菜单栏或 Windows 系统托盘中，语音快捷键可以继续工作。点击 EasyInput 托盘图标可重新显示主窗口；需要彻底退出时，使用托盘菜单里的“退出”。

1. 确认“隐私与安全性”里的麦克风与辅助功能已经允许 EasyInput。
2. 按首次引导提示完整退出 EasyInput。
3. 从启动台或访达重新打开一次，让权限进入新的 App 进程。

正常只需要完成这一次重新打开；不要把反复重启当成日常排障步骤。

先看“设置 → 快捷键操作方式”。新安装默认是“按一下开始 / 再按一下结束”，所以松开不会结束；只有选择“按住说话”时，松开快捷键才结束录音。

1. 确认 EasyInput 正在运行，并核对“设置”里的当前快捷键与操作方式。
2. macOS 检查辅助功能；Windows 检查快捷键是否被其他 App 占用，并允许 EasyInput 通过安全软件。
3. 如果 App 快捷键能用、只有开发板 KEY1 / KEY3 不能用，回到“键盘 → 按键”同步一次当前设置。
4. 页面明确提示按键冲突时，再换一个较少被其他软件占用的快捷键。

1. 在系统隐私设置中确认 EasyInput 可以使用麦克风。
2. 在 App“语音”页打开麦克风面板，选择“跟随系统默认”或明确选择正确设备。
3. 点击“测试麦克风”，观察音量条；没有变化时检查系统输入音量是否为 0、设备是否静音。
4. 刷新设备列表；仍无声时，到系统声音设置确认该设备本身可以收到声音。

先确认当前输入位置，再判断 Windows 环境是否拦截。能识别但文字没有进入输入框时，杀毒软件、行为防护或企业管控拦截模拟键盘与剪贴板操作，是 Windows 上应优先排查的常见外部原因之一。

1. EasyInput 把结果交给处理完成时的当前应用与输入位置。等待完成前，请把目标窗口保持在前台，并让光标或选区留在真正要接收文字的位置。
2. Windows 先用普通权限的“记事本”测试。记事本可以输入、只有某个软件不行，通常说明问题在该软件、权限级别或它所在环境；记事本也不行，再继续检查安全软件。
3. 查看安全软件的拦截或行为防护记录。在 Windows 安全中心或正在使用的第三方杀毒软件中，只把从 EasyInput 官方渠道安装的 EasyInput.exe 加入允许 / 信任列表，然后完整退出并重新打开 EasyInput。
4. 检查接收文字的软件是否“以管理员身份运行”。普通权限的 EasyInput 可能无法向更高权限窗口输入；可以时，优先让接收文字的软件按普通方式运行。
5. 先使用“设置 → 文字输入方式 → 自动”；个别软件仍不接收时，再分别尝试“直接输入（仅单行）”或“始终粘贴”，每次只测试一种。
6. macOS 则确认“辅助功能”仍然开启。

不要长期关闭杀毒或系统防护，也不要把来源不明的安装包加入白名单。

如果页面提示“文字可能已经输入”或“无法确认是否显示”，先检查目标位置，不要立即重试，以免重复输入。

可以。把光标放在输入框里，不选择文字，按 KEY3 或语音编辑快捷键直接说出问题。EasyInput 会把这次录音作为一次单轮 AI 对话，并把回答输入到当前光标位置；如果先选中文字，同一个按键才会进入改写。

1. USB：使用确定支持数据传输的 USB 线，重新插入电脑接口，并保持开发板开机。
2. 蓝牙：“已配对”不等于当前已连接；进入系统蓝牙设置，点击 EasyInput AI 连接。
3. 仍未连接时，先关闭再打开开发板；只有系统本身持续无法连接时，才删除设备后重新配对。

不是。“待同步”只表示 App 本机设置与上次成功写入开发板的内容不同。确认修改后点击“同步到键盘”；如果把内容完整改回原值，提示会自动消失。

1. 保持开发板开机、唤醒并连接，先读页面给出的具体原因。
2. USB 提示连接问题时检查数据线；蓝牙提示连接问题时，确认系统蓝牙中的 EasyInput AI 当前已连接。
3. 只有页面明确显示“蓝牙设置暂时不可用”时，才长按滚轮 3 秒进入约 5 分钟设置模式，等待 1 秒后重试。
4. macOS 提示“输入监控”时完成授权；刚授权后完整退出并重新打开 EasyInput，再同步一次。

如果页面说“无法确认本次配置是否已经写入”，不要立即重复同步；先按页面提示确认当前状态，避免重复写入。

进入“键盘 → 按键”查看当前电脑与开发板系统；App 已连接时点击“同步到键盘”，App 会按当前电脑系统写入开发板。只有页面显示“可在键盘上切换系统”时，才可在无法使用 App 时长按旋钮约 3 秒，看到彩虹灯后松开，并在 10 秒内按 KEY1 选择 macOS、KEY2 选择 Windows。

有 USB 时优先使用 USB，保持 App 和开发板连接并等待本次同步结束；失败时按页面的 USB 或 Wi-Fi 提示处理，再进行一次明确重试。

1. 先确认开发板按键功能正常，再打开“键盘 → 网络”。
2. 开发板必须连接 2.4GHz Wi-Fi；电脑可以连接同一路由器的 5GHz Wi-Fi 或网线。
3. 路由器、Wi-Fi 名称或密码改变后，重新“自动获取”并同步到开发板。
4. 公司或访客网络可能阻止局域网设备互相通信，可先用普通家庭路由器验证。

选择 App 中的“键盘优先”后，如果开发板麦克风在本次录音开始时不可用，EasyInput 会安全使用已经准备好的电脑麦克风；保存的偏好不会因此改变。

确认网络与 Wi-Fi 设置正确后仍无法使用开发板麦克风，请从 EasyInput 官方渠道覆盖安装当前版本，再重新测试。

1. 回到“键盘 → 编程助手”，在实际使用的助手上点击“检查”或“修复”。
2. 按对应 Provider 的页面提示完成宿主确认；Codex 才使用页面给出的 /hooks 检查步骤。
3. 新建一次 Codex 或 Claude Code 会话，发送一条普通消息，等待页面显示“联动正常”。
4. 确认开发板通过 USB 或蓝牙连接。

“配置存在”只证明设置已经写入；收到一次真实助手事件，才证明运行链路成立。

当前板开机时短按并松开 BOOT 会进入下载模式。恢复只需要：

1. 关闭开发板电源。
2. 再正常开机。

不要再次按 BOOT；不需要拔 USB、按住 BOOT 配合上电，也不要寻找板上不存在的 RESET 键。

1. 结束正在进行的录音、开发板同步、设备读取或麦克风测试。
2. 确认网络正常，再到“帮助与更新”重试。
3. macOS 如果提示安装位置不稳定，先把 EasyInput 移到“应用程序”文件夹并重新打开。
4. 此版本无法自动更新或仍失败时，从 EasyInput 官方入口下载最新版覆盖安装。