@rivus/gateway 0.16.2

package/templates/a-share-briefing-analysis.mjs

@@ -0,0 +1,93 @@
+export function analyzeAShareBriefing({ overseasEvidence, quotes, sectorEvidence }) {
+  return Object.freeze({
+    index: Object.freeze(analyzeIndexStructure(quotes)),
+    overseas: Object.freeze(analyzeOverseasStructure(overseasEvidence)),
+    sector: analyzeSectorStructure(sectorEvidence),
+    turnover: quotes
+      .filter(({ symbol }) => symbol === "sh000001" || symbol === "sz399001")
+      .reduce((sum, quote) => sum + quote.amount, 0)
+  });
+}
+
+function analyzeIndexStructure(quotes) {
+  const direction = readDirection(quotes);
+  const ranked = [...quotes].sort((left, right) => right.changePercent - left.changePercent);
+  const strongest = ranked[0];
+  const weakest = ranked.at(-1);
+  const spread = strongest.changePercent - weakest.changePercent;
+  const dispersion = spread >= 1.5 ? "结构分化较大" : spread >= 0.75 ? "存在一定分化" : "表现相对同步";
+  const average = quotes.reduce((sum, quote) => sum + quote.changePercent, 0) / quotes.length;
+  const positive = quotes.filter(({ changePercent }) => changePercent > 0).length;
+  const negative = quotes.filter(({ changePercent }) => changePercent < 0).length;
+  const strength =
+    positive === quotes.length
+      ? "四个指数一致收涨，指数层面的风险偏好偏强。"
+      : negative === quotes.length
+        ? "四个指数一致收跌，指数层面的风险偏好偏弱。"
+        : average >= 0.5
+          ? "多数指数收涨且平均涨幅偏强，但方向并不完全一致。"
+          : average <= -0.5
+            ? "多数指数承压且平均跌幅偏弱，仍需防范弱势扩散。"
+            : "指数涨跌互现，尚未形成一致的市场方向。";
+  const growth = quotes.find(({ name }) => name === "创业板指");
+  const largeCap = quotes.find(({ name }) => name === "沪深 300");
+  const styleGap = growth.changePercent - largeCap.changePercent;
+  const style =
+    styleGap >= 0.5
+      ? `创业板指较沪深 300 高 ${formatPercentagePoint(styleGap)}，成长风格相对占优。`
+      : styleGap <= -0.5
+        ? `沪深 300 较创业板指高 ${formatPercentagePoint(-styleGap)}，大盘风格相对占优。`
+        : "创业板指与沪深 300 表现接近，暂未形成清晰的成长/大盘偏向。";
+  const risk =
+    spread >= 1.5
+      ? `最强与最弱指数相差 ${formatPercentagePoint(spread)}，单看综合指数可能掩盖明显分化。`
+      : `最强与最弱指数相差 ${formatPercentagePoint(spread)}，指数间分化暂时可控。`;
+  return { direction: `四个宽基指数 ${direction}`, dispersion, risk, strength, strongest, style, weakest };
+}
+
+function analyzeOverseasStructure(evidence) {
+  if (!evidence) {
+    return {
+      conclusion: "隔夜海外指数数据不可用，外部风险背景待开盘数据确认",
+      direction: undefined,
+      inference: "海外指数数据不可用，不补写外部市场判断。"
+    };
+  }
+  const direction = readDirection(evidence.quotes);
+  const average = evidence.quotes.reduce((sum, quote) => sum + quote.changePercent, 0) / evidence.quotes.length;
+  const conclusion = `隔夜美股 ${direction}，外部风险背景${average >= 0.3 ? "偏积极" : average <= -0.3 ? "偏谨慎" : "偏中性"}`;
+  const nasdaq = evidence.quotes.find(({ symbol }) => symbol === "usIXIC");
+  const sp500 = evidence.quotes.find(({ symbol }) => symbol === "usINX");
+  const gap = nasdaq.changePercent - sp500.changePercent;
+  const relative =
+    gap >= 0.3
+      ? `纳斯达克较标普 500 高 ${formatPercentagePoint(gap)}，海外科技风险偏好相对更强。`
+      : gap <= -0.3
+        ? `纳斯达克较标普 500 低 ${formatPercentagePoint(-gap)}，海外科技风险偏好相对更弱。`
+        : "纳斯达克与标普 500 表现接近，海外科技风格未显示明显偏离。";
+  return { conclusion, direction, inference: `${conclusion}。${relative}` };
+}
+
+function analyzeSectorStructure(evidence) {
+  if (!evidence) return "行业数据不可用，不补写行业主线判断。";
+  const leaders = evidence.leaders
+    .slice(0, 2)
+    .map(({ name }) => name)
+    .join("、");
+  const laggards = evidence.laggards
+    .slice(0, 2)
+    .map(({ name }) => name)
+    .join("、");
+  return `领涨端集中在${leaders}，领跌端集中在${laggards}；这只描述行业横截面强弱，不构成市场涨跌的驱动归因。`;
+}
+
+function readDirection(quotes) {
+  const positive = quotes.filter(({ changePercent }) => changePercent > 0).length;
+  const negative = quotes.filter(({ changePercent }) => changePercent < 0).length;
+  const flat = quotes.length - positive - negative;
+  return `${positive} 涨 ${negative} 跌${flat > 0 ? ` ${flat} 平` : ""}`;
+}
+
+function formatPercentagePoint(value) {
+  return `${value.toFixed(2)} 个百分点`;
+}

