投資組合追蹤器
一套 CLI 工具,用於追蹤股票與加密貨幣投資組合,提供即時價格、損益(P&L)與股利管理功能。
何時使用此技能
當您需要以下功能時,可使用此技能:
- 在本機追蹤股票與加密貨幣持倉
- 取得即時價格與損益
- 追蹤股利收益率、成本收益率(YOC)與預估收益
- 查看即將到來的除息日期
- 管理多個投資組合
- 將投資組合資料匯出為 CSV
工具
此技能提供以下功能:
1. 列出持倉
顯示所有持倉的當前價值與損益。
指令:
npx tsx portfolio.ts list
2. 新增持倉
新增一筆股票或加密貨幣持倉。
指令:
npx tsx portfolio.ts add <symbol> <quantity> <price> <name> [type]
範例:
npx tsx portfolio.ts add AAPL 10 150 "Apple Inc." stock
npx tsx portfolio.ts add BTC 0.5 45000 Bitcoin crypto
3. 賣出持倉
使用 FIFO(先進先出)成本基礎法賣出股份。
指令:
npx tsx portfolio.ts sell <symbol> <quantity> <price> [date]
範例:
npx tsx portfolio.ts sell AAPL 5 180 2025-06-01
npx tsx portfolio.ts sell BTC 0.25 50000
4. 交易歷史
查看所有持倉或特定標的的賣出歷史。
指令:
npx tsx portfolio.ts history [symbol]
範例:
npx tsx portfolio.ts history
npx tsx portfolio.ts history AAPL
5. 損益摘要
顯示已實現與未實現的損益。
指令:
npx tsx portfolio.ts pnl
6. 股利追蹤
查看股票持倉的詳細股利資訊,包含收益率、成本收益率(YOC)與預估年收益。
指令:
npx tsx portfolio.ts dividends
7. 股利摘要
顯示投資組合層級的股利摘要:總預估收益、加權平均收益率與成本收益率。
指令:
npx tsx portfolio.ts dividend-summary
輸出包含:
- 總預估年收益
- 每月/每季收益估計
- 所有持倉的加權平均收益率
- 投資組合成本收益率
- 配息股票數量
8. 股利行事曆
查看持倉的即將到來除息日期。
指令:
npx tsx portfolio.ts calendar [days]
範例:
npx tsx portfolio.ts calendar # 未來 30 天
npx tsx portfolio.ts calendar 60 # 未來 60 天
9. 列出含股利
list 指令會自動擷取股利資料。使用 --no-dividends 標記可略過。
指令:
npx tsx portfolio.ts list # 包含股利資訊
npx tsx portfolio.ts list --no-dividends # 略過股利
10. 移除持倉
按標的符號移除持倉。
指令:
npx tsx portfolio.ts remove <symbol>
11. 投資組合價值
顯示總投資組合價值與損益。
指令:
npx tsx portfolio.ts value
12. 管理投資組合
列出、切換或建立投資組合。
指令:
npx tsx portfolio.ts portfolios
npx tsx portfolio.ts switch "投資組合名稱"
npx tsx portfolio.ts create "新投資組合"
提示: 執行 npm link 後,您可以使用較短的 portfolio 指令代替 npx tsx portfolio.ts。
安裝
首先,安裝所需的相依套件:
npm install
這將安裝所有必要套件,包含 TypeScript 執行環境 (tsx)、Next.js、React,以及 package.json 中列出的其他相依套件。
選擇性: 全域連結 CLI 以便更輕鬆存取:
npm link
連結後,您可以使用 portfolio <command> 代替 npx tsx portfolio.ts <command>。
NPM 腳本
npm run dev # 啟動網頁介面(選擇性)
npm run build # 建置正式環境
網頁介面(選擇性)
您也可以執行選擇性的網頁介面,支援完整的股利追蹤功能:
npm run dev
網頁介面功能:
- 即時投資組合價值與損益追蹤
- 股利摘要卡片(年收益、加權收益率、YOC、即將到來日期)
- 每檔股票的詳細股利細項表格
- 即將到來除息日期的視覺化行事曆
- 投資組合配置的互動式圓餅圖
資料儲存
投資組合資料儲存在本機的 data/portfolio.json 中。首次執行時會自動建立資料檔案,並包含空的投資組合。
功能特色
- 透過 Yahoo Finance API 取得即時股價
- 透過 CoinGecko API 取得即時加密貨幣價格
- 支援多個投資組合
- 每筆持倉的損益追蹤
- 股利追蹤(收益率、YOC、預估收益、除息日期)
- CLI 與選擇性網頁介面