答案已發布15 來源
Win10 安裝指南：用 WSL2 跑 Ubuntu，再部署專案
專案用到 Bash、Git、GNU timeout、Python 3.10+ 同 PyYAML；部署程式亦會匯入 Unix 專用的 fcntl 模組，所以唔建議直接用 Windows 原生 Python 安裝。[7] Win10 如支援 WSL2，可以喺 Ubuntu 環境安裝同執行；Windows 10 2004 版（Build 19041）或以上可用一鍵安裝指令，較舊版本可能要手動設定。[10][12][15] 部署前先跑 preflight 同 dry run；即使檔案已部署到 WSL，仍要確認 IDE 實際喺邊個環境執行，以及有冇載入設定。
發布者圖片由 GPT Image 2 生成
研究答案
重點
- 專案用到 Bash、Git、GNU timeout、Python 3.10+ 同 PyYAML；部署程式亦會匯入 Unix 專用的 fcntl 模組，所以唔建議直接用 Windows 原生 Python 安裝。[7]
- Win10 如支援 WSL2，可以喺 Ubuntu 環境安裝同執行；Windows 10 2004 版（Build 19041）或以上可用一鍵安裝指令，較舊版本可能要手動設定。[10][12][15]
- 部署前先跑 preflight 同 dry run；即使檔案已部署到 WSL，仍要確認 IDE 實際喺邊個環境執行，以及有冇載入設定。
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you operate via client side tool execution on the](https://d15bya8fi85z1v.cloudfront.net/chat/IbEfUgNRVbQuBwZI6xLn8uUpdIy1/images/70A21BC5961258BE376D/8C9CEB076789B956243D.png)
AI 提示
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you operate via client side tool execution on the. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"当前项目不能直接用 Windows 原生 PowerShell/CMD 完成安装；Win10 上建议采用 WSL2 + Ubuntu 路线。以下是基于已读取源码的安装建议，未在 Win10 实机验证，也未执行安装或修改项目。\n\n 兼容性结论\n\n 安装依赖 Bash、Git、GNU timeout、Pyth. Topic tags: general web, workflow, code, python, api. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts wit
先講結論：用 WSL2，唔好當佢係 Windows 原生安裝
呢個專案要求 Bash、Git、GNU timeout、Python 3.10 或以上，以及 PyYAML，見專案 README.md。部署程式亦會直接匯入 fcntl；呢個 Python 模組只適用於 Unix 類系統，並唔支援 Windows 原生環境。7
所以，喺 Win10 上較合適嘅做法係用 WSL2 加 Ubuntu。要留意，喺 WSL 入面部署檔案，唔等於 Windows 本機嘅 IDE 已經載入套件：專案嘅自動探索機制係按 Linux 路徑設計，見 scripts/deployment_targets.py。
1. 喺 Win10 安裝 WSL 同 Ubuntu
以下步驟以可以使用 WSL2 為前提。Windows 10 2004 版（Build 19041）或以上可用一鍵安裝指令；如果版本較舊，可能要跟微軟的手動安裝步驟。10
12
15
用系統管理員身分開啟 PowerShell，執行：12
wsl --install -d Ubuntu
跟住畫面指示重新開機。第一次啟動 Ubuntu 時，按提示建立 Linux 使用者名稱同密碼。3
檢查 Ubuntu 用緊邊個 WSL 版本：12
wsl --list --verbose
如果 Ubuntu 顯示 VERSION 為 1，可轉用 WSL2：12
wsl --set-version Ubuntu 2
2. 喺 Ubuntu 安裝依賴同取得程式碼
以下指令要喺 Ubuntu 終端執行，唔係 PowerShell。先完成管理員驗證，再安裝依賴；任何一步出錯就先停低處理，唔好繼續部署。
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
安裝完成後，確認 Python 版本係 3.10 或以上：
python3 --version
喺你揀定嘅 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；唔好將遠端腳本直接用管道傳入 shell 執行。專案亦建議先審查可信版本，見 README.md。
3. 先預檢，再決定要唔要部署
喺專案根目錄執行預檢同模擬執行。呢兩個選項由 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 本機設定路徑，見
scripts/deployment_targets.py。
**總結：**如果你接受喺 WSL2 入面工作，可以跟以上步驟嘗試；如果一定要完全喺 Windows 原生環境執行，現有程式碼未提供可直接照做的完整安裝方式，須先處理檔案鎖、權限、目錄同步同 Windows 設定路徑等相容性問題。檔案部署成功，亦唔代表 IDE 已載入或權限驗收已通過，見專案 README.md。
Studio Global AI
繼續你的研究
此頁麵包含一個有來源支援的答案，您可以在 Studio Global 內繼續。
人們還問
「Win10 安裝指南：用 WSL2 跑 Ubuntu，再部署專案」的簡短答案是什麼？
專案用到 Bash、Git、GNU timeout、Python 3.10+ 同 PyYAML；部署程式亦會匯入 Unix 專用的 fcntl 模組，所以唔建議直接用 Windows 原生 Python 安裝。[7]
首先要驗證的關鍵點是什麼？
專案用到 Bash、Git、GNU timeout、Python 3.10+ 同 PyYAML；部署程式亦會匯入 Unix 專用的 fcntl 模組，所以唔建議直接用 Windows 原生 Python 安裝。[7] Win10 如支援 WSL2，可以喺 Ubuntu 環境安裝同執行；Windows 10 2004 版（Build 19041）或以上可用一鍵安裝指令，較舊版本可能要手動設定。[10][12][15]
接下來在實務上我該做什麼？
部署前先跑 preflight 同 dry run；即使檔案已部署到 WSL，仍要確認 IDE 實際喺邊個環境執行，以及有冇載入設定。
來源
docs.python.orgfcntl — The fcntl and ioctl system calls — Python 3.14.8 documentation
devblogs.microsoft.comdevblogs.microsoft.com · commandline · install-wslInstall WSL with a single command now available in Windows 10 ...