投資組合追蹤技能
一個完全在本機執行的投資組合追蹤工具。所有資料都儲存在 ~/.portfolio-tracker/ 中。
架構
- 資料:
~/.portfolio-tracker/data.json(投資組合、資產、價格) - 設定:
~/.portfolio-tracker/config.json(API 金鑰、錢包位址、使用者設定檔) - 腳本:TypeScript CLI 工具,位於
<skill-path>/scripts/,透過npx tsx執行
首次設定
在執行任何腳本之前,請確保已安裝相依套件:
npm install --prefix <skill-path>/scripts
將 <skill-path> 替換為此技能的實際安裝路徑。
腳本運作方式
每個腳本都是獨立的 CLI 工具。請使用以下方式執行:
npx tsx <skill-path>/scripts/<script>.ts <command> [args]
腳本在需要時會從標準輸入讀取資料,並將 JSON 輸出到標準輸出。
data-store.ts
load— 讀取投資組合資料(若遺失則建立預設值)save— 寫入投資組合資料(從標準輸入讀取 JSON)load-config— 讀取設定save-config— 寫入設定(從標準輸入讀取 JSON)
fetch-prices.ts
crypto <symbol>— 取得加密貨幣價格(Binance → CoinGecko)stock <symbol>— 取得股票價格(Yahoo Finance)fx— 取得 USD/CNY/HKD 匯率historical <symbol>— 取得 3 年月度歷史資料search <query>— 依名稱或代號搜尋資產refresh— 批次重新整理價格(從標準輸入讀取資產 JSON)
binance-sync.ts
sync <apiKey> <apiSecret>— 擷取所有 Binance 餘額(6 種帳戶類型)validate <apiKey> <apiSecret>— 驗證 API 憑證
ibkr-sync.ts
sync <token> <queryId>— 透過 Flex Query 擷取 IBKR 持倉validate <token> <queryId>— 驗證 IBKR 憑證
blockchain-sync.ts
sync <address> [chain]— 擷取錢包餘額(單一鏈或全部 5 條 EVM 鏈)validate <address>— 驗證 EVM 位址
資料類型
資產
{
"id": "unique-id",
"type": "CRYPTO | USSTOCK | HKSTOCK | ASHARE | CASH",
"symbol": "BTC",
"name": "Bitcoin",
"quantity": 1.5,
"avgPrice": 40000,
"currentPrice": 50000,
"currency": "USD | CNY | HKD",
"transactions": [],
"source": { "type": "manual | binance | wallet | ibkr" }
}
投資組合
{
"id": "unique-id",
"name": "Main",
"assets": [...]
}
工作流程模式
檢視投資組合
- 透過
data-store.ts load載入資料 - 依
currentPortfolioId找到當前投資組合 - 使用
quantity * currentPrice計算每個資產的總價值 - 使用
exchangeRates轉換為顯示幣別 - 以格式化表格呈現
新增資產
- 載入資料
- 使用
fetch-prices.ts search <query>搜尋資產 - 透過
fetch-prices.ts crypto/stock <symbol>取得當前價格 - 使用產生的唯一 ID 將資產加入當前投資組合
- 儲存資料
重新整理價格
- 載入資料
- 將當前投資組合的資產透過標準輸入傳遞給
fetch-prices.ts refresh - 同時執行
fetch-prices.ts fx取得匯率 - 更新每個資產的
currentPrice以及exchangeRates - 將
lastPriceRefresh設為目前的 ISO 時間戳 - 儲存資料
從交易所/錢包同步
- 載入設定以取得憑證
- 執行對應的同步腳本
- 合併結果:更新既有資產(依 symbol+source 配對),新增資產
- 儲存資料
指令
可用的使用者指令:
/portfolio— 檢視與管理投資組合/prices— 重新整理所有價格/setup— 設定 API 金鑰與錢包/sync-binance— 從 Binance 同步/sync-ibkr— 從 Interactive Brokers 同步/sync-wallet— 從區塊鏈錢包同步/advise— 取得 AI 投資建議