The project's README from github.com/TedLin1993/all-set-tw. As one markdown file: README.md.
ALL SET — 自動同步銀行、信用卡、投資與電子發票的自架個人財務整合工具。
可免費自架: 可透過 Cloudflare Workers Free Plan 一鍵部署,不需要自行準備伺服器;一般個人低頻使用可從免費方案開始。
以下畫面使用匿名 Demo 資料,取自目前版本。
| 桌面版總覽 | 手機版總覽 |
|---|---|
![]() |
![]() |
| 資產清冊 | 活動分析 | 設定與資料來源 |
|---|---|---|
![]() |
![]() |
![]() |
| 資料來源 | 支援內容 | 登入與驗證 |
|---|---|---|
| 電子發票載具 | 載具發票與品項明細 | App 登入 |
| 集保 e 存摺 | 交割帳戶餘額與明細(支援銀行)、股票、ETF、基金持倉與交易 | App 登入;首次可能需要 OTP |
| 玉山銀行 | 存款帳戶、餘額與交易;信用卡帳單與刷卡交易 | 網銀登入 |
| 國泰世華銀行 | 存款帳戶、餘額與交易;信用卡帳單與刷卡交易 | 網銀登入;額外驗證需人工處理 |
| 永豐行動銀行 | 信用卡總覽、近期帳單與未出帳消費 | 網銀登入;AI 自動辨識驗證碼 |
| 台新銀行 | 信用卡額度、帳單、已入帳與即時授權消費 | 網銀登入;AI 自動辨識驗證碼 |
| 中國信託銀行 | 存款帳戶、餘額與交易;信用卡帳單、已入帳、未出帳與即時消費明細 | App 登入 |
| 新光銀行 | 臺外幣帳戶、餘額、交易明細與信用卡帳單 | App 登入 |
| 華南銀行 | 存款帳戶與餘額;信用卡帳單與刷卡明細 | 網銀登入;AI 自動辨識驗證碼 |
| 王道銀行 | 活存、定存、餘額與交易 | App 登入;AI 自動辨識驗證碼 |
| 第一銀行 | 存款帳戶、餘額與交易明細;信用卡帳單與刷卡明細 | 網銀登入;AI 自動辨識驗證碼 |
| 凱基銀行 | 臺幣活存帳戶、餘額與交易明細 | 網銀登入;AI 自動辨識驗證碼 |
本專案使用的 Workers、D1、Queues、Workers AI 與 Browser Run 均提供免費額度。各項免費額度並非無限;超過服務限制時,相關功能可能暫停至額度重置。
點擊下方按鈕。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。
taiwan-fin-hubworkers.dev 網址旁啟用 Cloudflare Access
切換後,Cloudflare 會顯示以下資訊:
POLICY_AUDTEAM_DOMAIN,例如 https://yourteam.cloudflareaccess.com前往 Settings → Variables and secrets 設定這兩個 Secret。
workers.dev 網址,確認會先要求 Cloudflare Access 登入Cloudflare Access 可能預設使用 Email OTP,登入狀態通常會在 24 小時後過期。以下設定可改用 Cloudflare 帳號登入,並將登入期限延長至一個月。
新建立的 Zero Trust organization 通常已預設啟用 Cloudflare identity provider,不需要另外新增。
taiwan-fin-hub Access Application 中,將 Session Duration 設為 1 month更多 Queue、Access、自動更新原理與故障排查請參考進階部署與更新。
Cloudflare 的 Deploy to Cloudflare 流程目前不會將 .github/workflows 複製到新 repository,因此首次部署可以正常使用,但需要完成下方的一次性設定才會啟用版本更新。
不需要修改程式碼,可直接在 GitHub 網頁完成:
deploy/github/sync-upstream.yml,點擊 Raw 並複製完整內容.github/workflows/sync-upstream.yml,貼上剛才複製的內容並 commit 至 main若已將 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、共用型別、資料庫與連接器套件。
前後端與共用套件皆使用 TypeScript 7 型別檢查;Svelte 前端透過 svelte-check --tsgo 執行,並保留工具所需的 TypeScript 6 相依。
CONFIG_ENCRYPTION_KEY 衍生的金鑰進行 AES-GCM 加密,D1 只儲存密文。本程式僅供個人研究與自用,未與臺灣集中保管結算所、財政部、金融監督管理委員會、各銀行或任何金融機構合作,亦未獲前述機構授權或背書。本程式所呈現之資料以您自行提供之憑證取得,作者不保證資料之即時性、正確性與完整性,亦不對因使用本程式所產生之任何直接或間接損失負責。請勿將本程式用於任何商業用途。
本專案採用 MIT License,並保留原專案的著作權與授權聲明。
本專案以 kevchentw/taiwan-fin-hub 為基礎發展而來。感謝原作者與貢獻者奠定專案基礎。