Actual Budget 25.9.0 版本解析移動端規則管理、Pluggy.ai 銀行連接與自動化后端落地【免費下載鏈接】actualA local-first personal finance app項目地址: https://gitcode.com/GitHub_Trending/ac/actualActual 25.9.0 是 Actual Budget本地優先的個人理財應用在 2025 年 9 月發布的穩定版本核心圍繞三大能力展開為移動端補齊規則Rules頁面并提供獨立編輯頁、在報表中顯示實驗性預算貨幣、正式發布實驗性的 Pluggy.ai 銀行連接器。本文基于 官方 25.9.0 發布說明 展開并結合倉庫源碼desktop-client、loot-core、sync-server逐項剖析新特性、增強與修復的底層實現幫助讀者理解每個功能的落地位置與使用方式。版本概覽與升級方式本版本對應的 Docker 標簽為25.9.0發布說明明確該版本包含若干新功能與大量修復。升級時按倉庫根目錄的 Dockerfile 與 docker-compose.yml 構建或拉取25.9.0鏡像即可自托管用戶也可直接使用actualbudget/actual-server:25.9.0鏡像在 sync-server 目錄下同樣提供了 docker-compose.yml 與 Ubuntu/Alpine 兩套 Dockerfile。核心新特性1. 移動端規則頁面查看、管理、編輯一體化自 25.9.0 起Actual 在移動端正式提供了規則Rules頁面用戶可以在手機上查看、篩選、創建、編輯和刪除規則。這一系列改動由多個 PR 組成#5390新增移動端規則頁面用于在移動設備上查看和管理規則#5516將移動端規則編輯抽取為獨立頁面優化導航體驗#5556移動端規則編輯支持通過確認彈窗刪除規則#5587移動端新建規則的默認階段由pre改為default。從源碼看移動端規則列表頁面位于 packages/desktop-client/src/components/mobile/rules/MobileRulesPage.tsx其核心流程為通過send(rules-get)拉取全部規則并監聽undo-event在撤銷后自動刷新列表支持按文本過濾內部使用getNormalisedString歸一化后匹配ruleToString生成的描述文本列表會過濾掉已完成completed的排期關聯規則點擊規則跳轉到/rules/{rule.id}編輯頁MobileRuleEditPage.tsx刪除規則調用rule-delete-all若規則與排期關聯導致刪除失敗會彈出 warning 通知成功刪除則展示可撤銷Undo提示。配套的 UI 組件還包括 AddRuleButton.tsx、RulesList.tsx 與 RulesListItem.tsx。在桌面端#5543為移動端獨立編輯頁提供了組件基礎。2. 報表頁面顯示實驗性預算貨幣#5283 為報表Reports頁面增加了貨幣顯示能力使實驗性預算experimental budget中的貨幣得以展示。該功能與實驗性功能開關聯動用戶需先在設置中啟用相關實驗選項報表才會體現對應的貨幣單位。3. 正式發布實驗性 Pluggy.ai 銀行連接器#5628 將 Pluggy.ai 銀行同步集成正式納入實驗性發布。Pluggy.ai 是面向拉丁美洲金融市場的銀行連接服務作為 GoCardless 之外的又一銀行數據源選項。從 sync-server 源碼可以看到完整的服務端接入路由掛載于/pluggyai見 sync-server/src/app.tsapp.use(/pluggyai, pluggai.handlers)處理器實現位于 app-pluggyai/app-pluggyai.js提供三個接口POST /pluggyai/status返回當前憑據來源per-budget-file/global/ 未配置POST /pluggyai/accounts按 itemId 拉取賬戶列表POST /pluggyai/transactions按賬戶與起始日期拉取交易區分已入賬booked與待處理pending交易并計算起始余額。SDK 封裝位于 pluggyai-service.js基于pluggy-sdk的PluggyClient實現憑據通過 secrets-service.js 存儲支持全局與按預算文件兩種憑據作用域。代碼中還有若干細節值得注意信用卡CREDIT賬戶的金額會做符號反轉trans.amount * -1起始余額同樣取負信用卡分期installment交易會通過addMonthsClamped按分期期數修正交易日期避免 31 日加月跳月的邊界問題Pluggy 沙箱數據賬戶 owner 為John Doe會將起始日期強制設為2000-01-01以便拉取全部歷史數據。需要說明的是Pluggy.ai 連接器目前仍為實驗性功能其可用性、機構覆蓋范圍與穩定程度以官方后續發布為準在使用前請確認你的銀行機構是否在 Pluggy 覆蓋范圍內。4. 自動化的后端基礎與 UI 連接25.9.0 還為預算自動化Automations功能埋下了地基#5532 增加支持自動化 UI 的后端邏輯#5533 將自動化 UI 與后端打通。從源碼看loot-core 側暴露了budget/get-category-automations與budget/set-category-automations兩個方法見 loot-core/src/server/budget/app.ts分別對應goalActions.getTemplatesForCategory與goalActions.storeTemplates桌面端則在 BudgetAutomationsModal 目錄下實現了完整的自動化編輯界面AutomationEditorPane、AutomationListRow、CleanupListRow、ConflictBanner 等并配套 BudgetAutomationsModal.test.ts 測試。該功能同樣屬于實驗性范疇需在設置中開啟后使用。增強項解讀25.9.0 包含多項面向使用體驗的增強報表時間范圍#5419通過getLiveRange以priorYearToDate模式計算范圍與已有的 Year to date、Last month、Current quarter 等預設并列展示在報表日期范圍選擇器中。排期相關#5482 在即將到來的交易upcoming transactions備注中顯示排期名稱#5580 將其限定為僅在即將到來的交易中展示。對賬體驗#5521 對賬窗口同時展示絕對日期如08/08/2025與相對日期如3 days ago#5528 修復了對賬窗口中的數學計算錯誤Bug #5527。余額歷史圖開關#5452 為側邊欄賬戶懸停提示中的余額歷史圖新增顯隱開關。銀行同步細節#5458 銀行同步頁面對最近一次同步時間提供更詳細的懸停提示#5479 新增瑞典銀行 L?nsf?rs?kringar有限歷史的 GoCardless 解析支持#5383 為慕尼黑 Stadtsparkasse 的 GoCardless 交易解析補充了交易信息到備注。貨幣擴展新增卡塔爾里亞爾#5456、波蘭茲羅提#5472、瑞典克朗與土耳其里拉#5477、印度盧比#5483、菲律賓比索#5507。導入#5461 支持從 nYNAB 導入分類備注。移動端#5605 預算橫幅顯示未分類/超支總額#5607 移動端友好的 DateSelect 組件#5604 子交易支持 Make Transfer 菜單#5574 提升標簽tags可讀性。工具提示#5475 為 Tooltip 組件增加可配置的關閉延遲。重要修復一覽發布說明列出了數十項 Bug 修復按主題歸納如下移動端#5072 修復多賬戶視圖中預覽交易不加載、未分類拆分交易不加載的問題#5415 修復移動端交易鉤子與交易加載體驗#5126 通過 AutoTextSize 增強移動預算表格的響應式文本縮放#5589 移動端未分類交易視圖隱藏轉賬交易#5429 修復移動導航的響應式布局以適配更長文本/翻譯。規則與排期#5529 修復 link schedules 條件的顯示#5600 補充規則頁面對排期的描述條件#5406 排期日期選擇中 add specific days 換行并動態調整數字輸入寬度#5519 修復日期失焦導致其他按鈕全部禁用的問題。報表與預算#5520 修復匯總報表中負數顯示#5495 修復實時報表日期模式不支持兩個月窗口的問題#5573 修復日歷報表卡片渲染循環#5608 修復按金額過濾時崩潰#5526 修復交易表中偶爾選中隱藏分類的問題#5496 當 to budget 為負時隱藏 hold for next month 選項#5594 修復部分堆疊模板條件下 by template 計算不正確的問題#5541 修復 SpendingCard 崩潰。賬戶與交易#5462 阻止賬戶關閉到自身#5438 允許基于已關閉賬戶的轉賬收款人進行過濾#5485 與 #5523 修復合并時舊收款人名稱顯示#5460 自定義映射字段缺失時收款人回退到默認值#5418 收款人列超長名稱用省略號截斷防溢出#5464 移除批量前置/追加備注時自動添加的空格與規則動作保持一致。翻譯與本地化主要貢獻者 milanalexandre#5396、#5411、#5421、#5471、#5486、#5514、#5549、#5565、#5634 等補齊了規則、報表、排期狀態、關閉賬戶、導入交易彈窗等界面文本的多語言支持。其他#5457 修復系統默認淺色主題下標簽顏色異常#5398 標簽顏色默認改為 null回退到主題色并加強標簽校驗#5579 相同 redux action 已 pending 時避免重復調用數據庫#5623 修復 sync server 在 arm64 Mac 上啟動失敗#5631 修復 Docker 健康檢查腳本#5643 支持 webRoot 位于隱藏目錄如.cache#5659 修復收入彈窗余額不顯示。維護與工程化進展#5379#5566、#5567 移除未使用的依賴包 reselect、sourcemap、processRedux 狀態重構contributor: joel-jeremy#5581 賬戶狀態遷入 accountsSlice、#5592 收款人狀態遷入 payeesSlice、#5593 分類狀態遷入 budgetSlice、#5597 標簽狀態遷入 tagsSlice、#5598 queriesSlice 更名為 transactionsSlice#5576 修復 AutoTextSize 警告#5591 為 Command bar 增加視覺回歸測試VRT#5544 文件為倉庫目錄分配維護負責人#5404 允許 fork 倉庫通過 workflow dispatch 觸發 Docker edge 鏡像構建#5480 合并自動包版本號 workflow#5497 升級 sync-server 依賴。小結與升級建議25.9.0 是 Actual 在移動端體驗、銀行連接生態與自動化功能儲備上的一個關鍵版本移動端規則頁讓手機端也具備完整的規則管理能力Pluggy.ai 連接器為拉美用戶提供了新的銀行同步選項自動化后端與 UI 的打通則為后續版本的完整自動化功能鋪路。升級前建議先備份預算文件可參考 backup-restore 文檔并在實際銀行環境驗證 Pluggy.ai 的可用性后再啟用相關實驗性開關。【免費下載鏈接】actualA local-first personal finance app項目地址: https://gitcode.com/GitHub_Trending/ac/actual創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 Actual Budget 25.9.0 版本解析：移動端規則管理、Pluggy.ai 銀行連接與自動化后端落地
Actual Budget 25.9.0 版本解析移動端規則管理、Pluggy.ai 銀行連接與自動化后端落地【免費下載鏈接】actualA local-first personal finance app項目地址: https://gitcode.com/GitHub_Trending/ac/actualActual 25.9.0 是 Actual Budget本地優先的個人理財應用在 2025 年 9 月發布的穩定版本核心圍繞三大能力展開為移動端補齊規則Rules頁面并提供獨立編輯頁、在報表中顯示實驗性預算貨幣、正式發布實驗性的 Pluggy.ai 銀行連接器。本文基于 官方 25.9.0 發布說明 展開并結合倉庫源碼desktop-client、loot-core、sync-server逐項剖析新特性、增強與修復的底層實現幫助讀者理解每個功能的落地位置與使用方式。版本概覽與升級方式本版本對應的 Docker 標簽為25.9.0發布說明明確該版本包含若干新功能與大量修復。升級時按倉庫根目錄的 Dockerfile 與 docker-compose.yml 構建或拉取25.9.0鏡像即可自托管用戶也可直接使用actualbudget/actual-server:25.9.0鏡像在 sync-server 目錄下同樣提供了 docker-compose.yml 與 Ubuntu/Alpine 兩套 Dockerfile。核心新特性1. 移動端規則頁面查看、管理、編輯一體化自 25.9.0 起Actual 在移動端正式提供了規則Rules頁面用戶可以在手機上查看、篩選、創建、編輯和刪除規則。這一系列改動由多個 PR 組成#5390新增移動端規則頁面用于在移動設備上查看和管理規則#5516將移動端規則編輯抽取為獨立頁面優化導航體驗#5556移動端規則編輯支持通過確認彈窗刪除規則#5587移動端新建規則的默認階段由pre改為default。從源碼看移動端規則列表頁面位于 packages/desktop-client/src/components/mobile/rules/MobileRulesPage.tsx其核心流程為通過send(rules-get)拉取全部規則并監聽undo-event在撤銷后自動刷新列表支持按文本過濾內部使用getNormalisedString歸一化后匹配ruleToString生成的描述文本列表會過濾掉已完成completed的排期關聯規則點擊規則跳轉到/rules/{rule.id}編輯頁MobileRuleEditPage.tsx刪除規則調用rule-delete-all若規則與排期關聯導致刪除失敗會彈出 warning 通知成功刪除則展示可撤銷Undo提示。配套的 UI 組件還包括 AddRuleButton.tsx、RulesList.tsx 與 RulesListItem.tsx。在桌面端#5543為移動端獨立編輯頁提供了組件基礎。2. 報表頁面顯示實驗性預算貨幣#5283 為報表Reports頁面增加了貨幣顯示能力使實驗性預算experimental budget中的貨幣得以展示。該功能與實驗性功能開關聯動用戶需先在設置中啟用相關實驗選項報表才會體現對應的貨幣單位。3. 正式發布實驗性 Pluggy.ai 銀行連接器#5628 將 Pluggy.ai 銀行同步集成正式納入實驗性發布。Pluggy.ai 是面向拉丁美洲金融市場的銀行連接服務作為 GoCardless 之外的又一銀行數據源選項。從 sync-server 源碼可以看到完整的服務端接入路由掛載于/pluggyai見 sync-server/src/app.tsapp.use(/pluggyai, pluggai.handlers)處理器實現位于 app-pluggyai/app-pluggyai.js提供三個接口POST /pluggyai/status返回當前憑據來源per-budget-file/global/ 未配置POST /pluggyai/accounts按 itemId 拉取賬戶列表POST /pluggyai/transactions按賬戶與起始日期拉取交易區分已入賬booked與待處理pending交易并計算起始余額。SDK 封裝位于 pluggyai-service.js基于pluggy-sdk的PluggyClient實現憑據通過 secrets-service.js 存儲支持全局與按預算文件兩種憑據作用域。代碼中還有若干細節值得注意信用卡CREDIT賬戶的金額會做符號反轉trans.amount * -1起始余額同樣取負信用卡分期installment交易會通過addMonthsClamped按分期期數修正交易日期避免 31 日加月跳月的邊界問題Pluggy 沙箱數據賬戶 owner 為John Doe會將起始日期強制設為2000-01-01以便拉取全部歷史數據。需要說明的是Pluggy.ai 連接器目前仍為實驗性功能其可用性、機構覆蓋范圍與穩定程度以官方后續發布為準在使用前請確認你的銀行機構是否在 Pluggy 覆蓋范圍內。4. 自動化的后端基礎與 UI 連接25.9.0 還為預算自動化Automations功能埋下了地基#5532 增加支持自動化 UI 的后端邏輯#5533 將自動化 UI 與后端打通。從源碼看loot-core 側暴露了budget/get-category-automations與budget/set-category-automations兩個方法見 loot-core/src/server/budget/app.ts分別對應goalActions.getTemplatesForCategory與goalActions.storeTemplates桌面端則在 BudgetAutomationsModal 目錄下實現了完整的自動化編輯界面AutomationEditorPane、AutomationListRow、CleanupListRow、ConflictBanner 等并配套 BudgetAutomationsModal.test.ts 測試。該功能同樣屬于實驗性范疇需在設置中開啟后使用。增強項解讀25.9.0 包含多項面向使用體驗的增強報表時間范圍#5419通過getLiveRange以priorYearToDate模式計算范圍與已有的 Year to date、Last month、Current quarter 等預設并列展示在報表日期范圍選擇器中。排期相關#5482 在即將到來的交易upcoming transactions備注中顯示排期名稱#5580 將其限定為僅在即將到來的交易中展示。對賬體驗#5521 對賬窗口同時展示絕對日期如08/08/2025與相對日期如3 days ago#5528 修復了對賬窗口中的數學計算錯誤Bug #5527。余額歷史圖開關#5452 為側邊欄賬戶懸停提示中的余額歷史圖新增顯隱開關。銀行同步細節#5458 銀行同步頁面對最近一次同步時間提供更詳細的懸停提示#5479 新增瑞典銀行 L?nsf?rs?kringar有限歷史的 GoCardless 解析支持#5383 為慕尼黑 Stadtsparkasse 的 GoCardless 交易解析補充了交易信息到備注。貨幣擴展新增卡塔爾里亞爾#5456、波蘭茲羅提#5472、瑞典克朗與土耳其里拉#5477、印度盧比#5483、菲律賓比索#5507。導入#5461 支持從 nYNAB 導入分類備注。移動端#5605 預算橫幅顯示未分類/超支總額#5607 移動端友好的 DateSelect 組件#5604 子交易支持 Make Transfer 菜單#5574 提升標簽tags可讀性。工具提示#5475 為 Tooltip 組件增加可配置的關閉延遲。重要修復一覽發布說明列出了數十項 Bug 修復按主題歸納如下移動端#5072 修復多賬戶視圖中預覽交易不加載、未分類拆分交易不加載的問題#5415 修復移動端交易鉤子與交易加載體驗#5126 通過 AutoTextSize 增強移動預算表格的響應式文本縮放#5589 移動端未分類交易視圖隱藏轉賬交易#5429 修復移動導航的響應式布局以適配更長文本/翻譯。規則與排期#5529 修復 link schedules 條件的顯示#5600 補充規則頁面對排期的描述條件#5406 排期日期選擇中 add specific days 換行并動態調整數字輸入寬度#5519 修復日期失焦導致其他按鈕全部禁用的問題。報表與預算#5520 修復匯總報表中負數顯示#5495 修復實時報表日期模式不支持兩個月窗口的問題#5573 修復日歷報表卡片渲染循環#5608 修復按金額過濾時崩潰#5526 修復交易表中偶爾選中隱藏分類的問題#5496 當 to budget 為負時隱藏 hold for next month 選項#5594 修復部分堆疊模板條件下 by template 計算不正確的問題#5541 修復 SpendingCard 崩潰。賬戶與交易#5462 阻止賬戶關閉到自身#5438 允許基于已關閉賬戶的轉賬收款人進行過濾#5485 與 #5523 修復合并時舊收款人名稱顯示#5460 自定義映射字段缺失時收款人回退到默認值#5418 收款人列超長名稱用省略號截斷防溢出#5464 移除批量前置/追加備注時自動添加的空格與規則動作保持一致。翻譯與本地化主要貢獻者 milanalexandre#5396、#5411、#5421、#5471、#5486、#5514、#5549、#5565、#5634 等補齊了規則、報表、排期狀態、關閉賬戶、導入交易彈窗等界面文本的多語言支持。其他#5457 修復系統默認淺色主題下標簽顏色異常#5398 標簽顏色默認改為 null回退到主題色并加強標簽校驗#5579 相同 redux action 已 pending 時避免重復調用數據庫#5623 修復 sync server 在 arm64 Mac 上啟動失敗#5631 修復 Docker 健康檢查腳本#5643 支持 webRoot 位于隱藏目錄如.cache#5659 修復收入彈窗余額不顯示。維護與工程化進展#5379#5566、#5567 移除未使用的依賴包 reselect、sourcemap、processRedux 狀態重構contributor: joel-jeremy#5581 賬戶狀態遷入 accountsSlice、#5592 收款人狀態遷入 payeesSlice、#5593 分類狀態遷入 budgetSlice、#5597 標簽狀態遷入 tagsSlice、#5598 queriesSlice 更名為 transactionsSlice#5576 修復 AutoTextSize 警告#5591 為 Command bar 增加視覺回歸測試VRT#5544 文件為倉庫目錄分配維護負責人#5404 允許 fork 倉庫通過 workflow dispatch 觸發 Docker edge 鏡像構建#5480 合并自動包版本號 workflow#5497 升級 sync-server 依賴。小結與升級建議25.9.0 是 Actual 在移動端體驗、銀行連接生態與自動化功能儲備上的一個關鍵版本移動端規則頁讓手機端也具備完整的規則管理能力Pluggy.ai 連接器為拉美用戶提供了新的銀行同步選項自動化后端與 UI 的打通則為后續版本的完整自動化功能鋪路。升級前建議先備份預算文件可參考 backup-restore 文檔并在實際銀行環境驗證 Pluggy.ai 的可用性后再啟用相關實驗性開關。【免費下載鏈接】actualA local-first personal finance app項目地址: https://gitcode.com/GitHub_Trending/ac/actual創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考