Sebagian besar masalah di 1DesignTool bermuara pada segelintir penyebab — agen yang hilang atau belum sign-in, run yang macet, pratinjau yang tidak mau render, gate FAIL, atau cap yang habis. Halaman ini adalah tempat pertama yang perlu diperiksa untuk masing-masingnya.
Agen tidak ada di picker
Aplikasi menemukan CLI yang didukung di PATH Anda — sama seperti yang dilakukan terminal.
- Sudah terinstal? Jalankan CLI dengan namanya di terminal (
claude,codex…) — kalau shell menemukannya, aplikasi juga seharusnya. - Sudah sign-in? Picker menampilkan status sign-in; sign-in yang hilang adalah urusan auth milik CLI, bukan aplikasi. Sign-in di sisi CLI dan buka kembali aplikasinya.
- Ada di daftar? 16 CLI yang didukung tercantum di Agen coding yang didukung — CLI yang tidak ada di daftar tidak bisa dipasang.
Run macet atau gagal
- Periksa kuota agen — turn ditagihkan ke akun CLI Anda; akun yang habis atau kedaluwarsa menggagalkan run secara terlihat di transcript.
- Baca transcript-nya — output agen sendiri ada di sana; error sisi-CLI muncul sebagai dirinya, bukan sebagai kegagalan generik.
- Coba lagi sekali — kegagalan CLI yang sementara kadang berhasil saat dicoba ulang. Kegagalan yang menetap punya penyebab yang disebutkan transcript.
Pratinjau tidak mau render
- Pratinjau itu default-deny — tipe file yang tidak disajikan classifier ter-render sebagai kosong alih-alih tidak aman. Ini lantai keamanannya, bukan bug.
- Worktree basi — pada proyek codebase, pratinjau membaca worktree
1design/<slug>; kalau status branch terlihat aneh, tinjau diff di branch bar dulu sebelum mencurigai rendernya. - Refresh panelnya — tombol reload di rel pratinjau membaca ulang folder; file yang setengah-tertulis biasanya pulih di paint berikutnya.
Gate FAIL tidak mau hilang
- Perbaiki di lebar ini — tombol fix pada temuan FAIL mengirim persis masalah itu kembali ke agen sebagai brief satu baris; temuan menyebut lebar dan elemennya, jadi perbaikannya biasanya mekanis.
- Periksa di lebar itu — temuan menyebut viewport mana yang rusak; lihat hasilnya di sana sebelum berasumsi aturannya yang salah.
- Beberapa temuan memang disengaja — trade-off yang diketahui bisa diterima; gate menyarankan, ia tidak memblokir. Lihat Gate design kit.
Cap menolak run
Penolakan 1design:limit: menyebut cap yang habis — turn, render, versi,
variant, atau sistem desain di tier gratis. Settings → Usage menampilkan
meter secara lengkap, dan mengarsipkan versi membebaskan slot tanpa lisensi.
Cap adalah penghitung seumur hidup; Pro menghapusnya. Lihat
Free vs Pro.
Di Windows: error EISDIR (masalah yang diketahui)
Di 1.7.0 pada Windows, skrip design kit bisa gagal dengan EISDIR — yang
merusak Knowledge, pemeriksaan pasca-turn, ekspor video, dan Build mode. Ini
bug yang diketahui, sudah diperbaiki di rilis berikutnya; di macOS alur yang
sama tidak terpengaruh.
Klien MCP tidak mau terhubung
- Periksa panel akses — Settings → MCP access menampilkan endpoint, token, dan daftar klien yang diizinkan; klien yang ditolak biasanya tidak ada di daftar.
- Periksa tokennya — token di panel adalah yang dikirim klien; token basi atau salah menolak koneksinya.
- Periksa activity log — log menampilkan apa yang sampai ke server dan apa yang tidak.
Tempat pertama yang diperiksa
- Panel transcript — output agen, apa adanya
- Branch bar — pada proyek codebase, apa yang benar-benar diubah turn
- Settings → Usage — meter mana yang habis
- Activity log — apa yang benar-benar dilakukan klien MCP
Tip: Transcript adalah bacaan pertama, selalu — output agen sendiri adalah versi jujur tentang apa yang terjadi, dan kebanyakan kasus "aplikasi rusak" sebenarnya adalah "CLI mengatakan sesuatu yang diterjemahkan UI terlalu halus".