decky loader

甲板裝載機

關於

Decky Loader 是 Steam Deck 的自製外掛程式啟動器。它可用於設計選單風格、更改系統聲音、調整螢幕飽和度、更改其他系統設定等等。

有關 Decky Loader 以及文件和開發工具的更多信息，請訪問我們的 wiki。

特徵

乾淨地註入和載入多個插件。
在系統更新和重新啟動之間保持安裝狀態。
允許插件和載入器之間的雙向通訊。
支援從 TypeScript React 運行的 Python 函數。
允許插件進行完全繞過 CORS 的 fetch 呼叫。

常見問題

• Syncthing 可能會使用 Steam Deck 上的連接埠 8080，Decky Loader 需要該連接埠才能運作。如果您使用 Syncthing 作為服務，請將其連接埠變更為其他連接埠。

• 8384 是 Syncthing 的推薦埠。

• 如果您正在使用任何使用連接埠 1337 或 8080 的軟體，請將其連接埠變更為其他連接埠或卸載它。

• 有時 Decky 會在 SteamOS 更新時消失。只需重新運行安裝程式並再次安裝穩定分支即可輕鬆解決此問題。如果這不起作用，請嘗試安裝預發行版。如果這不起作用，請檢查現有問題，如果沒有問題，則可以提交新問題。

安裝

• 無需設定 admin/sudo 密碼即可完成此安裝。

1. 如果可能的話準備一個滑鼠和鍵盤。

• 鍵盤和滑鼠可以透過 USB-C 或藍牙連接到 Steam Deck。

• 許多藍牙鍵盤和滑鼠應用程式可用於 iOS 和 Android。 （KDE connect 已預先安裝在 Steam 平台上）

• Steam Link 應用程式可在 Windows、macOS 和 Linux 上使用。它可以很好地作為遠端桌面的替代品。

• 如果您沒有其他選擇，請使用右側觸控板作為滑鼠，然後根據需要按 開啟螢幕鍵盤。

2. 按下按鈕並開啟電源選單。

3. 選擇“切換到桌面”。

4. 在您選擇的瀏覽器上導覽至此 Github 頁面。

5. 下載安裝程式檔案。 （如果使用 Firefox，它將被命名為decky_installer.desktop.download 。在運行之前將其重新命名為decky_installer.desktop ）

6. 將文件拖到桌面上並雙擊運行它。

7. 輸入您的管理員密碼或允許 Decky 暫時將您的管理員密碼設定為Decky! （安裝程式完成後該密碼將被刪除）

8. 選擇您要安裝的 Decky Loader 版本。

• 最新版本
  適合大多數用戶。這是 Decky Loader 的最新穩定版本。

• 最新預發布
  適用於插件開發人員。預發行版不太可能完全穩定，但包含最新的變更。有關插件開發的更多信息，請參閱 wiki 頁面。

9. 開啟桌面上的返回遊戲模式捷徑。

• 對於可以使用 Konsole 的人來說，還可以進行快速安裝。運行curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/install_release.sh | sh並在出現提示時輸入您的密碼。

解除安裝

看到你離開我們感到很遺憾！如果您因為遇到問題而考慮卸載，請考慮提問或加入我們的 Discord，以便我們可以幫助您和其他使用者。

1. 按下按鈕並開啟電源選單。

2. 選擇“切換到桌面”。

3. 再次執行安裝程式文件，然後選擇uninstall decky loader 。

• 對於可以使用 Konsole 的人來說，還可以快速卸載。運行curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/uninstall.sh | sh並在出現提示時輸入您的密碼。

入門

現在您已經安裝了 Decky Loader，您可以開始使用外掛程式了。每個插件都由不同的開發人員維護並具有自己的用途，但大多數插件都遵循下面概述的一般結構。

？外掛

1. 按按鈕並導航至該圖示。這是用於與插件和載入器本身互動的 Decky 選單。

2. 選擇該圖示以開啟插件瀏覽器。您可以在這裡找到並安裝插件。

• 您也可以從「設定」選單中的 URL 安裝。我們不建議安裝來自不受信任來源的插件。

3. 若要安裝插件，請選擇所需插件上的「安裝」按鈕。您也可以從下拉式選單中選擇版本，但不建議這樣做。

4. 若要更新、解除安裝和重新載入插件，請導覽至 Decky 選單並選擇 圖示。

• 請記住，卸載插件只會刪除其插件文件，而不會刪除它可能創建的任何其他文件。

插件開發

目前還沒有完整的插件開發文件。然而，一個好的起點是插件模板儲存庫。如果您有任何疑問，請考慮加入我們的 Discord。

貢獻

請查閱有關開發的 wiki 頁面，以獲取有關安裝 Decky Loader 開發版本的更多資訊。您也可以按照此 YouTube 指南在 Windows 或 Linux 電腦上安裝 Steam Deck UI 進行測試。

1. 在開始 PR 之前，使用對 main 的最新提交來克隆儲存庫。

2. 在儲存庫的克隆中，執行這些命令。

    CD前端
   PNPM我
   pnpm 運行構建

3. 如果您要修改 UI，則需要在將變更部署到 Steam Deck 之前執行這些命令。

4. 使用 VS Code 任務或deck.sh腳本將變更部署到 Steam Deck 進行測試。

5. 您將使用 Python 腳本版本測試您的變更。您每次都需要建置、部署和重新載入。

️如果您由於庫過期而收到建置錯誤，您應該在儲存庫中執行此命令。

 pnpm 更新 Decky-frontend-lib --latest

原始碼控制和部署插件留給克隆儲存庫的每個貢獻者，以保持依賴項最新。

製作人員

插件載入器概念的最初想法是基於 marios8543 的 Steam Deck UI Inject 專案的工作。