從第一筆，
到每一次心中有數。

1. 核心架構與隱私安全原則

• 100% 私有雲端：記帳資料完全保存在你自己的 Google Drive 與 Google 試算表中，無任何第三方中繼資料庫或代理伺服器。
• 權限最小化原則 (drive.file)：存取帳本使用 drive.file 範疇（另宣告外部請求與觸發器權限），只能讀寫 AzLedger 自身建立的帳本，無法存取你 Google 雲端硬碟中的其他私人文件。
• 單一擁有者綁定：Bot 具備防偽機制，首次啟用需輸入一次性安全綁定碼，任何非擁有者或群組傳送的訊息均會被直接忽視，防止未授權記帳。
• 背景自動巡檢：每分鐘背景 Worker 自動巡檢當月資料，信用卡分期、應收往來自動排程展開與編號，免手動整理。

2. Telegram 日常記帳語法大全

在 Telegram 對著你的專屬 Bot 直接傳送文字即可完成記帳。系統具備智慧自然語意解析，能自動識別金額、帳戶、分類與備註。

(1) 一般日常支出

• 午餐 120複製
  • 系統自動比對關鍵字「午餐」➔ 分類自動歸入【飲食】。
  • 未指定帳戶時，預設使用【現金】（或第一個資產帳戶）。
• 早餐 60 蛋餅紅茶複製
  • 項目為早餐（60元），附加說明「蛋餅紅茶」自動寫入【備註】欄位。

(2) 指定支付帳戶

• 國泰 好市多 1500 購物複製
  • 帳戶：國泰（信用卡／銀行）。
  • 項目：好市多（1500元），分類：購物。
• 現金 晚餐 250複製
  • 明確指定以現金扣款。

(3) 同時輸入備註 (Note)

💡 規則：在項目或金額後空格加上補充文字，任何非金額、非帳戶的字句均會完整保留於「備註」欄！

• 午餐 120 麥當勞大麥克複製 ➔ 金額 120，備註：麥當勞大麥克
• 國泰 咖啡 160 買一送一跟同事分複製 ➔ 帳戶：國泰，金額 160，備註：買一送一跟同事分
• 悠遊卡 計程車 250 下雨返家複製 ➔ 帳戶：悠遊卡，金額 250，備註：下雨返家

(4) 多筆同時記帳

• 同一行多筆：午餐100 飲料30 點心40
  • 系統自動拆解為 3 筆獨立交易，共用當前日期與帳戶。
• 多行輸入：早餐 50 咖啡 80 捷運 35複製

(5) 補記過去日期

• 昨天 晚餐 200複製
• 前天 聚餐 800 現金複製
• 2026/11/05 門市加油 1200 國泰複製

(6) 收入記錄

• 收入 50000 薪資 銀行複製
  • 帳戶：銀行（餘額增加 50,000 元），類別：薪資。
• 收入 60000 薪資 銀行 10月業績獎金複製
  • 附加說明「10月業績獎金」自動記入備註。

(7) 帳戶轉帳、提款與存款

• 轉帳 3000複製（Bot 會彈出選單讓你點選轉出帳戶與轉入帳戶）
• 提款 2000複製（銀行 ➔ 現金）
• 存款 5000複製（現金 ➔ 銀行）

(8) 信用卡繳費

• 繳卡費 5000複製（Bot 彈出選單選擇由哪家銀行扣繳至哪張信用卡）
• 信用卡繳費 8000 銀行複製

(9) 信用卡分期

• 分期 15000 3期 電視 國泰複製
  • 記錄總額 15,000 元、分 3 期。
  • 背景自動展開：背景巡檢後系統背景 Worker 自動將 3 期本金（各 5,000 元）精確排程歸入未來各月分頁中，免手動算期數。

(10) 借貸往來（代墊／應收／應付）

• 應收 450 小明 KTV唱歌分攤 現金複製
  • 代表你幫小明代墊 450 元，小明欠你錢。
  • 現金帳戶支出 450 元，「應收應付」帳冊自動建立應收款項。
  • 背景自動歸檔：背景 Worker 自動歸檔並賦予款項 ID，整理完成後即可收款銷帳。
• 應付 500 小明 晚餐複製
  • 代表你欠小明 500 元。

