Keyviz：实时按键与鼠标操作可视化工具 #

Keyviz 是什么？ #

Keyviz 是一款免费开源的按键与鼠标操作实时可视化工具，它会在屏幕上生成一个轻量悬浮窗，实时显示你当前按下的每一个键盘按键、组合键，以及鼠标的点击、滚轮和拖拽动作。

它主要服务于录屏教程、直播讲解、在线教学、产品演示和远程协助等场景：以往观众只能看到结果，却不知道操作者按了什么键；Keyviz 把这些"看不见的输入"直接搬到画面上，让每一步操作都清晰可循。软件安装包仅数 MB 大小，后台静默运行，几乎不占用系统资源，也不会打断你正常的打字与点击习惯，录屏时开启、录完随手关闭即可。它完全开源免费，无需注册账号，也没有广告和内购。

Keyviz 有哪些亮点特色？ #

• 实时按键可视化：按下即显示，延迟极低，既能呈现单个按键，也能完整展示 Ctrl + Shift + K 这类多键组合，观众一眼就能看懂操作逻辑。
• 鼠标动作同步展示：除键盘外，还能显示鼠标左键、右键、中键点击，滚轮上下滚动以及拖拽动作，覆盖演示过程中的全部输入行为。
• 外观高度可定制：按键框的颜色、背景、边框、圆角、阴影、字号以及出现与消失动画均可自由调整，可轻松匹配不同录屏画面的视觉风格。
• 位置与排布灵活：悬浮窗可放置在屏幕的任意角落或自定义位置，支持水平、垂直方向堆叠，并可调整缩放与透明度，避免遮挡画面主体内容。
• 按键过滤与忽略：支持设置忽略列表或白名单，隐藏修饰键、功能键等不必要的输入，也可以避免敏感按键出现在录制画面中，让演示更干净。
• 轻量开源无广告：项目完全开源、免费使用，无广告、无内购、无账号体系；2.x 系列安装包仅约 4 MB，后台运行内存占用低。
• 跨平台原生支持：同时提供 Windows 与 macOS 安装包，macOS 版本区分 Intel（x64）与 Apple Silicon（aarch64）两种芯片架构，按机器选择即可。
• 零干扰即开即用：启动后自动在桌面显示悬浮窗，不需要复杂配置；不录制视频、不修改系统设置，用完直接退出，不影响日常键鼠操作。

免费下载 Keyviz #

以下为官方提供的各平台安装包，点击链接即可下载。请根据自己的操作系统与芯片架构选择对应文件。

说明：上表中的版本号、文件名与体积来自下载信息本身；其他历史版本与 Linux 版安装包官网未说明。

Keyviz 如何使用？ #

Keyviz 的操作逻辑非常直观，基本流程如下：

1. 启动程序：安装完成后运行 Keyviz，屏幕默认位置会出现一个半透明的按键悬浮窗，此时敲击键盘就能看到实时反馈。
2. 打开设置界面：在悬浮窗上右键，或通过系统托盘（Windows）/ 菜单栏（macOS）图标进入设置面板，所有可调项都集中在这里。
3. 调整外观样式：在样式或外观（Appearance / Visual）选项中修改按键框颜色、文字颜色、背景、边框粗细、圆角、阴影、字号与动画时长，使它和你的录屏画面配色统一。
4. 设置位置与方向：在位置（Position）选项中把悬浮窗固定到屏幕的左上、右上、左下、右下或自定义坐标，并选择水平或垂直排布，避免挡住演示重点区域。
5. 配置按键过滤：在过滤（Filter）选项中把不需要展示的按键加入忽略列表，或只保留白名单中的按键，例如隐藏单独按下的 Shift、Ctrl 等修饰键。
6. 配合录屏软件使用：打开 OBS Studio、系统自带录屏工具等开始录制，观众即可在画面中同步看到你的按键与鼠标动作；录制结束后直接退出 Keyviz 即可。

提示：Keyviz 本身不具备录屏功能，它是作为"叠加层"与录屏软件配合工作的。若悬浮窗没有出现在录制画面中，请在录屏软件里确认选择了正确的屏幕捕获方式。

Keyviz 的常见问题？ #

