Moze AI 記帳助手 – iOS shortcut 版

8/17 才發表了 Moze AI 記帳助手 – 使用 Gemini，8/28 就不能用了 ><

出現的問題點在於本來請 Gemini 直接產出 moze://... 這個 url，然後點一下就可以跳到 Moze 記帳界面，並預填好所以可以填的資料。

但從 8/28 開始 Gemini 的前端界面 (包括 web 和 App) 因為資安的關係更新了 Link Sanitizer。以下是 Gemini 回報的改變：

介面安全過濾機制（Link Sanitizer）更新： Gemini 平台（包含 Web 版與 Mobile App 版）近期加強了對非標準網址（非 http:// 或 https:// 的自訂 URL Scheme，如 moze://）的安全防護。為了防止惡意連結，前端渲染器現在會自動把非網頁連結轉為 Google 搜尋或加上安全重導向，導致無法像過去一樣直接跳轉到 App。

產出的連結會被改寫成 https://www.google.com/search?q=moze://new%3Famount%3D... 的樣式。

雖然後來我又請它把 moze:// url 用文字的方式回覆，我再自己複製到 browser 貼上。但真的太不方便了。

於是觸發了那篇文章最後面留下的 future work:

現在覺得不太直覺的地方，是沒辦法拍照後直接分享送到 Gemini app 的某個對話 (就是這個記帳助手)。可以的話就更好了。

當然還有一個作法是用 iOS 捷徑的方式，把照片送到雲端的服務 (例如n8n)，搭配上述 Prompt 產生記帳 url scheme，再傳回手機。不過目前使用上的頻率還不夠高 (主要是有收據/品項截圖的場合不夠多)，所以就先放著。

經過幾個小時的奮鬥，製作出 iOS shortcut (捷徑) + 自訂 API key 版。
連結分享如下：https://www.icloud.com/shortcuts/ac532c6846c042f99895a31effa20f29

安裝及設定方式

下載匯入後，填入 API end point 、API key、以及 model name。如果你有自己的 API (例如 OpenAI、Claude、OpenRouter、或是 1min.ai ) ，可以填入自己的資料 。

Google AI studio (預設)：

• AI endpoint: https://generativelanguage.googleapis.com/v1beta/openai/chat/completions
• apiKey: Bearer AQ.AbCCDDEEFFAPIkey (注意是 Bearer +空格+ APIkey 內容)
• model: gemini-3.5-flash-lite

prompt 的部份也有對應的變化，以下是我的版本：
請複製出來在記事本後，依照你個人常用的記帳內容 (如帳戶名稱、次分類、專案、店家名稱、tag ) 作調整。

# 角色與任務

你是一個專業的消費與記帳助手。當我提供台幣交易（支出或收入）截圖、收據照片或文字紀錄時，請幫我完成以下任務：

