Ray

Ray 是什麼？

Ray 是開源 AI 理財顧問，連接你的銀行資料來回答問題，並協助你分析支出、儲蓄目標與財務健康。其核心目的是基於你的實際帳戶與交易歷史提供建議，同時讓助理在本機運行。

Ray 設計用來「了解你的完整情況」，透過持續追蹤你的家庭、收入、目標、風險承受度與關鍵決策，建立持久化個人檔案。當你的情況改變時，它會更新該脈絡，讓後續建議反映先前的狀況。

主要功能

• 本地 AI 理財顧問：在你自己的機器上運行助理（無需註冊或應用商店安裝），讓你從本地環境獲得建議。
• 透過 Plaid 連接銀行資料：安全透過 Plaid 連結帳戶，使用真實餘額與交易作為回答基礎。
• 持久化使用者檔案（「記住一切」）：持續記錄你的目標、偏好、生活事件與過去決策，讓建議隨時間演進，而非從通用假設重新開始。
• 30+ 種理財工具，用於真實資料查詢與計算：助理查詢連結的財務資料、執行計算，並用結果回應問題（例如預測、淨值、異常檢查）。
• 基於實際交易的支出與目標分析：根據觀察到的收入/支出模式，獲得關於負擔能力及選擇如何影響餘額與貢獻的回應。
• 行為評分與連續紀錄：每日 0–100 行為評分，搭配連續紀錄與解鎖成就，連結支出/紀律模式（例如無用餐日、零支出日）。

如何使用 Ray

1. 安裝 Ray：使用 npm 指令 npm install -g ray-finance。
2. 連接銀行：使用 ray link 透過 Plaid 連結帳戶。
3. 在 Ray 介面提問（使用 ray status/ray 啟動，如所示），詢問支出、儲蓄目標、帳戶總額或負擔能力。Ray 會使用連結資料回答。

使用情境

• 購買或旅行前的負擔能力檢查：詢問是否負擔得起旅行，考量實際收入/支出模式，以及對帳戶餘額與貢獻的影響。
• 基於真實利率與現金流的債務清償規劃：使用 Ray 納入目前資金流向，並在有約束（如即將到來的家庭活動）時建議債務優先順序。
• 跨連結帳戶的淨值快照：要求淨值；Ray 從支票、儲蓄、信用卡與貸款等帳戶拉取餘額，提供單一更新數字。
• 租金或住房「收入百分比」檢視：詢問租金是否過高，使用稅後收入與帳戶數字計算住房佔比，並評估生活情況變化時的調整。
• 偵測異常或意外帳戶活動：要求掃描近期交易異常，找出如意外費用或重複付款等項目。

常見問題

• Ray 需要註冊嗎？ 安裝流程使用 npm 指令，並說明「無帳戶、無註冊、無應用商店」。

• Ray 如何取得我的財務資料？ Ray 透過 Plaid 連接銀行帳戶，使用安全連結與加密。

• Ray 是儀表板還是聊天機器人？ 頁面將 Ray 與儀表板、聊天機器人區分，呈現為「理財大腦」，查詢真實財務資料並執行如計算等動作。

• Ray 如何維持建議的一致性？ Ray 持續追蹤你的目標、偏好、生活事件與過去決策，讓後續對話建立在前次基礎上。

• 我能要求什麼類型的輸出？ 範例包括儲蓄目標預測、旅行負擔能力、每日行為評分、淨值總計，以及異常交易掃描。

替代方案

• 個人理財預算應用程式，具交易分類：儀表板工具可總結支出，但可能無法提供決策導向建議或本地、資料驅動對話。
• 試算表式規劃：試算表可模擬債務清償時程與預測，但使用者常需自行維護公式與分析，而非讓助理查詢即時帳戶資料。
• 無直接銀行整合的聊天式理財問答：通用助理可回答問題，但通常不會如 Ray 透過 Plaid 與本地工具般，納入實際連結餘額與交易歷史。