Linux语音控制助手安装与使用指南

本指南将详细介绍如何设置并使用由OmegaUI维护的linux-voice-control——一个高度可定制的Linux语音控制助手。我们将关注其关键的目录结构、启动文件以及配置文件，帮助您快速上手。

1. 项目目录结构及介绍

linux-voice-control
├── guigui                   # 可能的GUI相关代码或资源
├── images                    # 图像资源
├── lvc_gui_flutter          # 使用Flutter构建的GUI应用源码
├── misc                      # 杂项文件
├── pretrained_models         # 预训练模型存放位置
├── .gitignore               # Git忽略文件列表
├── CODE_OF_CONDUCT.md       # 社区行为准则
├── LICENSE                   # 许可证文件（GPL-3.0）
├── README.md                 # 项目读我文件
├── __init__.py               # Python初始化脚本
├── basic_mode_manager.py     # 基础模式管理器
├── build-gui-bundle.sh       # 构建GUI的脚本
├── chatgpt_port.py           # 与ChatGPT交互的脚本
├── command_manager.py        # 命令管理器
├── config_manager.py         # 配置管理器
├── dry-run.sh                # 干运行脚本，用于测试
├── install.sh                # 安装脚本，处理依赖安装
├── linux-voice-control       # 主程序入口
├── linux-voice-control-gui   # GUI程序入口
├── live_mode_manager.py      # 实时模式管理器
├── live_mode_setup.py        # 实时模式设置脚本
├── lvc-commands.json         # 命令映射文件
├── lvc-config.json           # 主配置文件
├── lvc-icon.png              # 项目图标
├── main.py                   # 程序主逻辑
├── master_control_mode_setup.py # 大师级控制模式设置脚本
├── master_mode_manager.py    # 大师级控制模式管理器
├── notifier.py               # 通知管理器
├── portaudio-install-post.url # PortAudio安装辅助链接
├── requirements.txt          # Python依赖列表
├── update.sh                 # 更新脚本
└── utils.py                  # 辅助函数集合

目录结构概览

• lvc-commands.json 和 lvc-config.json 是核心配置文件。
• install.sh 负责安装过程中的依赖安装。
• main.py 是项目的主程序。
• lvc_gui_flutter 包含了GUI应用程序的源码。
• lvc-config.json 存储系统配置，如名称、通知设置等。
• lvc-commands.json 映射用户的语音命令到具体执行的系统命令或动作。

2. 项目启动文件介绍

• main.py: 这是主要的运行脚本，当你在终端中直接运行项目时，该文件会被执行。它包含了语音识别的主体逻辑，集成了解析用户命令、执行对应操作等功能。
• install.sh: 提供一键式安装脚本，自动处理Python依赖安装，并进行初步的环境配置，确保项目能够顺利运行。

3. 项目的配置文件介绍

• lvc-config.json:
  • name: 控制系统的名称，默认为“alex”。
  • record-duration: 录音持续时间，单位为秒。
  • notifications-enabled: 是否启用桌面通知。
  • lvc-commands.json:
    • 这个文件定义了用户的语音命令与系统命令的映射关系。每条命令是一个键值对，键为语音指令，值为要执行的操作，包括命令本身、“反馈”消息以及是否阻塞（即执行反馈后才执行命令）。

设置流程简介

1. 基础安装: 克隆项目、运行install.sh安装依赖。
2. 配置个性化: 编辑lvc-config.json和lvc-commands.json以满足个人需求。
3. 激活大师级控制模式: 运行master_control_mode_setup.py，按指示说话进行训练，然后在配置文件中或通过语音命令激活此模式。
4. 运行: 最后，通过终端运行linux-voice-control或启动GUI来使用您的语音控制助手。

这个项目让Linux用户能够通过语音执行常见的计算机任务，提供了高程度的自定义空间，从而提升了使用的灵活性和便捷性。