Lazyeat：免触碰控制器的安装与使用指南

Lazyeat 是一款专为解决用餐时操作电子设备痛点设计的免触碰控制器。通过摄像头识别手势动作，用户无需接触键盘鼠标即可实现视频播放控制、网页浏览等操作，彻底告别油腻手指带来的设备污染问题。无论是家庭聚餐时的视频娱乐，还是办公间隙的简餐时光，Lazyeat 都能为你提供便捷卫生的操作体验。

项目核心价值与应用场景

Lazyeat 的核心价值在于将计算机视觉技术与日常使用场景完美结合，主要适用于以下场景：

• 餐饮娱乐场景：用餐时无需擦拭双手即可控制视频播放、调节音量或切换节目
• 厨房烹饪场景：烹饪过程中无需洗手即可操作食谱页面或计时器
• 卫生敏感环境：医疗、实验室等需要保持手部清洁的工作环境
• 临时手部占用：如化妆、绘画等双手被占用时的设备操作

核心技术架构解析

Lazyeat 采用多技术栈协同工作，构建了高效的手势识别与控制体系：

• Python：作为核心编程语言，负责后端逻辑处理与系统集成
• MediaPipe：谷歌开源的多媒体处理框架，提供手部关键点检测能力，实现精准的手势识别
• Tauri：跨平台桌面应用开发框架，用于构建轻量级桌面界面，实现摄像头访问与系统交互
• Vue.js：前端框架，负责构建直观的用户交互界面与手势配置面板
• WebAssembly：通过 vision_wasm_internal.wasm 实现高性能的客户端图像处理，降低延迟提升响应速度

这些技术的有机结合，使得 Lazyeat 能够在普通硬件上实现实时手势识别，响应速度达到 29 FPS（每秒传输帧数），确保操作的流畅性。

环境准备与依赖安装

在开始部署 Lazyeat 前，请确保您的系统满足以下要求：

• 操作系统：Windows/macOS/Linux（推荐 Windows 10 及以上版本）
• 硬件配置：具备摄像头的计算机，最低配置为双核处理器、4GB 内存
• 软件依赖：Python 3.8+、Git 版本控制工具

🔧 基础环境检查

打开终端执行以下命令，确认 Python 和 Git 已正确安装：

# 检查 Python 版本
python --version  # 应显示 3.8 或更高版本

# 检查 Git 版本
git --version     # 应显示有效的 Git 版本信息

如未安装，请先从 Python 官网和 Git 官网获取并安装对应软件。

分步部署与验证

1. 获取项目代码

🔧 克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/la/lazyeat

执行成功后，当前目录将生成 lazyeat 文件夹，包含项目完整源代码。

2. 安装依赖包

🔧 进入项目目录并安装 Python 依赖：

cd lazyeat
pip install -r requirements.txt

验证安装结果：检查终端输出，确认所有依赖包均显示 "Successfully installed"。

3. 配置应用参数

🔧 复制并修改配置文件（如需要自定义设置）：

# 如有配置模板文件，复制并修改
cp config.example.json config.json

配置文件示例（config.json）：

{
  "camera_index": 0,          // 摄像头设备索引，多摄像头时可调整
  "detection_threshold": 0.7, // 手势识别阈值，数值越高识别越严格
  "gesture_timeout": 1500     // 手势动作超时时间（毫秒）
}

4. 启动应用程序

🔧 运行主程序：

python src-py/main.py

成功启动后，将显示应用窗口并自动激活摄像头。首次运行可能需要授权摄像头访问权限。

5. 验证安装结果

应用启动后，通过以下方式验证安装是否成功：

• 观察摄像头画面是否正常显示
• 尝试做出 "暂停" 手势（单手张开1.5秒），查看是否有响应
• 打开视频播放器，测试手势控制功能是否正常工作

功能使用指南

Lazyeat 提供丰富的手势控制功能，以下是常用操作说明：

基本控制手势

• 光标控制：竖起食指滑动控制光标位置
• 单击操作：双指举起执行鼠标单击
• 滚动控制：食指和拇指捏合（okay手势）滚动页面
• 全屏控制：四指并拢发送F键（全屏切换）
• 暂停/继续：单手张开1.5秒暂停/继续手势识别

高级功能

• 语音识别：六指手势开始语音识别，拳头手势结束
• 退格操作：特定手势发送退格键
• 自定义快捷键：通过设置界面可自定义手势对应的键盘操作

常见问题与解决方案

问题1：摄像头无法启动

解决方案：

1. 检查摄像头是否被其他应用占用
2. 确认应用已获得摄像头访问权限
3. 尝试修改配置文件中的 camera_index 参数

问题2：手势识别不灵敏

解决方案：

1. 确保光线充足，避免背光或强光直射
2. 调整摄像头角度，使手部位于画面中央
3. 提高配置文件中的 detection_threshold 值

问题3：应用启动后无响应

解决方案：

1. 检查系统是否安装了所有依赖包
2. 尝试更新显卡驱动
3. 以管理员身份运行程序

扩展功能与未来展望

Lazyeat 目前支持基础的手势控制功能，未来计划添加更多实用特性：

• 自定义手势录制功能，允许用户创建个性化控制手势
• 多语言语音控制支持，扩展语音操作能力
• 手机远程控制模式，通过手机摄像头实现控制
• 智能场景识别，自动切换不同应用的控制模式

通过持续优化手势识别算法和扩展应用场景，Lazyeat 致力于成为用户日常操作的便捷助手，让免触碰交互成为常态。