Stocki 金融数据读取

问题背景

大模型回答金融数据时，常见风险是把口径、来源和结构猜错：用 oper_rev 这类原始字段直接输出，混淆实时价、OHLCV、财报面板和一致预期，或在接口未返回时补一个看似合理的数字。stocki-datareader 针对这类问题，把结构化金融数据查询约束为一条可控链路：只读真实响应，不把内部字段暴露给用户，不追加买卖建议。

工作机制

技能按三层路由处理请求：

• Tier 0 预处理：遇到非常见指标名先走 metric-resolver.md，遇到自然语言公司、指数、行业名称先走 name-resolver.md，尽量归一化成裸代码。
• Tier 1 综合入口：对“分析 X”“贵不贵”“业务结构”“为什么涨跌”等开放式请求，优先调用 financial-context.md，避免用多个接口拼接出本可由综合接口返回的结果。
• Tier 2 具体数据：实时价、OHLCV、财务面板、一致预期、行业成分和交易日历分别路由到对应参考文档。

关键纪律包括：

• 不编造：响应里没有的值要明确说明没有。
• 不输出内部形态：用户侧使用 AAPL、600519 这类裸代码，指标显示为“营业总收入”或 Total Revenue，行业直接显示为“食品饮料”。
• 控制行数：/api/v3/datareader/read 默认按 50 行截断，可按估算的 unique_symbols × time_window × metrics 决定是否设置 inline_threshold，上限为 1000。
• 错误即停：脚本失败时按 0 到 4 的统一退出码报告，不自动重试。

适用边界

适合需要真实、可解释的结构化金融数据读取，例如实时报价、历史价格、财报、估值、行业成员和一致预期。不适合解释基础概念、写没有数据支撑的行情评论，或要求模型给出个性化买卖建议。美国市场数据可用性受上游限制，遇到不可用端点时，技能应提示用户并回退到可用的实时价、市值或价格序列接口。