Biblioteca di lettura
Creare una scheda di cronologia senza salvare segreti
Conserva una cronologia utile della ricerca sulla quantizzazione separando credenziali, condizioni inviate, osservazioni sulle risposte e note interpretative del lettore.
Elencare gli input pubblici ripetibili
La scheda di cronologia dovrebbe rispecchiare esattamente il contratto dei filtri dell’API. Per il quaderno LocalLLaMA proposto, registra q, subreddit, author, kind, from, to, min_score, limit e page quando usati. Un esempio compatto è q=quantization, subreddit=LocalLLaMA, limit=3, page=1. Conserva le date come valori YYYY-MM-DD UTC effettivamente inviati. Queste voci spiegano le condizioni; non provano che sia stata restituita una particolare discussione e ripeterle non garantisce la stessa risposta in futuro.
Considera gli input pubblici come campi senza credenziali, non come informazioni automaticamente innocue. Una query può contenere un progetto privato e una nota identificare qualcuno senza intenzione di divulgarlo. Decidi cosa conservare o esportare invece di copiare l’intero oggetto della richiesta. Escludi gli header di autenticazione dalla cronologia. Se salvi localmente una risposta, distinguila dalla richiesta e registra quando è stata ottenuta; altrimenti il collegamento per ripetere la query potrebbe sembrare una copia archiviata del risultato originale.
Separare la conservazione dei segreti
Il backend del chiamante deve accedere alla chiave API salvata per inviare X-API-Key o Authorization: Bearer. Un hash unidirezionale da solo non fornisce questa credenziale in uscita. Tieni la chiave utilizzabile in un archivio segreto adatto sul backend, fuori da bundle del browser, query string, esportazioni della cronologia e log diagnostici. Il servizio memorizza invece hash e prefisso della chiave per autenticare: è un ruolo differente. Le chiavi complete appaiono una volta alla registrazione o rigenerazione, che invalida immediatamente quella precedente. La cronologia non deve diventare un backup involontario della chiave.
Distingui tre rapporti: account del lettore nell’applicazione, sessione del gestore presso il servizio e chiave API usata per il recupero. Chiavi e saldi sono specifici del tenant; cambiare host non rende valida la chiave di un altro tenant. Escludere credenziali riduce un canale di esposizione, ma non protegge query e note da ogni problema del browser o dei controlli d’accesso. Rivedi le scelte di conservazione e condivisione dell’applicazione. Non presentare questa scheda proposta come confine di sicurezza testato o funzione di cronologia fornita dall’API.
Salvare le note interpretative
Tieni separate osservazioni e conclusioni. Una scheda potrebbe annotare che sono stati visualizzati tre record, uno senza corpo utilizzabile, e che restano da chiarire le condizioni di memoria dell’esperimento. È un’annotazione illustrativa, non un risultato osservato. Se conservi pagination.total, conserva anche pagination.relation e gli indicatori di continuazione e finestra necessari a spiegare la risposta. Un limite inferiore non è un conteggio esatto. Nessuno di questi campi misura la rilevanza di un record o quanto sia comune il problema.
Lascia una breve spiegazione del perché un riferimento viene conservato. Identificala come nota del lettore, mantieni l’identità disponibile della fonte e non mescolarla al testo originale citato. I campi facoltativi possono mancare e i riferimenti al genitore non ricostruiscono la discussione completa. Riaprire una risposta salvata può non chiamare l’API; aggiornarla esplicitamente è un nuovo recupero. Ogni aggiornamento riuscito costa un credito, anche vuoto. Conserva un aggiornamento fallito o incerto come esito distinto, senza sovrascrivere l’osservazione precedente con una scheda bianca senza spiegazione.
Rivedere i limiti di conservazione
Definisci cancellazione, esportazione e scadenza per questa applicazione prima di offrire una cronologia persistente. Rimuovere una scheda locale elimina i dati che la tua implementazione decide di conservare; non elimina un record dell’archivio, non chiude l’account di servizio e non modifica i suoi dati di pagamento. Pulizia del browser, perdita del dispositivo o restrizioni di memorizzazione possono eliminare la cronologia locale. Se offri sincronizzazione o backup, descrivili e testali come funzioni separate dell’applicazione: non sono endpoint dell’archivio, e l’articolo non dimostra che siano implementati.
Qui il servizio non specifica un periodo fisso di conservazione dei dati dell’account, e questo non promette accesso permanente ai contenuti archiviati. Una query salvata può rimanere comprensibile anche quando la fonte scompare, purché la scheda distingua vecchia osservazione e nuovo recupero. Esamina gli export per segreti e note sensibili, poi lascia decidere al lettore cosa tenere. Il risultato utile è una traccia verificabile della decisione di ricerca, non la garanzia che dati, interpretazione e link rimangano validi per sempre.
