読解ライブラリー
検索の前提が伝わるフィルターパネルを作る
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は最終境界を示します。上限は1回100件、100ページです。境界到達も応答件数の正確さも、コミュニティや題材の完全な収録を証明しません。
順序はアーカイブの_docであり、時間、関連度、スコア順ではないと説明します。ローカルな並べ替えが変えるのは取得済みの材料だけです。レコードが平坦で、タイトル、投稿者、日付、リンクがない場合もあると示します。任意のparent_idやlink_idは手元のグループ化には使えても、検索フィルターや会話の完全性の証明にはなりません。精密そうなフォームを完全または代表的なReddit像と誤解させず、制限と不確実性を読者が説明できるパネルにします。
