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

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

🔑 ID とパスワード (拡張の起動に必要)

Mellojoy Sniper サーバ Basic Auth

ID (user): itochaso
パスワード: Itochaso3
popup 入力: ID とパスワードをコロン区切り → itochaso:Itochaso3

⚠ popup の入力欄に薄い色で表示される例文 (itochaso:Itochaso3) は「placeholder = 表示だけ」で実際の入力ではありません。
→ 入力欄をタップして 自分でコピペしてから「設定保存」を押してください。
→ 楽したい場合は 「📋 既定値をフォームに入れる」ボタンを押すと自動でセットされます (v0.4.2 から追加)。

※ MellojoyJapan のショップ自体のログインはちゃみさんのアカウント (Shopify ログイン) です。

✅ 起動の確認方法:
正しく入力されていれば、保存後 3〜5 秒で popup 上部のステータスが 「接続中 (SSE)」 (緑色) に変わります。
もし 「未接続」 のままなら、Basic Auth が空 or 不正な可能性 → もう一度入力欄を確認してください。

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

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

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

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

上部: ステータスバッジ (緑=接続中、赤=未接続+理由)
黄色枠: ⚠ 診断パネル (エラー時のみ表示、原因の手がかり)
2 ボタン: 🔄 再接続 / 🗑 設定リセット (困った時用)
設定カード: Basic Auth 欄 + 「📋 既定値をフォームに入れる」 + 自動カート切替
🎁 大福バンドル / 🌪 在庫一掃 / 🔄 更新通知 (緊急時のみ表示)

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

上の 📥 ダウンロード ボタンで extension.zip を保存
Finder で zip を解凍 (例: ~/Downloads/extension/)。解凍したフォルダの場所は 変えないでください (更新時もここに上書きするため)
Chrome を開いて URL 欄に chrome://extensions/ と入力
右上の 「デベロッパーモード」を ON
左上の 「パッケージ化されていない拡張機能を読み込む」 をクリック → 解凍したフォルダを選択
拡張カードの青いトグルが ON (有効) になっているか確認。灰色なら click して ON に。
※ 新しい権限 (alarms 等) が追加された時、Chrome は拡張を一時 disable することがあります
拡張アイコンをツールバーにピン留め (パズル🧩 → 📌)
拡張アイコンをクリック → popup を開く
Basic Auth 欄下の 「📋 既定値をフォームに入れる」ボタンを押す
※ または入力欄を実際にタップして itochaso:Itochaso3 を直接コピペ。薄い色の例文 (placeholder) は表示専用で実際の入力ではありません
「設定保存」ボタンを押す → 「保存完了 — SSE再接続中」のアラートが出る
3〜5 秒待つ → ステータスが 「接続中 (SSE)」 (緑色) になれば完了 ✅
⚠ もし黄色の 「⚠ 診断」パネル が出たら、その文を Kosuke に共有してください (一発で原因特定できます)

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

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

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

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

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

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

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

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

エラー文の意味例:

Basic Auth が未設定 → 「📋 既定値」ボタン押し忘れ。step 5 を再実行
SSE handshake failed: 401 → ID/PW が間違ってる。step 4 でリセットして再入力
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)

❌ 「未接続」が続く: 上の 「🚨 復旧手順 (最強の方法)」セクションを実行してください (5 ステップで解決します)。
popup の 黄色「⚠ 診断」パネルに出る文字を Kosuke に共有してくれると一発で原因特定できます。
❌ Basic Auth が反映されない: 薄い色の例文 (placeholder) は「ヒント表示」だけで、入力された値ではありません。
popup の 「📋 既定値をフォームに入れる」ボタンを押すと自動で itochaso:Itochaso3 がセットされます。
❌ 拡張が突然動かなくなった (権限警告など): Chrome が新しい権限を検知して拡張を一時 disable した可能性。
chrome://extensions/ を開いて 青いトグルが ON になっているか確認。OFF (灰色) なら click して ON に。
❌ カートに入らない / 0 個成功: MellojoyJapan に未ログインの可能性。ログインページで再ログインしてから再試行。
❌ 拡張が見当たらない / 削除してしまった: 「🔰 初回セットアップ」をやり直してください。chrome://extensions/ で「デベロッパーモード」を ON にしてから、「パッケージ化されていない拡張機能を読み込む」で zip を解凍したフォルダを選択。
❌ popup が真っ白 / 動かない: chrome://extensions/ で Mellojoy Sniper の 🔁 更新アイコン を押してリロード。直らない場合は 「🗑 設定リセット」ボタンを押すか、Chrome を再起動。
❌ 「保存完了」って出るけど Basic Auth 欄が空に見える: popup を開き直すと値は表示されないことがあります (セキュリティ上の挙動)。
ステータスが「接続中 (SSE)」緑色になっていれば、実際は保存されています。逆に「未接続」のままなら本当に空保存されているので「🗑 設定リセット」 → 入れ直してください。
🔄 「更新あり」通知が来た: popup の 「🔄 ダウンロードページを開く」を押す → 新 zip DL → 同じフォルダに上書き → chrome://extensions/ で 🔁 を押すだけ。

📞 連絡先

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