ALL SET — 自動同步銀行、信用卡、投資與電子發票的自架個人財務整合工具。
可免費自架： 可透過 Cloudflare Workers Free Plan 一鍵部署，不需要自行準備伺服器；一般個人低頻使用可從免費方案開始。
本專案以 kevchentw/taiwan-fin-hub 為基礎，持續擴充資料來源、同步流程與 UI/UX。感謝原作者與貢獻者奠定專案基礎。
以下畫面使用匿名 Demo 資料，取自目前版本。
| 桌面版總覽 | 手機版總覽 |
|---|---|
 |
 |
| 資產清冊 | 活動分析 | 發票活動 |
|---|---|---|
 |
 |
 |
| 投資明細 | 銀行與信用卡 | 設定與資料來源 |
|---|---|---|
 |
 |
 |
| 資料來源 | 支援內容 | 登入與驗證 |
|---|---|---|
| 電子發票載具 | 載具發票與品項明細 | 使用電子發票 App 帳密；登入狀態失效時自動重新登入 |
| 集保 e 存摺 | 交割帳戶餘額與明細（支援銀行）、股票、ETF、基金持倉與交易 | 首次或新裝置登入可能需要 Email／簡訊 OTP |
| 玉山銀行 | 存款帳戶、餘額與交易；信用卡帳單與刷卡交易 | Browser Run 登入；session 失效時重新登入 |
| 國泰世華銀行 | 存款帳戶、餘額與交易；信用卡帳單與刷卡交易 | 每次同步透過 Browser Run 登入；額外驗證需人工處理 |
| 永豐行動銀行 | 信用卡總覽、近期帳單與未出帳消費 | 自動辨識圖形驗證碼；失敗時可人工輸入 |
| 台新銀行 | 信用卡額度、帳單、已入帳與即時授權消費 | 自動辨識圖形驗證碼；失敗時可人工輸入 |
| 中國信託銀行 | 存款帳戶、餘額與交易；信用卡帳單、已入帳、未出帳與即時消費明細 | 行動銀行 API 自動登入 |
| 新光銀行 | 臺外幣帳戶、餘額、交易明細與信用卡帳單 | 行動銀行 App API 自動登入 |
| 華南銀行 | 存款帳戶與餘額；信用卡帳單與刷卡明細 | 自動辨識圖形驗證碼；失敗時可人工輸入 |
| 王道銀行 | 活存、定存、餘額與交易 | App API 登入並自動辨識驗證碼；失敗時可人工輸入 |
| 第一銀行 | 存款帳戶、餘額與交易明細；信用卡帳單與刷卡明細 | 網路銀行登入並自動辨識圖形驗證碼；失敗時可人工輸入 |
- 連接器依賴外部網頁、App API 與回應格式；資料來源改版後可能需要更新才能恢復同步。
- 系統不會繞過圖形驗證碼、OTP、裝置驗證等互動式安全機制；需要人工處理時會停止同步並顯示提示。
- 台新與王道的排程預設停用；自動登入可能取代正在使用的官方 App session。第一銀行透過網路銀行 Browser session 同步，登入失效時會重新取得圖形驗證碼。
- 資料更新時間與完整性取決於外部服務，不應視為銀行、券商或財政部的即時正式對帳資料。
本專案使用的 Workers、D1、Queues、Workers AI 與 Browser Run 均提供免費額度。各項免費額度並非無限；超過服務限制時，相關功能可能暫停至額度重置。
玉山、國泰、永豐與台新會使用 Browser Run。Workers Free Plan 目前每日包含 10 分鐘瀏覽器使用量；實際額度以 Cloudflare 最新方案為準。
點擊下方按鈕。Cloudflare 會在你的 GitHub 帳號建立新的 repository、自動建立 D1 Database，並部署至 Cloudflare Workers：
Cloudflare Builds 會在 build 階段自動檢查並建立排程同步所需的 Queue；正式部署腳本也會再次檢查。既有安裝更新到使用 Queue 的版本時不需要手動建立資源。
首次使用時，依畫面透過 Git account → New Github Connection → Install & Authorize 授權 Cloudflare 存取 GitHub。
部署頁會先預填 Access 相關欄位；首次部署只需將 CONFIG_ENCRYPTION_KEY 改成自己產生的隨機金鑰，TEAM_DOMAIN 與 POLICY_AUD 會在步驟二設定。
CONFIG_ENCRYPTION_KEY 是系統加密連接器設定時必須使用的金鑰，可用下列指令產生：
openssl rand -hex 32使用一鍵部署時只需填入一次，部署後由 Cloudflare 保存；日常使用與後續自動更新不需要重新輸入。沒有另外記下金鑰不會影響現有部署，但若日後要重建 Worker、搬移環境或沿用既有 D1，就必須使用相同金鑰，否則需要重新設定所有連接器。若重視災難復原，建議將它保存在密碼管理器；無論是否另外保存，都不要在既有部署中任意更換或刪除。
填寫完成後點擊 Deploy。
- 前往 Cloudflare Dashboard → Workers & Pages，選擇剛建立的
taiwan-fin-hub - 開啟 Domains，將 Worker URL 的存取模式從 Public 改為 Restricted
- 若沒有 Domains 頁籤，請至 Settings → Domains & Routes，在
workers.dev網址旁啟用 Cloudflare Access
切換後，Cloudflare 會顯示以下資訊：
- Audience (aud)：填入 Worker Secret
POLICY_AUD - JWKs URL：取出前面的網域作為
TEAM_DOMAIN，例如https://yourteam.cloudflareaccess.com
前往 Settings → Variables and secrets 設定這兩個 Secret。
- 開啟 Worker 的
workers.dev網址，確認會先要求 Cloudflare Access 登入 - 登入後前往「設定 → 資料來源」設定連接器
- 點擊同步以取得最新資料
Cloudflare Access 可能預設使用 Email OTP，登入狀態通常會在 24 小時後過期。以下設定可改用 Cloudflare 帳號登入，並將登入期限延長至一個月。
- 前往 Zero Trust → Integrations → Identity providers，確認已有 Cloudflare；若沒有，點選 Add new identity provider → Cloudflare
- 啟用 Restrict to account members 並儲存，避免非此 Cloudflare 帳號成員登入
- 前往 Zero Trust → Access controls → Applications → taiwan-fin-hub → Authentication，將登入方式設為 Cloudflare
- 若只使用此登入方式，可啟用 Apply instant authentication，略過登入方式選擇頁
新建立的 Zero Trust organization 通常已預設啟用 Cloudflare identity provider，不需要另外新增。
- 在
taiwan-fin-hubAccess Application 中，將 Session Duration 設為 1 month - 前往 Zero Trust → Access controls → Access settings，將 Global session duration 設為 1 month
- 若 Access Policy 另外設定了 Session Duration，也要改為一個月，否則會以較短的期限為準
更多 Queue、Access、自動更新原理與故障排查請參考進階部署與更新。
Cloudflare 的 Deploy to Cloudflare 流程目前不會將 .github/workflows 複製到新 repository，因此首次部署可以正常使用，但需要完成下方的一次性設定才會啟用版本更新。
不需要修改程式碼，可直接在 GitHub 網頁完成：
- 在你的部署 repository 開啟
deploy/github/sync-upstream.yml，點擊 Raw 並複製完整內容 - 回到 repository 首頁，選擇 Add file → Create new file
- 將檔名設為
.github/workflows/sync-upstream.yml，貼上剛才複製的內容並 commit 至main - 前往 Settings → Actions → General → Workflow permissions，確認已允許 GitHub Actions 讀寫 repository 內容
若已將 repository clone 至本機，也可以執行：
mkdir -p .github/workflows
cp deploy/github/sync-upstream.yml .github/workflows/sync-upstream.yml
git add .github/workflows/sync-upstream.yml
git commit -m "啟用版本自動更新"
git push完成一次性設定後，可以前往部署 repository 的 Actions → Sync Latest Version → Run workflow，點擊 Run workflow 立即更新。workflow 也會在每天台灣時間 04:15 自動執行。
每次執行會取得最新版本、進行安全三方合併，並由 Cloudflare Workers Builds 重新部署。若你修改過程式碼並與上游發生衝突，workflow 會停止且不會推送；請從 Actions 紀錄查看衝突並手動處理。首次同步、備份 branch 與舊版 workflow 的排查方式請參考進階部署與更新。
建立不納入版本控制的私人設定，將 wrangler.local.toml 的 D1 Database ID 換成開發用資料庫，並在 .dev.vars 設定自己的 CONFIG_ENCRYPTION_KEY：
cp apps/worker/wrangler.local.toml.example apps/worker/wrangler.local.toml
cp apps/worker/.dev.vars.example apps/worker/.dev.vars
npm install
npx wrangler login
npm run dev範例設定的 D1 與 Workers AI 會連到 Cloudflare remote binding，請勿使用正式資料庫。常用驗證指令：
npm run format:check
npm run typecheck
npm run verify:web
npm run test:backend
npm run build本機 relay、資料庫遷移與既有 D1 部署方式請參考進階部署與更新。
前端使用 Svelte 5、TypeScript、Tailwind CSS 4 與 shadcn-svelte；後端執行於 Cloudflare Workers，以 Hono 提供 API，並整合 D1、Access、Browser Run、Workers AI、Cron Triggers 與 Queues。專案以 npm workspaces 管理 Web、Worker、共用型別、資料庫與連接器套件。
- Cloudflare Access 是一般模式的登入閘道；Worker 會驗證 JWT 的簽章、issuer、audience 與有效期限。
- 連接器帳密以
CONFIG_ENCRYPTION_KEY衍生的金鑰進行 AES-GCM 加密，D1 只儲存密文。 - 目前不支援金鑰輪替；若刪除或更換 Cloudflare 中的金鑰，必須重新設定所有連接器。
本程式僅供個人研究與自用，未與臺灣集中保管結算所、財政部、金融監督管理委員會、各銀行或任何金融機構合作，亦未獲前述機構授權或背書。本程式所呈現之資料以您自行提供之憑證取得，作者不保證資料之即時性、正確性與完整性，亦不對因使用本程式所產生之任何直接或間接損失負責。請勿將本程式用於任何商業用途。
本專案採用 MIT License，並保留原專案的著作權與授權聲明。