這個專案不適合直接透過 Windows 原生 PowerShell 或 CMD 安裝。若你使用 Windows 10，較合適的做法是透過 WSL2 執行 Ubuntu，再於 Linux 環境中安裝。以下是根據專案程式碼整理的操作建議；未在 Windows 10 實機驗證，也未執行安裝或修改專案。

先確認相容性

• 專案需要 Bash、Git、GNU timeout、Python 3.10 以上版本和 PyYAML，詳見 README.md。
• 部署模組會匯入 Unix 專用的 fcntl 檔案鎖定模組，詳見 asset_safety.py。Windows 原生 Python 不支援這個模組，因此只安裝 Git Bash 和 Windows 版 Python 並不足以解決相容性問題。7
• 模式自動探索是依照 Linux 的目錄配置設計，詳見 deployment_targets.py。所以，在 WSL 裡部署檔案，不代表 Windows 本機的 IDE 已經載入套件。

1. 在 Windows 10 安裝 WSL

以下步驟適用於支援 WSL2 的環境。微軟的一鍵安裝方式適用於更新後的 Windows 10 2004 版及更新版本；較舊的版本可能需要手動安裝。1510

以系統管理員身分開啟 PowerShell，執行：12

wsl --install -d Ubuntu

依照提示重新啟動電腦。首次啟動 Ubuntu 時，設定 Linux 使用者名稱與密碼。3

接著確認 Ubuntu 使用的是 WSL2：12

wsl --list --verbose

如果 Ubuntu 的 VERSION 顯示為 1，執行以下命令轉換為 WSL2：12

wsl --set-version Ubuntu 2

2. 在 Ubuntu 安裝依賴並取得專案

以下命令請在 Ubuntu 終端機執行。先完成管理員認證，再安裝專案所需依賴；若任何命令失敗，請先排除問題，不要繼續部署。

sudo -v

timeout 600s sudo -n apt-get update < /dev/null &&
timeout 600s sudo -n env DEBIAN_FRONTEND=noninteractive apt-get install -y git coreutils python3 python3-yaml < /dev/null

在你選定的 Linux 工作目錄中複製專案。以下網址取自 install.sh：

timeout 30s env GIT_TERMINAL_PROMPT=0 git -c core.autocrlf=false -c core.hooksPath=/dev/null clone --no-recurse-submodules --branch main https://github.com/zhaosan2023/dotfiles-bmad-solo.git dotfiles-bmad-solo < /dev/null

複製成功後，進入專案目錄：

cd dotfiles-bmad-solo

正式執行前，先檢查下載版本中的 install.sh 和 bs.sh。不要直接將遠端腳本透過管線執行；專案也建議先審查可信的版本，詳見 README.md。

3. 先預檢，再部署

在專案根目錄執行只讀預檢和模擬執行。bs.sh 支援這兩個參數，詳見 bs.sh：

timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null

只有在預檢成功、確認目標正確，而且同意修改目前 Linux 使用者的全域設定後，才執行正式部署及狀態檢查，詳見 README.md：

timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null

如果檢查結果顯示資產衝突、設定損壞或有尚未完成的交易，應先處理問題；不要刪除狀態紀錄或強行覆寫，詳見 README.md。

4. 確認 IDE 實際執行的位置

• 使用 VS Code 時，可在 Windows 安裝 VS Code 和 WSL 擴充功能，再連線至 Ubuntu 工作區。這是微軟建議的 WSL 開發方式。9
• 仍須確認 Roo 實際在哪個擴充功能宿主執行，以及模式設定是否屬於該宿主。專案也要求另外驗收執行時狀態，詳見 README.md。
• 如果使用的是 Windows 本機版 Antigravity、Gemini 或 Roo，不能把 WSL 內的部署視為已安裝到 Windows 本機。現有自動探索功能並未涵蓋 Windows 本機設定路徑，詳見 deployment_targets.py。

**結論：**若可以使用 WSL2，可依上述步驟在 Ubuntu 中嘗試安裝；若必須完全在 Windows 原生環境執行，目前的程式碼還不足以提供可直接採用的完整安裝方式，需先處理檔案鎖定、檔案權限、目錄同步和 Windows 設定路徑等相容性問題。即使檔案已成功部署，也不代表 IDE 已載入，或權限驗收已通過，詳見 README.md。

