需求分析汇报 · 尚未执行正式分析国内商品：开发需求分析
建立逐品种的单合约、供需、库存、基差、期限结构和全球参照证据。
所属研究框架 国内商品主题 国内商品等待客户决定
这份报告帮助管理者判断三件事
1客户的方法论究竟要求系统分析什么
2需要哪些数据、指标和计算口径
3还缺什么、先开发什么、由谁做决定
为什么值得投入：商品品种、交易所、合约、现货等级和单位高度具体；范围不冻结就无法建立稳定数据合同，更不能形成统一商品总分。
建议：先按已确认规则保存单合约结算价，并继续核验逐品种基本面；客户一次性确认品种清单后再进入完整 Sprint。
为什么这样建议：五个代表单合约、四个南华指数、三类现货及十项供需库存序列已实际 API 返回；剩余阻塞是客户品种池、连续化和现货可比口径，而不是代表数据是否存在。
需求分析阶段 · 不包含当前市场结论或虚构运行结果
02 · Requirements analysis
研究起点：客户的方法论和已确认要求
先说明客户原本想解决什么，再介绍系统口径；客户在确认页面留下的反馈用于修正原始文档，而不是替代原始文档。
客户提供的原始依据建立逐品种的单合约、供需、库存、基差、期限结构和全球参照证据。
- 客户原始材料，冻结于 2026-08-21 · 大类资产宏观量化研究体系（结构化+全模块方法论+内外盘拆分+知识沉淀版）.docx · 第6.4节 国内商品
- 客户原始材料，冻结于 2026-08-21 · 大类资产研究体系(境内外独立版).xlsx · 国内商品页
- 2026-08-21 辅助排序表；客户确认优先级仍为待确认 · 国内大类资产研究主题优先级确认表.xlsx · 主题优先级确认!A28:H35（建议优先级2，客户确认待确认）
本主题必须覆盖✓Word 与 Excel 对商品正式范围给出不同清单。
✓首期需避免把未经确认的连续合约变化当成可投资收益。
✓逐品种定义供需、库存、基差、期限结构和全球参照。
单合约：带明确到期月份的交易所期货合约。 它是真实可核对价格，不包含未经确认的换月拼接。
基差：可比现货价减期货价。 只有等级、地点、单位和日期可比时才有意义。
期限结构：同一品种不同到期合约之间的价格关系。 它反映近远期紧张程度，但不是连续合约收益。
本次边界不在范围未确认前合成商品总分；不把单合约价格当连续总收益；不使用不可比现货计算基差
03 · Requirements analysis
从方法论要求到可执行分析口径
这一页建立最重要的对应关系。需求分析阶段只描述将来报告要回答什么，不填写尚未计算的当前市场数字。
分析口径：把客户的研究要求变成可重复执行的输入范围、计算规则和输出形式。
Word 与 Excel 对商品正式范围给出不同清单。反馈待处理
→
需客户固定品种、交易所和代码清单。
为什么这样建议：当前评审文本与原确认未形成可直接实施的同一语义，需要保留来源、差异和明确关闭条件。
→
国内商品逐品种证据包为什么需要：首期只交付可追溯分项与明确状态；综合判断、排名或正式方向必须等依赖和确认关闭后另行发布。
首期需避免把未经确认的连续合约变化当成可投资收益。已确认
→
首期只把单合约官方结算价作为事实；连续和总收益保持暂停并显式标记。
→
国内商品逐品种证据包为什么需要：首期只交付可追溯分项与明确状态；综合判断、排名或正式方向必须等依赖和确认关闭后另行发布。
逐品种定义供需、库存、基差、期限结构和全球参照。尚未确认
→
需确认逐品种平衡表、库存边界、基差方向和全球配对。
为什么这样建议：当前评审文本与原确认未形成可直接实施的同一语义，需要保留来源、差异和明确关闭条件。
→
国内商品逐品种证据包为什么需要：首期只交付可追溯分项与明确状态；综合判断、排名或正式方向必须等依赖和确认关闭后另行发布。
04 · Requirements analysis
最终采用哪些数据
这一页只给最终数据选择、业务用途、当前可用状态和仍缺的数据条件。取数命令、返回字段和筛选过程保留在内部证据中，不进入管理报告正文。
输入数据：完成计算所需的一类业务事实。同一类数据可以有很多日期或分类的数据点，但仍然是一类输入。
交易所单合约行情 真实数据已取得，一期最低历史未验收
最终采用
iFinD cmd_history_quotation；上期所/广期所/上能所/大商所/郑商所官方行情
用于什么
逐合约结算价、收盘、持仓、成交、到期和交易所。
当前状态
2026-08-21 浏览器定位单合约 CU2609.SHF、AU2609.SHF、AG2609.SHF、SC2609.INE、LC2609.GFE，并逐项执行 THS_HD 的 close、settle、open_interest；2026-01-01 至 2026-08-21 均返回预览。
还缺什么
五个代表单合约及四个南华指数的行情字段已 API 验证；正式品种池、全部可取合约、换月和连续化规则仍取决于客户决策。
供需与库存基本面 真实数据已取得，一期最低历史未验收
最终采用
iFinD EDB：精炼铜产量 M001622723；现货 S002854166/S002855256/S020132498；库存 S011038832；官方统计/行业机构
用于什么
产量、进口、出口、需求代理、库存和仓单等逐品种事实。
当前状态
2026-08-21 执行 THS_EDB API：精炼铜/粗钢/原油/碳酸锂产量 M001622723/S000021531/S000006815/S012518262，螺纹社会库存 S011038832，粗钢表观消费 S002827283，地产销售 S002916792，基建投资 M004385772，精炼铜/原油进口 S002916251/M004390168；均返回预览。
还缺什么
代表性供给、库存、需求与进口序列已 API 返回；品种到基本面指标的正式映射、单位换算和全量历史质量仍未冻结。
现货、基差与期限结构输入 真实数据已取得，一期最低历史未验收
最终采用
iFinD 现货候选；交易所官方合约行情；全球参照从已治理境外结果消费
用于什么
可比现货价格、逐合约结算价、交割单位和交易日历。
当前状态
2026-08-21 执行 THS_EDB API：1#铜现货 S002854166、螺纹钢现货 S002855256、碳酸锂指数 S020132498；均返回预览。
还缺什么
三类现货/指数候选和代表合约结算价已 API 验证；现货与交割品可比性、单位税费、基差方向和各品种覆盖仍未确认。
05 · Requirements analysis
系统需要计算哪些指标，它们分别回答什么问题
指标数量按研究含义和计算规则统计，不按曲线点数、日期数或窗口数统计。
计算指标：一套可重复执行的计算规则，以及它在不同日期、期限或分类下产生的结果。一条含十个期限点的曲线仍然是一个指标，不是十个指标。
5
类指标定义
指标 = 计算定义
维度 = 品种 / 窗口 / 期限等观察角度
数据点 = 某个维度组合下的一个结果
单合约价格与变化
逐合约展示结算价、持仓和价格变化，不拼接连续收益。
输入：交易所单合约行情
二维表 · 品种 / 交易所 / 合约 / 窗口
计算口径已确认供需平衡证据
并列展示产量、进口、出口、需求代理和库存变化；项目不完整时不计算统一缺口。
输入：供需与库存基本面
二维表 · 品种 / 期间 / 项目
计算口径尚未确定库存水平与周期阶段
按已确认范围计算库存变化、库存消费比和阶段标签。
输入：供需与库存基本面
分类结果 · 品种 / 期间 / 库存范围
计算口径尚未确定现货基差
同品种可比现货价减对应期货结算价，并明确方向和单位。
输入：现货、基差与期限结构输入
时间序列 · 品种 / 现货源 / 合约 / 日期
计算口径尚未确定期货期限结构
同交易日不同到期合约的价差或年化斜率，不等同连续合约收益。
输入：交易所单合约行情、现货、基差与期限结构输入
曲线 · 品种 / 交易日 / 合约对
已给出实施方案
06 · Requirements analysis
关键指标准备采用什么计算口径
如果客户材料没有写到供应商代码和工程参数，分析人员应根据业务意图、官方定义和真实数据验证给出可复算的实施方案，同时把仍需验证的技术条件单独列出。
口径状态：“已确认”来自有效客户要求；“已给出实施方案”表示分析人员已依据客户意图和可用证据选定可开发方案，未来权威要求可覆盖但当前不阻塞设计；“尚未确定”才表示现有证据不足。
先解释窗口例如20D必须说明是20个共同交易日还是自然日。
先解释单位例如bp必须说明与百分点之间的换算关系。
不伪造当前结果需求分析只给公式和示例口径；真实代入值由开发完成后的受控分析产生。
07 · Requirements analysis
国内商品的数据到底长什么样？
先看三行示例数据，再看字段含义。供应商代码只是数据地址，业务含义才是研究真正使用的内容。
先把它当成一张普通表：一行是一个日期或一个对象；一列说明时间、品种、数值或单位。以下数字均为教学示例，不是当前市场值。
单一期货合约（日度）
示例：CU2609.SHF
| 交易日 | 合约 | 收盘价 | 结算价 | 持仓量 |
|---|
| 示例周一 | 沪铜2609 | 78,100 | 78,200 | 112,000 |
| 示例周二 | 沪铜2609 | 78,450 | 78,380 | 115,500 |
| 示例周三 | 沪铜2609 | 78,300 | 78,260 | 118,200 |
它是什么：一行是一只具体到期月份的合约。结算价用于每日结算，持仓量表示尚未平仓的合约数量。
怎么读：“主连”不是可直接交割的单一合约；研究换月必须保留原始单合约。
现货与期货（可比口径）
现货候选 + 单合约结算价
| 价格类型 | 示例价格 | 单位 | 条件 |
|---|
| 1#铜现货 | 78,500 | 元/吨 | 含税 |
| 沪铜2609结算 | 78,200 | 元/吨 | 期货 |
| 差值 | +300 | 元/吨 | 现货−期货 |
它是什么：只有等级、地点、税费、单位和日期可比时，现货减期货才叫可解释的基差。
怎么读：+300 表示示例中现货比该期货合约贵 300 元/吨。
库存与产量（不同频率）
螺纹库存周度 / 精炼铜产量月度等
| 指标 | 统计期 | 示例值 | 频率 |
|---|
| 社会库存 | 示例第1周 | 100 万吨 | 周 |
| 社会库存 | 示例第2周 | 110 万吨 | 周 |
| 精炼铜产量 | 示例7月 | 120 万吨 | 月 |
它是什么：库存、产量、进口、需求通常频率不同，不能把月度值假装成每天都有。
怎么读：库存上升可能来自供给增加或需求变弱，单一指标不能直接下结论。
08 · Requirements analysis
国内商品的指标到底在算什么？
每张卡都按“输入数字 → 算式 → 结果 → 白话含义”展开；未确认口径仍然保留醒目标记。
指标不是新数据：它是把前一页的原始数据按照固定公式加工成更容易比较的结果。以下计算仍是教学示例，不代表当前判断。
基差：现货相对期货贵还是便宜？
代入什么数据
现货 78,500 元/吨；期货结算 78,200 元/吨
怎么算
78,500 − 78,200 = +300 元/吨
示例基差 +300 元/吨
这个结果是什么意思
正值表示现货更贵；方向必须固定，不能有时算现货−期货、有时反过来。
当前口径状态：未确认：现货等级、地点、税费和方向规则待定
期限结构：远月相对近月贵多少？
代入什么数据
9月合约 78,200；12月合约 78,800 元/吨
怎么算
78,800 − 78,200 = +600 元/吨
示例远月比近月高 600 元/吨
这个结果是什么意思
这类形状常被称为远月升水；必须明确使用哪些合约和距离到期多少天。
当前口径状态：未确认：正式品种池和合约选择规则待定
库存变化：库存是在累积还是去化？
代入什么数据
本周 110 万吨；上周 100 万吨
怎么算
(110 − 100) ÷ 100 = +10%
示例周度库存增加 10%
这个结果是什么意思
它只是库存变化事实；要结合产量、进口和需求解释原因。
当前口径状态：建议口径：按原始频率计算，不把月度值前填成日度
09 · Requirements analysis
能否进入开发，还需要验证哪些数据条件
本页只列尚未掌握的外部事实和数据条件，不把 Cognode 需要开发的功能写成 gap。系统要做的工作单独列在下一页。
当前判断等待客户决定
先按已确认规则保存单合约结算价，并继续核验逐品种基本面；客户一次性确认品种清单后再进入完整 Sprint。
需要管理者推动的事项
- Word、Excel 与两条客户反馈对首期商品范围指向不同清单。；责任人：产品负责人 / 客户；下一步：一次性确认品种、交易所和代码冻结清单，并确认逐品种数据边界。
等待客户选择五个代表单合约及四个南华指数的行情字段已 API 验证；正式品种池、全部可取合约、换月和连续化规则仍取决于客户决策。
补齐方式：客户确认品种池后批量枚举单合约，保存合约元数据并验证换月重叠期、交易日历和连续化规则。
为什么这样建议：样本可取不等于全历史、全字段、许可和生产接入均已满足，因此单独保留关闭动作。
数据定义不清代表性供给、库存、需求与进口序列已 API 返回；品种到基本面指标的正式映射、单位换算和全量历史质量仍未冻结。
补齐方式：随正式品种池建立品种-指标矩阵，导出全历史并审计单位、频率、缺失、修订和可比性。
为什么这样建议：样本可取不等于全历史、全字段、许可和生产接入均已满足，因此单独保留关闭动作。
质量处理规则未定义三类现货/指数候选和代表合约结算价已 API 验证；现货与交割品可比性、单位税费、基差方向和各品种覆盖仍未确认。
补齐方式：固定现货等级/地点/税费/单位标签，定义不可比阻断与基差方向，再按正式品种池扩展。
为什么这样建议：样本可取不等于全历史、全字段、许可和生产接入均已满足，因此单独保留关闭动作。
10 · Requirements analysis
建议如何拆分开发工作和安排先后顺序
每个工作包都对应一个可以独立安排、交付和验收的结果。先做无依赖项，再做依赖数据或客户决策的部分。
1关闭需求语义并冻结可实施契约。
交付：确认点处置表、有效开发规则、版本化数据与输出范围
前置条件：需求评审 Release 4 的确认点、未决反馈和版本指纹是语义权威。
为什么这样安排：先解决确认指纹、反馈和范围冲突，避免后续数据与公式建立在移动目标上。
2完成数据契约、来源映射、API 历史核验和受控接入设计。
交付：序列目录、字段与时点契约、历史覆盖矩阵、质量门与降级规则
前置条件：关闭需求语义并冻结可实施契约。；iFinD 账号用于候选序列检索和 API 样本验证；全历史、批量权限和展示许可仍需逐项核验。
为什么这样安排：当前 API 样本只证明代表序列可取，需要将历史、修订、许可和批量能力逐项升级为可验收证据。
3实现可复算、可版本化且受发布状态保护的指标方法。
交付：指标计算契约、黄金样例、结果版本与发布保护、查询投影
前置条件：完成数据契约、来源映射、API 历史核验和受控接入设计。
为什么这样安排：分项、草案和正式结果必须在计算与查询层同时可区分。
11 · Requirements analysis
还需要谁做决定，开发完成后怎么验收
管理者不需要检查代码；只需要确认业务选择，并用可观察的输入、操作、结果和反向场景验收。
首期国内商品最终覆盖哪些品种、交易所和正式代码？ 待决定
可选方案
- 黄金/白银/原油为核心，碳酸锂/铜其次
- Word 的铜/铝/碳酸锂
- Excel 的沪铜/螺纹钢/碳酸锂/原油
- 提交新的冻结清单
分析人员建议
在客户冻结清单前，只准备黄金、白银、原油、碳酸锂、铜的候选数据目录，其他品种只做统计，不合成总分。
为什么这样建议：这个默认值最贴近具体评论，但明确不把它误记为客户最终确认。
逐品种供需平衡、库存范围、现货可比口径和基差方向采用什么定义？ 待决定
可选方案
- 按逐品种合同逐项确认
- 仅展示分项不计算派生指标
- 采用产品团队草案后集中验收
分析人员建议
先展示分项并建立逐品种合同；派生指标逐项确认后开放。
为什么这样建议：可以继续积累真实证据，同时不制造伪精确缺口和基差。
| 验收时做什么 | 应该看到什么 | 用什么证据判断 | 什么情况必须失败 |
|---|
| 从任一输出追溯到需求、来源定位、评论、确认状态和方法版本。 | 所有链路可闭环；陈旧确认、未决反馈和分析建议显示为不同状态。 | 机器可读规格、验证器输出和查询返回的证据引用。 | 确认指纹与当前文本不一致时，系统拒绝标记为 confirmed。 |
| 以小样本和边界日期查询每类必需数据，并检查缺失、修订和可用时间。 | 返回结构满足契约，样本证据不被升级为全量或生产就绪证明。 | API 请求函数、序列 ID、返回字段、行数摘要和质量检查记录。 | 只在网页中搜索到候选项但未执行 API 时，证据状态不得高于 source_mapped。 |
| 使用固定样例独立复算指标，并测试缺失、修订和窗口边界。 | 结果与独立复算一致，未确认方法仅输出草案或证据，不发布正式结论。 | 黄金样例、公式版本、输入快照、复算差异和负例结果。 | 核心输入缺失或方法未确认时，系统不得输出无标记的正式评分、排名或方向判断。 |
12 · Requirements analysis
附录：完整追踪关系与后续报告扩展方式
内部标识只用于研发追溯，不要求管理者记忆。主体报告已经用业务名称解释了同一组内容。
如何继续形成最终客户报告：开发完成后保留前 6 页的方法、输入和指标说明，在其后追加真实数据覆盖、计算复核、图表、结论和数据依据。不能回写或掩盖原先标注的建议口径。
| 需求标识 | 原文位置 | 已发布解释 | 产出标识 | 验收标识 |
|---|
CN-WF5-D01 | 第6.4节 国内商品；与 Excel 商品清单对照 | 首期商品范围存在两组反馈和两份原材料冲突；澄清前逐品种保存证据，不合成商品总分。 | OUT-PRIMARY | AC-TRACE |
CN-WF5-CONTRACT | 国内商品页：单合约、连续合约与收益口径 | 首期保存并展示交易所单个合约结算价；连续合约、换月收益和可投资总收益待换月规则确认后再计算。 | OUT-PRIMARY | AC-TRACE |
CN-WF5-D03 | 第6.4节 供需、库存、基差、成本与全球参照 | 国内官方数据优先；逐品种数据可以先展示，供需缺口、库存阶段和跨市场归因在定义确认后形成。 | OUT-PRIMARY | AC-TRACE |