Cerebro

Cerebro 是一个开源启动器，旨在提高您的生产力和效率

使用方法

您可以在发布页面下载最新版本。

如果没有适合您操作系统的安装程序，请查看从源代码构建可执行文件。
如果您是 Linux 用户，请参阅如何安装可执行文件

安装完成后，使用默认快捷键 ctrl+space 来显示应用窗口。您可以通过点击菜单栏中的图标，然后选择"首选项..."来自定义此快捷键。

Cerebro

插件

核心插件

使用您喜欢的搜索引擎搜索网络
搜索并启动应用程序，例如 spotify
浏览文件系统并预览文件（例如 ~/Dropbox/passport.pdf）
计算器
智能转换器。15$，150 рублей в евро，100 eur in gbp

安装插件

您可以通过在 Cerebro 搜索栏中输入 plugins <插件名称> 来管理和安装更多插件。

在 Cerebro 的 Awesome 列表中发现插件和更多内容。

如果您有兴趣创建自己的插件，请查看插件文档。

快捷键

Cerebro 提供了几个快捷键来提高您的生产力：

ctrl+c：将插件的结果复制到剪贴板，如果插件没有提供结果，将复制您输入的术语
ctrl+1...9：直接从列表中选择结果
ctrl+[hjkl]：使用类似 vim 的按键导航结果（也可以使用 ctrl+o 选择结果）

更改主题

使用快捷键 ctrl+space 打开应用窗口，然后输入 Cerebro Settings。在那里您可以更改主题。

目前默认支持浅色和深色主题

更改Cerebro主题

配置文件路径

您可以在以下路径找到配置文件，具体取决于您的操作系统：

Windows：%APPDATA%/Cerebro/config.json

Linux：$XDG_CONFIG_HOME/Cerebro/config.json 或 ~/.config/Cerebro/config.json

macOS：~/Library/Application Support/Cerebro/config.json

⚠️ 错误的配置文件可能会导致 Cerebro 无法正常工作。如果您不确定自己在做什么，请不要直接编辑配置文件。

从源代码构建可执行文件

如果您想安装 Cerebro 的某个版本，但可执行文件尚未发布，您可以按照以下说明从源代码构建：

克隆仓库
使用 yarn 安装依赖：
```
yarn --force
```
构建软件包：
```
 yarn package
```

注意：在 CI 中，我们使用 yarn build，因为有一个操作用于打包和发布可执行文件

在 Linux 上安装可执行文件

如果您是 Linux 用户，您可能需要授予可执行文件执行权限。为此，请打开终端并运行以下命令：

sudo chmod +x <可执行文件路径>

然后，您可以通过运行以下命令来安装可执行文件：

如果您使用的是 AppImage 可执行文件：
```
./<可执行文件路径>
```
如果您使用的是 deb 可执行文件：
```
dpkg -i <可执行文件路径>
```

在某些计算机上，您可能需要使用提升的权限（sudo）运行这些命令。sudo ./<可执行文件路径> 或 sudo dpkg -i <可执行文件路径>

贡献

CerebroApp 是一个开源项目，我们欢迎社区的贡献。在本文档中，您将找到有关 Cerebro 如何工作以及如何为项目做出贡献的信息。

⚠️ 注意：本文档面向Cerebro开发者。如果您想了解如何开发插件，请查看插件开发者文档。

总体架构

Cerebro基于Electron和React构建。

一个基本的Electron应用由主进程和渲染进程组成。主进程负责应用程序生命周期，渲染进程负责用户界面。

在我们的情况下，我们使用：

app/main.development.js作为主进程
app/main/main.js作为主要渲染进程
app/background/background.js作为次要渲染进程

所有这些文件都使用Webpack和Babel进行打包和转译。

构建过程由electron-builder管理。

两个渲染进程

这种双渲染进程架构用于保持主渲染进程（Cerebro）的响应性，并避免在执行长时间任务时阻塞用户界面。

当我们需要执行长时间任务时，我们向后台进程发送消息，后台进程异步执行任务，并在任务完成时向主渲染进程发送回消息。

这就是我们实现插件系统的方式。插件的initializeAsync方法在后台进程中执行。

前提条件

Node.js (>= 16)
yarn

安装Cerebro

首先，通过git克隆仓库：

git clone https://github.com/cerebroapp/cerebro.git cerebro

打开项目

cd cerebro

然后安装依赖：

yarn

在开发模式下运行

yarn run dev

注意：需要node版本>=16.x

解决常见问题

npm postinstall时出现AssertionError: Current node version is not supported for development。在yarn执行postinstall脚本时会检查node版本。如果您看到此错误，您需要检查package.json中devEngines部分的node和npm版本，并安装适当的版本。
Uncaught Error: Module version mismatch. Exepcted 50, got ... 此错误意味着带有原生扩展的node模块是用错误的node版本构建的（您本地的node版本 != electron中包含的node版本）。要修复此问题，请运行yarn --force