읽기 라이브러리
전제가 드러나는 필터 패널 설계하기
LocalLLaMA 필터 패널이 경계를 설명하게 하세요. 적용 조건, 되돌릴 수 있는 변경, 읽기 쉬운 요청 상태와 자료의 한계를 드러냅니다.
적용 중인 필터를 모두 표시하세요
필터 패널은 요청이 반환할 수 있는 자료를 설명합니다. 양자화 노트 예시에서는 q=quantization, subreddit=LocalLLaMA, limit=3, page=1을 별도 선택으로 나타내세요. 커뮤니티 제한은 관련 토론이 모두 거기 있다거나 그곳의 모든 토론을 아카이브가 갖고 있다는 보장이 아닙니다. “메모리 측정에서 어떤 조건이 보고되었는가?” 같은 읽기 질문을 가까이 두면, 독자가 선택된 범위와 이유를 알 수 없는 부재를 구별할 수 있습니다.
실제 계약에 맞는 라벨을 쓰세요. 여러 분석 q 단어는 일치하는 한 title 또는 text 안에 있어야 하며 두 필드 동시 일치나 부분 일치의 합산이 아닙니다. kind=comment는 레코드 종류만 좁히고 완전한 댓글 스레드를 약속하지 않습니다. min_score=10은 저장 점수의 기준일 뿐 남은 자료가 권위 있거나 유용하다는 평가가 아닙니다. 생략한 필터와 적용한 제한을 구별해 보이세요. 검색을 몰래 좁히는 기본값도 독자가 알아야 할 결정입니다.
제거할 수 있는 조건을 보여 주세요
전체 요청을 다시 만들지 않고 조건 하나를 없앨 수 있게 하세요. “최소 점수 제거”라는 명확한 동작은 쿼리, 커뮤니티, 나머지 필터를 유지할 수 있습니다. 제출 전에 바뀐 매개변수를 보이고 새 결과 순서는 1페이지에서 시작합니다. 이는 명시된 두 요청의 비교를 돕습니다. 레코드가 늘거나 제외 개수가 정확히 드러난다는 보장은 아닙니다. 두 응답은 제한적이고 전체 수는 하한일 수 있으며 재조회는 안정된 스냅샷을 약속하지 않습니다.
그 조작에 품질의 의미를 부여하지 마세요. min_score를 빼는 것이 스팸을 받아들이는 것도, 더하는 것이 전문가 증거를 고르는 것도 아닙니다. 그 기준이 이번 조사에 무엇을 기여하는지 물어보세요. 질문에 도움 없이 낯선 관점만 숨긴다면 쓰지 않는 것도 합리적입니다. 조정마다 자동 조회하지 말고 제출을 명시적으로 만드세요. 빈 결과도 성공하면 1크레딧이므로 탐색 조작이 조용히 유료 요청을 연속 발생시키지 않아야 합니다.
URL 상태를 이해하기 쉽게 유지하세요
적용 필터를 인코딩한 URL은 검색에서 선택한 전제를 남기는 기록입니다. 예시는 https://api.redditsearchapi.com/v1/search?q=quantization&subreddit=LocalLLaMA&limit=3&page=1 입니다. 앱은 같은 조건 요약을 보여 주고 노트에 보관할 수 있습니다. URL을 만들 때 값은 올바로 인코딩하되 화면에는 읽기 쉬운 라벨을 쓰세요. 저장한 요청은 선택한 조건을 재현할 뿐 이전 응답을 보존하거나 나중에 같은 레코드가 나온다고 보장하지 않습니다.
인증 정보는 URL과 공유 이미지에 넣지 마세요. 호출자의 백엔드가 비밀 저장소에서 X-API-Key 또는 Authorization: Bearer를 붙입니다. 쿼리 값과 주석 자체도 민감할 수 있으니 공유 전 검토하세요. 날짜 입력은 from과 to를 YYYY-MM-DD UTC로 보내고 to의 UTC 하루 전체를 포함해야 합니다. 날짜 범위나 페이지 크기를 바꾸는 것은 새 비교의 시작입니다. 경계 의미가 달라진 이전 페이지 번호를 이어 가는 일이 아닙니다.
반환 범위를 설명하세요
응답이 오면 표시한 내용과 메타데이터가 입증하는 내용을 구분합니다. 실제 렌더링 수를 나타내고 pagination.total에 pagination.relation을 붙이세요. gte에는 근사 기호 대신 “최소”를, unknown이나 null에는 “전체 수 미상”을 씁니다. Pagination.has_more는 지원 범위 안의 진행을, pagination.window_exhausted는 마지막 경계 상태를 나타냅니다. 최대 100개, 100페이지입니다. 경계에 닿거나 응답 개수가 정확하다고 커뮤니티나 주제를 완전히 수집한 것은 아닙니다.
레코드는 _doc 아카이브 순서이며 시간, 관련도, 점수순이 아니라고 밝히세요. 로컬 재정렬은 이미 받은 자료에만 적용됩니다. 평면 레코드이며 제목, 작성자, 날짜, 출처 링크가 없을 수 있음을 설명합니다. 선택적 parent_id나 link_id는 가진 자료를 묶는 데 도움을 주지만 필터나 전체 대화의 증거는 아닙니다. 패널은 독자가 제한과 불확실성을 말할 수 있게 해야 합니다. 정밀해 보이는 폼을 Reddit 전체 또는 대표적 모습으로 오해하게 하면 안 됩니다.