(11) 撤銷與防呆指令

• 輸入 刪除最後一筆：Bot 會回傳最後一筆交易摘要，點擊【確認刪除】即可清除該筆（同列收入不受影響；已修改或分期交易具備防呆保護）。
• 輸入 取消：放棄當前尚未點選完成的草稿。
• 輸入 重試：若因網路暫時中斷未收到確認，沿用原代碼重送防重複入帳。

3. Telegram 查詢與資產管理指令

隨時在 Telegram 輸入以下斜線指令，查閱財務報表：

📊 /預算 (別名：/b)

• 顯示當月總預算、已支用金額、支出進度百分比與進度條。
• 實質安全動支額度 (Safe-to-Spend)：
  • 自動扣除本月「尚未扣繳的固定支出」（如即將到期的房租、Netflix 等）。
  • 顯示「實質剩餘額度」，防止月初誤以為錢還很多而超支。
  • 若透支會主動標記 🚨 實質超支 警報。

💳 /帳戶 (別名：/a)

• 條列所有資產帳戶（現金、各銀行、電子票證）即時餘額。
• 條列信用卡已發生淨欠款與總資產淨值。

👥 /往來 [對象] (別名：/查 [對象])

• 範例：/往來 小明
• 立即調出與小明的所有借貸狀態：總代墊應收、總借入應付、未結淨額，以及最近 5 筆未結款項明細。

📱 /操作 (別名：/panel, /m)

• 取得專屬的行動操作面板入口。
• Bot 回傳包含授權 Token 的專屬按鈕 [ 🚀 點此開啟操作面板 ]，手機單手秒開網頁。

📖 /h (別名：/help)

• 叫出完整的記帳語法小抄、查詢指令清單與備註填寫範例。

📦 /版本（別名：/version、/v）

查看目前核心版本、發布日期與平滑升級指南。

4. 固定循環支出與自動提醒系統

免除手動記週期性帳單的麻煩，支援訂閱服務、房租、保險等循環扣款。

(1) 新增固定排程語法

• 日期：支援 1 ~ 31 日，或輸入 月底。
• 模式：
  • 自動複製：到期當天由每日排程自動記入帳本並在 Telegram 發送扣款收據。
  • 提醒複製（預設）：到期當天在 Telegram 推播通知，附帶 [✅ 確認入帳] 與 [⏭️ 跳過此期] 按鈕，點擊後才寫入。
• 範例：
  • 固定 5日 390 Netflix 國泰 娛樂 提醒複製
  • 固定 1日 18000 房租 銀行 家居 自動複製
  • 固定 月底 90 iCloud 國泰 提醒複製

(2) 管理指令

• /固定清單複製（或 /循環清單）：查看目前生效中的所有固定排程、扣款日與累積執行狀態。
• /固定刪除 [編號]複製：依序號停用並刪除指定的排程規則。

5. 私人操作面板 (Web App 行動端)

專門處理需要表單確認或進階維護的操作，具備手機 RWD 自適應與現代化 Modal 浮層設計。

┌──────────────────────────────────────────────┐
│  AzLedger 私人操作面板 (vR9.20)             │
│  💡 提示小卡：日常記帳請留在 Telegram 進行 │
├──────────────────────────────────────────────┤
│  月份選單：[ 11月 ▼ ]                        │
│                                              │
│  [ 收還款／抵銷 ]   [ 📊 整理指定月份 ]      │
│  [ 🔄 立即同步分類 ] [ 🔍 執行帳單查詢 ]     │
├──────────────────────────────────────────────┤
│  ▶ 展開年度結轉精靈（年終專用折疊面板）      │
│  ▶ 展開進階列操作（修改分期／同筆關聯）      │
└──────────────────────────────────────────────┘

核心功能清單

1. 收還款／抵銷：點擊彈出具備暗色遮罩的浮層視窗，進行借款結清與對帳。
2. 📊 整理指定月份：手動觸發指定月份的排序與核帳（日常由背景 Worker 自動處理）。
3. 🔄 立即同步分類與帳戶：在試算表修改新帳戶或新分類後，點擊立即熱重載。
4. 🔍 執行信用卡帳單查詢：依卡片與結帳日區間，產出對帳明細。
5. 進階列操作（折疊收納）：
   • 需指定儲存格座標（如 D5:T5）的高階功能：
     • 修改分期：微調某一期的金額或提前還款。
     • 合併為同筆交易：將多筆支出綁定為同筆關聯（如買手機 + 保護貼）。
     • 取消同筆關聯。

