Keyviz 键鼠可视化：3 步让每个快捷键都清晰可见
【免费下载链接】keyvizKeyviz is a free and open-source tool to visualize your keystrokes ⌨️ and 🖱️ mouse actions in real-time.项目地址: https://gitcode.com/gh_mirrors/ke/keyviz
录教程时，你按下Ctrl + Shift + T，屏幕另一端的观众却只能听到你说"就是那个恢复标签页的组合键"；远程支持时，你让对方"点一下那个图标"，对方却不知道你的鼠标左键点在哪里。这类沟通断点，一个键鼠可视化工具就能补上。
Keyviz 是一款免费开源的桌面工具，把你按下的每个键和每一次鼠标动作，实时渲染成悬浮在桌面按键上的键帽和点击指示——Windows 与 macOS 提供官方安装包，Linux 可从源码构建（X11 环境）。
⚙️ 工作原理：一个"看不见"的覆盖层
Keyviz 基于 Tauri 构建：前端是 React + TypeScript 的界面，Rust 侧负责全局事件监听，核心是内置的 rdev 事件库（src-tauri/crates/rdev/）。启动后它会在桌面铺一层透明窗口，这层窗口有三个特性：
- 置顶透明：盖在所有窗口之上，但背景完全透明，不遮挡你的桌面；
- 鼠标穿透：窗口被设置为忽略鼠标事件，你可以照常点击、拖拽，可视化层不会挡路；
- 事件驱动：键盘和鼠标事件一经捕获，立刻渲染成带入场/出场动画的键帽，延迟接近于零。
效果上，一次Alt + 拖拽会在屏幕上同时出现 Alt 键帽和拖拽指示；普通打字则是按键逐一浮现、逐一消失。
📥 最短路径装好 Keyviz
Windows / macOS（推荐）：到项目的 Releases 页下载对应安装包即可。
- Windows：下载
.msi，双击按向导安装，完成后系统托盘会出现 Keyviz 图标； - macOS：下载
.dmg拖入 Applications。首次启动后，去"系统设置 → 隐私与安全性"中授予输入监控和辅助功能两项权限，否则收不到按键。
Linux（X11）：目前以源码构建为主，环境需有 Node.js 和 Tauri 前置：
git clone https://gitcode.com/gh_mirrors/ke/keyviz && cd keyviz npm install npx tauri build✨ 三个最值得试的能力
1. 鼠标动作同样入镜。多数按键提示工具只管键盘，Keyviz 会把左键点击、滚轮滚动、拖拽直接画在光标附近，"Cmd + Click""Alt + Drag"这类组合一眼可辨，做演示时鼠标操作不再是黑盒。
2. 三级过滤，决定"演"给观众看什么。General 设置里的过滤项有三档：Off（全部显示）、Hotkeys（只显示修饰键）、Custom（自定义白名单，按住 Ctrl 可批量勾选相关按键）。录视频时切到 Hotkeys，屏幕只出现你刻意展示的组合键，避免满屏噪音。
3. 历史轨迹回放。开启 History 后，最近按过的键会保留在画面中形成一条视觉轨迹，并可调保留条数——观众看到的是一段操作过程，而不是一张张孤立截图。配合 Press Count 还能统计每个键被按了多少次。
🎥 一个具体用法：给教程录像加"字幕级"按键提示
- 启动 Keyviz，从托盘菜单打开设置界面；
- 在 Keycap 选项卡挑一个外观预设（如 Lowprofile），打开Highlight Modifier，让修饰键用强调色与普通键区分；
- General 里过滤切到Hotkeys，按需打开 History；
- 把显示区域拖到屏幕角落，调好大小与对齐方式（支持导入/导出整套外观配置）；
- 开始录屏，正常操作即可——你按下的每个组合键都会以键帽动画呈现。
🩹 遇到问题先查这里
- 现象：启动后屏幕什么都没有→ 可能原因：macOS 未授予输入监控/辅助功能权限；或过滤被设为 Custom 但白名单为空 → 处理：到系统设置补齐权限；过滤档位先切回
Off验证。 - 现象：某些键不显示→ 可能原因：该键不在 Custom 白名单内 → 处理：进 Custom Filter 面板把目标按键勾回来。
- 现象：窗口挡住桌面操作→ 正常情况 Keyviz 的可视化层是鼠标穿透的，若某窗口被挡住，检查是否误用了其他置顶工具，或退出 Keyviz 后重启它。
- 现象：Linux 上无法安装→ 当前官方安装包只覆盖 Windows 与 macOS，Linux 需 X11 环境并走上面的源码构建流程。
🎯 它适合谁
录教程的内容作者、做远程支持的技术人员，以及想复盘自己操作习惯的开发者，是它最典型的用户。判断标准很简单：只要你需要让别人"看见"你按了什么，Keyviz 就值得一试——开源免费，装好即用，不改变你的任何操作习惯。
【免费下载链接】keyvizKeyviz is a free and open-source tool to visualize your keystrokes ⌨️ and 🖱️ mouse actions in real-time.项目地址: https://gitcode.com/gh_mirrors/ke/keyviz
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
