🎁 ちゃみさん、いつもありがとうございます

Mellojoy Sniper の Chrome 拡張で 代理購入 していただくための説明ページです。 12時の補充に合わせて Chrome 拡張のボタン1つで人気商品をまとめてカートに入れて、ちゃみさんは Shop Pay で決済するだけでOKです。

✅ こうなってれば全部 OK

拡張アイコンを開いて「準備OK」と出ていれば大丈夫

🟢 通常時 (1日中ほぼこれ)

popup に 「準備OK」と緑バッジで表示。これだけ確認できれば 12 時補充に向けて自動で待機している状態です。

⚡ 12 時前後 (11:55〜12:15)

popup が自動で 「⚡ 補充モード」に切替わり、ピンク/オレンジで脈動。検知・投入カウントが 0.5 秒ごとに更新されます。

⚠ 異常 (Kosuke に連絡)

「⚠ サーバー応答なし」が 5 分以上続く場合のみ問題。それ以外 (「🟡 接続中…」「🟢 準備OK」「⚡ 補充モード」) は全部正常です。

💡 拡張アイコンを ピン留めしておくと、popup を開かなくてもバッジで状態がわかります。
💡 12 時前は popup を 開きっぱなしにしておくと、補充の瞬間に検知・カート投入の様子がリアルタイムで見えます。
💡 12 時の決済 (Shop Pay) 以外、ちゃみさんは 何もしなくて OK。すべて自動です。

📚 補足情報

🟢 認証撤廃 (v0.5.0〜): Basic Auth は廃止しました。拡張をインストールしたら何も入力せず自動接続します。
※ MellojoyJapan のショップ側ログインはちゃみさんのアカウントを使用します。

📌 ピン留め必須: Chrome 仕様上、拡張は最初パズル🧩 内に隠れます。パズル🧩 → Mellojoy Sniper の右の📌 で常時表示に。

🌏 マレーシアからアクセス時: Mellojoyjapan.com は マレーシア IP を anti-bot で弾くことがあり (Access Denied)、カート投入失敗。ちゃみさん (日本) は影響なし。Kosuke がマレーシアから検証する時は VPN で日本 IP に切替が必要。

🔁 SSE 切断は正常: Cloudflare Tunnel の制約で SSE は数分で切れます。拡張は 15 秒後に自動再接続。popup の状態が「準備OK」⇄「接続中…」を行き来するのは普通の挙動です。在庫検知は popup 閉じてても動きます。

📥 拡張をインストール / 更新する

📥 最新版の拡張 zip をダウンロード v…

💡 完全自動更新ではありません: 厳密に言うと、Chrome 拡張は 「最新版あり」と通知が来る ところまでは自動。実際の入れ替えは 3 ステップの手作業 が必要です。開発者 (Kosuke) が手元で改修するたびに、popup の上部に 緑枠の「🔄 更新あり」カードが出ます。

📐 popup の構成 (v0.5.4 から):

上部: ステータスバッジ「準備OK」「⚡ 補充モード」「🟡 接続中…」「⚠ サーバー応答なし」
黄色枠: ⚠ 診断パネル (異常時のみ表示)
2 ボタン: 🔄 再接続 / 🗑 設定リセット
設定カード: 認証なし notice + 自動カート設定 (基本いじらない)
🎁 大福バンドル (12 時に手動 click) / 🌪 在庫一掃 / 🔄 更新通知

12 時前後 (11:55-12:15): popup が 脈動アニメに変わり、 0.5 秒ごとに自動更新。検知/投入カウントが 1 秒以下で追えます。

🔰 初回セットアップ (1 度だけ)

上の 📥 ダウンロード ボタンで extension.zip を保存
Finder で zip を解凍 (例: ~/Downloads/extension/)。解凍したフォルダの場所は 変えないでください (更新時もここに上書きするため)
Chrome を開いて URL 欄に chrome://extensions/ と入力
右上の 「デベロッパーモード」を ON
左上の 「パッケージ化されていない拡張機能を読み込む」 をクリック → 解凍したフォルダを選択
拡張カードの青いトグルが ON (有効) になっているか確認。灰色なら click して ON に。
※ 新しい権限 (alarms 等) が追加された時、Chrome は拡張を一時 disable することがあります
拡張アイコンをツールバーに必ずピン留め: ブラウザ右上の パズル🧩 アイコン → ドロップダウンの中に Mellojoy Sniper がある → 右の 📌 (Pin) ボタンを click
※ Chrome 仕様上「最初からピン留め」は強制できません。手動でピン留めしてください
拡張アイコンをクリック → popup を開く
3〜5 秒待つ → ステータスが 「接続中 (SSE)」 (緑色) になれば完了 ✅
※ v0.5.0 から認証撤廃済 → 何も入力不要で自動接続します
⚠ もし黄色の 「⚠ 診断」パネル が出たら、その文を Kosuke に共有してください (一発で原因特定できます)

