市场报告技能

生成一份结构化的全球市场快照报告，包含股票指数与大宗商品数据。

架构 / 职责划分

采用双层设计：

1. scripts/fetch_market.sh 是一个原始数据获取辅助脚本。
2. 调用方（caller）或智能体（agent）负责解析、计算、回退决策及最终格式化。

辅助脚本职责：

• 获取原始 Yahoo Finance 数据载荷。
• 获取并解码支持的中国股市代码（tickers）对应的原始新浪财经（Sina Finance）数据载荷。
• 成功时，将原始源响应输出至 stdout。
• 失败时，将诊断信息写入 stderr，并以非零退出码退出。

调用方职责：

• 按下方回退顺序选择数据源。
• 从返回的 JSON 中解析 Yahoo Finance 的收盘价数组（close arrays）。
• 在 scripts/fetch_market.sh 外部单独获取并解析 Trading Economics 页面。
• 从解码后的 Sina Finance 响应文本中解析数值字段。
• 计算涨跌值（change）与涨跌幅（percent）。
• 格式化最终市场报告。

scripts/fetch_market.sh 不对市场数据载荷进行解析以生成最终数值结果。

数据源支持与回退顺序

1. Yahoo Finance（主用）—— 速度快、覆盖广
2. Trading Economics（多数指数的高层级回退方案）
3. Sina Finance（仅针对支持的中国股市代码，在辅助脚本层面提供回退支持）

若 Yahoo Finance 请求失败（如遭遇限频、错误或无数据），应在调用工作流中启用 Trading Economics 作为回退方案。
scripts/fetch_market.sh 仅支持 yahoo 和 sina 模式，不实现 te 模式。
对于 STAR Market Composite（科创综指），应优先使用 Sina Finance 作为辅助脚本回退方案。
调用方应将非零退出码视为辅助脚本失败，并从 stderr（而非 stdout）读取诊断信息。

主用：Yahoo Finance

代码符号（Ticker Symbols）

请严格使用以下代码符号：

• 标普500指数（S&P 500）：^GSPC
• 道琼斯工业平均指数（Dow Jones）：^DJI
• 纳斯达克综合指数（NASDAQ）：^IXIC
• 上证综指（SSE Composite）：000001.SS
• 深证成指（Shenzhen Component）：399001.SZ
• 科创板综合指数（STAR Market）：000680.SS（注意：不是 000688.SS）
• 日经225指数（Nikkei 225）：^N225
• 印度孟买敏感指数（Sensex）：^BSESN
• 黄金（Gold）：GC=F
• 白银（Silver）：SI=F
• 原油（Crude Oil）：CL=F
• 铜（Copper）：HG=F

查询方式

使用 scripts/fetch_market.sh yahoo 或等效的 curl 命令获取原始 Yahoo Finance JSON：

curl -s "https://query1.finance.yahoo.com/v8/finance/chart/{TICKER}?interval=1d&range=5d" -H "User-Agent: Mozilla/5.0"

调用方必须自行解析返回的 JSON 并计算所需数值。

回退：Trading Economics

若 Yahoo Finance 失败，请在调用工作流中直接通过网页抓取 Trading Economics 数据，而非经由 scripts/fetch_market.sh：

指数对应 URL

• 美国（S&P 500）：https://tradingeconomics.com/united-states/stock-market
• 中国（上证）：https://tradingeconomics.com/china/stock-market
• 中国（深证）：https://tradingeconomics.com/china/stock-market（同一页，但展示不同数据）
• 日本（日经）：https://tradingeconomics.com/japan/stock-market
• 印度（Sensex）：https://tradingeconomics.com/india/stock-market

从 Trading Economics 提取数据

调用方需获取页面内容并提取：

• Actual（当前值）：最新报价（例如：6762.88）
• Previous（前值）：前一交易日收盘价（例如：6830.71）

需计算：

• 涨跌值（Change） = Actual − Previous
• 涨跌幅（Percent） = (Change / Previous) × 100

来自美国页面的示例：

Actual: 6762.88
Previous: 6830.71
Change: 6762.88 - 6830.71 = -67.83
Percent: -67.83 / 6830.71 * 100 = -0.99%

回退：新浪财经（Sina Finance）（scripts/fetch_market.sh 支持）

若 Yahoo Finance 对下列支持的中国股市代码失败，请使用 scripts/fetch_market.sh sina：