Keyviz 会把我的按键内容上传到服务器吗？ Keyviz 是开源项目，没有账号体系与云端同步功能，按键读取与渲染都在本地完成。官方仓库中未单独说明隐私政策条款，如果对安全性有要求，可以直接查阅源码自行验证。需要注意的是，这类工具必须读取全局键盘事件，因此才需要相应的系统权限。

为什么安装后按键盘没有任何反应？ 在 macOS 上，需要在「系统设置 → 隐私与安全性 → 辅助功能」（部分系统版本还需开启「输入监控」）中为 Keyviz 授予权限，否则程序无法读取全局按键事件；授予权限后建议重启一次 Keyviz。在 Windows 上，请确认程序仍在后台运行，并检查是否被安全软件拦截。

Keyviz 能直接录屏或录制成视频吗？ 不能。Keyviz 只负责把按键和鼠标操作可视化，输出的是屏幕上的悬浮窗画面，需要搭配 OBS Studio、系统自带录屏等工具一起使用。

如何隐藏某些按键，避免出现在录制画面里？ 使用设置中的按键过滤功能，把不想显示的按键加入忽略列表；也可以只保留需要展示的按键。建议在正式录制前先试敲一遍，确认画面上没有多余的按键提示。

aarch64 和 x64 应该选哪个安装包？ aarch64 对应 Apple Silicon（M 系列芯片）的 Mac 设备，x64 对应 64 位 Windows（以及 Intel 芯片的 Mac）。选错架构会出现无法安装或运行异常的情况，可在「关于本机」或「系统信息」中查看自己的芯片类型。

Keyviz 支持 Linux 或手机端吗？ 官网未说明是否提供 Linux、Android 或 iOS 版本，目前下载信息中仅包含 Windows 与 macOS 安装包，其他平台请以官方仓库的发布说明为准。

Keyviz 如何安装？ #

Windows #

1. 下载 keyviz_2.1.0_x64_en-US.msi 安装包。
2. 双击该 MSI 文件，启动安装向导。
3. 若系统弹出 Windows Defender SmartScreen 提示，点击「更多信息」→「仍要运行」继续。
4. 按向导提示完成安装，安装结束后从开始菜单启动 Keyviz。
5. 启动后即可在屏幕上看到按键悬浮窗，无需额外配置。

注意：x64 安装包适用于 64 位 Windows 系统；ARM 架构 Windows 设备是否受支持，官网未说明。

macOS #

1. 先确认芯片类型：Apple Silicon（M 系列）下载 keyviz_2.1.0_aarch64.dmg。
2. 双击 DMG 文件挂载磁盘映像。
3. 将 Keyviz 图标拖入「应用程序」文件夹。
4. 首次打开时若提示「无法验证开发者」，请在「系统设置 → 隐私与安全性」中点击「仍要打开」，或右键点击应用图标选择「打开」。
5. 按提示为 Keyviz 授予「辅助功能」权限（部分系统版本还需开启「输入监控」），然后重启应用即可正常显示按键。

Linux #

官网未说明是否提供 Linux 安装包及对应的安装方式，如需使用请关注官方仓库的发布说明。

Keyviz 如何卸载？ #

Windows #

1. 打开「设置 → 应用 → 已安装的应用」（Windows 10 为「应用和功能」）。
2. 在列表中找到 Keyviz，点击右侧的「卸载」。
3. 也可以打开「控制面板 → 程序和功能」，选中 Keyviz 后点击「卸载」。
4. 按卸载向导提示完成操作，必要时重启系统。

提示：通过 MSI 安装的程序通常会被完整移除；若卸载后仍有残留，可手动检查安装目录与用户配置目录（具体路径官网未说明）。

macOS #

1. 先退出正在运行的 Keyviz（菜单栏图标 → 退出）。
2. 打开「访达 → 应用程序」，将 Keyviz 图标拖入废纸篓。
3. 清空废纸篓即可完成卸载。
4. 如需彻底清理残留，可检查用户资源库中与 Keyviz 相关的配置与缓存目录（~/Library/Application Support、~/Library/Preferences、~/Library/Caches 等），官方未说明具体的残留路径，删除前请确认目录归属。

Linux #

官网未说明 Linux 版本的安装方式，因此对应的卸载方式亦未说明。