开源项目自动化与 Agent 类新手
Keyviz:实时可视化按键与鼠标操作的开源工具
Keyviz 是一款免费开源工具,可实时可视化键盘按键与鼠标动作(如 Cmd + Click、Alt + Drag、点击与滚轮滚动),适合教程录制、演示讲解与协作分享场景。支持颜色、尺寸、布局、边框、背景、筛选、历史轨迹、位置与出入动画等全面自定义;提供 Windows MSI、macOS DMG 安装包,Linux 目前可在 X11 协议下通过源码构建使用。
0 次阅读2026/09/15 发布
#按键可视化#鼠标动作可视化#Tauri#Rust#桌面应用#教程演示辅助#跨平台#实时输入显示#自动化与 Agent 类#AI Agent#自动化#mulaRahul(GitHub 仓库 mulaRahul/keyviz)
社区作者 · zZz
它解决什么问题
Keyviz 是一款免费、开源的工具,能够实时可视化你的按键与鼠标动作。它可以让观众在教程、演示、协作或任何需要的场合中,清楚看到你正在按下的便捷快捷键。
核心能力
⌨️ 按键 & 🖱️ 鼠标动作
- 除普通按键外,还可视化鼠标动作,例如 Cmd + Click、Alt + Drag 等。
- 在光标旁显示鼠标点击与滚轮滚动动作。
- 配图 1 展示了按键可视化(Keystroke Visualization)效果。
- 配图 2 展示了鼠标指示器(Mouse Indicator)效果。
⚙️ 全面自定义
不必接受默认样式,可视化的每个方面都由你控制(配图 3 为设置面板):
- 样式(Styling):修改颜色(修饰键与普通键分别设置)、尺寸、布局、边框和背景。
- 筛选(Filtering):通过热键或自定义过滤器控制显示哪些按键。
- 历史(History):保留最近输入的可视轨迹。
- 位置(Position):将可视化窗口移动到屏幕任意位置。
- 动画(Animations):使用预设的进入与退出动画,自定义输入出现和消失的方式。
安装方式
Windows 与 macOS
从 GitHub Releases 页面下载 Keyviz 最新版本:
- Windows:下载 .msi 安装程序,运行并按照步骤完成安装。
- macOS:下载 .dmg 文件。
- 注意:Keyviz 需要“输入监控(Input Monitoring)”和“辅助功能(Accessibility)”权限,请在以下位置启用:设置 > 隐私与安全性 > 输入监控 与 辅助功能。
Linux(x11)
Keyviz 兼容使用 X11 协议的 Linux。目前你可以按照下面的构建说明进行试用。
🛠️ 构建说明
如果你想贡献代码或从源码构建最新功能,请确保系统已安装 Node.js 与 Tauri。
- 克隆仓库:
git clone https://github.com/mulaRahul/keyviz.gitcd keyviz- 安装依赖:
npm install- 构建可执行文件:
npx tauri build支持项目
- 给仓库点 Star:帮助更多人发现该项目。
- GitHub Sponsors:赞助 @mularahul。
- Keyviz Pro:在支持该开源项目开发的同时获取专属功能,可在 keyviz.org/pro 升级到 Pro。
项目使用 Tauri 构建(Built with 🦀 and ❤️ using Tauri)。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
准备环境
- Windows / macOS 用户:无需开发环境,直接下载安装包即可。
- Linux 用户:目前仅兼容 X11 协议,需要通过源码构建试用。
- 源码构建者:需在系统中准备好 Node.js 与 Tauri。
一、Windows 与 macOS 安装
- 打开 GitHub Releases 页面,下载 Keyviz 最新版本。
- Windows:下载 .msi 安装程序,运行它并按照步骤完成安装。
- macOS:下载 .dmg 文件并安装。
- 首次运行常见问题(权限):Keyviz 需要“输入监控(Input Monitoring)”和“辅助功能(Accessibility)”权限,请前往 设置 > 隐私与安全性 > 输入监控 与 辅助功能 中启用;未授权时按键/鼠标动作可能无法被捕获显示。
二、Linux(x11)源码构建
- 确认系统使用 X11 协议,并已安装 Node.js 与 Tauri。
- 克隆仓库:
git clone https://github.com/mulaRahul/keyviz.gitcd keyviz- 安装依赖:
npm install- 构建可执行文件:
npx tauri build- 首次运行:使用构建产物启动 Keyviz,按需在设置面板中调整样式、筛选、历史、位置与动画。
常见问题
- 看不到按键/鼠标显示:检查系统是否已授予输入监控与辅助功能权限;Linux 下确认处于 X11 会话而非其它显示协议。
- 显示内容过多或过杂:使用热键或自定义过滤器筛选要显示的按键。
- 想更换外观:在设置面板调整颜色(修饰键与普通键)、尺寸、布局、边框、背景,以及进入/退出动画。
- 想要更多功能:可了解项目方提供的 Keyviz Pro(keyviz.org/pro)。
适用场景
录制教程或课程时向观众展示正在按下的快捷键
演示与演讲中实时呈现键盘与鼠标操作
直播或协作/远程会议中说明操作步骤
展示 Cmd + Click
Alt + Drag 等组合鼠标操作
按需筛选只显示特定快捷键
保持画面简洁
在 Linux X11 环境下自行构建并试用
开发者参与贡献或基于源码构建最新功能