oneshot-zap

X に流れてくる露骨なスパムを処理するには、… → ポストを報告 → スパム → 次へ → ブロック → 完了 という多段のダイアログを毎回手で踏む必要がある。1 件なら大したことはないが、まとめて湧くスパムを相手にすると、この繰り返しがそのまま負担になる。

世にある「ワンクリックブロック」系の拡張は ブロックだけ で止まり、報告まではしてくれない。報告はプラットフォーム側の対処につながる一手なのに、面倒さゆえに省略されがち。報告も込みで一発で終わらせる道具が見当たらなかったので、自分で作った。

API ではなく 実際の報告フローを DOM 操作でなぞる 方針にした。コンテントスクリプトで各ポストのアクションバー右端に⚡ボタンを注入し、押されたら … → ポストを報告 → スパム → 次へ → ブロック → 完了 のダイアログを順に自動クリックして最後まで進める。結果はトーストで返す。公式 UI を借りることで、非公開 API に依存せず "人間がやる操作" の自動化に徹している。

この手の自動化の弱点は、X 側の DOM 変更でセレクタが壊れる こと。フロー定義を src/flow.ts に各ステップ（caret / report / 「スパム」/ Next /「さんをブロック」/ 完了）として一箇所に集約し、壊れたらそこだけ直せる形にした。タイミング依存も避けられないため、要素の出現を待つ前提でステップを組んでいる。

取り返しのつかない操作なので、安全側に倒した。初期状態では実行前に 確認モーダル を出し、オプションページから ON/OFF を切り替えられる（OFF で 1 クリック即実行）。日本語 UI 前提で文言セレクタを組むため、表示言語が日本語のときのみ動作する明示的な制約も置いた。「本物のスパムにのみ使う」前提を README とモーダルの両方で念押ししている。

ロジックは DOM から切り離してテストした。フロー進行を純粋な手続きとして書き、Vitest + happy-dom で各ステップのセレクタ解決と分岐を単体検証。ビルドは esbuild でバンドルし、pnpm dist が icons 生成 → typecheck → build を通して拡張ルートとなる dist/ を吐く流れにしている。

c12o-dev/oneshot-zap として MIT で公開。pnpm dist でビルドした dist/ を「パッケージ化されていない拡張機能」として読み込めば動く。報告 → ブロックの多段ダイアログが⚡ひとつに畳まれ、スパム処理の手数が体感で大きく減った。

"取り消せない自動操作" という性質に正面から向き合い、デフォルトで確認モーダルを挟む / 日本語 UI に限定する / 本物のスパム限定を明記する、という安全側の設計を一通り入れている。便利さと不可逆性のトレードオフを、UI とドキュメントの両方で扱った題材になった。