AnswersPublished15 sources
Panduan memasang projek ini di Windows 10 melalui WSL2
Projek memerlukan Bash, Git, GNU timeout, Python 3.10+ dan PyYAML; modul kunci fail yang digunakan juga khusus untuk Unix. Pada Windows 10, laluan yang disarankan ialah WSL2 dengan Ubuntu.
Diterbitkan olehImej dijana dengan GPT Image 2
Research answer
Key takeaways
- Projek memerlukan Bash, Git, GNU timeout, Python 3.10+ dan PyYAML; modul kunci fail yang digunakan juga khusus untuk Unix.
- Pada Windows 10, laluan yang disarankan ialah WSL2 dengan Ubuntu. Arahan pemasangan WSL satu baris memerlukan Windows 10 versi 2004 (build 19041) atau lebih baharu.
- Jalankan pratonton dan semakan awal sebelum memasang. Pemasangan dalam WSL tidak semestinya bermakna IDE Windows asli telah memuatkan konfigurasi.
![[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 Prompt
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
Jika anda menggunakan Windows 10, projek ini tidak boleh dipasang terus dengan PowerShell atau CMD sahaja. Pilihan yang disarankan ialah WSL2 dengan Ubuntu—persekitaran Linux yang berjalan bersama Windows.
Sebabnya, projek ini memerlukan Bash, Git, GNU timeout, Python 3.10+ dan PyYAML, seperti dinyatakan dalam README.md (baris 35). Selain itu, modul pemasangan mengimport fcntl, iaitu modul Python yang tersedia pada Unix dan bukan Windows asli 7 (
scripts/asset_safety.py, baris 10). Jadi, memasang Git Bash dan Python untuk Windows sahaja tidak mencukupi.
1. Pasang WSL dan Ubuntu
Arahan pemasangan WSL satu baris tersedia untuk Windows 10 versi 2004 (build 19041) dan lebih baharu. Jika Windows anda lebih lama, rujuk langkah pemasangan manual Microsoft 12
10.
Buka PowerShell sebagai pentadbir dan jalankan 12:
wsl --install -d Ubuntu
Ikut arahan pada skrin dan mulakan semula komputer jika diminta. Kali pertama Ubuntu dibuka, anda akan diminta mencipta nama pengguna dan kata laluan Linux 3.
Semak versi WSL Ubuntu:
wsl --list --verbose
Jika lajur VERSION menunjukkan 1, tukarkannya kepada WSL2 12:
wsl --set-version Ubuntu 2
2. Pasang keperluan dan dapatkan kod projek
Buka terminal Ubuntu—bukan PowerShell—kemudian sahkan akses pentadbir dan pasang pakej yang diperlukan. Jika mana-mana arahan gagal, berhenti dahulu dan selesaikan masalah itu sebelum meneruskan.
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
Klon repositori ke direktori kerja pilihan anda. Alamat repositori ini turut dinyatakan dalam install.sh (baris 10):
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
Selepas klon berjaya, masuk ke direktori projek:
cd dotfiles-bmad-solo
Sebelum menjalankan pemasang, semak kandungan install.sh dan bs.sh yang telah dimuat turun. Elakkan menjalankan skrip jauh terus melalui paip; projek itu sendiri mengesyorkan supaya skrip disemak terlebih dahulu (README.md, baris 33).
3. Buat semakan sebelum pemasangan
Dari direktori utama repositori, jalankan semakan awal dan pratonton tanpa membuat perubahan. Skrip menyokong pilihan ini (bs.sh, baris 343):
timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null
Teruskan hanya jika semakan berjaya, sasaran pemasangan betul dan anda bersetuju konfigurasi global untuk pengguna Linux semasa ditulis. Kemudian jalankan pemasangan serta semakan status (README.md, baris 39):
timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null
Jika skrip melaporkan konflik fail, konfigurasi rosak atau urus niaga yang belum selesai, tangani masalah itu dahulu. Jangan padam rekod status atau memaksa fail ditindih (README.md, baris 85).
4. Pastikan IDE menggunakan persekitaran yang betul
Jika menggunakan VS Code, pasang VS Code pada Windows bersama sambungan WSL, kemudian sambungkan IDE kepada ruang kerja Ubuntu. Microsoft menerangkan kaedah ini sebagai cara menggunakan VS Code dengan WSL 9.
Namun, pemasangan fail dalam WSL tidak membuktikan bahawa Roo sudah memuatkan mod atau konfigurasi tersebut. Semak hos sambungan yang menjalankan Roo dan pastikan konfigurasi berada dalam persekitaran yang digunakan IDE. Projek juga menyatakan bahawa pengesahan semasa jalan perlu dibuat secara berasingan (README.md, baris 94).
Jika anda menggunakan Antigravity, Gemini atau Roo yang berjalan secara asli pada Windows, jangan anggap pemasangan WSL sebagai pemasangan Windows yang berjaya. Pengesanan automatik projek ini menyasarkan susun atur Linux (scripts/deployment_targets.py, baris 11). Kesimpulannya: WSL2 ialah laluan yang boleh dicuba; untuk penggunaan Windows asli sepenuhnya, kod semasa belum menyediakan arahan pemasangan lengkap. Fail berjaya disalin pun belum bermakna IDE sudah memuatkannya atau semakan kebenaran telah lulus (README.md, baris 29).
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "Panduan memasang projek ini di Windows 10 melalui WSL2"?
Projek memerlukan Bash, Git, GNU timeout, Python 3.10+ dan PyYAML; modul kunci fail yang digunakan juga khusus untuk Unix.
What are the key points to validate first?
Projek memerlukan Bash, Git, GNU timeout, Python 3.10+ dan PyYAML; modul kunci fail yang digunakan juga khusus untuk Unix. Pada Windows 10, laluan yang disarankan ialah WSL2 dengan Ubuntu. Arahan pemasangan WSL satu baris memerlukan Windows 10 versi 2004 (build 19041) atau lebih baharu.
What should I do next in practice?
Jalankan pratonton dan semakan awal sebelum memasang. Pemasangan dalam WSL tidak semestinya bermakna IDE Windows asli telah memuatkan konfigurasi.
Sources
docs.python.orgfcntl — The fcntl and ioctl system calls — Python 3.14.8 documentation
learn.microsoft.comInstall WSL
developer.microsoft.comWindows Subsystem for Linux | Microsoft Developer