需使用電腦
完成首次部署
請在 PC / Mac 的桌面瀏覽器操作 Apps Script 編輯器與授權。設定完成後，日常記帳可透過手機 Telegram 完成。
YOUR LEDGER. YOUR CLOUD.
AzLedger個人智慧
雲表記帳系統。
現行正式版 vR9.20
以 Google 試算表為核心、透過 Telegram 實現極速雙向記帳與即時資產管家。
帳本在你的 Google Drive；記帳訊息經 Telegram 與 Google 處理。本引導站不收集帳本、Bot Token 或綁定碼。
日常記帳，留在聊天裡。
我的 AzLedger專屬記帳 Bot
記帳情境示意
現金 午餐120 12:30 ✓✓
✅ 已入帳
午餐 120 元（現金｜飲食）
📊 今日累計支出：320 元/預算 12:31 ✓✓
📊 本月預算23.7%
$3,200 / $13,500剩餘額度$10,300
傳送訊息…
Google 試算表你擁有資料，也保有掌控。
01 / BEFORE YOU BEGIN
先理解，再開始。
一份屬於自己的工具，
也有需要先知道的邊界。
需使用電腦
無 SLA
運行時間保證
運行於你的 Google 帳號免費配額，沒有企業級可用性保證。Google 配額、服務狀態與網路都可能影響執行。
版本各自獨立
不自動隨開發者更新
部署後是你的獨立私有副本。開發者發布新版不會強制更新你的帳本；升級由你決定，需手動替換程式並更新部署。
02 / MAKE IT YOURS
五步，把帳本帶回自己的雲端。
準備好電腦、Google 帳號，
以及你的 Telegram。
01
AzLedger 記帳本
02
03
A
appsscript.jsonB
程式碼.gs04
執行初始建表，完成授權
執行 initializeAzLedgerR9 並授權，開啟執行記錄的新帳本連結。
設定頁 B29 顯示「初始帳本建立完成」後，再開始記帳。
initializeAzLedgerR9▶ 執行05
綁定自己的 Telegram Bot
向 @BotFather 取得 Token。將同一腳本部署為 Web App，選「我／所有人」。
在設定頁填 B6 網址、B7 Token，勾選 B8；將 B11 的整行綁定指令傳給自己的 Bot。
設定與權限說明 ↗- B6
- Web App /exec 網址
- B7
- BotFather Token
- B8
- ☑ 套用 Telegram 設定
- B11
- /start 綁定碼
FOR YOUR NEXT CHAPTER
帳本留下，引擎更新。
已經在使用 AzLedger？
在原專案完成這三步就好。
歷史資料 100% 保留
更新處理引擎，保留既有交易列、分類、帳戶與每個月份。
連線設定繼續沿用
更新原部署，Web App 網址與 Telegram Token 不變，Bot 不需重新綁定。
更新後，隨時查驗
在 Telegram 輸入 /版本，確認核心版本為 vR9.20。
- 01
複製代碼框 B
到程式碼下載區，複製最新
AzLedger-R9-Full.gs全文。 - 02
覆蓋原專案，存檔
開啟原 Apps Script 專案，覆蓋
程式碼.gs全文並儲存。 - 03
原部署選擇新版本
管理部署 → 編輯 → 版本選「新版本」→ 部署，完成升級。
03 / THE SOURCE IS YOURS
兩份檔案，就能開始。
由同一份建置產物同步，
複製前核對檔案完整性。
正在載入並核對發布檔…
貼入 Apps Script 的資訊清單，保留此專案需要的三項權限。
正在載入資訊清單…完整單一發布程式，貼入清空後的程式碼檔。原始碼預設收合；複製與下載均包含全文。
展開完整程式碼
若直接以檔案方式開啟網頁，瀏覽器可能阻擋載入。請使用 HTTPS 網站或本機 HTTP 預覽。授權與 Token 設定都在你自己的 Google 專案完成。
A SMALL MESSAGE, A CLEARER PICTURE
想到哪一筆，就從這裡開始。
記帳範例與查詢指令，
選一張卡片，複製就能用。
何時（選填）做什麼（分類/類型）多少錢哪個帳戶備註/參數
這是記帳資訊的通用結構，實際輸入依下方範例。帳戶與對象使用自己帳本中的名稱；國泰與悠遊卡等自訂帳戶需先建立，缺少欄位時依 Bot 按鈕補選。
九種日常，從一則訊息開始。
01 日常支出
[日期] [帳戶] [分類] [金額] [備註]
午餐 120 悠遊卡 加蛋帳戶可放在項目前後，日期放在句首。
手冊詳細說明 ↗02 日常收入
[日期] 收入 [金額] [名稱/備註]
收入 52000 薪水指定帳戶與類別時，請使用自己帳本中的名稱。
手冊詳細說明 ↗03 帳戶轉帳
轉帳 [金額] [轉出帳戶]
轉帳 3000 現金傳送後，依 Bot 按鈕選擇轉入帳戶。
手冊詳細說明 ↗04 信用卡繳費
繳卡費 [金額]／信用卡繳費 [金額] [扣款帳戶]
繳卡費 5000依按鈕選擇扣款帳戶與繳費的信用卡。
手冊詳細說明 ↗05 信用卡分期
分期 [總金額] [期數]期 [名稱] [帳戶]
分期 15000 3期 電視 國泰國泰須先設為信用卡帳戶；系統背景自動展開期數。
手冊詳細說明 ↗06 代墊款（應收）
應收 [金額] [對象] [備註] [出帳]
應收 450 小明 KTV唱歌分攤 現金你先幫對方付款；收回款項時使用 /操作 銷帳。
手冊詳細說明 ↗07 被代墊（應付）
應付 [金額] [對象] [備註]
應付 500 小美 晚餐記錄你欠對方的款項，缺少欄位依按鈕補選。
手冊詳細說明 ↗08 每月固定支出
固定 [扣款日] [金額] [名稱] [帳戶] [分類] [模式]
固定 5日 390 Netflix 現金 娛樂 提醒模式可選「提醒」或「自動」；提醒需確認後才入帳。
手冊詳細說明 ↗09 撤銷防呆
刪除最後一筆
刪除最後一筆傳送後核對摘要，點擊確認才會刪除。
手冊詳細說明 ↗需要的資訊，隨時問 Bot。
預算監控
/預算
/預算別名：/b
查看本月總預算、支用進度與扣除固定款後的實質安全剩餘額度。
資產盤點
/帳戶
/帳戶別名：/a
條列現金、銀行、電子票證餘額與總資產淨值。
代墊追蹤
/往來 [對象]
/往來 小明別名：/查 [對象]
查詢好友的代墊與借貸未結清餘額及往來明細。
私人面板
/操作
/操作別名：/panel、/m
取得私人操作面板，處理收還款、抵銷、修改分期與年度結轉。
固定管理
/固定清單
/固定清單別名：/循環清單
列出已登錄的每月定期扣款項目與狀態。
固定管理
/固定刪除 [ID]
/固定刪除 1依編號或 ID 刪除已設定的固定扣款項目。
系統資訊
/版本
/版本別名：/v、/version
查驗核心版號、發布日期與平滑升級指南連結。
年度結轉
/rollover
/rollover開啟結轉精靈，先預覽與核對，再確認建立新年度。
即時小抄
/h
/h別名：/help
在聊天室調出完整語法速查與備註輸入教學。
05 / GOOD QUESTIONS
第一次設定，
你可能想問。
出現「Google 尚未驗證這個應用程式」怎麼辦？
只有在確認這是你建立的 AzLedger 專案、程式碼來源正確，且權限符合本頁資訊清單後，才在授權頁選「進階 → 前往 AzLedger（或你自行命名的專案）」。若來源或權限不同，先停止核對；組織政策不允許時，請洽管理員。
建立超過 10 秒，是不是壞掉了？
建表不保證 10 秒完成。請查看設定頁 B29 進度與 B31 訊息；系統會保留進度，由背景接續。發生錯誤時依訊息修正，再執行 continueAzLedgerR9，不要另建副本或刪除狀態。
為什麼 Web App 要開放 Anyone？
Telegram 的伺服器需要在未登入 Google 的情況下送達 Webhook。記帳端另有密鑰及私人帳號綁定；請保管部署資訊、Token、綁定碼與私人操作連結。若帳號所屬組織不提供 Anyone 選項，請先確認政策。
新版發布後，我的帳本會自動改變嗎？
不會。你的腳本與帳本由你管理。升級需先閱讀版本說明、核對既有資料，再手動替換完整程式並更新原 Web App 部署；歷史版本若有移轉需求，請依對應手冊處理。
既有用戶如何升級？
在原 Apps Script 專案以代碼框 B 覆蓋程式並儲存，再到「管理部署 → 編輯 → 新版本」更新原部署；既有記帳資料、分類、帳戶與歷史月份會保留，原 Web App 網址與 Telegram Token 沿用。完成後輸入 /版本 驗收。閱讀平滑升級指南 →
免費與私有，具體代表什麼？
本專案沒有月費或中繼代管費；Google 與 Telegram 的服務及配額條件仍適用。帳本位於你的 Google Drive，開發者不會因你安裝而取得帳本權限。你自行分享給他人的腳本或試算表權限，仍由你管理。
LESS FRICTION. MORE CLARITY.