package/templates/a-share-briefing-renderer.mjs

@@ -0,0 +1,257 @@
+import { analyzeAShareBriefing } from "./a-share-briefing-analysis.mjs";
+
+const TIME_ZONE = "Asia/Shanghai";
+
+export function renderAShareMarketBriefing(input) {
+  if (input.status === "ready") return renderReadyBriefing(input);
+  if (input.status === "snapshot-unavailable") return renderUnavailablePreMarket(input);
+  return renderUnavailablePostMarket(input);
+}
+
+function renderReadyBriefing({
+  marketDate,
+  occurrenceDate,
+  overseasEvidence,
+  policyEvidence,
+  quotes,
+  sectorEvidence,
+  session,
+  source
+}) {
+  if (session === "pre-market") {
+    return renderPreMarketBriefing({
+      marketDate,
+      occurrenceDate,
+      overseasEvidence,
+      policyEvidence,
+      quotes,
+      sectorEvidence,
+      source
+    });
+  }
+  const analysis = analyzeAShareBriefing({ quotes, sectorEvidence });
+  return [
+    `## A 股盘后分析简报 | ${occurrenceDate}`,
+    "",
+    "### 30 秒结论",
+    "",
+    `**${analysis.index.direction}，${analysis.index.dispersion}**；${analysis.index.strongest.name}领涨，${analysis.index.weakest.name}相对最弱。`,
+    "",
+    "### 市场事实",
+    "",
+    `**行情基准**：今日收盘（行情日期 ${marketDate}）`,
+    `**沪深两市成交额**：${formatTrillionYuan(analysis.turnover)}`,
+    "",
+    "#### 主要指数",
+    renderIndexDetails(quotes, true),
+    "",
+    "#### 行业表现",
+    ...renderSectorEvidence(sectorEvidence),
+    "",
+    "#### 政策资讯线索（近 3 天）",
+    ...renderPolicyEvidence(policyEvidence),
+    "",
+    "### 分析判断（基于上列事实）",
+    "",
+    `- **市场强弱**：${analysis.index.strength}`,
+    `- **风格结构**：${analysis.index.style}`,
+    `- **行业主线线索**：${analysis.sector}`,
+    `- **结构风险**：${analysis.index.risk}`,
+    "- **资讯边界**：官方标题只作为同期背景，不据此认定市场涨跌原因。",
+    "",
+    "### 下一时点观察",
+    "",
+    `- ${formatPossessive(analysis.index.strongest.name)}相对强势能否延续，${analysis.index.weakest.name}能否收窄差距。`,
+    "- 创业板指与沪深 300 的相对表现是否继续确认风格方向。",
+    "- 后续行业与成交数据是否支持当前指数结构。",
+    "",
+    `> 来源：${formatSources({ policyEvidence, sectorEvidence, source })}；行情可能存在延迟，请以交易所最终数据为准。`,
+    "> 分析判断只由本简报展示的事实推导；同期线索不等于已证明的涨跌原因。",
+    "> 仅供信息参考，不构成投资建议。"
+  ].join("\n");
+}
+
+function renderPreMarketBriefing({
+  marketDate,
+  occurrenceDate,
+  overseasEvidence,
+  policyEvidence,
+  quotes,
+  sectorEvidence,
+  source
+}) {
+  const analysis = analyzeAShareBriefing({ overseasEvidence, quotes, sectorEvidence });
+  return [
+    `## A 股盘前分析简报 | ${occurrenceDate}`,
+    "",
+    "### 30 秒结论",
+    "",
+    `**上一交易日 A 股：${analysis.index.direction.replace("四个宽基指数 ", "")}${analysis.index.dispersion === "表现相对同步" ? "，指数表现相对同步" : `，${analysis.index.dispersion}`}；${analysis.overseas.conclusion}**`,
+    "",
+    "### 市场事实",
+    "",
+    `**行情基准**：上一可用交易日（${marketDate}）收盘`,
+    `**上一交易日沪深两市成交额**：${formatTrillionYuan(analysis.turnover)}`,
+    "",
+    "#### 主要指数",
+    renderIndexDetails(quotes, false),
+    "",
+    "#### 隔夜海外指数",
+    ...renderOverseasEvidence(overseasEvidence, analysis.overseas.direction),
+    "",
+    "#### 上一交易日行业表现",
+    ...renderSectorEvidence(sectorEvidence),
+    "",
+    "#### 政策资讯线索（近 3 天）",
+    ...renderPolicyEvidence(policyEvidence),
+    "",
+    "### 分析判断（基于上列事实）",
+    "",
+    `- **A 股前序结构**：${analysis.index.strength}`,
+    `- **前序风格**：${analysis.index.style}`,
+    `- **前序行业线索**：${analysis.sector}`,
+    `- **外部风险背景**：${analysis.overseas.inference}`,
+    `- **结构风险**：${analysis.index.risk}`,
+    "- **边界**：隔夜美股只能作为外部风险背景，不能直接推导今日 A 股方向；官方标题与行业排名也不构成涨跌因果证明。",
+    "",
+    "### 今日观察清单",
+    "",
+    "- 集合竞价与开盘后首小时的方向、成交是否确认或否定前序指数结构。",
+    `- ${formatPossessive(analysis.index.strongest.name)}相对强势能否延续，${analysis.index.weakest.name}能否收窄差距。`,
+    "- 创业板指与沪深 300 的相对表现是否继续确认风格方向。",
+    "- 领涨与领跌行业是否出现延续、轮动或快速反转。",
+    "",
+    `> 来源：${formatSources({ overseasEvidence, policyEvidence, sectorEvidence, source })}；行情可能存在延迟，请以交易所最终数据为准。`,
+    "> 分析判断只由本简报展示的事实推导；同期线索不等于已证明的涨跌原因。",
+    "> 仅供信息参考，不构成投资建议。"
+  ].join("\n");
+}
+
+function renderPolicyEvidence(evidence) {
+  if (!evidence) return ["- **官方资讯**：当前不可用，本次不补写政策或事件驱动。"];
+  const unavailable =
+    evidence.unavailableSources.length > 0
+      ? [`- **官方资讯缺失**：${evidence.unavailableSources.join("、")}当前不可用；其余标题仍按计划发生时刻截断。`]
+      : [];
+  if (evidence.items.length === 0) {
+    return [...unavailable, "- **官方资讯**：近 3 天未筛得新标题；这不代表没有其他市场信息。"];
+  }
+  return [
+    ...unavailable,
+    ...evidence.items.map(
+      ({ publishedAt, source, title, url }) =>
+        `- [${escapeMarkdownLabel(title)}](${url})（${source}，${formatSourceTime(publishedAt)}）`
+    )
+  ];
+}
+
+function renderSectorEvidence(evidence) {
+  if (!evidence) return ["- **行业数据**：当前不可用，本次不据此判断板块驱动。"];
+  return [
+    `- **领涨行业**：${formatSectorRanking(evidence.leaders)}`,
+    `- **领跌行业**：${formatSectorRanking(evidence.laggards)}`,
+    `- **行业数据时间（上海）**：${formatShanghaiTime(evidence.asOf)}`
+  ];
+}
+
+function renderOverseasEvidence(evidence, direction) {
+  if (!evidence) return ["- **海外指数**：当前不可用，本次不据此判断外部风险背景。"];
+  return [
+    `- **隔夜美股方向**：${direction}`,
+    ...evidence.quotes.map(
+      ({ changePercent, name, price }) => `- **${name}** ${formatNumber(price)}（${formatPercent(changePercent)}）`
+    ),
+    `- **行情源标注时间**：${evidence.asOf}`
+  ];
+}
+
+function renderIndexDetails(quotes, includeRange) {
+  return quotes
+    .map(
+      (quote) =>
+        `- **${quote.name}** ${formatNumber(quote.price)}（${formatPercent(quote.changePercent)}）` +
+        (includeRange ? `，日内 ${formatNumber(quote.low)}–${formatNumber(quote.high)}` : "")
+    )
+    .join("\n");
+}
+
+function renderUnavailablePostMarket({ marketDate, occurrenceDate, source }) {
+  return [
+    `## A 股盘后简报 | ${occurrenceDate}`,
+    "",
+    "> 今日休市或行情尚未更新，本次不生成当日涨跌数据。",
+    "",
+    `**最近可用行情日期**：${marketDate}`,
+    "",
+    `> 来源：${source}；行情可能存在延迟，请以交易所最终数据为准。`,
+    "> 仅供信息参考，不构成投资建议。"
+  ].join("\n");
+}
+
+function renderUnavailablePreMarket({ asOf, occurrence, occurrenceDate, source }) {
+  const occurrenceTime = new Intl.DateTimeFormat("zh-CN", {
+    hour: "2-digit",
+    hourCycle: "h23",
+    minute: "2-digit",
+    timeZone: TIME_ZONE
+  }).format(new Date(occurrence));
+  return [
+    `## A 股盘前简报 | ${occurrenceDate}`,
+    "",
+    `> 行情源已经产生计划时间之后的数据，无法可靠还原 ${occurrenceTime} 的盘前快照；本次不展示指数涨跌。`,
+    "",
+    `最近可用行情时间：${asOf}`,
+    "",
+    `> 来源：${source}；行情可能存在延迟，请以交易所最终数据为准。`,
+    "> 仅供信息参考，不构成投资建议。"
+  ].join("\n");
+}
+
+function formatSources({ overseasEvidence, policyEvidence, sectorEvidence, source }) {
+  return [source, overseasEvidence?.source, sectorEvidence?.source, ...(policyEvidence?.sources ?? [])]
+    .filter(Boolean)
+    .join("；");
+}
+
+function formatSectorRanking(sectors) {
+  return sectors.map(({ changePercent, name }) => `${name}（${formatPercent(changePercent)}）`).join("、");
+}
+
+function escapeMarkdownLabel(value) {
+  return value.replaceAll("[", "\\[").replaceAll("]", "\\]");
+}
+
+function formatSourceTime(value) {
+  return value.slice(11, 19) === "00:00:00" ? value.slice(0, 10) : value.slice(0, 16).replace("T", " ");
+}
+
+function formatShanghaiTime(value) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    day: "2-digit",
+    hour: "2-digit",
+    hourCycle: "h23",
+    minute: "2-digit",
+    month: "2-digit",
+    second: "2-digit",
+    timeZone: TIME_ZONE,
+    year: "numeric"
+  }).formatToParts(new Date(value));
+  const read = (type) => parts.find((part) => part.type === type)?.value;
+  return `${read("year")}-${read("month")}-${read("day")} ${read("hour")}:${read("minute")}:${read("second")}`;
+}
+
+function formatPossessive(name) {
+  return /\d$/u.test(name) ? `${name} 的` : `${name}的`;
+}
+
+function formatNumber(value) {
+  return new Intl.NumberFormat("zh-CN", { maximumFractionDigits: 2, minimumFractionDigits: 2 }).format(value);
+}
+
+function formatPercent(value) {
+  return `${value >= 0 ? "+" : ""}${value.toFixed(2)}%`;
+}
+
+function formatTrillionYuan(value) {
+  return `${(value / 1_000_000_000_000).toFixed(2)} 万亿元`;
+}

