การแก้ไขปัญหา: Terminal
แก้ปัญหา terminal ที่พบบ่อย เช่น หน้าจอว่างเปล่า พิมพ์ไม่ได้ และ AI agent ทำงานผิดปกติ
Terminal เปิดขึ้นแต่ไม่มีเอาต์พุตเมื่อพิมพ์
อาการ: คุณกดแป้นพิมพ์แต่ไม่มีอะไรปรากฏใน terminal หรือ terminal เปิดขึ้นมาเป็นหน้าจอว่างเปล่าและค้างอยู่อย่างนั้น
สาเหตุที่เป็นไปได้และวิธีแก้:
ไฟล์ init ของ shell มีข้อผิดพลาด ไฟล์เริ่มต้นของ shell (.zshrc, .bashrc หรือ .bash_profile) อาจมีข้อผิดพลาดด้านไวยากรณ์ หรือมีคำสั่งที่ค้าง ลองเปิด terminal Bash ธรรมดาใน 1DevTool แล้วรัน:
cat ~/.zshrc
มองหาข้อผิดพลาดที่เห็นได้ชัด เช่น เครื่องหมายคำพูดปิดที่หายไป ตัวแปรที่ไม่ได้กำหนดค่า หรือคำสั่ง source ที่ชี้ไปยังไฟล์ที่ไม่มีอยู่ แก้ไขข้อผิดพลาดใน Env Manager หรือโปรแกรมแก้ไขข้อความ แล้วเปิด terminal ใหม่อีกครั้ง
ประเภท terminal ไม่ถูกต้อง หากคุณเลือก terminal แบบ “Claude Code” แต่ยังไม่ได้ติดตั้ง CLI claude terminal จะเปิดขึ้นมาได้ แต่ shell จะเปิดใช้งาน agent ไม่สำเร็จ ให้ติดตั้ง Claude Code ก่อน (npm install -g @anthropic-ai/claude-code) หรือเปลี่ยนประเภท terminal เป็นเซสชัน Bash หรือ Zsh ธรรมดา
รีเซ็ตด่วน คลิกขวาที่ใดก็ได้บนแท็บ terminal แล้วเลือก Restart Terminal วิธีนี้จะหยุดโปรเซส shell ปัจจุบันและเริ่มโปรเซสใหม่โดยไม่ต้องปิดแผง
AI Agent ไม่ตอบสนองต่ออินพุต
อาการ: คุณพิมพ์ prompt ใน terminal ของ agent แต่ไม่มีอะไรเกิดขึ้น ไม่มี spinner ไม่มีการตอบกลับ และไม่มีการรับทราบใดๆ
สาเหตุที่พบบ่อยที่สุดคืออินเทอร์เฟซของ agent อยู่ในโหมดย่อยที่ไม่ได้อ่านอินพุตของคุณ ตัวอย่างเช่น หาก agent เปิดไฟล์ในโปรแกรมแก้ไขข้อความอย่าง vim หรือ nano ภายใน terminal การกดแป้นพิมพ์จะไปยังโปรแกรมแก้ไขนั้นแทนที่จะเป็น agent
วิธีแก้:
- กด Ctrl+C หนึ่งหรือสองครั้งเพื่อยกเลิกสิ่งที่ agent กำลังทำอยู่และกลับสู่ prompt หลัก จากนั้นพิมพ์ข้อความของคุณใหม่
- ใช้ Agent Input Overlay แทนการพิมพ์ลงใน terminal โดยตรง กด Cmd+I (หรือ Ctrl+I บน Windows/Linux) เพื่อเปิดช่องอินพุตเฉพาะที่ส่ง prompt ไปยัง agent ได้อย่างราบรื่น โดยไม่ต้องกังวลกับสถานะของ terminal
- หาก agent ดูเหมือนค้างสนิท ให้คลิกขวาที่แท็บ terminal แล้วเลือก Restart Terminal เพื่อเริ่มเซสชัน agent ใหม่
Scrollback ถูกตัดหลังจาก Agent ตอบกลับ
อาการ: หลังจาก agent ตอบกลับยาวๆ คุณเลื่อนขึ้นไปดูได้แค่ระยะหนึ่งเท่านั้น เอาต์พุตก่อนหน้านั้นหายไป
วิธีแก้:
- คลิกปุ่ม Expand scrollback ที่ส่วนหัวของ terminal (ไอคอนลูกศรที่มุมขวาบนของแผง terminal) ซึ่งจะโหลดประวัติเพิ่มเข้ามาในมุมมองชั่วคราว
- หากต้องการแก้แบบถาวร ให้เพิ่มขีดจำกัดของ scrollback ไปที่ Settings → Terminal → Scrollback Lines ค่าเริ่มต้นคือ 10,000 บรรทัด และเพิ่มได้สูงสุด 100,000 บรรทัด โปรดทราบว่า scrollback buffer ที่ใหญ่มากจะใช้หน่วยความจำมากขึ้น
Scrollback แสดงข้อความสับสนหรือซ้อนทับกัน
อาการ: หลังจากปรับขนาดแผงหรือเปิด terminal ใหม่ ประวัติเก่าแสดงบรรทัดที่รวมกัน อักขระแปลกปลอม หรือบล็อกที่ซ้ำกัน
วิธีแก้: มองหาปุ่มสีเหลืองอำพัน Repair view บน terminal ปุ่มนี้จะปรากฏเมื่อประวัติบางส่วนถูกวาดด้วยความกว้างที่ต่างจากความกว้างปัจจุบันของแผง คลิกปุ่มนี้แล้วมุมมองจะถูกสร้างขึ้นใหม่จากแถวที่ตรงกับความกว้างของ terminal เอง
Terminal แสดงข้อความ “[detached]”
คุณอาจเห็นบรรทัดเช่น [detached (from session main)] ปรากฏที่ด้านบนของ terminal นี่คือข้อความจาก tmux ซึ่งเป็น terminal multiplexer ที่ 1DevTool ใช้เพื่อให้เซสชันทำงานต่อเนื่องอยู่เบื้องหลัง
ข้อความนี้หมายความว่าหน้าจอถูกตัดการเชื่อมต่อจากเซสชันที่กำลังทำงานอยู่ชั่วคราว แล้วเชื่อมต่อใหม่ ถือเป็นเรื่องปกติโดยสมบูรณ์ มักเกิดขึ้นเมื่อคุณสลับโปรเจกต์ ซ่อนแล้วเปิด terminal ใหม่ หรือเมื่อแอปถูกเรียกคืนจากสถานะย่อหน้าต่าง เซสชันและโปรเซสที่กำลังรันทั้งหมดจะไม่ได้รับผลกระทบ
Terminal ที่ซ่อนไว้เริ่มเซสชันใหม่แทนที่จะกลับมาทำงานต่อ
อาการ: คุณซ่อน terminal โดยคลิกไปที่อื่นหรือปิดแผง จากนั้นเปิดขึ้นมาใหม่ แล้ว terminal เริ่มใหม่หมด คำสั่งก่อนหน้าและโปรเซสที่กำลังรันอยู่หายไป
สาเหตุ: 1DevTool ใช้ tmux เพื่อให้เซสชัน terminal ทำงานต่อเนื่องอยู่เบื้องหลัง หากไม่ได้ติดตั้ง tmux หรือ tmux ไม่อยู่ใน PATH ของ shell เซสชันจะไม่สามารถคงอยู่ได้และจะเริ่มใหม่ตั้งแต่ต้นทุกครั้ง
วิธีแก้: ติดตั้ง tmux แล้วรีสตาร์ต 1DevTool
- macOS:
brew install tmux - Linux (Debian/Ubuntu):
sudo apt install tmux - Linux (Fedora/RHEL):
sudo dnf install tmux
หลังติดตั้งแล้ว ให้ปิด 1DevTool ให้สนิทแล้วเปิดใหม่ เซสชัน terminal ใหม่จะคงอยู่ได้แม้ถูกซ่อนไว้
Terminal ใช้ CPU สูง
หากเครื่องของคุณร้อนหรือพัดลมหมุนเสียงดัง อาจมีโปรเซสของ terminal ใช้ CPU มากเกินไป
วิธีระบุต้นเหตุ: วางเมาส์เหนือแท็บ terminal แต่ละแท็บ แท็บที่กำลังทำงานจะแสดงตัวบ่งชี้ที่หมุนอยู่ คุณยังสามารถเปิด terminal แล้วรัน top หรือ htop เพื่อดูว่าโปรเซสใดเป็นต้นเหตุ
วิธีหยุด:
- กด Ctrl+C ใน terminal เพื่อหยุดโปรเซสที่กำลังรันอยู่
- หรือคลิกขวาที่แท็บ terminal แล้วเลือก Kill Process เพื่อบังคับยุติสิ่งที่รันอยู่ภายใน
หากโปรเซสนั้นเป็น dev server หรือเครื่องมือ build ที่ทำงานเกินการควบคุม สามารถปิดแล้วเริ่มใหม่ด้วยคำสั่งเริ่มต้นตามปกติได้อย่างปลอดภัย