Pustaka bacaan
Memperlihatkan perubahan kueri kepada pengguna
Buat pencarian kuantisasi dapat ditelusuri: simpan kondisi awal, ubah satu filter, bandingkan respons terbatas, dan jelaskan hal yang tidak dapat dibuktikan perbedaannya.
Catat kondisi awal
Kondisi awal bukan sekadar kata kunci pertama, melainkan seluruh filter, termasuk komunitas, penulis, rentang tanggal, dan ambang skor. Untuk latihan membaca LocalLLaMA yang diusulkan, mulai dari /v1/search?q=quantization&subreddit=LocalLLaMA&limit=3&page=1 di https://api.redditsearchapi.com. Pertanyaan pembaca mungkin tentang kondisi memori yang dijelaskan eksperimen. Ini usulan permintaan, bukan bukti tersedianya diskusi tertentu. Tulis pertanyaan di atas parameter agar perubahan berikutnya mempunyai tujuan.
Simpan nilai yang dikirim terpisah dari isi formulir saat ini. Catat waktu respons sebagai pengamatan aplikasi, jumlah rekaman yang diterima, dan bidang paginasi sebenarnya. Simpan pagination.total bersama pagination.relation; nilai bertanda gte adalah batas bawah, bukan jumlah persis yang diperkirakan. Menyimpan respons secara lokal dapat mempertahankan bahan yang diperiksa pembaca. Menyimpan URL saja mempertahankan kondisi permintaan, bukan salinan keadaan arsip yang stabil. API tidak membuat catatan perbandingan ini untuk Anda.
Ubah satu kontrol
Misalkan pembaca ingin melihat pengaruh ambang skor. Pertahankan q=quantization, subreddit=LocalLLaMA, limit=3, dan page=1, lalu tambahkan min_score=10. Tampilkan nilai lama dan baru sebelum pengiriman. Ambang ini memfilter skor tersimpan; bukan memilih bukti berkualitas atau meminta urutan skor. Latihan lain bisa mengubah hanya komunitas. Gunakan nilai subreddit tepat yang diinginkan, jangan menganggap awalan r/ sebagai penulisan setara untuk filter yang sama.
Kirim permintaan baru hanya setelah tindakan eksplisit. Mengedit bidang tidak perlu memicu pengambilan berbayar pada setiap ketukan. Jika pertanyaannya memerlukan quantization memory, jelaskan bahwa kedua istilah analisis harus cocok dalam satu bidang title atau text; ini bukan pencarian frasa persis atau semantik. Pertahankan tanggal sebagai YYYY-MM-DD UTC dengan seluruh hari to disertakan. Mulai kondisi baru pada halaman 1. Kueri berubah adalah urutan baru, bukan halaman 2 dari kueri lama.
Tampilkan kartu kueri sebelum dan sesudah
Letakkan dua permintaan yang dikirim di samping hasil masing-masing. Tandai parameter yang berubah dengan teks, bukan warna saja, dan tampilkan kapan setiap permintaan dibuat. Kartu ringkas dapat memuat pertanyaan, filter terkirim, status respons, jumlah rekaman ditampilkan, serta total beserta keterangannya. Jika salah satu gagal, tandai area hasilnya sebagai gagal; jangan membandingkan respons lama yang berhasil di bawah label filter baru. Kaitkan setiap respons yang datang dengan permintaannya agar jawaban terlambat tidak diam-diam mengganti kartu yang salah.
Tampilkan teks sumber yang tersedia di bawah setiap kartu tanpa menyebut rekaman pertama sebagai hasil terbaik. Judul, penulis, tanggal, dan tautan sumber yang berguna dapat tidak tersedia. Tandai kekosongan tersebut, jangan membuat pengganti. Pembaca bisa menambahkan pengamatan seperti “pengaturan masih belum tersedia”, terpisah jelas dari teks sumber. Jika aplikasi menyimpan kedua respons, itu penyimpanan milik pemanggil dengan pilihan retensinya sendiri. Ringkasan parameter yang dibagikan harus menghilangkan kredensial dan memberi peringatan bila kueri atau catatan mengandung informasi sensitif.
Nyatakan batas penafsirannya
Mengubah satu masukan memudahkan pemeriksaan perbandingan yang dimaksud; tidak membuktikan bahwa setiap perbedaan yang diamati semata-mata disebabkan masukan itu. Permintaan terpisah tidak dijamin sebagai salinan keadaan yang stabil. Kedua respons terbatas, dan total gte tidak mendukung pengurangan persis atas populasi kecocokan. Pengambilan mengikuti _doc, bukan tanggal, relevansi, atau skor. Kartu tersebut mendokumentasikan dua permintaan dan bahan yang dikembalikannya, bukan pengukuran terkendali atas kualitas, popularitas, atau prevalensi masalah teknis.
Setiap pengambilan berhasil menghabiskan satu kredit, termasuk hasil kosong. Halaman selanjutnya adalah permintaan lain, dengan paling banyak 100 rekaman dan nomor halaman hingga 100; habisnya jendela itu tidak membuktikan cakupan lengkap. Rekaman datar dan rujukan induk opsional tidak menjamin percakapan lengkap. Akhiri perbandingan dengan keputusan berikutnya: simpan rujukan berguna, teliti pengaturan yang hilang, ubah satu kondisi lagi, atau berhenti. API historis independen ini menyediakan bahan untuk keputusan tersebut, bukan tampilan Reddit langsung atau jawaban terverifikasi.
