# SteamOS 雙系統

## 請先仔細閱讀這部分

### 說明

本教學主要是針對 **「在蝦皮上從光連科技(`barbatoast`)店面購買SSD」** 並 **「預先安裝雙系統」** 的說明 以其他方式自行安裝的系統，不一定能夠照做。

### 什麼時候會需要做這些操作？

1. 新的 SSD 需要在機器上登錄開機資訊，**此步驟是本地進行的，無法預裝**。
2. 若 Windows Update 改變了開機資訊，有可能需要重新進行一次這些操作。

***

## 第一步：手動進入 SteamOS

{% hint style="success" %}
若可以進入 SteamOS，請直接跳過這章節。
{% endhint %}

1. 關閉 SteamDeck
2. 按住`音量鍵+`，短按一下`開機鍵`。聽到開機音效即可放掉音量鍵。
3. 選擇左下角的`Boot from file`&#x20;

   <figure><img src="https://hackmd.io/_uploads/H18tOWXd3.png" alt=""><figcaption></figcaption></figure>
4. 選擇`esp/efi/steamos/steamcl.efi` 以我這台來說分別是`第一個`/`第二個`/`第三個`/`第三個`選項。等待一段時間，**這個過程會是黑畫面，之後應該會進入SteamOS**。&#x20;

   <figure><img src="https://hackmd.io/_uploads/HyY4YWmOn.png" alt=""><figcaption></figcaption></figure>

## 第 1.5 步：

自 2024 年 8/15 之後出貨的雙系統，**若您沒有使用過重設系統功能**，理論上每次開機到 SteamOS 都會執行一次 Script，因此成功進入 SteamOS 後，您可以直接關機再開機，無須進行第二步及之後的步驟。

{% hint style="info" %}
若您關機再開機仍然沒有出現開機選單，請繼續第二步驟。
{% endhint %}

## 第二步：恢復開機啟動選單

1. 開機之後，按住 `開機鍵` 點擊 `切換至桌面` 以進入 `桌面模式`

2. 點左下角，System裡面打開 `Konsole`；打開瀏覽器(FireFox)&#x20;

   <figure><img src="https://hackmd.io/_uploads/HJTJoZ7u3.png" alt=""><figcaption></figcaption></figure>