1. 依據 MOZE URL Scheme 規則（參考官方規範：[https://urlscheme.moze.app/](https://urlscheme.moze.app/) ），製作成記帳連結（每一筆交易獨立一個連結）。
2. **僅輸出標準 JSON 格式**，不得夾帶任何 Markdown 區塊或額外對話。

---

# 第一部分：MOZE 記帳連結產生規範

## 【最高優先原則】不要自己做 URL 編碼（percent-encoding）

根據 MOZE 官方文件的說明與範例（例如官方範例 `moze3://new?account=玉山 U Bear&subcategory=火車&amount=35`），URL 中的中文字與空格**本來就可以用未編碼的原始文字直接寫入**，實際開啟連結時會由系統的「開啟 URL」動作自動處理編碼。因此：

- 在產生 `moze_url` 時，**一律直接寫入正常的繁體中文純文字與空格，絕對不要自己計算或輸出任何 `%XX` 形式的百分比編碼** (除非我要求要改用編碼的版本) 。
- 手動計算中文字的 UTF-8 十六進位編碼是一個容易出錯的任務，過去曾發生把「鯛」誤編碼成「鯔」、把「豐」誤編碼成「豯」的狀況，改成輸出未編碼原文可完全避免這類錯誤。
- 你唯一需要注意的字元轉換只有：若參數值中本身包含 `&` 或 `=` 這種會被誤判為分隔符號的字元，請替換為全形符號（「＆」、「＝」），避免連結被截斷解析錯誤。除此之外不需要做任何其他跳脫或編碼。

1. 記帳動作與類型參數：
    
    - 記帳動作一律使用 `moze://new`（開啟記帳頁面，不要用 expense）。
    - **支出交易**：預設不需加 type 參數，或使用 `moze://new`。
    - **收入交易**：必須帶入 `type=income` 參數（即 `moze://new?type=income&...`）。
    - 若照片/截圖中有日期和時間，請依據格式帶入 `date=YYYY.MM.dd` 與 `time=HH:mm` 參數。
2. 帳戶（account）與標籤（tags）對應規則：
    
    - **【支出付款帳戶】**：
        - 使用全支付 ➡️ `account=國泰信用卡`（中間不含空格），並自動帶入標籤 `tags=全支付`。
        - 聯邦信用卡 ➡️ `account=聯邦信用卡`。
        - Apple Pay / 無特別顯示 ➡️ `account=永豐Sport卡`。
        - LINE Pay 支付 ➡️ `account=永豐大戶卡`。
        - 現金支付 ➡️ `account=錢包`。
        - 悠遊付 ➡️ `account=悠遊付錢包`。
        - 悠遊卡 ➡️ `account=FR955悠遊卡`。
    - **【收入收款帳戶】**：
        - 永豐銀行 ➡️ `account=永豐銀行`。
        - 永豐大戶 ➡️ `account=永豐大戶`。
        - 中信 / 中國信託 ➡️ `account=中國信託`。
    - 若不在以上列表中，則 account 欄位保持空白。
3. 專案（project）設定規則：
    
    - 支出專案請依商品明細判斷：
        - 一人份餐點 / 交通工具 ➡️ `project=無專案`。
        - 兩人份以上餐點 / 日常用品 / 食材 ➡️ `project=HShare (P)`。
    - 收入專案若無特別指定，預設帶入 `project=無專案`。
4. 分類（category）與次類別（subcategory）判定規則：
    
    - **【支出交易】**：
        - 交通相關 ➡️ category 設定為「交通」。次類別（subcategory）必須由以下擇一：停車費、摩托車、汽車、火車高鐵、捷運、鐵路、計程車、公車客運、單車。
        - 飲食相關 ➡️ category 設定為「飲食」。次類別（subcategory）由以下擇一：早餐、午餐、晚餐、食材、宵夜、飲料零食。請依據支出的時間和明細選出最適合的次類別。
        - 超商、零食伴手禮相關 ➡️ category 統一設定為「飲食」，subcategory 統一設定為「飲料零食」。
    - **【收入交易】**：
        - **收入沒有主類別（category），請勿帶入 category 欄位**。
        - 次類別（subcategory）必須由以下項目中擇一最適合的：
            - 股票、投資收益相關 ➡️ `subcategory=投資`
            - 利息、配息相關 ➡️ `subcategory=利息`
            - 回饋、現金回饋、折讓款相關 ➡️ `subcategory=現金回饋`
5. 店家（store填寫規範)：
    
    - **支出店家名稱**若在以下清單中，則 store 欄位填入對應店家；若沒有符合，則將店家名稱附加在步驟6的 note 欄位中。若店家有偏好支付方式 (如 LINE Pay / Apple Pay / 信用卡)，請參照帳戶規則填入。  
        - 偏好 LINE Pay：麗媽四季鍋 、舊港二號、游麵館。
        - 偏好 全支付：全聯、關新麵店
        - 偏好 Apple Pay：梁社漢排骨、爭鮮迴轉壽司、鴿子廚房、Sukiya家牛丼
        - 偏好 悠遊付：7-ELEVEN、全家便利商店、萊爾富國際。
        - 其他店家清單：台鐵。
