这是正常设计。驱动默认在系统托盘后台运行。点击任务栏右下角的隐藏图标箭头，找到知言家 logo，右键后选择“打开控制台”或“打开设置”。
常见问题
下面收录首次安装和日常使用中最常遇到的恢复动作。需要先判断故障层时，请从故障排查开始。
先确认使用的是数据线，再尝试重新插拔、更换电脑 USB 口和更换数据线。在控制台中点击“选择串口”与“刷新串口”。如果扫描后仍然为空，先不要反复安装 AI 插件，因为问题还停留在设备链路层。
让设备靠近电脑，等待上一轮扫描结束后再点击“扫描设备”。如果设备蓝牙曾被关闭，必须先通过 USB 连接，再在设置页重新开启“设备蓝牙”。
“已绑定”只表示驱动记住了设备，不表示 GATT 和 PING 已经验证。先等待自动重连；长时间无法恢复时，使用“清除绑定”忘记旧记录，再重新扫描和绑定。
这是设计行为。串口就绪时，驱动采用“串口优先”，BLE 保持热备。拔掉 USB 后，已经就绪的 BLE 才会接管普通任务链路。
如果控制台任务已经变化，说明插件通常正在工作。检查页面是否仍显示“串口优先”或“BLE 就绪”，再检查设备电量。电量不高于 20% 时，固件低电状态可能优先显示。
修复功能可以增量维护 Codex、Claude Code 和 TRAE 的用户级脚本与 Hook 配置，也能修复 opencode 全局插件，但不会安装项目级 opencode 插件，也不能替你在 TRAE 中启用 Agent Hooks。修复后请重启对应客户端；Codex 或 Claude Code 需要确认 Hook 信任，TRAE 需要启用 Agent Hooks 并选择“本地自动运行”。
卸载器只会从 TRAE 用户配置中精确移除驱动自己的 handler，并删除对应转发脚本；其他 TRAE Hook 会保留。Codex、Claude Code 和 opencode 的用户或项目配置不会自动清理。确认不再使用后，请先备份原文件，再分别移除对应条目。
“已安装（需在 TRAE 中启用）”只表示用户级脚本和 hooks.json 已就位。请在 TRAE 的 Agent Hooks 页面启用用户级 Driver Hook，选择“本地自动运行”，核对命令指向 .trae-cn\zy-vibe-coding-driver.ps1，然后重启或重新载入 TRAE。
知言家不是普通的桌面氛围灯，而是专为 AI 编程工作流设计的状态外设。普通 RGB 灯只能手动切换颜色或播放固定灯效，而知言家能通过本地驱动深度对接 Codex、Claude Code、OpenCode、TRAE 等 AI 编程工具，实时同步任务状态（进行中、等待审批、已完成、失败等），让你不用切窗口就能知道 AI 任务进度。它解决的是“AI 在后台跑，我要不要去看一眼”的注意力切换问题。
不会。知言家只接收 AI 工具发出的任务状态信号（如进行中、待审批、已完成），不接触代码内容，也不需要联网。
目前原生支持 Codex、OpenCode、Claude Code 三款主流 AI 编程工具，TRAE 可在 Windows 10/11 上使用（需在 TRAE 中启用 Agent Hooks 并选择“本地自动运行”）。驱动目前仅支持 Windows 10/11 系统，macOS 和 Linux 版本正在规划中。对于支持本地 stdio MCP 的其他 AI 客户端，还可以使用驱动内置的 MCP 服务作为兼容方案接入。
对于经常使用 AI 编程工具的开发者，价值主要体现在三点：一是减少上下文切换，不用每隔几十秒切回终端看结果，思路不被打断；二是不浪费等待时间，审批请求和任务完成会通过灯光提醒，你可以放心去做其他事；三是保护专注状态，安静的视觉提示比弹窗和声音更不容易打断心流。如果你每天用 AI 编程工具超过 1 小时，长期下来节省的注意力成本是很可观的。
可以。知言家的灯语分为两层：中心区域表示任务来源（Codex、Claude Code、OpenCode、TRAE 各有默认颜色，也可自定义），外圈表示任务状态（进行中、需要你、已完成等）。你可以在驱动控制台中为每个工具和每种状态自定义颜色，也可以调整灯效亮度。官网首页的灯效预览区可以实时体验不同效果和颜色搭配。