ปัญหาส่วนใหญ่ใน 1DesignTool ลงความที่สาเหตุไม่กี่อย่าง — agent ที่หายไปหรือ sign-out การรันที่หยุดนิ่ง ตัวอย่างที่ไม่เรนเดอร์ gate FAIL หรือ cap ที่หมด หน้านี้คือที่แรกที่ควรดูสำหรับแต่ละอย่าง
Agent ไม่อยู่ในตัวเลือก
แอปหา CLI ที่รองรับบน PATH ของคุณ — เหมือนที่ terminal ทำ
- ติดตั้งแล้วหรือไม่? รัน CLI ด้วยชื่อใน terminal (
claude,codex…) — ถ้า shell เจอ แอปก็ควรเจอ - Sign in แล้วหรือไม่? ตัวเลือกแสดงสถานะ sign-in; sign-in ที่หายไปคือ auth ของ CLI เอง ไม่ใช่ของแอป Sign in ที่ฝั่ง CLI แล้วเปิดใหม่
- อยู่ในรายชื่อหรือไม่? CLI ที่รองรับ 16 ตัวแสดงที่ Coding agent ที่รองรับ — CLI ที่ไม่อยู่ใน รายการเสียบเข้าไม่ได้
การรันหยุดนิ่งหรือล้มเหลว
- เช็กโควตาของ agent — เทิร์นเรียกเก็บจากบัญชี CLI ของคุณ; บัญชีที่หมดหรือ หมดอายุทำให้การรันล้มเหลวอย่างเห็นได้ใน transcript
- อ่าน transcript — เอาต์พุตของ agent เองอยู่ที่นั่น; ข้อผิดพลาดฝั่ง CLI แสดงเป็นตัวมันเอง ไม่ใช่ความล้มเหลวทั่วไป
- ลองอีกครั้ง — ความล้มเหลวชั่วคราวของ CLI บางครั้งผ่านเมื่อลองใหม่ ความ ล้มเหลวที่คงอยู่มีสาเหตุที่ transcript ระบุ
ตัวอย่างไม่เรนเดอร์
- ตัวอย่างเป็น default-deny — ประเภทไฟล์ที่ตัวจำแนกไม่เสิร์ฟเรนเดอร์เป็น อะไรเลยแทนที่จะไม่ปลอดภัย นี่คือพื้นความปลอดภัย ไม่ใช่บั๊ก
- worktree เก่า — บนโปรเจกต์ codebase ตัวอย่างอ่าน worktree
1design/<slug>; ถ้าสถานะ branch ดูแปลก review diff ของแถบ branch ก่อนสงสัย การเรนเดอร์ - รีเฟรชแผง — ปุ่ม reload บนเลนตัวอย่างอ่านโฟลเดอร์ใหม่; ไฟล์ที่เขียนค้าง มักหายเมื่อ paint ถัดไป
Gate FAIL ไม่หาย
- แก้ที่ความกว้างนี้ — ปุ่มแก้ของผลการตรวจ FAIL ส่งปัญหานั้นกลับไปหา agent เป็นบรีฟหนึ่งบรรทัด; ผลการตรวจระบุความกว้างและองค์ประกอบ การแก้จึงมักเป็น เชิงกล
- เช็กที่ความกว้างนั้น — ผลการตรวจบอกว่า viewport ไหนแตก; ดูผลลัพธ์ที่นั่น ก่อนสมมติว่ากฎผิด
- บางผลการตรวจตั้งใจ — trade-off ที่รู้จักยอมรับได้; เกตให้คำแนะนำ ไม่บล็อก ดู เกต design kit
Cap ปฏิเสธการรัน
การปฏิเสธ 1design:limit: ระบุ cap ที่หมด — เทิร์น เรนเดอร์ เวอร์ชัน variant
หรือ design system บนแพ็กเกจฟรี Settings → Usage แสดงมิเตอร์ทั้งหมด และ
การ archive เวอร์ชันคืนช่องโดยไม่ต้อง license cap เป็นตัวนับตลอดกาล; Pro ลบ
ออก ดู Free vs Pro
บน Windows: ข้อผิดพลาด EISDIR (ปัญหาที่รู้จัก)
ใน 1.7.0 บน Windows สคริปต์ design kit อาจล้มเหลวด้วย EISDIR — ซึ่งพัง
Knowledge เช็กหลังเทิร์น export วิดีโอ และโหมด Build มันเป็นบั๊กที่รู้จัก
แก้ในรุ่นถัดไป; บน macOS flow เดียวกันไม่ได้รับผล
ไคลเอนต์ MCP เชื่อมไม่ได้
- เช็กแผงการเข้าถึง — Settings → MCP access แสดง endpoint token และ รายการไคลเอนต์ที่อนุญาต; ไคลเอนต์ที่ถูกปฏิเสธมักไม่อยู่ในรายการ
- เช็ก token — token ของแผงคือสิ่งที่ไคลเอนต์ส่ง; token เก่าหรือผิดปฏิเสธ การเชื่อม
- เช็กบันทึกกิจกรรม — บันทึกแสดงว่าอะไรถึงเซิร์ฟเวอร์และอะไรไม่ถึง
ดูที่ไหนก่อน
- แผง transcript — เอาต์พุตของ agent ตามตัวอักษร
- แถบ branch — บนโปรเจกต์ codebase สิ่งที่เทิร์นเปลี่ยนจริง
- Settings → Usage — มิเตอร์ไหนหมด
- บันทึกกิจกรรม — ไคลเอนต์ MCP ทำอะไรจริง
Tip: transcript คือการอ่านแรกเสมอ — เอาต์พุตของ agent เองเป็นเวอร์ชัน ซื่อสัตย์ของสิ่งที่เกิด และกรณี "แอปพัง" ส่วนใหญ่จริง ๆ คือ "CLI พูดบางอย่าง ที่ UI แปลอ่อนเกินไป"