Dropstone CLI

Pemecahan Masalah

Masalah umum dan cara mengatasinya.

Untuk men-debug masalah dengan Dropstone, mulailah 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 keluaran 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 pada:

  • 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, data disimpan di ./<project-slug>/storage/
    • Jika tidak, data disimpan di ./global/storage/

Masalah umum

Dropstone tidak mau 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.

Jika aplikasi langsung mati tanpa mencetak apa pun di macOS, itu adalah kegagalan yang berbeda — lihat Terhenti (Killed) saat diluncurkan di macOS.

Terhenti (Killed) saat diluncurkan di macOS

Pada Apple Silicon, Dropstone 1.0.50 dihentikan oleh macOS sebelum mencetak apa pun, sehingga setiap perintah terlihat seperti ini:

dropstone --version
# zsh: killed     dropstone --version

Tidak ada log yang bisa dibaca dan tidak ada kesalahan yang bisa dicari: proses dihentikan sebelum dimulai, itulah sebabnya --print-logs dan dropstone upgrade juga ikut terhenti. macOS memvalidasi tanda tangan pada biner sebelum menjalankannya, dan tanda tangan yang dicap pada build tersebut tidak cocok. macOS hingga 26 masih menoleransinya; macOS 27 tidak. Windows dan Linux tidak pernah terpengaruh.

Untuk memastikannya sebelum menginstal ulang:

codesign --verify --verbose=4 "$(readlink -f "$(which dropstone)")"
# /opt/homebrew/bin/dropstone: invalid signature (code or signature have been modified)

Kemudian ganti biner tersebut. Homebrew dan penginstal sama-sama berfungsi tanpa perlu menjalankan salinan yang terinstal:

# Homebrew
brew update && brew upgrade dropstone

# Penginstal satu baris
curl -fsSL https://dropstone.io/install.sh | bash

Untuk membuka blokir salinan yang sudah Anda miliki alih-alih menginstal ulang:

codesign --force --sign - "$(readlink -f "$(which dropstone)")"

Versi 1.0.51 dan seterusnya ditandatangani dengan cara yang diterima macOS, dan setiap rilis memeriksa tanda tangan tersebut sebelum dipublikasikan.

Masalah autentikasi

Jika masuk atau validasi token gagal:

  1. Jalankan ulang dropstone dan masuk lagi melalui alur browser.
  2. Jika Anda berada di lingkungan tanpa kepala (headless), atur DROPSTONE_API_KEY dari token yang diterbitkan di dropstone.io/account.
  3. Pastikan jaringan Anda mengizinkan HTTPS keluar ke dropstone.io. Jika Anda berada di belakang proxy perusahaan, lihat Jaringan.

Model tidak ditemukan

Jika Anda melihat ModelNotFoundError, kemungkinan Anda merujuk ke ID model yang tidak ada. Gunakan salah satu dari:

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

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

Kesalahan inisialisasi

Jika Anda melihat InitError saat diluncurkan, kredensial yang tersimpan mungkin tidak valid atau rusak.

  1. Hapus data tersimpan Anda:

    rm -rf ~/.local/share/dropstone

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

  2. Jalankan ulang dropstone dan masuk lagi.

Kesalahan panggilan API

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

  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 perlu menginstal salah satu utilitas clipboard berikut 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
# lalu
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

Dropstone lebih memilih wl-clipboard di Wayland dan beralih ke xclip lalu xsel di X11.

Windows: Masalah kinerja umum

Jika Anda mengalami kinerja lambat, masalah akses file, atau gangguan terminal di Windows asli, beralihlah ke WSL. WSL memberi Anda lingkungan Linux yang menjalankan Dropstone dengan kecepatan sistem file asli dan dukungan terminal penuh.

Mendapatkan bantuan

Ctrl+I