• 上证综指（SSE Composite）：000001.SS → sh000001
• 深证成指（Shenzhen Component）：399001.SZ → sz399001
• 科创板综合指数（STAR Market Composite）：000680.SS → sh000680

特别地，对于 STAR Market Composite，此为首选的辅助脚本回退方案。

查询方式

curl -s "https://hq.sinajs.cn/list=sh000680" 
  -H "User-Agent: Mozilla/5.0" 
  -H "Referer: https://finance.sina.com.cn" | iconv -f GB2312 -t UTF-8

scripts/fetch_market.sh 遵循上述请求模式，并在可用时使用 iconv 解码。它返回已解码的原始响应文本；调用方须自行解析其中的数值字段。

响应格式

var hq_str_sh000680="科创综指,open,prev_close,low,high,close,...

数据提取

调用方须解析响应以提取：

• 名称（Name）： 科创综指（STAR Market Composite）
• 当前价（Current）： 第6个字段（收盘价）
• 前收盘价（Previous）： 第3个字段（前一交易日收盘价）

示例：

科创综指,1771.6386,1774.0261,1744.2182,1782.4838,1744.0835,...
                                         ↑            ↑
                                     previous      current
Change: 1744.0835 - 1774.0261 = -29.94
Percent: -29.94 / 1774.0261 * 100 = -1.69%

关键点：Yahoo Finance 日度涨跌计算

切勿使用 chartPreviousClose —— 该字段在亚洲市场中常不准确。

对于中国指数（SSE、深证成指、STAR Market），调用方必须：

1. 使用 range=5d 参数发起查询，以获取多个交易日的数据
2. 从返回载荷中解析 indicators.quote[0].close 数组
3. 定位最后一个非空的 close 值 —— 即今日收盘价
4. 定位倒数第二个非空的 close 值 —— 即前一交易日收盘价
5. 计算：今日收盘价 − 前一交易日收盘价 = 涨跌值（Change）

上证综指示例：

close 数组：[4182.59, 4122.68, 4082.47, 4108.57, 4124.19]
                                                      ↑ 今日（最后一个）
                                                  ↑ 前一日（倒数第二个）
Change: 4124.19 - 4108.57 = +15.62

输出格式

完成解析与计算后，须严格按如下格式生成报告，并附带时间戳：

Latest snapshot from the `market-global-snapshot` skill, generated at `UTC timestamp` and `China time`.

📊 股票指数：

- 🇺🇸 S&P 500: `price` 📈/📉 `change` (`percent`)
- 🇺🇸 道琼斯工业平均指数：`price` 📈/📉 `change` (`percent`)
- 🇺🇸 纳斯达克综合指数：`price` 📈/📉 `change` (`percent`)

- 🇨🇳 上证综指：`price` 📈/📉 `change` (`percent`)
- 🇨🇳 深证成指：`price` 📈/📉 `change` (`percent`)
- 🇨🇳 科创板综合指数：`price` 📈/📉 `change` (`percent`)

- 🇯🇵 日经225指数：`price` 📈/📉 `change` (`percent`)

- 🇮🇳 孟买敏感指数（Sensex）：`price` 📈/📉 `change` (`percent`)

🛢️ 大宗商品：

- 🟡 黄金：`price USD / troy oz` 📈/📉 `change` (`percent`)
- ⚪ 白银：`price USD / troy oz` 📈/📉 `change` (`percent`)
- 🛢️ 原油：`price USD / barrel` 📈/📉 `change` (`percent`)
- 🟠 铜：`price USD / lb` 📈/📉 `change` (`percent`)

错误处理

若 Yahoo Finance、Trading Economics 与 Sina Finance 全部失败：

1. 返回已有数据的子集（partial data）
2. 将不可用数据项标记为 N/A
3. 在报告末尾添加错误提示：“⚠️ Some data unavailable due to API errors”

请分别对待数据源获取失败与解析失败：若原始数据不可用或无法解析，调用方应将该项标记为 N/A。

历史数据

若需获取前一日（而非当日）数据，调用方应：

• 使用 close 数组中的倒数第二个值（而非最后一个）
• 当请求“昨日”数据时，此即为默认行为

示例：

close 数组：[4124.19, 4108.57, 4082.47, 4122.68, 4182.59]
                                        ↑            ↑
                                   昨日         今日

格式化规则

• 所有数字保留两位小数
• 价格数值需用反引号（`）包裹
• 正值使用 📈，负值使用 📉
• 涨跌值（change）需显式标注 + 或 - 符号
• 百分比需置于括号内，并带 % 符号