JawabanDipublikasikan15 sumber
Panduan Instalasi Windows 10: Gunakan WSL2, Bukan PowerShell Saja
Proyek ini tidak cocok dipasang langsung lewat PowerShell atau CMD karena memakai dependensi dan mekanisme khusus Unix. Di Windows 10 yang memenuhi syarat, pasang WSL2 dan Ubuntu, lalu jalankan perintah instalasi proyek dari terminal Ubuntu.
Diterbitkan olehGambar dibuat dengan GPT Image 2
Jawaban penelitian
Poin-poin penting
- Proyek ini tidak cocok dipasang langsung lewat PowerShell atau CMD karena memakai dependensi dan mekanisme khusus Unix.
- Di Windows 10 yang memenuhi syarat, pasang WSL2 dan Ubuntu, lalu jalankan perintah instalasi proyek dari terminal Ubuntu.
- Keberhasilan menyalin berkas di WSL tidak otomatis berarti IDE Windows telah memuat konfigurasi proyek.
![[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 Perintah
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
Kesimpulan singkat
Proyek ini tidak bisa dipasang sepenuhnya melalui PowerShell atau CMD Windows. Untuk Windows 10, jalur yang disarankan adalah WSL2 dengan Ubuntu. Panduan ini berdasarkan pemeriksaan kode sumber; langkah-langkahnya belum diuji di perangkat Windows 10 dan tidak ada instalasi yang dijalankan.
Mengapa perlu WSL?
Proyek membutuhkan Bash, Git, GNU timeout, Python 3.10 atau lebih baru, serta PyYAML (lihat README.md). Salah satu modul deployment juga mengimpor fcntl, yaitu modul Python untuk antarmuka sistem Unix yang tidak tersedia di Windows biasa 7. Jadi, memasang Git Bash dan Python untuk Windows saja belum cukup.
Selain itu, mekanisme pencarian konfigurasi proyek ditujukan untuk tata letak penyimpanan Linux (lihat scripts/deployment_targets.py). Menyalin berkas melalui WSL belum tentu membuat IDE yang berjalan langsung di Windows mengenali konfigurasi tersebut.
1. Pasang WSL dan Ubuntu
Langkah berikut mengasumsikan komputer mendukung WSL2. Perintah instalasi satu langkah tersedia untuk Windows 10 versi 2004 (build 19041) atau lebih baru; pada versi yang lebih lama, pemasangan WSL mungkin perlu dilakukan secara manual 12
15.
Buka PowerShell sebagai administrator, lalu jalankan 12:
wsl --install -d Ubuntu
Ikuti instruksi untuk memulai ulang komputer. Saat Ubuntu pertama kali dibuka, buat nama pengguna dan kata sandi Linux 3.
Periksa versi WSL yang digunakan Ubuntu:
wsl --list --verbose
Jika kolom VERSION menunjukkan 1, ubah distribusinya ke WSL2:
wsl --set-version Ubuntu 2
2. Pasang dependensi dan unduh repositori
Jalankan perintah berikut di terminal Ubuntu, bukan di PowerShell. Autentikasi administrator terlebih dahulu, lalu pasang dependensi. Jika salah satu perintah gagal, berhenti dan periksa masalahnya sebelum melanjutkan.
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
Pilih direktori kerja Linux, lalu klon repositori proyek:
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
Setelah proses klon berhasil, masuk ke direktori proyek:
cd dotfiles-bmad-solo
Sebelum menjalankan instalasi, tinjau install.sh dan bs.sh yang sudah diunduh. Jangan menjalankan skrip jarak jauh langsung melalui pipe; proyek sendiri juga menyarankan agar skrip ditinjau terlebih dahulu (README.md).
3. Jalankan pemeriksaan sebelum instalasi
Dari direktori utama repositori, jalankan pemeriksaan awal dan simulasi tanpa perubahan. Opsi ini tersedia di bs.sh:
timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null
Lanjutkan hanya jika pemeriksaan berhasil, tujuan instalasi sudah benar, dan Anda setuju proyek menulis konfigurasi global untuk pengguna Linux yang sedang digunakan. Jalankan instalasi dan pemeriksaan status:
timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null
Jika ditemukan konflik berkas, konfigurasi rusak, atau transaksi yang belum selesai, bereskan masalah tersebut terlebih dahulu. Jangan menghapus catatan status atau memaksa penimpaan (lihat README.md).
4. Pastikan IDE menggunakan lingkungan yang benar
- Jika memakai VS Code, pasang VS Code di Windows dan ekstensi WSL, lalu buka ruang kerja Ubuntu. Microsoft merekomendasikan pendekatan ini untuk pengembangan dengan WSL
9.
- Pastikan Roo berjalan pada host ekstensi yang tepat dan menggunakan konfigurasi mode dari lingkungan tersebut. Proyek meminta pemeriksaan runtime secara terpisah (
README.md). - Jika Antigravity, Gemini, atau Roo berjalan langsung di Windows, instalasi di WSL jangan dianggap sebagai instalasi Windows yang berhasil. Mekanisme pencarian konfigurasi proyek saat ini tidak mencakup jalur konfigurasi Windows (
scripts/deployment_targets.py).
Intinya: WSL2 dapat menjadi jalur untuk mencoba proyek ini di Windows 10. Namun, jika Anda harus menjalankannya sepenuhnya di Windows, kode saat ini belum menyediakan prosedur instalasi lengkap yang bisa direkomendasikan. Proyek perlu lebih dulu menyesuaikan mekanisme penguncian berkas, izin dan sinkronisasi direktori, serta jalur konfigurasi Windows. Berhasil menyalin berkas juga belum membuktikan bahwa IDE memuat konfigurasi atau bahwa izin telah terverifikasi (README.md).
Studio Global AI
Lanjutkan penelitian Anda
Halaman ini berisi jawaban yang didukung sumber yang dapat Anda lanjutkan di dalam Studio Global.
Orang-orang juga bertanya
Apa jawaban singkat untuk "Panduan Instalasi Windows 10: Gunakan WSL2, Bukan PowerShell Saja"?
Proyek ini tidak cocok dipasang langsung lewat PowerShell atau CMD karena memakai dependensi dan mekanisme khusus Unix.
Apa poin penting yang harus divalidasi terlebih dahulu?
Proyek ini tidak cocok dipasang langsung lewat PowerShell atau CMD karena memakai dependensi dan mekanisme khusus Unix. Di Windows 10 yang memenuhi syarat, pasang WSL2 dan Ubuntu, lalu jalankan perintah instalasi proyek dari terminal Ubuntu.
Apa yang harus saya lakukan selanjutnya dalam latihan?
Keberhasilan menyalin berkas di WSL tidak otomatis berarti IDE Windows telah memuat konfigurasi proyek.
Sumber
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 ...
developer.microsoft.comWindows Subsystem for Linux | Microsoft Developer