Dropstone CLI

Panduan pemecahan masalah

Diagnosis masalah Dropstone CLI secara sistematis. Kumpulkan informasi yang tepat, temukan log, dan isolasi penyebabnya sebelum menghubungi dukungan.

Sebagian besar masalah berasal dari salah satu dari empat hal: build lama, cache basi, kredensial buruk, atau jaringan. Halaman ini adalah urutan untuk memeriksanya, dan apa yang harus dikumpulkan ketika tidak ada satu pun yang menjadi penyebabnya.

Untuk pesan kesalahan tertentu, mulailah dengan Masalah umum. Untuk perilaku runtime dan debugging per fitur, lihat Pemecahan masalah CLI.

Tiga hal pertama yang harus dicoba

Jalankan ini sebelum hal lainnya. Hal-hal ini menyelesaikan sebagian besar laporan yang mengejutkan.

# 1. Perbarui
dropstone update

# 2. Lihat apa yang sebenarnya dilakukan Dropstone
dropstone --log-level DEBUG --print-logs
  1. Jika kegagalan terjadi di tengah sesi dan penyebabnya tidak jelas, bersihkan cache dan mulai ulang:
rm -rf ~/.cache/dropstone

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

Sebelum menghapus hal lain

Ketiga perintah di atas aman. Menghapus ~/.local/share/dropstone tidak aman — di situlah kredensial dan riwayat sesi Anda berada. Lihat Di mana state disimpan sebelum menghapus direktori tersebut.

Di mana state disimpan

Semua yang disimpan Dropstone di disk berada di dua direktori.

ApamacOS / LinuxWindows
Kredensial dan sesi~/.local/share/dropstone/%USERPROFILE%\.local\share\dropstone
Log~/.local/share/dropstone/log/%USERPROFILE%\.local\share\dropstone\log
Cache~/.cache/dropstone/%USERPROFILE%\.cache\dropstone

Di dalam direktori data:

  • auth.json — kredensial Anda. Hapus ini hanya untuk memaksa masuk ulang yang bersih.
  • log/ — log dengan stempel waktu. Sepuluh yang terbaru disimpan.
  • project/ — riwayat sesi, dibatasi per proyek.

File log dinamai berdasarkan waktu penulisannya, misalnya 2026-05-23T123456.log. Yang paling terbaru adalah yang Anda inginkan.

Dapatkan log yang layak dibaca

Secara default, level log tenang. Dua flag mengubahnya:

# Output terperinci ditulis ke file log
dropstone --log-level DEBUG

# Output yang sama dialirkan ke terminal Anda saat terjadi
dropstone --print-logs

Gunakan keduanya bersama-sama ketika Anda ingin melihat kegagalan terjadi dan tetap memiliki file setelahnya.

Jika masalahnya adalah crash saat peluncuran, --print-logs adalah yang membantu: file log mungkin tidak ditulis sama sekali sebelum proses mati, tetapi stderr selalu ada.

Apa yang harus disertakan dalam laporan

Laporan dengan lima hal ini biasanya memerlukan satu balasan untuk diselesaikan. Laporan tanpa hal-hal tersebut biasanya memerlukan empat balasan.

  1. Perintah persis yang Anda jalankan. Bukan parafrase — baris literal, termasuk flag.

  2. Apa yang Anda harapkan, dan apa yang terjadi. Kedua bagian. "Gagal" tidak mempersempit apa pun.

  3. Versi dan platform Anda.

    dropstone --version

    Plus OS dan versi Anda, dan apakah Anda menggunakan Windows asli atau di dalam WSL.

  4. Kutipan log yang relevan. Beberapa baris di sekitar kesalahan, bukan seluruh file. Redaksi apa pun yang sensitif — log sesi dapat berisi jalur file dan kode.

  5. Apakah dapat direproduksi. Selalu, kadang-kadang, atau sekali. "Kadang-kadang" layak disebutkan; itu menunjukkan masalah waktu atau state daripada input yang buruk.

Kirim ke dropstone.io/contact.

Mempersempit penyebab

Jika penyebabnya masih belum jelas, hilangkan variabel satu per satu. Masing-masing menghilangkan seluruh kategori.

Apakah ini masalah proyek? Jalankan Dropstone di direktori kosong. Jika berfungsi di sana, masalahnya terbatas pada proyek — kemungkinan file konfigurasi, file aturan, atau sesuatu di repo yang dibaca agen.

Apakah ini masalah konfigurasi Anda? Pindahkan sementara dropstone.json ke samping dan luncurkan ulang. Lihat Konfigurasi untuk mengetahui di mana file konfigurasi global dan proyek berada.

Apakah ini masalah server MCP? Server yang menggantung saat startup akan menghentikan seluruh sesi. Daftarkan dan nonaktifkan, lalu aktifkan kembali satu per satu:

dropstone mcp list

Apakah ini masalah jaringan? Proksi korporat adalah penyebab paling umum dari kegagalan yang terlihat seperti hal lain. Periksa:

curl -I https://dropstone.io

Jika itu gagal atau mengembalikan sesuatu yang tidak terduga, lihat Jaringan dan proksi. Perbaikan yang biasa adalah mengatur HTTPS_PROXY dan, yang penting, NO_PROXY=localhost,127.0.0.1 — Dropstone menggunakan loopback lokal selama sesi interaktif, dan merutekannya melalui proksi menyebabkan loop.

Apakah ini masalah kredensial Anda? Keluar dan masuk kembali:

dropstone auth logout
dropstone auth login

Apakah ini masalah terminal? Di Linux, salin dan tempel memerlukan utilitas clipboard yang terinstal. Lihat Pemecahan masalah CLI.

Apakah ini masalah Windows? Akses file lambat, gangguan terminal, dan masalah jalur di Windows asli biasanya hilang di bawah WSL. Lihat Windows dan WSL.

Sebelum menghubungi dukungan

Terkait

Ctrl+I