前言¶
做期货交割研究的人，手上通常同时开着好几张表：交易所的注册仓单、指定交割库的库存、有效预报、产业库存、临近交割合约的持仓，还有合约期限和历史交割数据。这些数据来自不同口径——物理吨数、仓单张数、合约手数——直接拼在一起算不出有意义的结论。要么把数量口径统一了但忘了手数折算，要么手数折了但同期基准没对上。
繁微 Fiona 仓单库存与交割数据这个 Skill，就是针对这条链路做的整合：输入上述几类数据，统一数量与合约手数口径，输出仓单覆盖率、持仓保留率和同期对照结果。下面介绍它的定位、能力边界和使用前需要准备的东西。
这是什么¶
这是一个面向期货交割研究的 Agent Skill，由东证期货发布，坐标为 @finoview/fiona-warehouse-delivery-pressure，当前版本 1.0.2，来源标记为 enterprise，在 SkillHub 上分类为 professional。
它解决的问题是：把分散在不同来源、不同计量单位上的仓单与交割数据，转换成可以直接对比的比率指标，并提供同期对照，便于判断某合约在临近交割时的仓单压力与持仓留存情况。
核心功能¶
按官方简介，该 Skill 使用的数据输入包括：
- 注册仓单
- 指定交割库库存
- 有效预报
- 产业库存
- 临近交割合约持仓
- 合约期限
- 历史交割数据
在口径处理上，它同时做两件事：一是统一物理数量口径，二是把数量换算成合约手数口径，避免出现「吨数直接当手数用」这类常见错误。
输出侧整理三项内容：
- 仓单覆盖率：用仓单/库存类数据衡量可供交割的实物对持仓的覆盖程度。
- 持仓保留率：衡量临近交割合约持仓中，有多少在交割窗口内保留到交割环节。
- 同期对照结果：把当前计算结果与同期基准放在一张对照里，用于横向比较。
安装与启用¶
已抓取资料中没有给出该 Skill 的安装命令或配置字段，只提供了名称、坐标、版本、来源和标签。因此这里不推测安装方式，请以官方页面为准：
官方地址：https://api.skillhub.cn/finoview/fiona-warehouse-delivery-pressure
SkillHub 页面：https://www.skillhub.cn/skills/finoview/fiona-warehouse-delivery-pressure
配置方面，标签里有一条硬性信息：requires_api_key=true。启用前需要先准备好可用的 API Key，并按你所用的 Agent 运行时（Cursor、Codex CLI、Claude Code 等）把它配置到对应位置。具体字段名以官方页面说明为准，本文不做臆测。
典型用法¶
已抓取资料中没有提供官方的可复现示例。下面按该 Skill 简介中声明的输入与输出，说明一次典型调用的形态，供你判断是否需要这类能力；具体参数格式请参照官方页面。
一次调用需要提供的输入大致是：
- 目标合约与临近交割日期，用于确定「临近交割合约」的范围。
- 注册仓单数量、指定交割库库存数量、有效预报数量、产业库存数量。
- 该合约的持仓量（手数）。
- 合约期限信息，以及用于同期对照的历史交割数据。
调用后得到的是口径统一后的结果，而不是原始数据表：
- 仓单覆盖率，数量口径与手数口径各一份。
- 持仓保留率。
- 同期对照结果，用于判断当前值相对同期的位置。
如果只想看某一两项指标，建议在调用时明确指定，避免返回完整对照带来的额外开销。
适用场景与注意¶
适合的场景：
- 临近交割合约的仓单压力判断，需要把仓单、库存、预报和持仓放在一起看。
- 需要把物理数量换算成合约手数后再做覆盖率或保留率计算。
- 需要同期对照，而不是只看单个时点的绝对值。
需要注意的点：
- 需要 API Key。
requires_api_key=true意味着没有配置好凭证时调用不会成功，先确认凭证可用再排其他问题。 - 版本信息。当前版本 1.0.2，属于早期版本，接口或字段后续可能有调整，升级前建议核对官方页面的版本记录。
- 输入数据质量决定输出质量。注册仓单、交割库库存、产业库存来自不同口径，入库前确认它们的统计时点和统计范围一致，否则覆盖率会被口径差异污染。
- 该 Skill 只做口径统一与指标计算，不负责数据源采集。你需要先自行拿到上述七类数据，再交给它处理。
- 本文依据的抓取资料未包含安装命令、配置字段和官方示例，这些部分请以官方页面为准。
结尾¶
这个 Skill 的价值在于把交割研究中最容易出错的环节——数量与手数的口径统一——固化成一次调用，输出仓单覆盖率、持仓保留率和同期对照。它不替代数据采集，也不提供行情预测，只是把已经拿到的数据按统一口径算清楚。
官方地址：https://api.skillhub.cn/finoview/fiona-warehouse-delivery-pressure
SkillHub 页面：https://www.skillhub.cn/skills/finoview/fiona-warehouse-delivery-pressure
