投资组合追踪器
一个用于追踪股票和加密货币投资组合的 CLI 工具,支持实时价格、盈亏和股息追踪。
何时使用此技能
在需要以下操作时使用此技能:
- 在本地追踪股票和加密货币持仓
- 获取实时价格和盈亏
- 追踪股息收益率、成本收益率和预计收入
- 查看即将到来的除息日
- 管理多个投资组合
- 将投资组合数据导出为 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 "Portfolio Name"
npx tsx portfolio.ts create "New Portfolio"
提示: 运行 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 # 启动 Web UI(可选)
npm run build # 构建生产版本
Web UI(可选)
您还可以运行一个可选的 Web 界面,支持完整的股息追踪功能:
npm run dev
Web UI 功能:
- 实时投资组合价值和盈亏追踪
- 股息总结卡片(年收入、加权收益率、YOC、即将到来的日期)
- 每只股票的详细股息分解表
- 即将到来的除息日可视化日历
- 投资组合分配的交互式饼图
数据存储
投资组合数据本地存储在 data/portfolio.json 中。首次运行时,会自动创建一个空的投资组合数据文件。
功能特点
- 通过 Yahoo Finance API 获取实时股票价格
- 通过 CoinGecko API 获取实时加密货币价格
- 支持多个投资组合
- 每个持仓的盈亏追踪
- 股息追踪(收益率、YOC、预计收入、除息日)
- CLI 和可选的 Web 界面