Pustaka bacaan
Membuat kartu riwayat pencarian tanpa menyimpan rahasia
Simpan riwayat kueri kuantisasi yang berguna sambil memisahkan kredensial, kondisi terkirim, pengamatan respons, dan catatan penafsiran pembaca.
Daftar masukan publik yang dapat diulang
Struktur kartu riwayat sebaiknya persis mencerminkan kontrak filter API. Dalam catatan LocalLLaMA yang diusulkan, rekam q, subreddit, author, kind, from, to, min_score, limit, dan page jika parameter itu digunakan. Contoh singkat ialah q=quantization, subreddit=LocalLLaMA, limit=3, page=1. Simpan tanggal sebagai nilai YYYY-MM-DD UTC yang benar-benar dikirim. Entri ini menjelaskan kondisi permintaan, bukan membuktikan adanya diskusi tertentu dalam respons, dan mengulangnya tidak menjamin respons yang sama nanti.
Perlakukan masukan publik sebagai bidang tanpa kredensial, bukan informasi yang otomatis aman. Kueri bisa memuat nama proyek rahasia dan catatan bisa mengidentifikasi orang yang tidak dimaksudkan untuk dibagikan. Tentukan apa yang boleh disimpan atau diekspor, jangan menyalin seluruh objek permintaan. Jauhkan header autentikasi dari riwayat. Jika aplikasi menyimpan respons lokal, identifikasi terpisah dari permintaannya dan catat waktu pengambilan. Tanpanya, tautan pengulangan kueri bisa disangka salinan arsip hasil asli.
Pisahkan penyimpanan rahasia
Backend pemanggil perlu mengakses kunci API tersimpannya untuk mengirim X-API-Key atau Authorization: Bearer. Hash satu arah saja tidak dapat menyediakan kredensial keluar itu. Simpan kunci yang bisa dipakai dalam penyimpanan rahasia backend yang sesuai, bukan berkas peramban, string kueri, ekspor riwayat, atau log diagnostik. Layanan sendiri menyimpan hash serta prefiks kunci untuk autentikasi; fungsinya berbeda. Kunci lengkap tampil sekali saat pendaftaran atau regenerasi, dan regenerasi langsung membatalkan kunci lama. Riwayat tidak boleh menjadi cadangan kunci tanpa sengaja.
Pisahkan tiga hubungan: akun pembaca dalam aplikasi, sesi pengelola pada layanan, dan kunci API layanan untuk pengambilan. Kunci serta saldo bersifat khusus tenant; mengganti host tidak membuat kunci tenant lain sah. Mengeluarkan kredensial dari riwayat mengurangi satu jalur kebocoran, tetapi tidak mengamankan kueri atau catatan dari seluruh masalah peramban dan kendali akses. Tinjau pilihan penyimpanan dan berbagi aplikasi. Jangan iklankan kartu usulan ini sebagai batas keamanan teruji atau fitur riwayat bawaan API arsip.
Simpan catatan penafsiran
Pisahkan pengamatan dari kesimpulan. Kartu dapat menyebut bahwa permintaan menampilkan tiga rekaman, satu tanpa teks isi yang berguna, dan pembaca masih memerlukan kondisi memori eksperimen. Ini contoh anotasi, bukan hasil arsip yang diamati. Jika menyimpan pagination.total, simpan pula pagination.relation serta indikator kelanjutan dan jendela yang diperlukan untuk menjelaskan respons. Batas bawah bukan hitungan persis. Tidak satu pun bidang itu mengukur relevansi rekaman atau seberapa umum masalah tersebut.
Biarkan pembaca memberi penjelasan singkat mengapa rujukan disimpan. Labeli sebagai catatan mereka, pertahankan identitas sumber yang tersedia, dan jangan gabungkan dengan kutipan sumber. Bidang opsional dapat tidak ada, dan referensi induk tidak menyediakan diskusi lengkap. Membuka respons tersimpan tidak harus memanggil API, sedangkan penyegaran eksplisit adalah pengambilan baru. Penyegaran berhasil tetap memakai satu kredit walau kosong. Simpan penyegaran yang gagal atau tidak pasti sebagai hasil tersendiri, bukan menimpa pengamatan lama dengan kartu kosong tanpa keterangan.
Tinjau batas penyimpanan
Tentukan perilaku penghapusan, ekspor, dan kedaluwarsa aplikasi sebelum menawarkan kartu sebagai riwayat persisten. Menghapus kartu lokal hanya menghapus data yang dipilih implementasi Anda untuk disimpan; itu tidak menghapus rekaman arsip, menutup akun layanan, atau mengubah catatan pembayarannya. Pembersihan peramban, kehilangan perangkat, dan pembatasan penyimpanan dapat menghilangkan riwayat lokal. Bila menawarkan sinkronisasi atau cadangan, jelaskan serta uji sebagai fitur aplikasi terpisah. Keduanya bukan endpoint arsip dan artikel ini tidak membuktikan implementasinya.
Layanan tidak menentukan masa retensi tetap bagi data akun di sini; pernyataan itu tidak menjanjikan akses permanen ke isi arsip. Kueri yang disimpan tetap bisa dipahami ketika sumber hilang, asalkan kartu membedakan pengamatan lama dari pengambilan baru. Tinjau ekspor untuk rahasia dan catatan sensitif, lalu biarkan pembaca memutuskan apa yang dipertahankan. Produk yang berguna adalah rekaman keputusan pencarian yang dapat ditelusuri, bukan jaminan bahwa data, penafsiran, atau tautan sumber berlaku selamanya.