這個專案不適合直接透過 Windows 原生 PowerShell 或 CMD 安裝。若你使用 Windows 10，較合適的做法是透過 WSL2 執行 Ubuntu，再於 Linux 環境中安裝。以下是根據專案程式碼整理的操作建議；未在 Windows 10 實機驗證，也未執行安裝或修改專案。

先確認相容性

• 專案需要 Bash、Git、GNU timeout、Python 3.10 以上版本和 PyYAML，詳見 README.md。
• 部署模組會匯入 Unix 專用的 fcntl 檔案鎖定模組，詳見 asset_safety.py。Windows 原生 Python 不支援這個模組，因此只安裝 Git Bash 和 Windows 版 Python 並不足以解決相容性問題。7
• 模式自動探索是依照 Linux 的目錄配置設計，詳見 deployment_targets.py。所以，在 WSL 裡部署檔案，不代表 Windows 本機的 IDE 已經載入套件。

1. 在 Windows 10 安裝 WSL

以下步驟適用於支援 WSL2 的環境。微軟的一鍵安裝方式適用於更新後的 Windows 10 2004 版及更新版本；較舊的版本可能需要手動安裝。1510

以系統管理員身分開啟 PowerShell，執行：12

wsl --install -d Ubuntu

依照提示重新啟動電腦。首次啟動 Ubuntu 時，設定 Linux 使用者名稱與密碼。3

接著確認 Ubuntu 使用的是 WSL2：12

wsl --list --verbose

如果 Ubuntu 的 VERSION 顯示為 1，執行以下命令轉換為 WSL2：12

wsl --set-version Ubuntu 2

2. 在 Ubuntu 安裝依賴並取得專案

以下命令請在 Ubuntu 終端機執行。先完成管理員認證，再安裝專案所需依賴；若任何命令失敗，請先排除問題，不要繼續部署。

sudo -v

timeout 600s sudo -n apt-get update < /dev/null &&
timeout 600s sudo -n env DEBIAN_FRONTEND=noninteractive apt-get install -y git coreutils python3 python3-yaml < /dev/null

在你選定的 Linux 工作目錄中複製專案。以下網址取自 install.sh：

timeout 30s env GIT_TERMINAL_PROMPT=0 git -c core.autocrlf=false -c core.hooksPath=/dev/null clone --no-recurse-submodules --branch main https://github.com/zhaosan2023/dotfiles-bmad-solo.git dotfiles-bmad-solo < /dev/null

複製成功後，進入專案目錄：

cd dotfiles-bmad-solo

正式執行前，先檢查下載版本中的 install.sh 和 bs.sh。不要直接將遠端腳本透過管線執行；專案也建議先審查可信的版本，詳見 README.md。

3. 先預檢，再部署

在專案根目錄執行只讀預檢和模擬執行。bs.sh 支援這兩個參數，詳見 bs.sh：

timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null

只有在預檢成功、確認目標正確，而且同意修改目前 Linux 使用者的全域設定後，才執行正式部署及狀態檢查，詳見 README.md：

timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null

如果檢查結果顯示資產衝突、設定損壞或有尚未完成的交易，應先處理問題；不要刪除狀態紀錄或強行覆寫，詳見 README.md。

4. 確認 IDE 實際執行的位置

• 使用 VS Code 時，可在 Windows 安裝 VS Code 和 WSL 擴充功能，再連線至 Ubuntu 工作區。這是微軟建議的 WSL 開發方式。9
• 仍須確認 Roo 實際在哪個擴充功能宿主執行，以及模式設定是否屬於該宿主。專案也要求另外驗收執行時狀態，詳見 README.md。
• 如果使用的是 Windows 本機版 Antigravity、Gemini 或 Roo，不能把 WSL 內的部署視為已安裝到 Windows 本機。現有自動探索功能並未涵蓋 Windows 本機設定路徑，詳見 deployment_targets.py。

**結論：**若可以使用 WSL2，可依上述步驟在 Ubuntu 中嘗試安裝；若必須完全在 Windows 原生環境執行，目前的程式碼還不足以提供可直接採用的完整安裝方式，需先處理檔案鎖定、檔案權限、目錄同步和 Windows 設定路徑等相容性問題。即使檔案已成功部署，也不代表 IDE 已載入，或權限驗收已通過，詳見 README.md。