Biblioteca di lettura
Progettare filtri che rendano esplicite le ipotesi
Fai spiegare i confini a un pannello LocalLLaMA: condizioni visibili, modifiche reversibili, stato della richiesta leggibile e limiti onesti del materiale ricevuto.
Etichettare ogni filtro attivo
Un pannello di filtri descrive il materiale che una richiesta può restituire. Per il quaderno proposto sulla quantizzazione, mostra q=quantization, subreddit=LocalLLaMA, limit=3 e page=1 come decisioni distinte. Il vincolo sulla comunità non assicura che ogni discussione rilevante vi appartenga o che l’archivio le contenga tutte. Metti accanto la domanda, per esempio quali condizioni siano state riportate per una misura della memoria. Aiuta a distinguere un confine scelto da un’assenza inspiegata nella risposta.
Usa etichette aderenti al contratto reale. Più termini q analizzati richiedono una corrispondenza dentro title o text, non entrambi contemporaneamente né un insieme di riscontri parziali distribuiti. kind=comment restringe il tipo di record, senza promettere thread completi. min_score=10 applica una soglia al punteggio memorizzato, non certifica autorevolezza o utilità dei record rimanenti. Distingui visivamente i filtri omessi dalle restrizioni attive. Anche un valore predefinito che restringe tacitamente è una decisione che il lettore deve conoscere.
Mostrare un vincolo rimovibile
Permetti di togliere una condizione senza ricostruire l’intera richiesta. Un comando chiaramente chiamato “Rimuovi punteggio minimo” può lasciare intatti query, comunità e altri filtri. Mostra il parametro risultante prima dell’invio e ricomincia da pagina 1. Questo favorisce il confronto tra due richieste dichiarate. Non garantisce più record né rivela esattamente quanti ne fossero esclusi: le risposte sono limitate, i totali possono essere limiti inferiori e il recupero ripetuto non promette un’istantanea stabile.
Non associare al controllo una narrazione sulla qualità. Togliere min_score non significa invitare spam; aggiungerlo non significa scegliere prove esperte. Chiedi che contributo dà la soglia a quell’indagine. Se nasconde opinioni insolite senza aiutare la domanda, lasciarla disattivata può essere ragionevole. Rendi esplicito l’invio, senza recuperare a ogni modifica. Ogni recupero riuscito costa un credito, anche se vuoto: controlli esplorativi non dovrebbero diventare silenziosamente una sequenza di richieste pagate.
Mantenere leggibile lo stato nell’URL
Un URL che codifica i filtri attivi registra in modo persistente le ipotesi della ricerca. Un esempio è https://api.redditsearchapi.com/v1/search?q=quantization&subreddit=LocalLLaMA&limit=3&page=1. La tua applicazione può mostrarne un riepilogo equivalente e conservarlo nel quaderno. Codifica correttamente i valori quando costruisci gli URL, usando etichette leggibili nell’interfaccia. Una richiesta salvata riproduce le condizioni scelte; non conserva la risposta precedente né garantisce gli stessi record in futuro.
Escludi la credenziale dall’URL e dagli screenshot condivisi. Il backend del chiamante aggiunge X-API-Key o Authorization: Bearer dal proprio archivio segreto. Anche query e annotazioni possono essere sensibili: controllale prima della condivisione. I controlli data devono serializzare from e to come YYYY-MM-DD UTC; to include l’intero giorno UTC. Cambiare intervallo o dimensione della pagina avvia un nuovo confronto, non prosegue un numero di pagina i cui confini precedenti non hanno più lo stesso significato.
Spiegare il perimetro risultante
Dopo l’arrivo della risposta, distingui ciò che è visualizzato da ciò che i metadati attestano. Mostra il conteggio realmente reso e qualifica pagination.total con pagination.relation. Per gte usa “almeno”, non un simbolo di approssimazione; per unknown o null, “totale sconosciuto”. Pagination.has_more governa la continuazione nella finestra supportata, mentre pagination.window_exhausted segnala la condizione di ultima finestra. Sono consentiti al massimo 100 record e 100 pagine. Né un confine né un conteggio esatto della risposta dimostrano copertura completa della comunità o dell’argomento.
Dichiara l’ordine di archivio _doc, non cronologico, per rilevanza o punteggio. Un riordinamento locale riguarda solo materiale già caricato. Spiega che i record sono piatti e che titolo, autore, data e link possono mancare. I riferimenti facoltativi parent_id o link_id aiutano eventualmente a raggruppare record disponibili, ma non sono filtri e non provano una conversazione completa. Il pannello dovrebbe permettere di nominare restrizioni e incertezze, senza confondere un modulo apparentemente preciso con una vista completa o rappresentativa di Reddit.
