30 秒看懂
- 傳截圖 → 機器人讀出「券名＋到期日」
- 按 ✅ 正確 → 選這張券是哪個帳號（或手機）
- 自動進 Google 行事曆「優惠券到期」
- 到期前 7 天、3 天收到「截圖＋文字」提醒；用掉了按 ✅ 已經用掉了
開始使用
- 在 LINE 加「券券小幫手」好友：加好友
- 機器人會回一串 6 碼核准代碼（家庭私人機器人，要核准才能用）。
- 主人在 Mac mini 跑
node scripts/admin.mjs allow <6 碼>（repo chuan2024/coupon-line-bot）。
- 核准後就能傳截圖了。家人也可以加好友、一樣核准，全家共用同一份清單和行事曆。
只回一對一私訊。被拉進群組不會說話：帳號和手機不該出現在群組。
傳截圖：4 步驟
蝦皮｜優惠券
免運券 滿 $299
到期 11/30（一） 23:59
▲ 剩 6 天
✅ 正確，下一步📅 改到期日✏️ 改名稱🗑 不要這筆
「免運券 滿 $299」是哪個帳號？
點下面的按鈕，或直接打字。
蝦皮 志權蝦皮 老婆0912-xxx-678➕ 輸入新的
✓ 已加入行事曆
【蝦皮】免運券 滿 $299
帳號 蝦皮 志權
到期 11/30（一） 23:59
示意圖，實際畫面以 LINE 為準
| 步驟 | 你要做的 | 機器人做的 |
|---|
| ① 傳截圖 | 從相簿選（可一次選好幾張）或直接拍 | Claude 看圖，讀出平台、券名、面額、低消、到期日。一張圖有好幾張券會拆成好幾筆，左右滑動逐筆確認 |
| ② 確認 | 對了就按 ✅ 正確；日期錯了按 📅 改到期日；名稱怪怪的按 ✏️ 改名稱；不要的按 🗑 | 看不清楚的會標 ▲ 請核對，沒讀到日期的一定要先選日期 |
| ③ 填帳號 | 點常用帳號，或打字（帳號名稱、手機號碼都可以） | 新打的帳號會記住，下次變成按鈕 |
| ④ 完成 | 不用做事 | 寫進 Google 行事曆，開始倒數提醒 |
其他打字指令
| 打字 | 會回什麼 |
|---|
清單 | 全部還沒用的券，依到期日排序 |
快到期 | 14 天內要到期的 |
新增 蝦皮免運券 11/30 | 沒有截圖時手動加（年份可省略：已經過了的日期會當成明年） |
取消 | 取消「等你打帳號／名稱」的狀態 |
說明 | 這份說明的摘要 |
辨識與查詢都用「回覆」，不扣每月 200 則的推播額度。
什麼時候會收到提醒
- 提醒內容：當初上傳的原始截圖＋文字卡（券名、帳號、低消、到期日）。手機通知那一行就看得到「剩幾天、哪個帳號」。
- 文字卡上有 ✅ 已經用掉了：按了就不再提醒，行事曆標題加 ✅、變灰色。
- 加進來時已經不到 7 天的，不會再推 D-7（回覆裡已經講過）；但 D-3 的最後提醒照推。
- 某天沒推成功（例如額度不夠），隔天早上會補推，不會漏。
- 截圖超過 1MB 時 LINE 不收圖片訊息，改成文字卡附「看截圖」連結。
- Google 行事曆本身也設了 7 天、3 天前的通知當備援（LINE 掛了也提醒得到）。
狀態標記全站一致：● 3 天內 ▲ 7 天內 ○ 還早 ✓ 已使用 ✕ 已過期（形狀不同，色弱也分得出）。
我的券（清單頁）
LINE 裡點選單「我的清單」或任何卡片上的「看全部的券」直接開，用 LINE 身分登入，不用另外輸入帳密。
- 還沒用／全部兩個分頁；上方搜尋可以找名稱、平台、帳號。
- 點一張券：看當初上傳的截圖（點圖可放大）、所屬帳號、面額、低消、到期時間。
- 下面的大按鈕：✅ 我用掉了／改回「還沒用」，行事曆會一起更新。
開示範版 ↗ （假資料，看版面用）
Google 行事曆
- 寫在 u457869@gmail.com 底下另建的「優惠券到期」行事曆（橘色），不會弄亂主行事曆，可以單獨隱藏或分享給家人。
- 每張券一個全天事件：標題「【蝦皮】免運券 滿 $299 到期 23:59」，說明欄有類型、所屬帳號、面額、低消、看截圖的連結。
- 不佔用忙碌時段（顯示為「有空」），不會擋到別人約你開會。
- 在機器人改日期、改名稱、標記用掉，行事曆都會同步；按 🗑 刪掉會連事件一起刪。
- 直接在行事曆上改不會回寫機器人（機器人是權威），要改請在 LINE 或清單頁改。
常見問題
- 辨識錯了怎麼辦？
- 確認卡上直接按「📅 改到期日」「✏️ 改名稱」。已經加進去的券也可以改：從清單點開看截圖，再對機器人打「新增 …」重加、舊的按 🗑。
- 截圖要拍到哪些地方？
- 至少要有券名或面額和到期日（「剩 3 天」也可以，會用今天推算）。一次截一整頁「我的優惠券」也行，會拆成多筆。
- 帳號要填什麼？
- 你看得懂就好：「蝦皮 志權」「酷澎 老婆」「0912-345-678」都可以。目的是到期時知道要登入哪個帳號去用。
- 老婆也想用？
- 請她加好友，把 6 碼核准代碼給主人核准。全家共用同一份清單與行事曆；到期提醒推給當初上傳的人，週報每個人都會收到。
- 會不會亂推、扣很多額度？
- 免費方案每月 200 則推播。只有 D-7、D-3 提醒和週一週報會用到（截圖和文字卡算同一則）。一個人每月大約 4 則週報＋每張券 2 則。
- 辨識要等多久？
- 一般 10～30 秒，等待時聊天室會出現「…」動畫。超過一分鐘還沒回，請再傳一次。
- 截圖會被別人看到嗎？
- 截圖存在私人的 Cloudflare 空間，不公開；只有帶簽章、會過期的網址才看得到（推播裡的 30 天、清單頁的 2 小時）。
運作原理
| 東西 | 在哪 |
|---|
| 程式 | 私有 repo chuan2024/coupon-line-bot（Cloudflare Worker coupon-bot） |
| 截圖辨識 | Claude API（claude-opus-5-5），一張約台幣 1 元（實測後更新） |
| 資料 | D1 coupon-bot（券、帳號、推播紀錄）；截圖在 KV，不公開 |
| 排程 | Cloudflare Cron 每天 01:00 UTC（台北 09:00） |
| 金鑰 | LINE、Claude、Google 的金鑰都只放在 Worker（wrangler secret），不進 Git |
| 部署 | Mac mini ~/apps/coupon-line-bot 上 npm run deploy |
流程參考工作用的「工安組行事曆機器人」（傳圖 → 辨識 → 確認卡 → 行事曆 → 排程推播），架構沿用「卡費小幫手」。