期货研报

技能文档

---
name: qituo-yanbao
description: "生成国内商品期货主力连续合约的标准化研究报告（PDF）。覆盖行情回顾、技术分析、基本面、资金面、市场情绪、操作建议六大维度，含专业图表与数据表格。自包含纯Python指标引擎。当用户要求生成期货研报、商品期货分析报告、沪金/沪银/沪铜/螺纹钢/原油等品种研究报告，或需要期货技术分析+持仓量分析+PDF报告时触发。"
category: 金融投资
---

# 期货研报 - 商品期货研究报告生成

为国内商品期货主力连续合约生成机构级标准化研报（PDF）。数据驱动章节自动生成，基本面/操作建议等需领域判断的章节由Agent撰写叙述覆盖。

## 依赖

首次使用前安装（仅需一次）：

```bash
pip3 install matplotlib reportlab numpy
```

可选：`pip3 install pypdf`（供PDF校验页数与文本）。

中文字体自动探测（macOS/Linux/Windows常见CJK字体），无需手动配置；也可用`--font`参数手动指定字体文件（TTF/TTC）。

## 工作流

```
研报生成进度：
- [ ] 1. 确认品种与参数
- [ ] 2. 获取数据
- [ ] 3. 计算分析
- [ ] 4. 撰写叙述（基本面/操作建议/结论）
- [ ] 5. 生成图表
- [ ] 6. 生成PDF
- [ ] 7. 校验PDF
- [ ] 8. 交付
```

### 第1步：确认参数

关键参数：品种代码与中文名、分析窗口（默认近3个月）、关联品种（用于相关性）、输出格式。用户未明确时询问品种、时间窗口。

### 第2步：获取数据

```bash
python scripts/fetch_futures.py AU0 --name 沪金主连 --days 130 \
    --extra AG0:沪银主连,SC0:原油主连 --out futures_data.json
```

`--days 130`约覆盖3个月（含60日均线所需余量）。`--extra`用于相关性分析，格式`代码:名称`。

### 第3步：计算分析

```bash
python scripts/analyze.py --data futures_data.json --symbol AU0 --out analysis.json
```

输出当前快照、全部技术指标、区间统计、量仓趋势、相关性、支撑阻力、近10日明细。

### 第4步：撰写叙述（关键增值环节）

Agent基于analysis.json数据+品种领域知识，撰写narrative.json：

```json
{
  "rating": "中性偏谨慎",
  "summary_points": ["中期趋势：...", "..."],
  "fundamental": [
    {"h": "3.1 国际金价联动", "p": "沪金以国际金价为定价锚..."},
    {"h": "3.2 美元指数", "p": "..."}
  ],
  "strategy": ["区间策略：...", "..."],
  "risks": ["仓位管理：...", "..."],
  "conclusion": ["综合...，..."]
}
```

字段均可选；缺省的章节用数据自动推导的通用内容兜底。**叙述必须与analysis.json的真实数据一致**，不得编造数字。

### 第5步：生成图表

```bash
python scripts/make_charts.py --data futures_data.json --symbol AU0 \
    --name 沪金主连 --outdir ./charts --window 63
```

生成K线主图、MACD图、RSI/KDJ图（红涨绿跌配色）。

### 第6步：生成PDF

```bash
python scripts/build_report.py --analysis analysis.json --charts ./charts \
    --name 沪金主连 --symbol AU0 --narrative narrative.json \
    --out 沪金主连研究报告.pdf
```

### 第7步：校验

确认页数≥10、中文提取无乱码、关键数据正确。

## 快速路径：一键生成

常规场景可一条命令完成全流程：

```bash
python scripts/run_all.py AU0 --name 沪金主连 --extra AG0:沪银主连
```

## 报告结构

封面 → 摘要（核心观点+KPI速览）→ 一 行情数据回顾（区间统计+量仓+明细+K线图）→ 二 技术分析（均线/MACD/RSI-KDJ/布林+指标表）→ 三 基本面分析 → 四 资金面分析（持仓量+多空+关联品种）→ 五 市场情绪（波动率+相关性）→ 六 风险提示与操作建议（支撑阻力表+策略+风控）→ 结论 → 免责声明

全文约11-13页A4，每页含页眉页脚。机构风格（深蓝+金色配色）。

## 数据源说明

- 使用新浪财经InnerFutures接口（稳定，日K自带成交量与持仓量）
- 不使用东方财富K线接口（对期货品种间歇性限流）
- 仅覆盖国内期货（上期所/能源中心/郑商所/大商所/广期所主力连续合约）
- 免费接口延迟约3-5秒，非交易时段返回收盘价

## 免责声明

本技能生成的报告仅供研究参考，不构成投资建议。期货交易高杠杆、高风险，投资者据此操作风险自担。生成报告时必须保留免责声明与数据说明章节。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。