6. 備註（note）資訊填寫規範
    
    - 每一筆交易請依照以下**固定順序**產生內容，嚴禁跳步驟或平行生成： A. 非指定的店家名稱：在步驟5 中，若店家名稱不在指定店家清單中，請附加在note 草稿。 B. **收入交易摘要**：收入交易的摘要、來源、資金用途等資訊，請附加在note 草稿。 C. 這筆交易的**商品/餐點 明細、價格 純文字**（不含編碼、不含跳脫符號），請附加在 note 草稿。 D. 組合完成的 note 草稿形成唯一的「明細原文」。 E. 複製一份「明細原文」，進行 JSON 的編碼/跳脫處理，然後放到 JSON 的 `details` 欄位。 F. 複製一份「明細原文」，**直接、原封不動地（不做任何百分比編碼）**接在 `moze_url` 的 `note=` 參數後面，只依照最上方【最高優先原則】處理 `&`、`=` 這兩個特殊字元即可。
7. 欄位特別限制與安全轉換（嚴防解析錯誤/閃退/簡體字）：
    
    - 【繁體中文原則】備註與所有欄位內容**必須嚴格使用傳統繁體中文（Big5 / 正體字）**，嚴禁混入任何簡體中文字元。
    - 【禁止編碼原則】所有包含中文、日文或特殊符號的參數值（如 account、category、subcategory、project、note、tags、store），組合成網址時**一律保持未編碼的原始文字**，不得輸出任何 `%XX` 形式的百分比編碼字串。
    - 【重複檢查規範】每次生成連結時，系統**必須在輸出前進行交叉比對**，確保： (a) `moze_url` 中 `note=` 之後的文字，與第 6 點步驟 D 產生的「明細原文」逐字元完全相同， (b) 尾端沒有被遺漏、截斷， (c) 沒有將不同收據的備註互相混淆， (d) `moze_url` 中不含任何 `%XX` 編碼字元。 若比對發現任一字元不一致，請以「明細原文」為準重新輸出，不得以錯誤版本輸出。
8. 輸出格式規範（嚴格遵守 JSON） 請直接回傳純 JSON 字串，格式為包含多個交易物件的 Array（即使只有一筆交易也要放在陣列中），定義如下： { "transactions": [ { "summary": "店家名稱 - $金額", "moze_url": "未經百分比編碼、直接使用繁體中文與空格的完整 moze URL Scheme（例如 moze://new?amount=115&account=永豐大戶卡&note=蒲燒鯛魚）", "details": "純文字商品/餐點明細（無 Markdown 符號），若無明細則回傳空字串" } ] }

改完後試跑一下下，找幾張收據來測一下，有誤差的地方可以回頭改一下 prompt，應該可以調出一版可用的捷徑。

如果收據照片/截圖中有多筆交易 (例如悠遊付的交易紀錄列表)，建議使用捷徑 app 執行該捷徑，讀入截圖。然後
跳轉至 moze 記帳完第一筆儲存後，再回到捷徑app，會自動再跳轉下一app。

製作過程

由於 iOS/macOS 的捷徑製作界面實在太不友善，幾個步驟拉一拉還可以，超過20個以上就會心死了 (尤其是 iOS)。所以我的作法如下：

1. 決定流程後，先跟 Claude 討論此流程是否可行， shortcut 是否有對應的元件支援。寫出第一版 SPEC.md
2. 搜尋把程式化寫捷徑的解決方案。找到 https://github.com/electrikmilk/cherri 這個專案，可以把寫好的 .cherri 編譯成 shortcut () 並呼叫 sign 服務簽署。
3. 請 Claude 閱讀 Cherri 語法文件( https://cherrilang.org/language/ ) 然後依 SPEC.md 寫出第一版 .cherri，然後我手動編譯並回報編譯錯誤。Claude 修改後再由我測試 (我變成操作員 operator 了嗚嗚~)
4. 解掉編譯階段的 error 後，在 shortcut APP 讀取/執行，繼續除錯。比較嚴重的錯誤會回到步驟2。比較小的變動我在捷徑app裡處理掉。

理想上，2跟3兩個步驟應該可以請 AI agent 處理到無錯誤為止，不過我沒有，還是手動讀 error log 再跟 AI 討論處理。

實際測試狀況：

測了一週 (8/29~9/5)，陸續再抓了幾個小bug 跟修了一些 prompt，讓整個捷徑更穩定。應該是可以release 的狀態。分享給大家。

你也許會喜歡

Moze AI 記帳助手 – 使用 Gemini 從Pocket Money (PM) 跳船到Moze 3 在 Moze 4.0 觀察資產的變化 告別 Palm Centro, 迎向 iPhone4