核心用法
portfolio-monitor 是一款基于 Python 的本地投资组合监控工具，通过调用 Yahoo Finance API（yfinance 库）获取实时行情数据，帮助用户管理多资产类别的持仓信息。
典型使用流程：
1. 安装依赖：pip3 install yfinance
2. 配置 memory/portfolio.json 录入持仓标的、数量、成本价及币种
3. 运行脚本即可获取实时市值、盈亏金额、盈亏比例及组合汇总报告
支持资产类型：
- 港股（如 0700.HK）
- 美股（如 AAPL）
- 加密货币（如 BTC-USD）
显著优点
| 优势 | 说明 |
|------|------|
| **零成本** | 依赖免费开源库，无订阅费用 |
| **隐私优先** | 本地运行，持仓数据不上传第三方 |
| **轻量便捷** | 单脚本 + JSON 配置，无需复杂数据库 |
| **多币种支持** | 自动处理不同币种持仓的汇总展示 |
| **可定制提醒** | 支持设置涨跌幅阈值触发提醒 |
潜在缺点与局限性
1. 数据可靠性依赖第三方：yfinance 非官方 API，存在数据延迟、接口变更或限速风险
2. 无历史回测功能：仅提供快照式监控，缺乏收益曲线、最大回撤等深度分析
3. 手动维护成本：新增交易需手动更新 JSON，无交易记录自动同步
4. 汇率处理简化：多币种组合可能未实现实时汇率换算，存在估值偏差
5. 无移动端支持：纯 CLI/脚本输出，无推送通知或 App 体验
适合人群
- 初级投资者：持仓品种简单（<20 只），需要基础盈亏追踪
- 隐私敏感用户：不愿将真实持仓上传至券商或第三方记账 App
- 技术爱好者：愿意维护本地配置，接受 CLI 交互方式
- 多市场散户：同时持有港股、美股、加密货币，希望统一视图
常规风险
| 风险类别 | 说明 |
|---------|------|
| **数据风险** | Yahoo Finance 数据可能存在 15 分钟延迟，极端行情下价格失真 |
| **依赖风险** | `yfinance` 库更新可能导致 API 失效，需关注维护状态 |
| **操作风险** | 手动输入持仓易出错，成本价录入错误将误导盈亏计算 |
| **合规提示** | 工具明确声明"不构成投资建议"，用户需独立判断 |
| **安全建议** | 定期备份 `portfolio.json`，避免持仓数据丢失 |
---
> 总结：该 skill 是入门级的个人投资看板工具，胜在轻量、免费、隐私友好，但功能深度有限，不适合需要专业级资产分析、自动化交易或机构级风险管理的用户。