💳 卡費小幫手

信用卡繳費提醒＋優惠查詢＋本月消費記帳頁。私人用，只有核准過的 LINE 帳號看得到資料。

開始使用

  1. 在 LINE 加「卡費小幫手」好友。
  2. 機器人會回一串 6 碼核准代碼。這時還查不到任何資料。
  3. 在 Mac mini 執行 node scripts/admin.mjs allow <6 碼> 核准（repo chuan2024/card-line-bot）。
  4. 核准後，點選單任一格就會回應；之後每天早上會收到該收的提醒。

機器人只回一對一私訊。被拉進群組不會說話：卡費金額不該出現在群組。

圖文選單：本期應繳、即將到期、本月優惠、本月消費、各卡資訊、使用說明
格子會回什麼也可以打字
💳 本期應繳還沒繳的總額＋每張帳單的截止日、金額、狀態。金額還沒出來的會註明「實際會更高」應繳、本期
⏰ 即將到期14 天內要繳、還沒繳的，一張一卡，附「去繳款」連結到期、截止
🎁 本月優惠先選銀行，再看每檔活動：▲ 要自己登錄排最前面，✓ 已登錄、✕ 額滿排後面優惠、台新優惠
🧾 本月消費開記帳頁（LINE 裡直接開）消費、明細
🗂 各卡資訊每家主力卡末四碼、結帳日（約）、繳款日、自動扣繳的戶頭卡片、結帳日
❓ 使用說明開這一頁說明

查詢都用「回覆」，不扣每月 200 則的推播額度，想按幾次都可以。

會收到哪些推播

推播什麼時候內容
🧾 帳單出來了某期第一次抓到金額、離截止日還有 4 天以上本期應繳、最低應繳、截止日
💳 7 天後截止截止日前 7 天 07:40應繳金額、截止日、自動扣繳的戶頭末碼（提醒確認餘額）、去繳款按鈕
💳 3 天後截止截止日前 3 天 07:40
⏰ 今天截止截止日當天 07:40（Mac 那天沒開機，之後補一次）
‼ 扣款失敗銀行來信說扣款失敗，每天一則直到處理金額＋去繳款
📋 本週總覽每週一 07:40，14 天內有要繳的才推一張卡列出全部未繳與總額

本月消費記帳頁

在 LINE 裡按「本月消費」直接開，用 LINE 身分登入，不用另外輸入帳密。

記帳頁示範畫面：本月消費、本期應繳、還沒付、本月要繳的帳單、各卡小計

示範畫面，數字都是假的。開示範版 ↗

常見問題

本月消費是空的？
明細來自信用卡帳單，要等帳單結帳寄來才有。月初到結帳前，這個月的明細會是空的，頁面會給一顆「看上個月明細」的按鈕。
某張帳單寫「金額未出」？
系統還沒抓到那期金額（聯邦、中信要等銀行的通知信；富邦每月 4、8 日自動登入抓）。繳款前請開原帳單確認。
已經繳了，怎麼讓它不要再提醒？
在 Notion「01_消費紀錄DB」那一列勾「是否繳費」，或在 Mac mini 的 inbox-radar /bills 勾已繳。最慢約 20 分鐘後這裡也會變成 ✓。
資料多久更新一次？
Mac mini 每 10 分鐘檢查一次，有變動才送上來。記帳頁最下面有「資料時間」。
結帳日為什麼寫「約」？
銀行信裡沒有結帳日，是用每期帳單最後一筆入帳日推出來的。推不出來就寫「未知」。
優惠只顯示 12 檔？
LINE 一次最多放 12 張卡，要自己登錄的排最前面；沒列出的會在下一則訊息講是哪些狀態。

資料從哪來

Mac mini 的 inbox-radar 讀帳單信、抓金額、解析明細、登錄銀行活動（這些原本就在跑）。 卡費小幫手只是另一個「看」的窗口：Mac mini 每 10 分鐘把唯讀快照送到 card.chuanworks.com，LINE 與記帳頁都只讀那份快照，不會改到 inbox-radar 的任何資料。

東西在哪
判斷今天推什麼inbox-radar lib/cardbot-remind.ts（07:40／13:40，跟著 bills-cron.sh）
快照同步inbox-radar scripts/cardbot-sync.ts（launchd com.chuan.inbox-radar-cardbot-sync，每 10 分）
LINE 回覆、推播卡片、記帳頁Cloudflare Worker card-bot＋D1（repo chuan2024/card-line-bot）
LINE 金鑰只放在 Worker（wrangler secret）；Mac mini 只有一把同步用的簽章金鑰