期货品种多空因子评分系统

概述

期货涨跌因子分析（全品种通用方法论 skill）

用户输入合约代码，输出该品种所属板块的核心涨跌驱动因子，按 5 层坐标系组织，并标注每个因子的方向逻辑、权重、数据源与传导路径。可选"净多空评分"。

这是一套方法论：Skill 本身只提供统一的因子坐标系与执行引擎，品种内容全部由 references/factor_table.json 承载——代码不写死任何品种。

触发场景

• "au2606 为什么涨/跌" / "什么在影响生猪期货价格"
• "XX 的利多利空因素有哪些" / "这个品种的基本面驱动"
• "给我列一下 IF 的定价因子" / "现在偏多还是偏空"

方法论（核心）

统一因子坐标系（5 层）

1. 宏观层 — 利率/汇率/通胀/流动性，定方向，对所有品种同向或反向传导
2. 板块层 — 各交易所/产业链板块的共性驱动（黑色看地产基建、农产品看天气与 USDA…）
3. 品种层 — 该合约独有供需结构（存栏/库存/进口依赖/产能周期），定中长期趋势
4. 事件层 — 交割月/仓单/极端天气/地缘/数据发布，造脉冲
5. 资金层 — 持仓结构/基差/期限结构/资金净流入，定短期节奏

核心公理：供需是根本，宏观定方向，资金定节奏，事件造脉冲。

方向判定规则（关键，避免写死）：每个因子条目自带"方向逻辑"——不写死统一多/空，而是写"当 X↑ 时 → 该板块价格 Y 方向"。同一宏观变量对不同板块方向相反（美元↑对黄金利空、对美豆出口也利空），故方向按板块维护。

依赖

• 行情源 = slzq-ai-trading-assistant（可选，用于接入 auto 类因子的实时状态：持仓/基差/库存）。已装则优先用其 MCP 工具（slzq_open_v1_market_snapshot 等）；未注册/无密钥时仅输出因子框架，不编数据。
• 纯本地即可运行：引擎只依赖 factor_table.json，无需网络。

执行逻辑（核心，全品种通用）

合约代码 → ①解析(代码→symbol→板块) → ②查因子库(板块→因子清单)
        → ③(可选)数据增强(按 source=auto 调 slzq 回填状态)
        → ④归一化输出(因子·方向·权重·来源·传导)
        → ⑤(可选)净多空评分 Σ(方向×权重×状态强度) → 偏多/偏空/中性

1. 输入：合约代码（必填）。
2. symbol_of(contract)：剥离数字得品种符号（au2606 → au）。
3. symbol_to_sector 查板块；缺失则回退"未知板块"兜底框架（同时提示去 factor_table.json 补映射）。支持 --sector 直接覆盖。
4. 读取该板块 factors：按 5 层顺序输出，字段含 name / layer / logic / bias / weight / source / transmission。
5. --score --state "因子名:状态值"：状态∈[-1,1]，计算净评分并给偏多/偏空/中性结论；未提供状态的因子不参与（透明化）。

为什么全品种通用（零硬编码）

• 引擎只有"解析→查表→输出"三段逻辑，不出现任何具体品种名。
• 品种差异 100% 在 factor_table.json：symbol_to_sector 映射 + sectors 板块因子集。
• 新增品种 = 在 symbol_to_sector 加一行（确认其板块已覆盖即可）。
• 新增板块 = 在 sectors 加一个节点及其因子集。

交付物

• 引擎：scripts/factor.py（纯标准库）。

  python3 factor.py --contract au2606
  python3 factor.py --contract IF2509
  python3 factor.py --contract m2509 --score --state "饲料养殖需求(猪周期/存栏):1,USDA报告/种植意向/库存:0.5,临储/抛储/进口政策:-0.5"

• 因子库：references/factor_table.json（覆盖 贵金属/基本金属/黑色建材/农产品/软商品/能源化工/新能源/股指期货/国债期货/航运 共 10 板块 + 未知兜底）。

边界

• manual 类因子为通用定性驱动，需结合 slzq 行情与权威数据研判，标注"待人工研判"，绝不编数据。
• auto 类因子（持仓/基差/库存等）标注可经 slzq 接入，本 skill 不自行伪造实时数值。
• 净多空评分是相对强弱参考，因子状态必须来自真实数据；缺状态时只输出框架不强行打分。
• 本因子库为方法论框架，非投资建议，输出须附免责。