🔄 更新する (popup に「更新あり」が出たとき)

popup の 緑枠「🔄 更新あり」カードを確認 (現バージョンと最新バージョンが表示されます)
このページに来て 📥 ダウンロード ボタンで 新しい zip を保存
Finder で zip を解凍 → 初回と同じフォルダに上書き (~/Downloads/extension/ など)
Chrome の chrome://extensions/ を開く
Mellojoy Sniper のカードにある 🔁 更新アイコン をクリック
popup を開いて バージョン表示が新しくなっていれば完了

💡 急がなくて大丈夫: 更新を放置しても旧版は引き続き動きます。緊急修正の時だけ Kosuke から連絡しますので、それ以外は気が向いた時に更新でOK。

⚠ v0.4.3 で「Service worker registration failed. Status code: 15」が出た方へ

v0.4.3 の background.js に SyntaxError が含まれていたため、Chrome が Service Worker を登録できずインストール時にエラーが出る不具合がありました。
v0.4.4 で修正済みです。下の 「🧹 壊れた拡張を削除して入れ直す手順」 を実行してください。

🧹 壊れた拡張を削除して入れ直す手順 (v0.4.3 を入れた方)

chrome://extensions/ を開く
赤い「エラー」表示が出ている Mellojoy Sniper の拡張カードで 「削除」ボタンを押す → dialog で「削除」確定
※ 完全削除して OK。chrome.storage の設定も一緒に消えますが、再保存は数秒で可能
上の 📥 ダウンロード ボタンで最新 extension.zip (v0.4.4 以降) を保存
古い解凍フォルダに 上書き解凍 (もしくは古いフォルダを削除して新規解凍)
chrome://extensions/ 右上の 「デベロッパーモード」が ON になっているか確認
左上の 「パッケージ化されていない拡張機能を読み込む」 → 解凍フォルダを選択
赤いエラーが出ずに拡張カードが追加されれば成功 ✅
popup を開いて 「📋 既定値をフォームに入れる」 → 「設定保存」 → 3-5 秒で「接続中 (SSE)」緑色になれば完了

🚨 「未接続」が続く時の復旧手順 (最強の方法)

状況: 「保存完了」と出るのに、ステータスが 「未接続」 のまま緑色にならない。

これは古い壊れた設定が拡張内に残っているか、Chrome が拡張を disable にしている可能性が高いです。下の 5 ステップで強制復旧できます。

新版 zip (v0.4.3 以降) を 📥 ダウンロードボタンで再 DL → 同じフォルダに上書き解凍
chrome://extensions/ を開く → Mellojoy Sniper の 🔁 更新アイコンを click
拡張カードの 青いトグルが ON になっているか確認 (灰色なら ON に)
拡張 popup を開く → 🗑 設定リセットボタンを押す
→ 古い壊れた config / bundle 設定が消える (統計はリセットされます)
3-5 秒待つ → 「接続中 (SSE)」になれば成功 ✅
※ v0.5.0 から認証なしで自動接続するため、何も入力不要

📊 popup の診断パネル: もし黄色枠で 「⚠ 診断: Failed to fetch」のような文字が出たら、それが原因の手がかりです。文章をそのまま Kosuke に共有してください。

エラー文の意味例:

SSE handshake failed: 5xx → sniper サーバ側のエラー (Kosuke に連絡)
Failed to fetch / NetworkError → ちゃみさんの Mac の network 問題か、sniper サーバ停止 (Kosuke に連絡)
SSE handshake failed: 5xx → sniper サーバ側のエラー (Kosuke に連絡)

🎯 バンドル限定モード (既定 ON)

✅ 既定で ON になっています: 拡張をインストールしただけで、popup の「🎯 バンドル登録商品のみカート (他商品は無視)」が 最初から ON です。何も操作しなくて OK。

これにより、12時の補充時に バンドルに登録した商品のみカート投入され、その他の商品 (他のキャラクターやコレクション) は 通知だけ来てカートには入りません。 ちゃみさんの意図しない買い物が発生しない安全モードです。

