Dropstone Docs

Pemecahan Masalah

Masalah umum dan cara mengatasinya.

Untuk men-debug masalah dengan Dropstone, mulai dengan memeriksa log dan data lokal yang disimpannya di disk.

Log

File log ditulis ke:

  • macOS / Linux: ~/.local/share/dropstone/log/
  • Windows: tekan WIN+R dan tempel %USERPROFILE%\.local\share\dropstone\log

File log diberi nama dengan stempel waktu (misalnya 2026-05-23T123456.log) dan 10 file log terbaru disimpan.

Anda dapat mengatur tingkat log dengan opsi baris perintah --log-level untuk output debug yang lebih detail:

dropstone --log-level DEBUG

--print-logs juga mengalirkan log ke stderr secara real-time:

dropstone --print-logs

Penyimpanan

Dropstone menyimpan data sesi dan data aplikasi lainnya di disk di:

  • macOS / Linux: ~/.local/share/dropstone/
  • Windows: tekan WIN+R dan tempel %USERPROFILE%\.local\share\dropstone

Direktori ini berisi:

  • auth.json: Kredensial autentikasi
  • log/: Log aplikasi
  • project/: Data khusus proyek seperti riwayat sesi
    • Jika proyek berada di dalam repositori Git, disimpan di ./<project-slug>/storage/
    • Jika tidak, disimpan di ./global/storage/

Masalah umum

Dropstone tidak akan dimulai

  1. Periksa log untuk pesan kesalahan.
  2. Coba jalankan dengan --print-logs untuk mengalirkan log ke stderr.
  3. Pastikan Anda menggunakan versi terbaru: dropstone update.

Masalah autentikasi

Jika masuk atau validasi token gagal:

  1. Jalankan kembali dropstone dan masuk lagi melalui alur browser.
  2. Jika Anda berada di lingkungan headless, atur DROPSTONE_API_KEY dari token yang dikeluarkan di dropstone.io/account.
  3. Konfirmasi jaringan Anda memungkinkan HTTPS keluar ke dropstone.io. Jika Anda berada di belakang proxy korporat, lihat Network.

Model tidak ditemukan

Jika Anda melihat ModelNotFoundError, Anda mungkin mereferensikan ID model yang tidak ada. Gunakan salah satu dari:

  • dropstone/dropstone-fast
  • dropstone/dropstone-pro
  • dropstone/dropstone-heavy

Jalankan dropstone models untuk mengonfirmasi apa yang tersedia untuk akun Anda.

Kesalahan inisialisasi

Jika Anda melihat InitError saat peluncuran, kredensial yang disimpan mungkin tidak valid atau rusak.

  1. Hapus data yang disimpan:

    rm -rf ~/.local/share/dropstone

    Di Windows: tekan WIN+R dan hapus %USERPROFILE%\.local\share\dropstone.

  2. Jalankan kembali dropstone dan masuk lagi.

Kesalahan panggilan API

Jika Anda melihat kesalahan panggilan API selama sesi, cache di disk mungkin sudah ketinggalan zaman.

  1. Hapus cache:

    rm -rf ~/.cache/dropstone

    Di Windows: tekan WIN+R dan hapus %USERPROFILE%\.cache\dropstone.

  2. Mulai ulang Dropstone.

Salin / tempel tidak berfungsi di Linux

Pengguna Linux memerlukan salah satu utilitas clipboard berikut yang diinstal agar salin/tempel berfungsi:

X11

apt install -y xclip
# atau
apt install -y xsel

Wayland

apt install -y wl-clipboard

Headless

apt install -y xvfb
# kemudian
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

Dropstone lebih suka wl-clipboard di Wayland dan kembali ke xclip kemudian xsel di X11.

Windows: Masalah kinerja umum

Jika Anda mengalami kinerja lambat, masalah akses file, atau glitch terminal di Windows native, beralih ke WSL. WSL memberi Anda lingkungan Linux yang menjalankan Dropstone dengan kecepatan filesystem native dan dukungan terminal penuh.

Mendapatkan bantuan

Ctrl+I