What's Changed

• fix: harden terminal auto-paste reliability and logging by @vimalinx in #2

New Contributors

• @vimalinx made their first contribution in #2

Full Changelog: v0.2.1...v0.2.2

Contributors

• @vimalinx

Bug Fix

• 修复 OpenClaw 路由稳定性:提升后侧键录音停止后的分发可靠性,并增加更清晰的分发原因日志(便于定位失败路径)。
• 增强后侧键冲突排查:内置 vibemouse doctor 现在可识别输入权限与 Hyprland 绑定冲突,避免侧键事件被系统/应用误抢占导致行为异常。

Improvements

• 新增 vibemouse doctor 子命令:覆盖配置有效性、OpenClaw 命令与 agent、麦克风输入、Linux 输入设备权限、服务状态等检查。
• 新增 OpenClaw 重试配置:VIBEMOUSE_OPENCLAW_RETRIES。
• 重写中英文 README,补齐架构、部署和故障排查说明。
• 新增 AI 助手专用部署/适配指南(中英双语),便于用户让本地 AI 助手做平台适配。

Verification

• python -m compileall vibemouse 通过
• python -m unittest discover -s tests -p \"test_*.py\" 通过(114 tests)

更新亮点

• 新增 OpenClaw 录音态分流:前侧键开始录音后,后侧键会停止录音并将转写直接发送到 OpenClaw(空闲态后侧键仍是 Enter)。
• 新增 OpenClaw 配置项:VIBEMOUSE_OPENCLAW_COMMAND、VIBEMOUSE_OPENCLAW_AGENT、VIBEMOUSE_OPENCLAW_TIMEOUT_S,支持自定义命令与 agent。
• 引入系统集成抽象层(system_integration),统一 Hyprland 工作区切换、快捷键、光标与焦点能力,为后续 Windows/macOS 适配打基础。
• 完善终端场景粘贴策略与状态路由,增强回退逻辑,降低日常使用中的误触和漂移风险。
• 补齐大规模回归测试(app/config/output/mouse_listener/system_integration)并同步更新中英文文档。

部署提示

• 部署到你自己的环境时,可将 VIBEMOUSE_OPENCLAW_AGENT 改成你的本地 AI 助手 ID(例如 main、ops 或自定义 agent 名称)。

兼容性与验证

• 在合并后分支上完成 python -m compileall vibemouse 和 python -m unittest discover -s tests -p \"test_*.py\",结果全部通过。
• 本次版本面向 Linux(Hyprland)日常使用稳定性优化,跨平台适配接口已预留。

更新亮点

• 修复 Hyprland 终端场景下的自动粘贴:终端窗口优先使用 Ctrl+Shift+V,失败回退 Shift+Insert。
• 保留通用 GUI 粘贴路径,非终端窗口继续使用系统快捷键与回退机制。
• 增加终端检测与粘贴路由回归测试,覆盖窗口 class/title 识别与多级回退。
• 更新中英文文档,补充 Hyprland 侧键与终端粘贴说明。

更新亮点

• 增强了鼠标侧键映射与去抖控制,录音开始/停止与提交流程在日常使用中更稳定。
• 改进了 Wayland/Hyprland 下的行为,优先使用系统级快捷键路由处理回车与自动粘贴回退。
• 强化了配置校验、临时音频文件处理与运行时诊断信息。
• 新增回归测试,覆盖配置解析、输出路由与录音生命周期关键路径。

适用场景

• Linux + Wayland(尤其 Hyprland)下的侧键语音输入工作流。
• 需要"按键即说、录完即贴、侧键提交"的高频日常使用。