Keyviz 安装指南：Windows、macOS、Linux 全平台部署教程

引言

Keyviz 是一款免费开源的键鼠输入可视化工具（Keyviz），能够实时显示键盘按键和鼠标操作。无论是制作屏幕录制教程、进行在线演示还是协作开发，它都能让观众清晰地看到您使用的快捷键和操作步骤，极大提升教学和演示效果。本文将提供详尽的跨平台安装指南，帮助您在 Windows、macOS 和 Linux 系统上快速部署 Keyviz。

一、Windows 系统安装步骤

1.1 系统要求

• 操作系统：Windows 10 或更高版本（64位）
• 最低配置：4GB RAM，100MB 可用磁盘空间

1.2 安装方法

方法一：通过 Microsoft Store 安装（推荐）

1. 打开 Microsoft Store 应用
2. 在搜索栏输入 "Keyviz"
3. 点击 "获取" 按钮进行安装
4. 安装完成后，可从开始菜单启动 Keyviz

方法二：使用 Winget 命令行安装

1. 按下 Win + X，选择 "命令提示符(管理员)" 或 "Windows PowerShell(管理员)"
2. 输入以下命令并回车：

winget install mulaRahul.Keyviz

3. 等待安装完成，Keyviz 将自动添加到开始菜单

方法三：使用 Scoop 包管理器安装

1. 若未安装 Scoop，请先执行以下命令安装：

iwr -useb get.scoop.sh | iex

2. 添加 extras 仓库并安装 Keyviz：

scoop bucket add extras
scoop install keyviz

方法四：手动安装

1. 访问 Keyviz 发布页面
2. 下载最新的 Windows 版本安装包（.exe 或 .zip）
3. 若是 .exe 文件，双击运行并按照安装向导操作
4. 若是 .zip 文件，解压到任意目录，双击 keyviz.exe 启动程序

1.3 常见问题解决

问题：启动时提示缺少 .dll 文件

这通常是由于缺少 Visual C++ 运行库导致的。解决方法：

1. 访问 Microsoft Visual C++ redistributable 下载页面
2. 下载并安装与系统匹配的最新版本
3. 重启电脑后再次尝试启动 Keyviz

二、macOS 系统安装步骤

2.1 系统要求

• 操作系统：macOS 10.14 (Mojave) 或更高版本
• 支持的处理器：Intel 和 Apple Silicon (M1/M2) 芯片

2.2 安装方法

方法一：通过 DMG 安装包安装

1. 访问 Keyviz 发布页面
2. 下载最新的 macOS 版本 DMG 文件
3. 双击 DMG 文件，将 Keyviz 拖入 Applications 文件夹
4. 从启动台或应用程序文件夹启动 Keyviz

2.3 权限设置（关键步骤）

Keyviz 需要以下系统权限才能正常工作：

启用 Input Monitoring 权限

1. 启动 Keyviz，当系统提示需要权限时，点击 "打开系统偏好设置"
2. 在系统偏好设置中，点击 "安全性与隐私"
3. 切换到 "隐私" 选项卡，选择左侧的 "输入监视"
4. 点击左下角的锁图标，输入管理员密码解锁设置
5. 勾选 Keyviz 旁边的复选框授予权限

启用 Accessibility 权限

1. 在同一 "隐私" 选项卡中，选择左侧的 "辅助功能"
2. 同样勾选 Keyviz 旁边的复选框
3. 关闭系统偏好设置，重启 Keyviz 使设置生效

flowchart TD
    A[启动 Keyviz] --> B{系统提示权限请求?};
    B -->|是| C[点击"打开系统偏好设置"];
    B -->|否| D[手动打开系统偏好设置];
    C --> E[进入"安全性与隐私"];
    D --> E;
    E --> F[切换到"隐私"选项卡];
    F --> G[选择"输入监视"];
    G --> H[解锁设置并勾选Keyviz];
    H --> I[选择"辅助功能"];
    I --> J[勾选Keyviz];
    J --> K[重启Keyviz完成设置];

三、Linux 系统安装步骤

3.1 系统要求

• 操作系统：Ubuntu 18.04、Fedora 30 或其他兼容的 Linux 发行版
• 架构：x86_64（64位）

3.2 安装前准备

对于 Ubuntu/Debian 系统，需要先安装依赖库：

sudo apt-get update
sudo apt-get install -y libayatana-appindicator3-dev

或

sudo apt-get install -y appindicator3-0.1 libappindicator3-dev

对于 Fedora/RHEL 系统：

sudo dnf install -y libappindicator-gtk3

3.3 安装方法

方法一：Debian/Ubuntu 系统（.deb 包）

1. 下载最新的 .deb 安装包：

wget https://gitcode.com/gh_mirrors/ke/keyviz/releases/download/v2.x.x/keyviz_x.x.x_amd64.deb

2. 安装 deb 包：

