คำตอบเผยแพร่แล้ว15 แหล่งที่มา
คู่มือติดตั้งบน Windows 10: ทำงานผ่าน WSL2 และ Ubuntu
แนะนำให้ใช้ WSL2 กับ Ubuntu เพราะสคริปต์ของโปรเจกต์ต้องพึ่ง Bash, Git, GNU timeout, Python และ PyYAML โค้ดใช้โมดูล fcntl ซึ่งเป็นส่วนหนึ่งของ Python สำหรับระบบ Unix จึงไม่ควรคาดหวังว่าจะติดตั้งด้วย Python บน Windows โดยตรงได้ [7] ก่อนติดตั้งจริง ให้ตรวจสอบไฟล์สคริปต์และรัน preflight กับ dry run ก่อน
เผยแพร่โดยรูปภาพสร้างด้วย GPT Image 2
คำตอบการวิจัย
ประเด็นสำคัญ
- แนะนำให้ใช้ WSL2 กับ Ubuntu เพราะสคริปต์ของโปรเจกต์ต้องพึ่ง Bash, Git, GNU timeout, Python และ PyYAML
- โค้ดใช้โมดูล fcntl ซึ่งเป็นส่วนหนึ่งของ Python สำหรับระบบ Unix จึงไม่ควรคาดหวังว่าจะติดตั้งด้วย Python บน Windows โดยตรงได้ [7]
- ก่อนติดตั้งจริง ให้ตรวจสอบไฟล์สคริปต์และรัน preflight กับ dry run ก่อน
- การติดตั้งภายใน WSL ไม่ได้ยืนยันว่า IDE ที่เปิดบน 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 พรอมต์
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
โปรเจกต์นี้ไม่ได้ออกแบบมาให้ติดตั้งจาก PowerShell หรือ CMD บน Windows โดยตรง ทางเลือกที่เหมาะกว่าบน Windows 10 คือใช้ WSL2 (Windows Subsystem for Linux) เพื่อเปิดสภาพแวดล้อม Ubuntu แล้วทำตามขั้นตอนติดตั้งในฝั่ง Linux
ข้อแนะนำด้านล่างอิงจากโค้ดและเอกสารที่ให้มา แต่ยังไม่ได้ทดสอบบนเครื่อง Windows 10 จริง และไม่มีการติดตั้งหรือแก้ไขไฟล์ในเครื่องของคุณ
ทำไมจึงควรใช้ WSL2
โปรเจกต์ต้องใช้ Bash, Git, GNU timeout, Python 3.10 ขึ้นไป และ PyYAML [ดูข้อกำหนดใน README ของโปรเจกต์] นอกจากนี้ โค้ดยังนำเข้าโมดูล fcntl สำหรับจัดการล็อกไฟล์ ซึ่งมีให้ใช้กับระบบ Unix ไม่ใช่ Windows โดยตรง 7 ดังนั้นการติดตั้ง Git Bash และ Python เวอร์ชัน Windows เพียงอย่างเดียวจึงไม่พอ
อีกจุดที่ควรระวังคือระบบค้นหาโหมดของโปรเจกต์อ้างอิงโครงสร้างไดเรกทอรีแบบ Linux การคัดลอกไฟล์ลงใน WSL จึงไม่ได้หมายความว่า IDE ที่ทำงานฝั่ง Windows จะพบการตั้งค่าโดยอัตโนมัติ
1. ติดตั้ง WSL และ Ubuntu
คำสั่งติดตั้งแบบรวดเร็วของ WSL ใช้ได้กับ Windows 10 เวอร์ชัน 2004 (Build 19041) ขึ้นไป ส่วนรุ่นเก่ากว่านั้นอาจต้องทำตามขั้นตอนติดตั้งด้วยตนเอง 12
15
10
เปิด PowerShell ในโหมดผู้ดูแลระบบ แล้วรันคำสั่งนี้:
wsl --install -d Ubuntu
ทำตามข้อความบนหน้าจอและรีสตาร์ตเมื่อระบบร้องขอ เมื่อเปิด Ubuntu ครั้งแรก ให้สร้างชื่อผู้ใช้และรหัสผ่านสำหรับ Linux 3
ตรวจสอบว่า Ubuntu ใช้ WSL2 หรือไม่:
wsl --list --verbose
หากคอลัมน์ 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
หากเวอร์ชันต่ำกว่า 3.10 ให้จัดการเรื่องเวอร์ชัน Python ให้เรียบร้อยก่อนดำเนินการต่อ
จากนั้นโคลนรีโพซิทอรีในตำแหน่งทำงานของ Linux ที่คุณเลือกไว้:
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 ที่ดาวน์โหลดมาเสียก่อน เอกสารของโปรเจกต์เองก็แนะนำให้ตรวจสอบสคริปต์จากแหล่งที่เชื่อถือได้ และไม่ควรรันสคริปต์จากระยะไกลผ่าน pipe โดยไม่ตรวจดูเนื้อหา
3. ตรวจสอบก่อนติดตั้งจริง
ที่ไดเรกทอรีหลักของรีโพซิทอรี ให้รันการตรวจสอบเบื้องต้นและโหมดจำลองก่อน คำสั่งทั้งสองรองรับโดย bs.sh:
timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null
ทำขั้นตอนถัดไปเฉพาะเมื่อการตรวจสอบผ่าน คุณยืนยันว่าเป้าหมายถูกต้อง และยอมรับการเขียนไฟล์ตั้งค่าระดับผู้ใช้ Linux ปัจจุบันแล้ว:
timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null
หากรายงานพบไฟล์ที่ชนกัน การตั้งค่าที่เสียหาย หรือธุรกรรมที่ยังไม่เสร็จ ให้จัดการปัญหาที่รายงานก่อน อย่าลบสถานะหรือบังคับเขียนทับเพื่อให้การติดตั้งเดินหน้าต่อ
4. ตรวจสอบว่า IDE ทำงานอยู่ฝั่งไหน
หากใช้ VS Code สามารถติดตั้ง VS Code บน Windows พร้อมส่วนขยาย WSL แล้วเชื่อมต่อกับพื้นที่ทำงานใน Ubuntu ได้ ซึ่งเป็นแนวทางที่ Microsoft แนะนำสำหรับการพัฒนาด้วย WSL 9
อย่างไรก็ตาม ควรตรวจสอบเพิ่มเติมว่า Roo ทำงานอยู่ใน extension host ฝั่งใด และการตั้งค่าโหมดถูกติดตั้งไว้ในสภาพแวดล้อมเดียวกันหรือไม่ เพราะการกระจายไฟล์สำเร็จยังไม่ยืนยันว่า IDE โหลดการตั้งค่าหรือผ่านการตรวจสอบสิทธิ์แล้ว
ถ้าใช้งาน Antigravity, Gemini หรือ Roo ที่รันบน Windows โดยตรง อย่าถือว่าการติดตั้งใน WSL เท่ากับติดตั้งบน Windows แล้ว ระบบค้นหาโหมดของโปรเจกต์ยังไม่ได้ครอบคลุมเส้นทางตั้งค่าของ Windows โดยตรง
สรุป: หากเครื่องรองรับ WSL2 ให้ใช้ Ubuntu ใน WSL เป็นสภาพแวดล้อมสำหรับติดตั้งและทดลองใช้งาน แต่ถ้าจำเป็นต้องทำงานบน Windows แบบ native ทั้งหมด โค้ดปัจจุบันยังไม่มีคำสั่งติดตั้งครบชุดที่แนะนำได้โดยตรง และจำเป็นต้องปรับเรื่อง file lock, สิทธิ์ไฟล์, การซิงก์ไดเรกทอรี และตำแหน่งตั้งค่าของ Windows ก่อน
Studio Global AI
ทำการวิจัยต่อ
หน้านี้รวมคำตอบที่ได้รับการสนับสนุนจากแหล่งที่มาซึ่งคุณสามารถดำเนินการต่อภายใน Studio Global
คนยังถาม
คำตอบสั้น ๆ สำหรับ "คู่มือติดตั้งบน Windows 10: ทำงานผ่าน WSL2 และ Ubuntu" คืออะไร
แนะนำให้ใช้ WSL2 กับ Ubuntu เพราะสคริปต์ของโปรเจกต์ต้องพึ่ง Bash, Git, GNU timeout, Python และ PyYAML
ประเด็นสำคัญที่ต้องตรวจสอบก่อนคืออะไร?
แนะนำให้ใช้ WSL2 กับ Ubuntu เพราะสคริปต์ของโปรเจกต์ต้องพึ่ง Bash, Git, GNU timeout, Python และ PyYAML โค้ดใช้โมดูล fcntl ซึ่งเป็นส่วนหนึ่งของ Python สำหรับระบบ Unix จึงไม่ควรคาดหวังว่าจะติดตั้งด้วย Python บน Windows โดยตรงได้ [7]
ฉันควรทำอย่างไรต่อไปในทางปฏิบัติ?
ก่อนติดตั้งจริง ให้ตรวจสอบไฟล์สคริปต์และรัน preflight กับ dry run ก่อน
แหล่งที่มา
docs.python.orgfcntl — The fcntl and ioctl system calls — Python 3.14.8 documentation
learn.microsoft.comInstall WSL
devblogs.microsoft.comdevblogs.microsoft.com · commandline · install-wslInstall WSL with a single command now available in Windows 10 ...