红旭官网
官方店铺
论坛技术支持
加技术客服沟通
红旭官网
官方店铺
论坛技术支持
加技术客服沟通
游客
注册
登录
桌摆Ai Agent运行指示灯
快速开始
AI Light 详细使用手册
日常使用
设备管理
接入 AI 编程工具
主题与提示音
个性化设置
故障排查
维护与数据管理
参考资料
术语表
高级接入参考
主题文件参考
AI-Light Hook API 使用指南
AI-Light 主题格式指南
设备蓝牙BLE通信协议规范
常见问题
如无权限阅读,请加微信:17625815328
-
+
首页
AI Light 详细使用手册
故障排查
故障排查
# 故障排查 先按症状找到对应条目。每次排查后,建议用“试听”页面验证设备,用一个真实 AI 任务验证接入。 ## 找不到 AI Light 设备 可能原因包括设备未供电、距离过远、电脑蓝牙关闭、权限被拒绝、系统蓝牙服务异常,或设备没有广播可识别的 AI Light 名称。附近的普通蓝牙设备不会显示在列表中。 1. 确认设备已经供电。 2. 把设备放到电脑附近。 3. 关闭再打开电脑蓝牙。 4. 检查系统是否允许 AI Light 使用蓝牙。 5. 返回“设备”页面选择“重新查找设备”。 6. Linux 用户还应确认系统蓝牙服务正在运行,且当前账户有访问权限。 7. 确认设备广播名称仍以 `ACLight-` 开头;如果设备名称异常,先重新给设备上电。 ## 设备连接失败 1. 重新查找,确认设备仍在列表中。 2. 确认设备没有被另一台电脑占用。 3. 让设备重新上电后再连接。 4. 退出并重新打开 AI Light。 5. 记录错误提示和应用版本。 ## 设备频繁断开或一直重连 1. 缩短设备与电脑之间的距离。 2. 排除遮挡和强无线干扰。 3. 等待自动重连完成,最多尝试 5 次。 4. 如果设备已经手动处理,选择“停止重连”,再重新连接。 5. 仍然异常时,忘记设备并重新配对。 ## 应用状态变化,但实体状态灯不亮 1. 检查侧栏底部是否显示“设备已连接”。 2. 打开“试听”,选择一个标准状态。 3. 使用“试听当前灯效”重播效果。 4. 检查当前主题是否把该状态设置为熄灭或极低亮度。 5. 换用 Default 经典主题再次验证。 6. 断开并重新连接设备。 ## 灯光正常但没有提示音 并非每个主题、每个状态都带提示音。Minimal 极简主题默认无声,其他主题也可能只在“出错了”时发声。 1. 在“主题”页面确认当前主题是否包含声音。 2. 用“试听”测试“已完成”和“出错了”。 3. 换用带提示音的主题再次验证。 4. 如果灯效正常但所有带声音的测试都无声,记录设备故障提示并联系支持。 ## AI 编程工具无法连接 如果出现 Node.js、npm 或配套组件相关错误,先打开“接入”页面查看“运行环境”卡片: 1. 选择“重新检测”,确认 Node.js 版本至少为 20,且 npm 可以执行。 2. 如果自动检测不到文件,展开详情并分别选择 Node.js 与 npm 的可执行文件。 3. 如果 Adapter 缺失或不兼容,点击工具卡片的“连接”,确认安装或升级。 4. 确认 npm 软件源可以访问;安装或升级完成后再次连接工具。 5. 如果仍失败,使用“复制诊断信息”保留完整错误提示,不要反复手工修改工具配置。 ## 接入已连接但任务状态不更新 1. 确认 AI Light 应用仍在运行,而不是已从托盘退出。 2. 新建一次任务;已经运行中的旧会话可能没有加载新 Hook。 3. 检查连接的是本机运行的 Claude Code、Codex 或 WorkBuddy。 4. 在“接入”页面先断开,再重新连接。 5. 确认手动“试听”可以改变应用状态,以排除应用本身加载失败。 6. 云端任务或没有经过本机 Hook 的操作不会自动同步。 ## 状态长时间停留在“已完成”或“出错了” 某些主题会让终态保持显示,直到下一条任务事件到来;另一些主题会在短暂展示后自动回到空闲。 需要立即清除时,打开“试听”页面并选择“停止灯效”。 ## 主题无法导入或保存 1. 查看导入窗口或提示消息中的具体原因。 2. 确认文件扩展名为 `.ailight-theme.json`。 3. 确认主题名称没有与内置主题重复。 4. 如果是手写 JSON,使用 JSON 校验工具检查格式。 5. 以某个内置主题创建新主题,再逐步应用修改,可以更容易定位问题。 ## 关闭窗口后找不到应用 关闭窗口只会隐藏 AI Light。请在 macOS 菜单栏、Windows 通知区域或 Linux 系统托盘中找到 AI Light 图标,然后选择“显示窗口”。 如果托盘中也没有图标,重新启动 AI Light。 ## 开机自启没有生效 1. 检查 AI Light 设置中的“开机自启”。 2. 检查操作系统的登录项或启动应用列表。 3. 如果应用被移动或重新安装,先关闭再重新开启该设置。 4. 确认系统策略没有禁止用户级启动项。 ## 获取进一步支持 提交问题时请尽量提供: - 操作系统名称和版本; - AI Light 应用版本; - 使用的 AI 编程工具及版本; - 问题发生前的操作步骤; - 完整错误提示; - 设备页面显示的连接、电量或故障信息; - 问题能否通过“试听”稳定复现。 公开提交信息前,请移除用户名、目录、令牌和其他敏感内容。
leon
2026年9月5日 14:39
90
0 条评论
转发
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
加微信:17625815328
加QQ:1677943816
加微信:17625815328
加QQ:1677943816
分享
链接
类型
密码
更新密码
有效期
Markdown文件
Word文件
PDF文档
PDF文档(打印)