市场追踪技能

该技能可帮助您获取最新报价和历史数据序列适用于：

• 股票 / ETF / 指数 (例如，AAPL, MSFT, ^GSPC, VOO)
• 外汇货币对 (例如，USD/ZAR, EURUSD, GBP-JPY)
• 所选数据提供商支持的加密货币代码（尽力而为）

其优化方向为：

• 快速的“当前价格是多少？”查询
• 使用本地观察列表进行轻量级追踪
• 缓存以避免访问频率限制

何时使用

当用户询问时使用此技能：

• “___的最新价格是多少？”
• “追踪___和___并显示每日变化。”
• “给我___的30天数据序列。”
• “将美元兑换成南非兰特（或追踪USD/ZAR）。”
• “维护一个观察列表并总结表现。”

数据提供商策略（重要）

• 股票/ETF/指数默认：通过yfinance使用雅虎财经（无需密钥，覆盖广泛），但它是非官方接口，可能受到频率限制。
• 外汇默认：ExchangeRate-API 开放访问端点（无需密钥，每日更新）。
• 如果用户需要高频数据或大量货币对，建议后续添加付费提供商。

详情及代码格式请参见providers.md文件。

快速开始（运行方法）

这些脚本旨在从终端运行。代理应：

1. 确保依赖项已安装
2. 运行脚本
3. 简洁汇总结果

安装：

• python -m venv .venv && source .venv/bin/activate（或 Windows 等效命令）
• pip install -r requirements.txt

命令

1) 最新报价（股票/ETF/指数）

示例：

• python scripts/market_quote.py AAPL
• python scripts/market_quote.py ^GSPC
• python scripts/market_quote.py VOO

2) 最新外汇汇率

示例：

• python scripts/market_quote.py USD/ZAR
• python scripts/market_quote.py EURUSD
• python scripts/market_quote.py GBP-JPY

3) 历史数据系列（CSV 格式输出到标准输出）

示例：

• python scripts/market_series.py AAPL --days 30
• python scripts/market_series.py USD/ZAR --days 30

4) 观察列表摘要（本地文件）

• 添加代码：python scripts/market_watchlist.py add AAPL MSFT USD/ZAR
• 删除：python scripts/market_watchlist.py remove MSFT
• 显示摘要：python scripts/market_watchlist.py summary

输出预期（应返回给用户的内容）

• 对于报价：价格、涨跌幅百分比、时间戳/来源，以及任何注意事项（例如“外汇数据每日更新”）。
• 对于数据系列：确认日期范围、数据点数量，并显示小部分预览（开头/结尾几行）。
• 如果遇到速率限制：解释发生了什么，并建议使用退避策略重试或降低请求频率。

安全性 / 正确性

• 除非数据提供商是真正的实时数据，否则切勿声称“实时”。外汇开放访问数据每日更新。
• 始终缓存响应并限制重复调用。
• 如果雅虎屏蔽请求，建议使用付费提供商或增加缓存生存时间。