package/templates/a-share-index-evidence.mjs

@@ -0,0 +1,99 @@
+import { readAShareProviderResponse } from "./a-share-provider-response.mjs";
+
+const SOURCE = "腾讯证券行情中心公开行情";
+const INDEXES = Object.freeze([
+  { name: "上证指数", symbol: "sh000001" },
+  { name: "深证成指", symbol: "sz399001" },
+  { name: "创业板指", symbol: "sz399006" },
+  { name: "沪深 300", symbol: "sh000300" }
+]);
+
+export async function readAShareIndexEvidence() {
+  const quotes = await Promise.all(INDEXES.map(readQuote));
+  const marketDates = new Set(quotes.map(({ marketDate }) => marketDate));
+  if (marketDates.size !== 1) throw new Error("a-share market quote dates are inconsistent");
+  const asOf = quotes
+    .map(({ asOf }) => asOf)
+    .sort((left, right) => left.localeCompare(right))
+    .at(-1);
+  return Object.freeze({ asOf, marketDate: quotes[0].marketDate, quotes: Object.freeze(quotes), source: SOURCE });
+}
+
+async function readQuote(index) {
+  const url = new URL("https://qt.gtimg.cn/");
+  url.searchParams.set("q", index.symbol);
+  const body = await readAShareProviderResponse({
+    accept: "text/plain",
+    maxBytes: 64 * 1024,
+    referer: "https://finance.qq.com/",
+    source: "a-share market quote",
+    url
+  });
+  return parseQuote(index, new TextDecoder("gbk").decode(body));
+}
+
+function parseQuote(index, body) {
+  const start = body.indexOf('"');
+  const end = body.lastIndexOf('"');
+  if (start < 0 || end <= start) throw new Error(`a-share market quote is invalid for ${index.symbol}`);
+  const fields = body.slice(start + 1, end).split("~");
+  const timestamp = fields[30];
+  if (!/^\d{14}$/.test(timestamp ?? "")) {
+    throw new Error(`a-share market quote is missing a timestamp for ${index.symbol}`);
+  }
+  if (!isValidCompactTimestamp(timestamp)) {
+    throw new Error(`a-share market quote has an invalid timestamp for ${index.symbol}`);
+  }
+  return Object.freeze({
+    amount: readQuoteAmount(fields[35], index.symbol),
+    asOf: formatShanghaiTimestamp(timestamp),
+    changePercent: readFiniteNumber(fields[32], index.symbol, "change percent"),
+    high: readFiniteNumber(fields[33], index.symbol, "high"),
+    low: readFiniteNumber(fields[34], index.symbol, "low"),
+    marketDate: `${timestamp.slice(0, 4)}-${timestamp.slice(4, 6)}-${timestamp.slice(6, 8)}`,
+    name: index.name,
+    price: readFiniteNumber(fields[3], index.symbol, "price"),
+    symbol: index.symbol
+  });
+}
+
+function isValidCompactTimestamp(timestamp) {
+  const values = [
+    Number(timestamp.slice(0, 4)),
+    Number(timestamp.slice(4, 6)),
+    Number(timestamp.slice(6, 8)),
+    Number(timestamp.slice(8, 10)),
+    Number(timestamp.slice(10, 12)),
+    Number(timestamp.slice(12, 14))
+  ];
+  const instant = new Date(Date.UTC(values[0], values[1] - 1, values[2], values[3], values[4], values[5]));
+  return (
+    instant.getUTCFullYear() === values[0] &&
+    instant.getUTCMonth() === values[1] - 1 &&
+    instant.getUTCDate() === values[2] &&
+    instant.getUTCHours() === values[3] &&
+    instant.getUTCMinutes() === values[4] &&
+    instant.getUTCSeconds() === values[5]
+  );
+}
+
+function readQuoteAmount(value, symbol) {
+  const amount = Number(value?.split("/")[2]);
+  if (!Number.isFinite(amount) || amount <= 0) {
+    throw new Error(`a-share market quote is missing amount for ${symbol}`);
+  }
+  return amount;
+}
+
+function readFiniteNumber(value, symbol, field) {
+  const number = Number(value);
+  if (!Number.isFinite(number)) throw new Error(`a-share market quote is missing ${field} for ${symbol}`);
+  return number;
+}
+
+function formatShanghaiTimestamp(timestamp) {
+  return `${timestamp.slice(0, 4)}-${timestamp.slice(4, 6)}-${timestamp.slice(6, 8)}T${timestamp.slice(
+    8,
+    10
+  )}:${timestamp.slice(10, 12)}:${timestamp.slice(12, 14)}+08:00`;
+}

