AnswersPublished15 sources
Windows 10 i ten projekt: instalacja przez WSL2 krok po kroku
Projekt wymaga środowiska Bash i narzędzi linuksowych; sam Windows z Git Bash nie wystarczy. Na Windows 10 najrozsądniej uruchomić Ubuntu w WSL2, a następnie sklonować i sprawdzić repozytorium.
Opublikowane przezObrazy wygenerowane za pomocą GPT Image 2
Research answer
Key takeaways
- Projekt wymaga środowiska Bash i narzędzi linuksowych; sam Windows z Git Bash nie wystarczy.
- Na Windows 10 najrozsądniej uruchomić Ubuntu w WSL2, a następnie sklonować i sprawdzić repozytorium.
- Instalacja w WSL nie oznacza automatycznie, że konfigurację załaduje program IDE działający natywnie w Windows.
![[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
Najpierw ważne zastrzeżenie: to nie jest instalator dla Windowsa
Tego projektu nie da się zainstalować wprost z PowerShella ani wiersza polecenia. Wymaga między innymi Basha, Gita, GNU timeout, Pythona 3.10 lub nowszego oraz PyYAML (zależność opisana w README.md). Co istotne, jeden ze skryptów importuje moduł fcntl, dostępny w systemach Unix, ale nie w natywnym Pythonie dla Windowsa 7. Sam Git Bash tego ograniczenia nie rozwiązuje.
W praktyce na Windows 10 warto więc użyć WSL2, czyli środowiska pozwalającego uruchamiać dystrybucję Linuksa i linuksowe narzędzia obok Windowsa 12. Poniższe kroki opisują próbę instalacji w Ubuntu działającym w WSL. Nie są potwierdzeniem, że projekt został sprawdzony na fizycznym komputerze z Windows 10.
1. Zainstaluj WSL i Ubuntu
Otwórz PowerShell jako administrator i wpisz:
wsl --install -d Ubuntu
Po wyświetleniu monitu uruchom ponownie komputer. Przy pierwszym starcie Ubuntu utwórz linuksową nazwę użytkownika i hasło 3.
Jednolinijkowe polecenie instalacji WSL jest przeznaczone dla zaktualizowanego Windows 10 w wersji 2004 (kompilacja 19041) lub nowszej. W starszej wersji systemu może być potrzebna ręczna instalacja WSL 12
10; Microsoft opisał też dostępność uproszczonej instalacji na Windows 10 2004 i nowszych
15.
Sprawdź, czy Ubuntu działa w WSL2:
wsl --list --verbose
Jeśli w kolumnie VERSION przy Ubuntu widnieje 1, możesz przekonwertować dystrybucję poleceniem:
wsl --set-version Ubuntu 2
2. Zainstaluj zależności i pobierz repozytorium
Kolejne polecenia uruchamiaj w terminalu Ubuntu, nie w PowerShellu. Najpierw sprawdź możliwość użycia sudo, a następnie zainstaluj wymagane narzędzia. Jeśli którykolwiek krok zakończy się błędem, zatrzymaj się i najpierw wyjaśnij jego przyczynę.
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
W wybranym linuksowym katalogu roboczym pobierz repozytorium:
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
Po udanym klonowaniu przejdź do katalogu projektu:
cd dotfiles-bmad-solo
Przed uruchomieniem instalatora przejrzyj pobrane pliki install.sh i bs.sh. Nie uruchamiaj zdalnego skryptu bezpośrednio przez potok; dokumentacja projektu zaleca sprawdzenie zaufanej wersji przed wykonaniem [README.md].
3. Najpierw kontrola, potem instalacja
Będąc w głównym katalogu repozytorium, wykonaj wstępne sprawdzenie i próbę bez zmian. Skrypt bs.sh obsługuje oba parametry (--preflight i --dry-run):
timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null
Dopiero jeśli kontrola zakończy się powodzeniem, wskazany cel jest właściwy, a Ty akceptujesz zmiany w konfiguracji globalnej bieżącego użytkownika Linuksa, uruchom wdrożenie i sprawdź jego status:
timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null
Jeśli skrypt wykryje konflikt plików, uszkodzoną konfigurację albo niedokończoną transakcję, najpierw usuń przyczynę problemu. Nie kasuj zapisanych informacji o stanie i nie wymuszaj nadpisania. Dokumentacja projektu opisuje takie przypadki jako przeszkody wymagające sprawdzenia (README.md).
4. Upewnij się, gdzie działa IDE
Jeśli korzystasz z Visual Studio Code, możesz zainstalować program i rozszerzenie WSL w Windows, a następnie połączyć się z obszarem roboczym w Ubuntu. Microsoft opisuje taki sposób pracy z WSL 9.
Wciąż trzeba jednak sprawdzić, w którym środowisku działa rozszerzenie Roo i do którego środowiska należy jego konfiguracja. Samo skopiowanie plików w WSL nie potwierdza, że IDE je załadowało ani że działa zgodnie z oczekiwaniami (README.md).
Jeśli korzystasz z natywnej, windowsowej wersji Antigravity, Gemini lub Roo, nie traktuj instalacji w WSL jako instalacji w tym programie. Mechanizm automatycznego wykrywania projektu jest ukierunkowany na linuksowy układ katalogów, a nie na ścieżki konfiguracji Windowsa (scripts/deployment_targets.py).
W skrócie: jeśli możesz użyć WSL2, spróbuj instalacji w Ubuntu, wykonując najpierw kontrolę i próbę bez zmian. Jeśli projekt musi działać w całości natywnie w Windowsie, obecna wersja nie ma gotowej, kompletnej instrukcji instalacji — wymagałoby to dostosowania między innymi obsługi blokad plików, uprawnień i ścieżek konfiguracji. Powodzenie kopiowania plików nie oznacza jeszcze, że IDE je załadowało.
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 "Windows 10 i ten projekt: instalacja przez WSL2 krok po kroku"?
Projekt wymaga środowiska Bash i narzędzi linuksowych; sam Windows z Git Bash nie wystarczy.
What are the key points to validate first?
Projekt wymaga środowiska Bash i narzędzi linuksowych; sam Windows z Git Bash nie wystarczy. Na Windows 10 najrozsądniej uruchomić Ubuntu w WSL2, a następnie sklonować i sprawdzić repozytorium.
What should I do next in practice?
Instalacja w WSL nie oznacza automatycznie, że konfigurację załaduje program IDE działający natywnie w Windows.