Okuma kitaplığı
Gizli bilgi saklamayan bir arama geçmişi kartı oluşturun
Kimlik bilgilerini, gönderilen koşulları, yanıt gözlemlerini ve okurun yorum notlarını ayırarak yararlı bir nicemleme sorgusu geçmişi tutun.
Yeniden kullanılabilir açık girdileri listeleyin
Geçmiş kartının yapısı API'nin filtre sözleşmesini tam yansıtmalıdır. Önerilen LocalLLaMA defterinde kullanıldıkları zaman gönderilen q, subreddit, author, kind, from, to, min_score, limit ve page değerlerini kaydedin. Kısa örnek: q=quantization, subreddit=LocalLLaMA, limit=3, page=1. Tarihleri gönderildikleri YYYY-MM-DD UTC biçiminde saklayın. Bu kayıtlar isteğin koşullarını açıklar; belirli tartışmanın döndüğünü kanıtlamaz ve tekrarlamak daha sonra aynı yanıtı garanti etmez.
Açık girdileri kimlik bilgisi içermeyen alanlar sayın, otomatik olarak zararsız bilgi saymayın. Sorguda özel proje adı, notta okurun paylaşmak istemediği bir kişinin kimliği bulunabilir. Tüm istek nesnesini kopyalamak yerine neyin saklanacağına veya dışa aktarılacağına karar verin. Kimlik doğrulama başlıklarını geçmişe almayın. Uygulama yanıtı yerel saklıyorsa istekten ayrı tanımlayıp alınma zamanını kaydedin. Aksi hâlde sorguyu yineleyen bağlantı, özgün sonucun arşiv kopyası sanılabilir.
Gizli bilgileri ayrı saklayın
Çağrı yapan arka uç, X-API-Key veya Authorization: Bearer göndermek için saklanan API anahtarına erişmelidir. Tek yönlü özet tek başına giden kimlik bilgisini sağlayamaz. Kullanılabilir anahtarı tarayıcı paketleri, sorgu dizeleri, geçmiş dışa aktarımları ve tanılama günlükleri dışında, uygun sunucu gizli deposunda tutun. Hizmetin kendisi doğrulama için anahtarın özetini ve önekini saklar; bu ayrı roldür. Tam anahtar kayıt veya yenilemede bir kez gösterilir, yenileme öncekini hemen geçersiz kılar. Geçmiş kaydı kazara anahtar yedeği olmamalıdır.
Üç ilişkiyi ayırın: okurun uygulama hesabı, hizmet operatörünün oturumu ve veri alımı için hizmet API anahtarı. Anahtarlar ve bakiyeler siteye özgüdür; sunucu adını değiştirmek başka sitenin anahtarını geçerli yapmaz. Kimlik bilgilerini geçmişten dışlamak bir sızıntı yolunu azaltır, fakat sorgu ve notları her tarayıcı veya erişim denetimi sorunundan korumaz. Uygulamanızın saklama ve paylaşım seçimlerini inceleyin. Önerilen kartı sınanmış güvenlik sınırı veya arşiv API'sinin sağladığı geçmiş özelliği olarak tanıtmayın.
Yorum notlarını kaydedin
Gözlemi sonuçtan ayırın. Kart, isteğin üç kayıt gösterdiğini, birinde kullanılabilir gövde bulunmadığını ve okurun deneyin bellek koşullarını hâlâ aradığını söyleyebilir. Bu, gözlenmiş arşiv sonucu değil, örnek nottur. pagination.total saklanıyorsa pagination.relation ile yanıtı açıklayacak devam ve pencere işaretlerini de saklayın. Alt sınır kesin sayı değildir. Bu alanların hiçbiri kaydın ilgisini veya sorunun yaygınlığını ölçmez.
Okurlar neden bir referansı tuttuklarını kısaca açıklayabilsin. Metni kendi notları olarak etiketleyin, mevcut kaynak kimliğini koruyun ve alıntıyla karıştırmayın. İsteğe bağlı alanlar eksik olabilir; üst kayıt bağlantıları tam tartışma sağlamaz. Saklanmış yanıtı açmak API çağrısı gerektirmeyebilir, açık yenileme ise yeni veri alımıdır. Boş olsa bile başarılı yenileme bir kredidir. Önceki gözlemin üzerine etiketsiz boş kart yazmak yerine başarısız veya belirsiz yenilemeyi ayrı sonuç olarak koruyun.
Saklama sınırlarını gözden geçirin
Kartı kalıcı geçmiş olarak sunmadan önce uygulamanın silme, dışa aktarma ve süre sonu davranışını tanımlayın. Yerel kartı kaldırmak, uygulamanızın seçtiği veriyi kaldırır; arşiv kaydını silmez, hizmet hesabını kapatmaz veya ödeme kayıtlarını değiştirmez. Tarayıcı temizliği, cihaz kaybı veya depolama kısıtları yerel geçmişi kaldırabilir. Eşitleme ya da yedekleme sunuyorsanız bunları ayrı uygulama özellikleri olarak açıklayıp sınayın. Bunlar arşiv uç noktaları değildir; makale uygulanmış olduklarını ileri sürmez.
Hizmet burada hesap verileri için sabit saklama süresi belirtmez; bu, arşiv içeriğine kalıcı erişim vaat etmez. Kart eski gözlemi yeni veri alımından ayırırsa kaynak erişilemez hâle gelse bile kaydedilmiş sorgu anlaşılır kalabilir. Dışa aktarımları kimlik bilgileri ve hassas notlar açısından inceleyin; neyin tutulacağına okur karar versin. Yararlı ürün, arama kararının izlenebilir kaydıdır; verisinin, yorumunun veya bağlantısının süresiz geçerli kalacağı güvencesi değil.
