Pustaka bacaan
Merancang panel filter yang memperlihatkan asumsi
Buat panel filter LocalLLaMA menjelaskan batasnya: kondisi terlihat, perubahan yang dapat dibatalkan, keadaan permintaan terbaca, dan keterbatasan bahan yang diterima.
Beri label pada setiap filter aktif
Panel filter menjelaskan bahan yang boleh dikembalikan permintaan. Untuk catatan kuantisasi yang diusulkan, tampilkan q=quantization, subreddit=LocalLLaMA, limit=3, dan page=1 sebagai keputusan terpisah. Batas komunitas tidak memastikan bahwa semua diskusi relevan berada di sana atau arsip menyimpan semuanya. Letakkan pertanyaan di dekatnya, misalnya kondisi apa yang dilaporkan untuk suatu pengukuran memori. Ini membantu pembaca membedakan batas yang dipilih dari ketiadaan dalam respons yang tidak terjelaskan.
Gunakan label sesuai kontrak nyata. Beberapa istilah q yang dianalisis memerlukan kecocokan dalam satu bidang title atau text, bukan keduanya sekaligus atau kumpulan kecocokan parsial lintas bidang. kind=comment membatasi jenis rekaman, bukan menjanjikan utas komentar lengkap. min_score=10 menerapkan ambang skor tersimpan, bukan penilaian bahwa sisanya berwibawa atau berguna. Tampilkan filter yang tidak dipakai secara berbeda dari pembatas aktif. Nilai bawaan yang mempersempit kueri diam-diam tetap keputusan yang perlu dipahami pembaca.
Tampilkan batasan yang bisa dihapus
Izinkan pembaca menghapus satu kondisi tanpa menyusun ulang permintaan. Tindakan berlabel jelas “Hapus skor minimum” dapat membiarkan kueri, komunitas, dan filter lain tetap. Tampilkan perubahan parameter sebelum dikirim, lalu mulai urutannya pada halaman 1. Ini mendukung perbandingan dua permintaan yang dinyatakan jelas. Tidak ada jaminan bertambahnya rekaman atau kepastian berapa yang dikecualikan: respons terbatas, total bisa berupa batas bawah, dan pengambilan ulang tidak dijanjikan sebagai cuplikan stabil.
Jangan lekatkan cerita kualitas pada kontrol itu. Menghapus min_score bukan mengundang spam; menambahkannya bukan memilih bukti pakar. Tanyakan kontribusi ambang tersebut bagi penelitian ini. Jika hanya menyembunyikan sudut pandang asing tanpa membantu pertanyaan, tidak menggunakannya mungkin masuk akal. Buat pengiriman eksplisit, bukan mengambil data setiap penyesuaian. Setiap pengambilan berhasil menghabiskan satu kredit, termasuk hasil kosong, sehingga kontrol eksplorasi tidak diam-diam berubah menjadi arus permintaan berbayar.
Pertahankan keadaan URL agar terbaca
URL yang menyandikan filter aktif menjadi catatan asumsi pencarian yang bisa disimpan. Contohnya https://api.redditsearchapi.com/v1/search?q=quantization&subreddit=LocalLLaMA&limit=3&page=1. Aplikasi dapat menampilkan ringkasan parameter setara dan menyimpannya dalam catatan. Enkode nilai parameter dengan benar ketika menyusun URL, sambil menampilkan label yang mudah dibaca. Permintaan tersimpan dapat mengulang kondisi yang dipilih; itu tidak menyimpan respons sebelumnya atau menjamin rekaman sama tetap tersedia.
Keluarkan kredensial dari URL dan tangkapan layar bersama. Backend pemanggil menambahkan X-API-Key atau Authorization: Bearer dari penyimpanan rahasianya. Nilai kueri dan anotasi sendiri mungkin sensitif, jadi periksa sebelum dibagikan. Kontrol tanggal harus mengirim from dan to sebagai YYYY-MM-DD UTC; to mencakup seluruh hari UTC tersebut. Mengubah rentang tanggal atau ukuran halaman memulai perbandingan baru, bukan meneruskan nomor halaman yang batas sebelumnya sudah berbeda arti.
Jelaskan cakupan hasilnya
Setelah respons datang, bedakan apa yang ditampilkan dari yang dapat dibuktikan metadatanya. Tampilkan jumlah yang benar-benar dirender dan jelaskan pagination.total dengan pagination.relation. Gunakan “setidaknya” untuk gte, bukan tanda perkiraan; gunakan “total tidak diketahui” untuk unknown atau null. Pagination.has_more mengatur kelanjutan dalam jendela yang didukung, sedangkan pagination.window_exhausted menandai kondisi batas akhirnya. Permintaan mengizinkan paling banyak 100 rekaman dan 100 halaman. Batas atau jumlah respons persis tidak membuktikan cakupan lengkap komunitas maupun topik.
Nyatakan bahwa rekaman memakai urutan arsip _doc, bukan kronologi, relevansi, atau skor. Pengurutan lokal hanya memengaruhi bahan yang sudah dimuat. Jelaskan rekaman datar dan bahwa judul, penulis, tanggal, serta tautan bisa tidak ada. parent_id atau link_id opsional dapat membantu mengelompokkan rekaman lokal yang tersedia, tetapi bukan filter atau bukti percakapan lengkap. Panel yang selesai harus memungkinkan pembaca menyebut batasan dan ketidakpastian, bukan mengira formulir yang tampak presisi sebagai gambaran Reddit yang lengkap atau representatif.
