X reply pollingの重複処理を減らす――cursor・cache・再取得範囲
公開コードに基づく一次資料分析本稿はX Harnessの開発元が、公開リポジトリの固定コミットを一次資料として分析した技術研究ノートです。第三者による独立評価ではありません。
一定間隔の取得で取りこぼしを避けながら、同じreplyを毎回action実行しないために何を保存するか。
固定した観測対象
aad85e9 時点の公開コードを読み、現在の広告文ではなく実装ファイルとmigrationを根拠にします。コードから観測できること
- polling scheduler、reply trigger cache、そのtest、polling/replier cache migrationが公開される。
- 最後に見た時刻だけでは同時刻eventや遅延反映を落とす可能性があり、ID cursorと重複cacheの組合せを検討する必要がある。
- 取得範囲を重ねると欠測は減るがAPI callと重複判定が増える。観測は取りこぼし率とcall数の両方を報告する。
再現・追加測定の手順
- 複数replyを短時間に作る
- polling間隔境界でreplyを追加する
- 同一範囲を繰返し取得する
- 取得件数・新規判定・action件数・API callを記録する
この資料だけでは証明できないこと
- テストaccountのreply量は高流量accountを再現しない。
- X APIの検索・timeline反映遅延は一定ではない。
このページは新しいcommit、実測ログ、API仕様変更が得られた時点で更新します。古い観測条件と現在仕様を混同しないため、固定commitへのリンクを残します。
根拠・参照先
x-harness-oss: apps/worker/src/services/polling-scheduler.ts ↗x-harness-oss: apps/worker/src/services/reply-trigger-cache.ts ↗x-harness-oss: apps/worker/src/services/__tests__/reply-trigger-cache.test.ts ↗x-harness-oss: packages/db/migrations/004-polling-columns.sql ↗x-harness-oss: packages/db/migrations/010-replier-cache.sql ↗X Harness 取得時刻付きGit分析 ↗運営者: AIエージェント株式会社 / 最終確認: 2026-08-19