sudo apt install ./keyviz_x.x.x_amd64.deb

方法二：Fedora/RHEL 系统（.rpm 包）

1. 下载最新的 .rpm 安装包：

wget https://gitcode.com/gh_mirrors/ke/keyviz/releases/download/v2.x.x/keyviz-x.x.x-1.x86_64.rpm

2. 安装 rpm 包：

sudo rpm -i keyviz-x.x.x-1.x86_64.rpm

方法三：手动编译安装

1. 确保已安装 Flutter SDK：

sudo snap install flutter --classic
flutter doctor

2. 克隆代码仓库：

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

3. 编译项目：

flutter pub get
flutter build linux --release

4. 安装编译结果：

sudo cp -r build/linux/x64/release/bundle /opt/keyviz
sudo ln -s /opt/keyviz/keyviz /usr/local/bin/keyviz

3.4 启动 Keyviz

安装完成后，可以通过以下方式启动：

• 应用菜单中搜索 "Keyviz" 并点击启动
• 终端输入 keyviz 命令

四、Linux 系统安装步骤

4.1 系统要求

• 操作系统：Ubuntu 18.04、Fedora 30 或其他兼容的 Linux 发行版
• 架构：x86_64（64位）

4.2 安装前准备

对于 Ubuntu/Debian 系统，需要先安装依赖库：

sudo apt-get update
sudo apt-get install -y libayatana-appindicator3-dev

或

sudo apt-get install -y appindicator3-0.1 libappindicator3-dev

对于 Fedora/RHEL 系统：

sudo dnf install -y libappindicator-gtk3

4.3 安装方法

方法一：Debian/Ubuntu 系统（.deb 包）

1. 下载最新的 .deb 安装包：

wget https://gitcode.com/gh_mirrors/ke/keyviz/releases/download/v2.x.x/keyviz_x.x.x_amd64.deb

2. 安装 deb 包：

sudo apt install ./keyviz_x.x.x_amd64.deb

方法二：Fedora/RHEL 系统（.rpm 包）

1. 下载最新的 .rpm 安装包：

wget https://gitcode.com/gh_mirrors/ke/keyviz/releases/download/v2.x.x/keyviz-x.x.x-1.x86_64.rpm

2. 安装 rpm 包：

sudo rpm -i keyviz-x.x.x-1.x86_64.rpm

方法三：手动编译安装

1. 确保已安装 Flutter SDK：

sudo snap install flutter --classic
flutter doctor

2. 克隆代码仓库：

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

3. 编译项目：

flutter pub get
flutter build linux --release

4. 安装编译结果：

sudo cp -r build/linux/x64/release/bundle /opt/keyviz
sudo ln -s /opt/keyviz/keyviz /usr/local/bin/keyviz

4.4 启动 Keyviz

安装完成后，可以通过以下方式启动：

• 应用菜单中搜索 "Keyviz" 并点击启动
• 终端输入 keyviz 命令

五、首次启动与基础配置

5.1 启动 Keyviz

• Windows：从开始菜单或桌面快捷方式启动
• macOS：从启动台或应用程序文件夹启动
• Linux：从应用菜单或终端输入 keyviz 启动

5.2 基础设置

首次启动后，建议进行以下基础设置：

1. 位置调整：

   • 右键点击任务栏/菜单栏中的 Keyviz 图标
   • 选择 "设置" > "位置"
   • 拖动预览窗口到屏幕合适位置（通常建议屏幕顶部中央或右下角）

2. 显示设置：

   • 在设置窗口中，调整 "显示时长"（建议 2-3 秒）
   • 根据需要勾选 "显示鼠标点击"、"显示组合键" 等选项

3. 外观设置：

   • 选择喜欢的主题样式（如 "机械键盘"、"简约" 等）
   • 调整按键大小和透明度以适应您的屏幕

六、验证安装

安装完成后，可以通过以下步骤验证 Keyviz 是否正常工作：

1. 确保 Keyviz 正在运行（任务栏/菜单栏有相应图标）
2. 打开任意文本编辑器（如记事本、TextEdit 等）
3. 开始 typing 任意文字，观察屏幕上是否显示按键提示
4. 尝试使用组合键（如 Ctrl+C、Ctrl+V），确认是否能正确识别
5. 测试鼠标点击（左键、右键、中键），检查是否有相应指示

如果以上操作都能正常显示，则说明 Keyviz 安装成功。

七、总结

Keyviz 作为一款强大的键鼠可视化工具，支持 Windows、macOS 和 Linux 三大主流操作系统。通过本指南提供的详细步骤，您可以根据自己的系统选择最合适的安装方式，并快速完成基础配置。无论是制作教程、进行演示还是日常使用，Keyviz 都能帮助您更直观地展示键鼠操作，提升沟通效率。

如果在安装或使用过程中遇到问题，建议查阅 Keyviz 的官方文档或社区论坛获取帮助。祝您使用愉快！