3. 同時按下 `STEAM` + `X` 可開啟虛擬鍵盤，瀏覽器中網址輸入 [to.lightus.tech/sd](https://to.lightus.tech/sd) 應該會來到這篇文章 **（網址分大小寫）。**

4. 在 Konsole 貼上以下指令，並按下 Enter 執行。（瀏覽器中用觸控板選取起來，L2可以作為右鍵選擇 `copy` 複製，Konsole的右上角點擊 `Paste` 貼上）

   <pre class="language-shell" data-full-width="true"><code class="lang-shell">git clone https://github.com/xTaiwanPingLord/SD_fix
   cd SD_fix
   git stash
   git pull
   </code></pre>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>如果看到以下訊息，請忽略，可直接進行下一步。<br>fatal: destination path 'SD_fix' already exists and is not an empty directory. </p></div>

5. 在 Konsole 貼上以下指令，並按下 Enter 執行。 **可能會要求輸入密碼: `admin`，輸入時不會顯示字元，需要盲打。**

   ```shell
   chmod +x install.sh
   sudo ./install.sh
   ```

6. 出現一堆文字後，重開機就會出現系統切換選單。

{% hint style="info" %}

* 切換系統用最左邊十字方向鍵選擇（有些人的機器要先按一下「上」或「下」才能選左右）
* 10秒沒選會自動進steamos
  {% endhint %}

## 若您尚未設定密碼、忘記密碼

{% hint style="info" %}
未設定密碼、輸入錯誤密碼時將出現：

* Sorry, try again.
* sudo: 3 incorrect password attempts.
  {% endhint %}

1. 開機之後，按住`開機鍵`點擊`切換至桌面`以進入`桌面模式`
2. 點左下角，System裡面打開`Konsole`
3. 在 Konsole 輸入 `passwd` 並按下 Enter 執行。
4. 若要求輸入目前的密碼，請重設密碼。若無，此時請輸入想設定的密碼，**輸入時不會顯示字元，需要盲打**，按下 Enter 後再輸入一次（確認用），再按下 Enter。此後任何帶 `sudo` 的指令都要使用這個密碼，請勿忘記。&#x20;

{% hint style="success" %}

### 重設密碼

請先嘗試用「變更帳戶」登出再重新登入。 如果上面的方法失效，請在SteamOS的設定內按「重設此機器」。
{% endhint %}

***

## 其他疑難雜症

### SteamOS 桌面模式 改成中文

請看（要跑很久很久，請耐心等待） <https://forum.gamer.com.tw/C.php?bsn=60599\\&snA=39235>

***

### SteamOS / Windows 共用 SD 卡

因為SteamOS格式化是EXT4格式，Windows讀不到，因此需要額外的操作使兩個系統都能用SD卡。 **格式化會清除所有資料，請先備份或把遊戲轉移到SSD內。** 以下步驟有鍵盤滑鼠會更好操作。

1. 在 Windows 的圖標點右鍵，打開磁碟管理。打開搜尋框（開始菜單），輸入`diskpart`，會開啟一個黑色的視窗。&#x20;

   <figure><img src="https://hackmd.io/_uploads/SyLxJzdih.png" alt=""><figcaption></figcaption></figure>
2. 找到 SD 卡，左邊會寫 `磁碟 x` ，在 `diskpart` 軟體中輸入 `select disk x` ，像我的就是 `select disk 3`，輸入完成按Enter。 **此步驟務必確認選擇的是正確的磁碟，否則有誤刪文件的風險。**&#x20;

   <figure><img src="https://hackmd.io/_uploads/HkaYnbdsh.png" alt=""><figcaption></figcaption></figure>
3. **再次提醒：務必確認上一步選擇的是正確的磁碟，否則有誤刪文件的風險。** 在 `diskpart` 軟體中輸入 `clean` ，輸入完成按 Enter。&#x20;

   <figure><img src="https://hackmd.io/_uploads/Hk_ahb_j2.png" alt=""><figcaption></figcaption></figure>
4. 如果成功，磁碟管理中那一塊會變成黑色的。在上面點右鍵，新增簡單磁碟區，**以下沒有說要調整的部分，請保持預設。**&#x20;

   <figure><img src="https://hackmd.io/_uploads/S1Q_aZdjn.png" alt=""><figcaption></figcaption></figure>
5. 在「指派磁碟區代號」的地方，選擇比較後面的英文字母。&#x20;

   <figure><img src="https://hackmd.io/_uploads/rk5hTZuo3.png" alt=""><figcaption></figcaption></figure>
6. 在「磁碟機標籤」的地方，輸入 `SD` ，請不要輸入其他多餘的內容。&#x20;

   <figure><img src="https://hackmd.io/_uploads/S1mMRbui3.png" alt=""><figcaption></figcaption></figure>
7. 確認磁碟已經成功格式化為`NTFS`&#x20;

   <figure><img src="https://hackmd.io/_uploads/r1qhC-dih.png" alt=""><figcaption></figcaption></figure>
8. 打開 Windows 內的 Steam ，打開設定，儲存空間的地方有一個加號，把格式化好的 SD 卡添加進去。

   <figure><img src="https://hackmd.io/_uploads/Bk_ryzdj3.png" alt=""><figcaption></figcaption></figure>
9. 確認 SD 卡內出現 `SteamLibrary` 資料夾，即可關機並切換系統至 SteamOS。&#x20;

   <figure><img src="https://hackmd.io/_uploads/HyGwkfOin.png" alt=""><figcaption></figcaption></figure>
10. 在 SteamOS 桌面模式的 Konsole 貼上以下指令，並按下 Enter 執行（瀏覽器中用觸控板選取起來，L2可以作為右鍵選擇`copy`複製，Konsole的右上角點擊`Paste`貼上） **可能會要求輸入密碼: `admin`，輸入時不會顯示字元，需要盲打**

```shell
sudo steamos-readonly disable
```

11. 在 Konsole 貼上以下指令並執行

```shell
kwrite /usr/share/polkit-1/actions/org.freedesktop.UDisks2.policy
```

12. 修改第`173`行

```xml
<allow_active>auth_admin_keep</allow_active>
```

改為

```xml
<allow_active>yes</allow_active> 
```

13. ctrl+s 儲存，輸入密碼按確定。
14. 關閉 Konsole 並重新開啟，在 Konsole 貼上以下指令並執行

```shell
kwrite /etc/fstab
```

15. 在最後一行貼上以下文字，ctrl+s 儲存，輸入密碼按確定。

```
LABEL=SD  /run/media/deck/SD  ntfs   defaults,nofail   0 0
```

16. Konsole 貼上以下指令並執行

```shell
sudo steamos-readonly enable
```

17. 打開桌面的模式的 Steam，左上角 `Steam` -> `設定` -> `儲存空間`，應該會自動讀取到 `STEAMLIBRARY` 資料夾，選擇完之後應該名稱會是 \`\`/run/media/deck/SD\`
18. 同一個頁面中有三個點的按鈕，按它，把 SSD 設定成預設下載位置。
19. 進 SteamOS 下載遊戲，看看是否能選共用磁區。

***

### 問題：藍芽找不到裝置

1. [點我重新下載驅動](https://steamdeck-packages.steamos.cloud/misc/windows/drivers/RTBlueR_FilterDriver_1041.3005_1201.2021_new_L.zip)
2. 解壓縮並打開裡面的x64資料夾
3. 在`Rtkfilter.inf`上點右鍵（觸控螢幕可長按），點安裝，等一段時間會有安裝成功的訊息框。

   <figure><img src="https://hackmd.io/_uploads/BJmEghSO3.png" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lightus.tech/services/steamos_dualboot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
