Vokie 插件

Vokie 原生支持外接语音设备，MoteDeck 按它的插件协议做了适配。装上配套插件 MoteDeck2Vokie 之后， 遥控器就是 Vokie 自己的语音设备：按住话筒键说话，音频由插件推进 Vokie 会话，松手后整理成完整文字再落进输入框。

不用插件 vs 用插件

	不用插件	装上插件
通路	虚拟声卡：MoteDeck → CABLE Input → 输入法读 CABLE Output	本机回环 TCP 直连
需要配虚拟声卡	需要	不需要
需要模拟语音快捷键	需要	不需要
短按话筒键	切换语音模式	切换语音模式（同步 Vokie 的模式）
长按话筒键	开麦，松手结束	开启 Vokie 会话，松手整理成文字

安装插件

1. 在 MoteDeck「语音」页点「外部应用程序支持」，再点「下载插件」，或直接从 Releases 下载 MoteDeck2Vokie-0.1.2.zip。
2. 把 ZIP 装进 Vokie 的插件目录。
3. 在插件界面里点「开启连接」。

图中标号：① 下载插件　② 连接插件

装好后插件会与 MoteDeck 自动握手（随机端口 + 共享 token），走本机回环 127.0.0.1。

装了插件之后

• 语音模式同步：Vokie 的语音模式会同步到 MoteDeck 的语音键配置，按一下遥控器就能切换。
• 会话类型分流：闪记、翻译、语音指令各有各的通道；插件被拒时自动退回普通语音输入， 不会出现「按了没反应」。
• 短按 / 长按：短按只切模式并弹出模式气泡，长按（约 0.25 秒）才开启 Vokie 会话。 按下期间保留 0.8 秒预录缓冲，开会话后一并补发，开口第一个字不丢。
• 气泡时机：会话被插件接下（session_accepted）后气泡才收起；若输入框先出现，气泡也会提前收掉。
• 掉线兜底：插件语音键在插件未连接、写 socket 失败、掉线竞态时会回退到它自己的快捷键注入； 该键没有自己的快捷键时直接报失败，不会借用其它语音键的绑定。

会话记录

插件用 vokie-session.json 记录当前会话；握手成功时会补发一次陈旧的 session_stop， 清掉 Vokie 侧卡住的 activeSession。

断开插件

断开后，插件带来的语音键会统一清理并回落到各自的原生快捷键，虚拟声卡那条路照常可用。

排错

现象	处理
装了插件但按住话筒键没反应	在插件界面确认连接已开启；MoteDeck「语音」页应显示插件已连接
闪记只有提示音、没有胶囊	确认 Vokie 版本支持 quickNoteConfig；插件按该字段走闪记会话
短按想直接说话却只切了模式	短按本来就是切模式，说话请按住不放
文字没上屏	先在 Vokie 里用实体键盘确认它的语音能正常出字，再判断是否插件侧问题