快速开始
这条路线面向第一次使用知言家 AI Coding 伴侣的用户。建议先走 USB 路线，因为它最容易确认设备和固件信息，也能在需要时重新开启设备蓝牙。
开始前，把这几样放在手边
- 电脑与用户账户：使用平时运行 AI 编程工具的电脑和账户。
- 知言家 AI Coding 伴侣设备：放在电脑附近，并确认设备有电。
- 可传输数据的 USB 线：只支持充电的线无法识别串口。
- 一个真实的 AI 项目：稍后将对应插件接入日常工作的项目。
首次使用路线
1. 下载并安装驱动
从官网驱动下载区下载安装程序，并沿用默认位置完成安装。如果下载没有自动开始，页面会转到官方发布中心。
详细步骤见安装与卸载驱动。
你应该看到
安装完成提示出现，Windows 右下角托盘区域新增知言家 logo。驱动没有弹出传统主窗口是正常现象。
2. 打开本机控制台
右键托盘中的知言家 logo，选择“打开控制台”。首次尚未连接设备时，页面显示“未连接”或“未发现设备”都属于正常状态。
3. 优先通过 USB 连接
使用数据线直接连接设备与电脑，等待数秒后刷新控制台。成功时，页面会显示“串口优先”“串口已连接”，并能读取设备名称或型号、固件版本和电量。
如果需要无线使用，再按照蓝牙绑定步骤在设备控制台内完成绑定。
4. 接入 AI 工具
根据正在使用的客户端选择对应说明：
插件配置会在客户端启动时读取。完成配置后，需要重启或重新打开对应客户端；出现 hook 信任提示时，先核对路径确实指向 zy-vibe-coding-driver 再允许。
4.1 接入 WSL 里的 AI 工具
OpenCode、Claude Code、Codex 运行在 WSL（Ubuntu） 内时，需要先在 Windows 宿主侧开启 netsh portproxy 桥接，让 WSL 内的工具能把事件投递到宿主的 driver（25263）。
在 Windows PowerShell 中粘贴运行下面脚本（自动定位 WSL 虚拟网卡 IP，仅对该地址监听；需要管理员，会弹出 UAC 请点"是"）：
powershell
$isAdmin = ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
$wslIp = (Get-NetIPAddress -AddressFamily IPv4 | Where-Object { $_.InterfaceAlias -like '*WSL*' -and $_.IPAddress -notlike '169.254*' } | Select-Object -First 1).IPAddress
if (-not $wslIp) { Write-Host '未找到 WSL 虚拟网卡 IP，请先启动一次 WSL 再试'; exit }
$cmd = "netsh interface portproxy add v4tov4 listenaddress=$wslIp listenport=25263 connectaddress=127.0.0.1 connectport=25263"
if ($isAdmin) { Invoke-Expression $cmd }
else { Start-Process powershell -Verb RunAs -ArgumentList "-NoProfile -Command `"$cmd`"" }完成后用 netsh interface portproxy show all 确认，应看到 <WSL适配器IP> 25263 → 127.0.0.1 25263。
重要：监听地址必须是 WSL 虚拟网卡 IP（如
172.31.96.1），不要写成0.0.0.0。0.0.0.0:25263会被系统独占占用，与 driver 的127.0.0.1:25263绑定冲突，导致驱动无法启动（报"端口被系统保留 / 拒绝监听"）。若show all里已有0.0.0.0 25263旧规则，先删除：netsh interface portproxy delete v4tov4 listenaddress=0.0.0.0 listenport=25263，重启 driver，再按上面脚本重建。
开启桥接后，回到接入 WSL 里的 OpenCode、接入 WSL 里的 Claude Code、接入 WSL 里的 Codex 完成对应配置。
5. 发送一条普通消息验证
让 AI 解释当前项目中的一个文件即可，不需要触发授权或运行危险命令。验证通过时：
- AI 开始处理后，控制台出现对应客户端的任务。
- 设备灯效随任务状态变化。
- 本轮完成后，控制台任务和设备灯语随之结束。
如果控制台任务会变化但设备没有亮，插件通常已经工作，应转去检查设备链路、电量或固件状态，而不是重复安装插件。
下一步请阅读安装与卸载驱动，了解下载文件选择、默认目录、托盘入口，以及卸载时会保留哪些配置。