Albert 启动器安装与使用教程

1. 项目目录结构及介绍

在 https://github.com/albertlauncher/albert.git 下载的 Albert 开源项目中，目录结构大致如下：

├── docs       # 文档和帮助文件
├── src         # 源代码
│   ├── albert  # 主程序代码
│   └── plugins # 插件库
├── config     # 用户配置文件夹（默认情况下不会出现在git仓库中）
└── misc        # 杂项文件，如构建脚本等

• docs: 包含项目的文档和用户指南。
• src: 存放核心代码，albert 是主程序，plugins 为插件目录，用于扩展功能。
• config: 用户自定义的配置文件所在位置，通常会在首次运行时创建。

2. 项目启动文件介绍

Albert 的主要启动文件是 src/albert/main.py。这个脚本负责初始化引擎、加载配置以及管理插件。要运行 Albert，你需要确保你的Python环境已经安装了所有依赖项。你可以通过命令行导航到项目根目录并执行以下命令来启动Albert（前提是你有Python环境并且安装了必要的包）：

python3 -m src.albert.main

或者，如果你已将项目设置为可执行程序，只需在项目根目录下运行:

./albert

3. 项目的配置文件介绍

配置文件位于 config 目录下（该目录可能不存在于git仓库中，因为它是特定用户的）。首次运行Albert时，它会自动创建一个配置目录，并在其中生成默认配置文件 config/config.ini。

config.ini 文件包含了 Albert 的各种设置，例如热键、插件行为等。以下是配置文件的一些关键部分及其作用：

• [General]: 这里设置通用参数，比如启动时是否隐藏窗口 (start_in_tray)。
• [Engine]: 关于搜索引擎的配置，如索引更新频率 (index_update_interval)。
• [Plugins]: 每个插件的配置，可以启用或禁用插件，调整优先级等。

若要自定义这些设置，可以直接编辑 config/config.ini 文件。请务必备份原文件，以防改动不当导致问题。

请注意，实际的配置项可能会更多且具体，具体取决于项目的最新状态。建议查看 config/config.example.ini 或者项目的官方文档以获取完整的配置说明。