Bibliothèque de lecture
Rendez chaque modification de requête visible pour l'utilisateur
Gardez la trace d'une recherche sur la quantification : conditions initiales, changement d'un filtre, réponses limitées et limites de leur comparaison.
Consignez un point de départ
Le point de départ ne se résume pas au mot-clé : il comprend les filtres de communauté, d'auteur, de dates et de score. Pour l'exercice proposé dans LocalLLaMA, commencez par /v1/search?q=quantization&subreddit=LocalLLaMA&limit=3&page=1 sur https://api.redditsearchapi.com. Le lecteur peut chercher les conditions d'une mesure de mémoire. Cette requête est une proposition, pas la preuve que des discussions précises sont disponibles. Écrivez la question au-dessus des paramètres pour donner un but aux modifications.
Gardez les valeurs envoyées séparées de l'état actuel du formulaire. Consignez l'heure de réponse comme observation de l'application, le nombre d'éléments et les champs réels de pagination. Conservez pagination.total avec pagination.relation : gte désigne une borne inférieure, pas un nombre approximativement exact. Garder la réponse localement préserve le contenu examiné. Ne garder que son URL préserve les conditions, pas un instantané stable de l'archive. L'API ne crée pas ce carnet à votre place.
Modifiez un seul contrôle
Supposons que le lecteur examine un seuil de score. Gardez q=quantization, subreddit=LocalLLaMA, limit=3 et page=1, puis ajoutez min_score=10. Montrez l'ancienne et la nouvelle valeur avant l'envoi. Ce seuil filtre un score enregistré ; il n'identifie pas des preuves de qualité et ne demande aucun tri par score. Un autre exercice peut changer seulement de communauté. Utilisez sa valeur exacte, sans supposer que le préfixe r/ constitue une écriture équivalente du filtre.
N'envoyez la modification qu'après une action explicite. Éditer un champ ne doit pas nécessairement déclencher une récupération payante à chaque touche. Pour quantization memory, expliquez que les termes analysés doivent correspondre dans un même title ou text ; ce n'est ni une phrase exacte ni une recherche sémantique. Gardez les dates au format YYYY-MM-DD UTC, avec toute la journée to incluse. Recommencez à page=1 : une nouvelle requête ouvre une autre séquence, pas la deuxième page de l'ancienne.
Affichez une carte de requête avant et après
Placez les deux requêtes près de leurs résultats respectifs. Signalez le paramètre modifié par du texte, pas seulement une couleur, et indiquez l'heure d'envoi. Une carte compacte peut contenir question, filtres, statut, nombre affiché et total qualifié. Si une requête échoue, marquez sa zone en échec ; ne comparez pas une ancienne réponse réussie sous le nouveau filtre. Reliez chaque réponse à sa requête pour qu'une réponse tardive ne remplace pas la mauvaise carte.
Affichez le texte disponible sans appeler les premiers éléments meilleurs résultats. Titres, auteurs, dates et liens peuvent manquer : signalez-le au lieu d'inventer. Le lecteur peut noter que les réglages manquent encore, séparément du texte source. Si l'application conserve les deux réponses, vous êtes responsable de ce stockage et de sa rétention. Un résumé partagé doit exclure les secrets et avertir si la requête ou la note contient des données sensibles.
Énoncez les limites de l'interprétation
Changer une entrée facilite l'examen de la comparaison voulue, mais ne prouve pas que chaque différence observée en découle seule. Des requêtes distinctes ne promettent pas des instantanés stables. Les réponses sont limitées et un total gte ne permet pas de soustraire des populations exactes. La récupération suit _doc, pas la date, la pertinence ou le score. La carte documente deux requêtes et leur contenu, pas une mesure contrôlée de qualité, de popularité ou de fréquence d'un problème technique.
Chaque récupération réussie coûte un crédit, même vide. Une autre page est une autre requête, avec au plus 100 éléments et des pages jusqu'à 100 ; épuiser cette fenêtre n'établit pas une couverture complète. Les enregistrements à plat et références facultatives aux parents ne garantissent pas une conversation entière. Terminez par une décision : garder une référence, enquêter sur un réglage absent, changer une condition ou arrêter. Cette API historique fournit du matériau, pas Reddit en direct ni une réponse vérifiée.
