Библиотека чтения
Покажите пользователю, что изменилось в запросе
Сделайте поиск о квантовании прослеживаемым: сохраните исходные условия, измените один фильтр, сравните ограниченные ответы и объясните пределы такого сравнения.
Зафиксируйте исходное состояние
Исходное состояние — не просто ключевое слово, а полный набор фильтров: сообщество, ограничения по автору, диапазон дат и порог оценки. Для предлагаемого упражнения по чтению LocalLLaMA начните с /v1/search?q=quantization&subreddit=LocalLLaMA&limit=3&page=1 на https://api.redditsearchapi.com. Читателя может интересовать, при каких условиях измеряли память в эксперименте. Это предлагаемый запрос, а не доказательство доступности конкретных обсуждений. Запишите вопрос над параметрами, чтобы дальнейшие изменения имели цель.
Сохраняйте отправленные значения отдельно от текущего содержимого формы. Отмечайте время ответа как наблюдение приложения, количество возвращённых записей и реальные поля пагинации. Храните pagination.total вместе с pagination.relation: значение с gte — нижняя граница, а не приблизительное точное число. Локально сохранённый ответ позволяет удержать материал, который читатель видел. Один URL сохраняет условия запроса, но не стабильный снимок архива. API не создаёт такой журнал сравнений за вас.
Измените один параметр
Допустим, читатель хочет оценить влияние порога оценки. Оставьте q=quantization, subreddit=LocalLLaMA, limit=3 и page=1 без изменений и добавьте min_score=10. До отправки покажите старое и новое значения. Порог фильтрует сохранённую оценку, а не определяет качественные свидетельства и не запрашивает порядок по оценке. В другом упражнении можно изменить только сообщество. Используйте его точное значение, не предполагая, что префикс r/ — равнозначное написание того же фильтра.
Отправляйте изменённый запрос только после явного действия. Редактирование поля не обязано вызывать платное получение при каждом нажатии клавиши. Если вопрос требует quantization memory, объясните: оба проанализированных термина должны совпасть внутри подходящего title или text; это не поиск точной фразы или по смыслу. Даты сохраняйте в формате YYYY-MM-DD UTC, включая день to целиком. Начните новые условия со страницы 1. Изменённый запрос — новая последовательность, а не страница 2 предыдущей.
Покажите карточку запроса до и после изменения
Расположите два отправленных запроса рядом с соответствующими исходами. Выделите изменённый параметр текстом, а не только цветом, и укажите время каждого запроса. Компактная карточка может содержать вопрос читателя, фильтры, статус ответа, число показанных записей и общее число с оговоркой. Если один запрос не удался, обозначьте эту область как ошибку; не сравнивайте старый успешный ответ под подписью нового фильтра. Связывайте поступающие ответы с их запросами, чтобы запоздавший ответ не заменил другую карточку незаметно.
Покажите доступный текст источника под каждой карточкой, не называя первые записи лучшими результатами. Заголовки, авторы, даты и пригодные ссылки могут отсутствовать. Обозначьте пробелы, а не придумывайте замену. Читатель может добавить пометку вроде «настройки всё ещё не указаны», явно отделённую от исходного текста. Если приложение хранит оба ответа, это ваше хранилище с собственными правилами хранения. Общая сводка параметров должна исключать секреты и предупреждать о чувствительных данных в запросе или заметке.
Обозначьте пределы интерпретации
Изменение одного параметра облегчает проверку задуманного сравнения, но не доказывает, что только оно вызвало каждое наблюдаемое различие. Отдельные запросы не гарантируют стабильные снимки. Оба ответа ограничены, а общее число с gte не позволяет точно вычитать размеры совокупностей совпадений. Получение идёт в архивном порядке _doc, а не по дате, релевантности или оценке. Поэтому карточка документирует два запроса и полученный материал, а не контролируемое измерение качества обсуждений, популярности или распространённости технической проблемы.
Каждое успешное получение стоит один кредит, включая пустой результат. Следующая страница — отдельный запрос с максимумом 100 записей и номером не выше 100; исчерпание окна не устанавливает полный охват. Плоские записи и необязательные ссылки на родителей не гарантируют целый разговор. Завершите сравнение следующим решением читателя: сохранить полезную ссылку, исследовать отсутствующую настройку, снова изменить одно условие или остановиться. Этот независимый исторический API предоставляет материал для решения, а не актуальное представление Reddit или проверенный ответ.
