cerebro

大腦

Cerebro 是一款開源啟動器，可提高您的生產力和效率

用法

您可以在發布頁面下載最新版本。

• 如果沒有適合您的作業系統的安裝程序，請檢查建置說明。
• 如果您是 Linux 用戶，請參閱如何安裝執行檔

安裝後，使用預設快捷鍵ctrl+space來顯示應用程式視窗。您可以透過點擊功能表列中的圖標，然後選擇「首選項...」來自訂此捷徑。

外掛

核心插件

• 使用您最喜歡的搜尋引擎搜尋網絡
• 搜尋並啟動應用程序，即spotify
• 透過文件預覽瀏覽檔案系統（即~/Dropbox/passport.pdf ）
• 計算機
• 智慧型轉換器。 15$ , 150 рублей в евро , 100 eur in gbp ;

安裝插件

您可以透過在 Cerebro 搜尋欄中輸入plugins <plugin-name>來管理和安裝更多插件。

在 Cerebro 的精彩清單中發現插件及更多內容。

如果您有興趣創建自己的插件，請查看插件文件。

快速方式

Cerebro 提供了多種提高工作效率的捷徑：

• ctrl+c ：將外掛程式的結果複製到剪貼簿，如果外掛程式沒有提供結果，則您引入的術語將被複製
• ctrl+1...9 ：直接從清單中選擇結果
• ctrl+[hjkl] ：使用類似 vim 的鍵瀏覽結果（也可以使用ctrl+o選擇結果）

改變主題

使用快速鍵ctrl+space開啟應用程式窗口，然後輸入Cerebro Settings 。在那裡您將能夠更改主題。

目前開箱即用支援淺色和深色主題

設定檔路徑

您可以根據您的作業系統在以下路徑中找到設定檔：

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 的某個版本，但可執行檔尚未發布，您可以按照以下說明從原始程式碼建置它：

1. 克隆儲存庫

2. 使用yarn安裝相依性：

   yarn --force

3. 建置包：

    yarn package

注意：在CI中我們使用yarn build ，因為有一個打包和發布可執行檔的操作

在 Linux 上安裝可執行文件

如果您是 Linux 用戶，您可能需要授予可執行檔的執行權限。為此，請打開終端機並執行以下命令：

sudo chmod +x < path to the executable >

然後，您可以透過執行以下命令來安裝可執行檔：

• 如果您使用 AppImage 執行檔：

  ./ < path to the executable >

• 如果您使用 deb 可執行檔：

  dpkg -i < path to the executable >

在某些電腦上，您可能需要以提升的權限 (sudo) 執行這些命令。 sudo ./<path to the executable>或sudo dpkg -i <path to the executable>

貢獻

CerebroApp 是一個開源項目，我們歡迎社區的貢獻。在本文檔中，您將找到有關 Cerebro 如何運作以及如何為該專案做出貢獻的資訊。

️注意：本文檔適用於 Cerebro 開發人員。如果您正在尋找如何開發插件，請查看插件開發人員文件。

通用架構

Cerebro 是基於 Electron 和 React。

一個基本的 Electron 應用程式由主進程和渲染器進程組成。主進程負責應用程式生命週期，渲染器進程負責 UI。

在我們的例子中，我們使用：

• app/main.development.js作為主流程
• app/main/main.js作為主渲染流程
• app/background/background.js作為輔助渲染器進程

所有這些文件都與 Webpack 和 Babel 捆綁並轉譯。

建置過程由電子建構器管理。

兩個渲染器行程

這種雙渲染器流程架構用於保持主渲染器進程 (Cerebro) 的回應能力，並避免在執行長任務時阻塞 UI。

當我們需要執行長任務時，我們向後台進程發送一條訊息，後台進程異步執行該任務，並在任務完成時將訊息發送回主渲染器。

這就是我們實作插件系統的方式。它們的initializeAsync方法是在背景處理程序中執行的。

先決條件

• Node.js (>= 16)
• 紗

安裝腦波

首先，透過 git 克隆儲存庫：

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

打開專案

 cd cerebro

然後安裝相依性：

yarn

在開發模式下運行

yarn run dev

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

解決常見問題

1. AssertionError: Current node version is not supported for development 。 yarn安裝後腳本檢查節點版本後。如果您看到此錯誤，您必須檢查package.json devEngines部分中的節點和 npm 版本並安裝正確的版本。

2. Uncaught Error: Module version mismatch. Exepcted 50, got ...此錯誤意味著具有本機擴展的節點模組使用錯誤的節點版本構建（您的本地節點版本！=節點版本，包含在電子中）。要解決此問題，請執行yarn --force

常規提交格式

該項目使用傳統的提交規範來追蹤更改。這有助於我們發布並強制執行一致的風格。您可以像往常一樣遵循此樣式進行提交，或使用以下命令來幫助您以正確的樣式進行提交：

• yarn cz
• yarn commit

發布版本

CerebroApp 正在使用 GH 操作來建立應用程式並將其發佈到版本中。若要發布新版本，請依照下列步驟操作：

1. 更新package.json和app/package.json檔案上的版本。
2. 使用 GH 建立版本並發布。 ？發布標籤必須包含v前綴（ 0.1.2 → ✅ v0.1.2 ）。
3. 使用版本的名稱和描述來完成名稱。
4. 建置可執行檔時，會觸發 GH 操作並更新版本。

執照

麻省理工學院 © Cerebro 應用程式