前言¶

做期货数据相关工作时，常见的痛点是：市场预期散落在各家研报和行情口径里，行情、持仓、仓单、观点分布在不同系统，想比较「同一品种在不同时点的预期分布怎么变」时，往往需要手工拼接，口径也说不清楚。下面介绍的这个 Skill 就是针对这个环节的，它把预期分布及其时间序列变化作为主要输出，而不是单独给一条价格预测。

这是什么¶

繁微 Fiona 期货市场预期数据（坐标 @finoview/fiona-futures-expectation）是东证期货发布在 SkillHub 上的企业来源 Skill，当前版本 1.0.2，分类 professional。它解决的问题是：用统一入口查询市场预期分布、期货行情、会员持仓、仓单、统计排名、东证观点和动态快评，并把这些来源的结果整理成不同来源、品种、时点的对照结果。

官方地址：https://api.skillhub.cn/finoview/fiona-futures-expectation
SkillHub 页面：https://www.skillhub.cn/skills/finoview/fiona-futures-expectation

核心功能¶

官方简介给出的能力范围如下，本节不额外扩展：

1、预期分布：查询并计算市场预期分布。
2、时间序列变化：对预期分布做跨时点比较，而不是只取单一快照。
3、多来源对照：数据来源包含市场预期分布、期货行情、会员持仓、仓单、统计排名、东证观点、动态快评。
4、结果整理：输出不同来源、不同品种、不同时点的对照结果。

需要说明的是，官方简介只描述了能力边界，没有给出每一项的具体接口字段和计算口径，这些需要在实际调用时以官方页面或返回结果为准。

安装与启用¶

本次抓取未能访问官方地址与 SkillHub 页面，因此页面上可能列出的安装命令、目录路径、配置字段（含 API Key 的填写位置）都没有拿到可靠文本，这里不臆造命令。

目前可以核实的两点：

1、标签中包含 requires_api_key=true，说明该 Skill 需要 API Key 才能启用，但获取方式、放置位置、是否在环境变量或配置文件中声明，官方资料中没有给出。
2、来源标签为 enterprise，发布者为东证期货，属于企业发布来源，不是社区开源仓库，因此命令与配置应以官方页面为准。

建议的操作方式是：先打开官方地址或 SkillHub 页面，核对安装与配置说明后再启用。在此之前不要照搬其他 Skill 的安装命令。

典型用法¶

官方简介给出的使用方式是「查询并计算预期分布及其时间序列变化，整理不同来源、品种和时点的对照结果」。按这个描述，可复现的调用流程大致是：

1、明确本次要比较的维度：来源（如东证观点、动态快评、统计排名）、品种、时点。
2、发起查询，取回预期分布相关数据。
3、对同一品种跨时点的结果做时间序列比较，观察分布的变化。
4、把不同来源的结果并列整理，形成对照。

以上是按官方描述拆解的步骤，具体参数名、返回结构、是否支持批量查询，官方资料中没有提供示例，需要在实际调用时确认。

适用场景与注意¶

适合的场景：

1、需要把市场预期分布当作一类数据来管理和比较，而不是当成单条观点。
2、需要把行情、持仓、仓单等行情侧数据与观点、快评这类文本侧数据放在同一次查询里对照。
3、需要跨时点观察同一品种预期分布的移动。

需要注意的地方：

1、该 Skill 依赖 API Key，且官方标签为 enterprise 来源，接入前应先确认权限与配额。
2、官方简介强调的是「整理对照结果」，不是直接给出交易信号；它输出的是分布与对比，怎么用由使用方决定。
3、页面快照显示评分 100000、下载 2956、安装 0。评分为满分制数值，下载量是页面展示口径，安装数为 0 说明目前通过该页面直接安装的记录很少，实际可用性需要自行验证。另有一处口径差异：任务简报中写的是评分 98275、下载 2886，与页面抓取值不一致，本文以官方页面抓取值为准。
4、本次未能访问官方页面，安装命令、配置字段、接口示例的缺失不代表这些内容不存在，只是本文无法核实，请勿据此判断该 Skill 缺少文档。

小结¶

这个 Skill 的价值在于把期货市场预期分布、行情、持仓、仓单、统计排名和东证观点放在同一个查询入口里，并把结果整理成跨来源、跨品种、跨时点的对照，省去手工拼接的重复劳动。它需要 API Key，来源为企业发布，接入前建议先核对官方页面的安装与配置说明。

官方地址：https://api.skillhub.cn/finoview/fiona-futures-expectation