# 請先仔細閱讀這部分
## 說明
最新版本請看
https://to.lightus.tech/sd

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

---
## 第一步：手動進入 SteamOS
:::warning
若可以進入 SteamOS，請直接跳過這章節。
:::
1. 關閉 SteamDeck
2. 按住`音量鍵+`，短按一下`開機鍵`。聽到開機音效即可放掉音量鍵。
3. 選擇左下角的`Boot from file`
4. 選擇`esp/efi/steamos/steamcl.efi`
以我這台來說分別是`第一個`/`第二個`/`第三個`/`第三個`選項
等待一段時間，**這個過程會是黑畫面，之後應該會進入SteamOS**。

## 第二步：恢復開機啟動選單
1. 開機之後，按住 `開機鍵` 點擊 `切換至桌面` 以進入 `桌面模式`
2. 點左下角，System裡面打開 `Konsole`；打開瀏覽器(FireFox)
3. 同時按下 `STEAM` + `X` 可開啟虛擬鍵盤，瀏覽器中網址輸入 shorturl.at/clmvQ 應該會來到這篇文章 **（網址分大小寫）**
4. 在 Konsole 貼上以下指令，並按下 Enter 執行。（瀏覽器中用觸控板選取起來，L2可以作為右鍵選擇 `copy` 複製，Konsole的右上角點擊 `Paste` 貼上）

git clone https://github.com/xTaiwanPingLord/SD_fix

:::info
如果看到以下訊息，請忽略，可直接進行下一步
fatal: destination path 'Myrtle' already exists and is not an empty directory.
:::
5. 在 Konsole 貼上以下指令，並按下 Enter 執行。
**可能會要求輸入密碼: `admin`，輸入時不會顯示字元，需要盲打**

sudo bash SD_fix/fix.sh

6. 出現一堆文字後，重開機就會出現系統切換選單
:::info
- 切換系統用最左邊十字方向鍵選擇（有些人的機器要先按一下「上」或「下」才能選左右）
- 10秒沒選會自動進steamos
:::

## 若您尚未設定密碼、忘記密碼
:::warning
輸入指令時出現
- Sorry, try again.
- sudo: 3 incorrect password attempts.
:::
1. 開機之後，按住`開機鍵`點擊`切換至桌面`以進入`桌面模式`
2. 點左下角，System裡面打開`Konsole`
3. 在 Konsole 輸入 `passwd` 並按下 Enter 執行。
4. 若要求輸入目前的密碼，請重設密碼。若無，此時請輸入想設定的密碼，**輸入時不會顯示字元，需要盲打**，按下 Enter 後再輸入一次（確認用），再按下 Enter。此後任何帶 `sudo` 的指令都要使用這個密碼，請勿忘記。
:::success
## 重設密碼
請先嘗試用「變更帳戶」登出再重新登入。
如果上面的方法失效，請在SteamOS的設定內按「重設此機器」。
:::

---

# 其他疑難雜症
## SteamOS 桌面模式 改成中文
請看（要跑很久很久，請耐心等待）
https://forum.gamer.com.tw/C.php?bsn=60599&snA=39235

---

## SteamOS / Windows 共用 SD 卡
因為SteamOS格式化是EXT4格式，Windows讀不到，因此需要額外的操作使兩個系統都能用SD卡。
**格式化會清除所有資料，請先備份或把遊戲轉移到SSD內。**
以下步驟有鍵盤滑鼠會更好操作。
1. 在 Windows 的圖標點右鍵，打開磁碟管理。打開搜尋框（開始菜單），輸入`diskpart`，會開啟一個黑色的視窗。

3. 找到 SD 卡，左邊會寫 `磁碟 x` ，在 `diskpart` 軟體中輸入 `select disk x` ，像我的就是 `select disk 3`，輸入完成按Enter。
**此步驟務必確認選擇的是正確的磁碟，否則有誤刪文件的風險。**
3. **再次提醒：務必確認上一步選擇的是正確的磁碟，否則有誤刪文件的風險。**
在 `diskpart` 軟體中輸入 `clean` ，輸入完成按 Enter。
4. 如果成功，磁碟管理中那一塊會變成黑色的。在上面點右鍵，新增簡單磁碟區，**以下沒有說要調整的部分，請保持預設。**
5. 在「指派磁碟區代號」的地方，選擇比較後面的英文字母。
6. 在「磁碟機標籤」的地方，輸入 `SD` ，請不要輸入其他多餘的內容。
7. 確認磁碟已經成功格式化為`NTFS`
8. 打開 Windows 內的 Steam ，打開設定，儲存空間的地方有一個加號，把格式化好的 SD 卡添加進去。
9. 確認 SD 卡內出現 `SteamLibrary` 資料夾，即可關機並切換系統至 SteamOS。
10. 在 SteamOS 桌面模式的 Konsole 貼上以下指令，並按下 Enter 執行（瀏覽器中用觸控板選取起來，L2可以作為右鍵選擇`copy`複製，Konsole的右上角點擊`Paste`貼上）
**可能會要求輸入密碼: `admin`，輸入時不會顯示字元，需要盲打**

sudo steamos-readonly disable

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

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

12. 修改第`173`行

<allow_active>auth_admin_keep</allow_active>

改為

<allow_active>yes</allow_active> 

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

kwrite /etc/fstab

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

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

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

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`上點右鍵（觸控螢幕可長按），點安裝，等一段時間會有安裝成功的訊息框。