package/templates/a-share-market-briefing.mjs

@@ -0,0 +1,83 @@
+import { renderAShareMarketBriefing } from "./a-share-briefing-renderer.mjs";
+import { readAShareIndexEvidence } from "./a-share-index-evidence.mjs";
+import { dateInShanghai } from "./a-share-market-date.mjs";
+import { readAShareOverseasEvidence } from "./a-share-overseas-evidence.mjs";
+import { readASharePolicyEvidence } from "./a-share-policy-evidence.mjs";
+import { readAShareSectorEvidence } from "./a-share-sector-evidence.mjs";
+
+export async function readAShareMarketBriefing(input) {
+  const { occurrence, session } = validateInput(input);
+  const occurrenceDate = dateInShanghai(new Date(occurrence));
+  const { asOf, marketDate, quotes, source } = await readAShareIndexEvidence();
+  if (marketDate > occurrenceDate) throw new Error("a-share market quote date is later than the scheduled occurrence");
+  const preMarketSnapshotUnavailable =
+    session === "pre-market" && Date.parse(asOf) > Date.parse(occurrence) + 5 * 60_000;
+  const status = preMarketSnapshotUnavailable
+    ? "snapshot-unavailable"
+    : session === "post-market" && marketDate !== occurrenceDate
+      ? "market-closed-or-not-updated"
+      : "ready";
+  const [overseasEvidence, policyEvidence, sectorEvidence] =
+    status === "ready"
+      ? await Promise.all([
+          session === "pre-market" ? readOptionalOverseasEvidence(occurrence) : undefined,
+          readOptionalPolicyEvidence(occurrence),
+          readOptionalSectorEvidence(marketDate)
+        ])
+      : [undefined, undefined, undefined];
+  const markdown = renderAShareMarketBriefing({
+    asOf,
+    marketDate,
+    occurrence,
+    occurrenceDate,
+    overseasEvidence,
+    policyEvidence,
+    quotes,
+    sectorEvidence,
+    session,
+    source,
+    status
+  });
+  return Object.freeze({ asOf, markdown, marketDate, session, source, status });
+}
+
+async function readOptionalOverseasEvidence(occurrence) {
+  try {
+    return await readAShareOverseasEvidence({ occurrence });
+  } catch {
+    return undefined;
+  }
+}
+
+async function readOptionalPolicyEvidence(occurrence) {
+  try {
+    return await readASharePolicyEvidence({ occurrence });
+  } catch {
+    return undefined;
+  }
+}
+
+async function readOptionalSectorEvidence(marketDate) {
+  try {
+    return await readAShareSectorEvidence({ marketDate });
+  } catch {
+    return undefined;
+  }
+}
+
+function validateInput(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    throw new Error("a-share-market-briefing input must be an object");
+  }
+  if (input.session !== "pre-market" && input.session !== "post-market") {
+    throw new Error("a-share-market-briefing session must be pre-market or post-market");
+  }
+  if (typeof input.occurrence !== "string" || !Number.isFinite(Date.parse(input.occurrence))) {
+    throw new Error("a-share-market-briefing occurrence must be an ISO date-time");
+  }
+  const keys = Object.keys(input);
+  if (keys.length !== 2 || !keys.includes("occurrence") || !keys.includes("session")) {
+    throw new Error("a-share-market-briefing input contains unsupported fields");
+  }
+  return { occurrence: input.occurrence, session: input.session };
+}

