企业官网建设流程全解析

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

录教程时你按下Ctrl + Shift + T，屏幕另一端的观众只能听到你口头解释"就是那个组合键"。Keyviz 是个免费开源的键鼠可视化工具，它把你敲的每个键、点下的每次鼠标都实时渲染成悬浮在桌面上的键帽和点击指示，让键盘和鼠标操作直接"看得见"。

一句话认识它

Keyviz 是一款跨平台的键鼠可视化桌面工具：你按下什么键、点了鼠标哪个位置，桌面上立刻浮现对应的键帽和图标，松手后自动淡出。它用 Tauri 构建——前端是 React 界面，Rust 端通过内置的 rdev 事件库（src-tauri/crates/rdev/）捕获全局输入事件，再铺一层置顶、透明、鼠标穿透的窗口来渲染，所以它盖在桌面最上层却完全不挡操作。Windows 和 macOS 有官方安装包，Linux 支持 X11 环境，完全免费开源。

三分钟装好它

Windows：到项目的 Releases 页下载.msi安装包，双击按向导安装即可。装完系统托盘会出现 Keyviz 图标，可视化层随之启动。

macOS：下载.dmg，把 Keyviz 拖进 Applications。首次启动后去"系统设置 → 隐私与安全性"，授予输入监控和辅助功能两项权限——缺了这两项，Keyviz 收不到按键。

Linux（X11）：目前走源码构建，先装好 Node.js 和 Tauri 前置依赖，然后：

git clone https://gitcode.com/gh_mirrors/ke/keyviz && cd keyviz npm install

这一步把仓库拉到本地并装好前端依赖。

npx tauri build

这一步编译出可执行文件，完成后按提示运行即可。

它最拿手的事

鼠标动作同样入镜。多数按键提示工具只管键盘，Keyviz 会把左键点击、滚轮滚动、拖拽直接画在光标旁边，"Cmd + Click""Alt + Drag"这类组合一眼可辨。做演示时，你可以专门展示一次Alt + 拖拽，观众会同时看到 Alt 键帽和光标处的拖拽图标。

三档过滤控制"演"什么。General 设置里的 Filter 有三档：Off（全部显示）、Hotkeys（只保留修饰键）、Custom（自定义白名单，按住 Ctrl 可批量勾选相关按键）。录视频前切到 Hotkeys，屏幕就只出现你刻意按的组合键，不会满屏噪音。

历史轨迹回放。打开 History 开关后，最近按过的键会留在画面里形成一条视觉轨迹，还能调保留条数和横竖排布方向；观众看到的是一段连续操作，而不是一张张孤立截图。

外观全可定制。键帽预设、修饰键高亮色、图标开关、按压计数（Press Count）、入场/出场动画都能调，还支持整套配置的导入/导出。键帽样式实现都在 src/components/keycaps/ 目录里，每种预设一个文件。

一个真实用法走查

以"给教程录像加按键字幕"为例：

1. 启动 Keyviz，从托盘菜单打开设置界面；
2. 在 Keycap 选项卡挑一个键帽预设（比如 Lowprofile），打开Highlight Modifier，让修饰键用强调色与普通键区分；
3. 回 General 选项卡，把 Filter 切到Hotkeys，按需打开 History；
4. 把显示区域拖到屏幕角落，调好大小和排列方向；
5. 开始录屏，正常操作即可——你按下的每个组合键都会以键帽动画浮现，松开后淡出，观众全程知道你在按什么。

卡住了看这里

• 启动后屏幕什么都没有→ 原因：macOS 没给输入监控/辅助功能权限，或 Filter 设在 Custom 但白名单是空的 → 解法：到系统设置补齐权限；把 Filter 先切回Off验证。
• 个别键不显示→ 原因：该键不在 Custom 白名单里 → 解法：打开 Custom Filter 面板（实现见 src/components/custom-filter.tsx），把目标按键勾回来。
• 可视化层挡住操作→ 正常情况鼠标穿透是开启的（见 src-tauri/src/app/window.rs 里的set_ignore_cursor_events(true)）→ 解法：检查是否叠加了其他置顶工具，或退出 Keyviz 重启一次。
• Linux 上装不了→ 原因：官方安装包只覆盖 Windows 与 macOS → 解法：确认是 X11 环境（Wayland 不支持），按上面源码构建流程走。

值不值得装

录教程的内容作者、做远程支持的技术人员、想复盘自己操作习惯的开发者，是它最典型的使用者。判断标准很简单：只要你曾需要让别人"看见"你按了什么、点了哪里，Keyviz 就值得一试。开源免费、装好即用，也不改变你任何操作习惯——从托盘启动它，试一两次Alt + 拖拽，你就知道它值不值了。

【免费下载链接】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