6. 應收應付與收款銷帳機制

當朋友匯款歸還代墊款時，標準銷帳流程如下：

銷帳 3 步驟

1. 在 Telegram 輸入 /操作，點擊按鈕開啟操作面板。
2. 點擊 【收還款／抵銷】：
   • 對象：選單切換至還款人姓名。
   • 動作：選擇 【收款】（若你還別人錢則選【還款】；雙方互相代墊則選【抵銷】）。
   • 日期：預設今日。
   • 實際帳戶：選取對方匯款進來的實收帳戶（例如：銀行、現金）。
3. 勾選款項：
   • 在下方未結清單中勾選該筆帳，確認本次收款金額（支援全額或部分還款）。
   • 點擊 【確認收款】 送出！

自動連鎖反應（免手動記收入）

• 「應收應付」分頁：已收金額自動累加，未結金額歸零，狀態自動轉為 「已結清」。
• 「帳戶餘額」：實收帳戶餘額自動增加該筆款項，嚴禁再於日常補記一筆收入（避免重複虛增資產）。

7. 試算表結構與分頁管理說明

8. 年度結轉精靈 (Year-End Rollover)

每年 12 月底或 1 月初時，AzLedger 支援一鍵平滑轉移至新年度，完全不需要手動開新表重造：

1. 預覽階段：
   • 在操作面板展開「年度結轉精靈」，點擊 【取得結轉預覽】（或在 Telegram 輸入 /rollover）。
   • 系統自動計算：各帳戶期初餘額、信用卡已發生淨欠款、未到期分期本金、未結應收應付。
2. 核對與確認：
   • 核對金額無誤後，點擊 【🚀 確認建立新年度並切換】。
3. 自動完成：
   • 系統自動建立全新年度試算表。
   • 將期初資產與未結項目自動繼承。
   • Telegram Bot 與 Webhook 自動切換至新帳本，原聊天室與日常記帳零中斷無縫延續！

9. 常見問題與故障排除 (FAQ)

Q1：在 Telegram 記完帳，試算表多久會看到？

送出成功後即可在 Google 試算表查看新交易；實際時間受 Google 配額與網路影響。

Q2：出現「這位對象目前沒有未結款項」怎麼辦？

1. 請檢查彈窗最上方的「對象」下拉選單，是否已切換為還款人姓名。
2. 如果是剛剛才在 Telegram 記的應收，後台 Worker 約需 1 分鐘自動排程歸檔，稍候重新打開即可。

Q3：如何新增新的銀行帳戶或信用卡？

1. 開啟試算表「帳戶管理」分頁，在空白列填入帳戶名稱、類別與初期餘額。
2. 切換至「設定」分頁勾選 B19（同步分類與帳戶），或在網頁面板點擊 【🔄 立即同步】。

Q4：更換手機或清除快取後，如何找到操作面板？

直接在 Telegram 對著 Bot 輸入 /操作，點擊按鈕即可立即開啟。

10. 版本資訊與更新

vR9.20 發布日期：2026-11-13

在 Telegram 輸入 /版本、/version 或 /v，即可查看自己部署的核心版本與升級連結。試算表「設定」B2、私人操作面板頁首及本手冊也會顯示版本。

每個私有副本獨立運作，官方發布新版不會自動覆蓋你的專案。準備更新時，請依照下方平滑升級指南操作。

11. 平滑升級指南

保留你的帳本，更新處理引擎。
在同一 Apps Script 專案依本指南升級，只替換處理引擎；既有記帳資料、分類、帳戶與歷史月份完整保留，不需重建帳本。更新原部署，原 Web App 網址與 Telegram Token 也不變，不需重新設定。

完成後，背景巡檢會同步試算表「設定」B2 的版本資訊。升級指南適用於現有 R9 帳本；歷史架構若另有資料移轉要求，請依相應移轉文件操作。