package/templates/a-share-market-date.mjs

@@ -0,0 +1,10 @@
+export function dateInShanghai(date) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    day: "2-digit",
+    month: "2-digit",
+    timeZone: "Asia/Shanghai",
+    year: "numeric"
+  }).formatToParts(date);
+  const read = (type) => parts.find((part) => part.type === type)?.value;
+  return `${read("year")}-${read("month")}-${read("day")}`;
+}

package/templates/a-share-overseas-evidence.mjs

@@ -0,0 +1,86 @@
+import { readAShareProviderResponse } from "./a-share-provider-response.mjs";
+
+const SOURCE = "腾讯证券海外指数公开行情";
+const MAX_AGE_MS = 4 * 24 * 60 * 60 * 1000;
+const INDEXES = Object.freeze([
+  { name: "道琼斯", symbol: "usDJI" },
+  { name: "纳斯达克", symbol: "usIXIC" },
+  { name: "标普 500", symbol: "usINX" }
+]);
+
+export async function readAShareOverseasEvidence({ occurrence }) {
+  const url = new URL("https://qt.gtimg.cn/");
+  url.searchParams.set("q", INDEXES.map(({ symbol }) => symbol).join(","));
+  const responseBody = await readAShareProviderResponse({
+    accept: "text/plain",
+    maxBytes: 64 * 1024,
+    referer: "https://finance.qq.com/",
+    source: "a-share overseas evidence",
+    url
+  });
+  const body = new TextDecoder("gbk").decode(responseBody);
+  const quotes = INDEXES.map((index) => parseQuote(index, body));
+  const asOf = quotes
+    .map(({ providerTime }) => providerTime)
+    .sort((left, right) => left.localeCompare(right))
+    .at(-1);
+  if (new Set(quotes.map(({ providerTime }) => providerTime)).size !== 1) {
+    throw new Error("a-share overseas evidence timestamps are inconsistent");
+  }
+  const age = providerClockTime(occurrence) - providerClockTime(asOf);
+  if (age < 0 || age > MAX_AGE_MS) throw new Error("a-share overseas evidence is stale for the occurrence");
+  return Object.freeze({ asOf, quotes: Object.freeze(quotes), source: SOURCE });
+}
+
+function providerClockTime(value) {
+  if (value.includes("T")) {
+    const parts = new Intl.DateTimeFormat("en-CA", {
+      day: "2-digit",
+      hour: "2-digit",
+      hourCycle: "h23",
+      minute: "2-digit",
+      month: "2-digit",
+      second: "2-digit",
+      timeZone: "America/New_York",
+      year: "numeric"
+    }).formatToParts(new Date(value));
+    const read = (type) => parts.find((part) => part.type === type)?.value;
+    return Date.parse(
+      `${read("year")}-${read("month")}-${read("day")}T${read("hour")}:${read("minute")}:${read("second")}Z`
+    );
+  }
+  return Date.parse(`${value.replace(" ", "T")}Z`);
+}
+
+function parseQuote(index, body) {
+  const match = body.match(new RegExp(`(?:^|\\n)v_${index.symbol}="([^"]+)";`, "u"));
+  if (!match) throw new Error(`a-share overseas evidence is missing ${index.symbol}`);
+  const fields = match[1].split("~");
+  const providerTime = fields[30];
+  if (!/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/.test(providerTime ?? "")) {
+    throw new Error(`a-share overseas evidence is missing a timestamp for ${index.symbol}`);
+  }
+  if (!isValidProviderTimestamp(providerTime)) {
+    throw new Error(`a-share overseas evidence has an invalid timestamp for ${index.symbol}`);
+  }
+  if (fields[35] !== "USD") throw new Error(`a-share overseas evidence has an unexpected currency for ${index.symbol}`);
+  return Object.freeze({
+    changePercent: readFiniteNumber(fields[32], index.symbol, "change percent"),
+    name: index.name,
+    price: readFiniteNumber(fields[3], index.symbol, "price"),
+    providerTime,
+    symbol: index.symbol
+  });
+}
+
+function isValidProviderTimestamp(value) {
+  const normalized = value.replace(" ", "T");
+  const timestamp = Date.parse(`${normalized}Z`);
+  return Number.isFinite(timestamp) && new Date(timestamp).toISOString().slice(0, 19) === normalized;
+}
+
+function readFiniteNumber(value, symbol, field) {
+  const number = Number(value);
+  if (!Number.isFinite(number)) throw new Error(`a-share overseas evidence is missing ${field} for ${symbol}`);
+  return number;
+}