現在のバンドル登録: 🍓 いちご Z048-8 × 3 + ✨ スフレ Z072-5 × 3 (合計 ¥14,094 / 6 個)
大福が再入荷したら 3 商品 × 各 3 個 = 9 個に増えます。

⚠ もし「全在庫を片っ端から買う」モードに切り替えたい場合: popup の「🎯 バンドル登録商品のみカート」のチェックを 外して「設定保存」を押す。すると 12時に出てきた在庫復活商品が全部自動カートに入ります (旧挙動)。
通常はこの操作は不要です。

🎯 12時の流れ

11:50 までに MellojoyJapan に ログイン状態にしておく (ログインページ)
11:55 ごろ拡張アイコンをクリック → popup を開く
「ステータス: 接続中 (SSE)」が緑色か確認
12:00 補充開始→ 拡張が自動で在庫検知 → 自動カート投入 (個別、単品)
個別カート投入の通知が出始めたら、popup の 「🎁 バンドルをカート投入」ボタンを押す (バンドルで一気に 6 個)
カートタブが自動で開く
「カートに進む」→「Shop Pay で決済」を押す
決済完了画面が出れば終了

📦 今回のバンドルで購入される商品

Chrome 拡張の 「🎁 バンドルをカート投入」 ボタンで、以下の商品を 同時にカートに入れます。

🍓 1. いちごショートケーキ Z048-8

正式名: Mellojoy ムースクリーム
いちごショートケーキスライス
variant: 49695269683440

¥2,299 × 3個 = ¥6,897

商品ページ →

✨ 2. 贅沢スフレ Z072-5 (中サイズ)

正式名: Mellojoy クリーミークリーム
ミディアムサイズメロジョイ贅沢スフレ
variant: 49695270273264

¥2,399 × 3個 = ¥7,197

商品ページ →

🍡

🍡 3. 大福シリーズ A026 — 再入荷待ち

状態: Shopify から削除済
variant: 未確定

大福商品は現在販売停止中です。再入荷したら拡張の popup から variant ID を設定すれば自動的に bundle に追加されます (Kosuke が設定します)。

🧮 合計予算

商品	単価	数量	小計
🍓 いちご Z048-8	¥2,299	3	¥6,897
✨ 贅沢スフレ Z072-5	¥2,399	3	¥7,197
🍡 大福 A026	再入荷待ち
合計 (現状)	—	6個	¥14,094

⚠ 商品が 売り切れていた 場合、その商品は スキップされます (拡張が自動 fallback)
例: いちごだけ売り切れ → スフレ 3 個のみカート投入 (¥7,197)

🆘 困ったとき (Q&A)

❌ 拡張インストール時に「Service worker registration failed. Status code: 15」が出る: v0.4.3 の不具合 (SyntaxError) です。v0.4.4 で修正済み。
上の 「🧹 壊れた拡張を削除して入れ直す手順」 を実行してください (古いを完全削除 → 新 zip で再 install)。
❌ 「未接続」が続く: 上の 「🚨 復旧手順 (最強の方法)」セクションを実行してください (5 ステップで解決します)。
popup の 黄色「⚠ 診断」パネルに出る文字を Kosuke に共有してくれると一発で原因特定できます。
❌ 拡張が突然動かなくなった (権限警告など): Chrome が新しい権限を検知して拡張を一時 disable した可能性。
chrome://extensions/ を開いて 青いトグルが ON になっているか確認。OFF (灰色) なら click して ON に。
❌ カートに入らない / 0 個成功: MellojoyJapan に未ログインの可能性。ログインページで再ログインしてから再試行。
❌ 拡張が見当たらない / 削除してしまった: 「🔰 初回セットアップ」をやり直してください。chrome://extensions/ で「デベロッパーモード」を ON にしてから、「パッケージ化されていない拡張機能を読み込む」で zip を解凍したフォルダを選択。
❌ popup が真っ白 / 動かない: chrome://extensions/ で Mellojoy Sniper の 🔁 更新アイコン を押してリロード。直らない場合は 「🗑 設定リセット」ボタンを押すか、Chrome を再起動。
🔄 「更新あり」通知が来た: popup の 「🔄 ダウンロードページを開く」を押す → 新 zip DL → 同じフォルダに上書き → chrome://extensions/ で 🔁 を押すだけ。

📞 連絡先

トラブルや質問は Kosuke (itochaso) まで。
拡張のロゴ → 統計カードに 「🛒 投入: N」 が増えていれば動作中です。
急ぐ時は LINE か Discord でお願いします。