mx_financial_assistant

# 金融问答 Skill

## 概述

基于东方财富权威金融数据库，打造覆盖"数据-资讯-知识-分析-决策"全链条的智能问答服务。通过自然语言交互，为用户提供从基础金融知识科普到专业投资研究支持的全方位解决方案，实现"一问即达"的高效金融信息获取体验。以对话式交互降低金融数据获取门槛，让专业投研能力触手可及。

支持标准模式和深度思考模式，返回总结回答内容（含选股类数据结果）及溯源参考（资讯、公告、数据等）。本接口为一次性返回回答结果的接口形式。

---

## 环境变量

| 变量名 | 说明 | 默认 |
|--------|------|------|
| `EM_API_KEY` | 接口鉴权密钥（必填） | 无 |

### 1. 配置 `EM_API_KEY`

```bash
# macOS / Linux
export EM_API_KEY="your_api_key_here"
```

```powershell
# Windows PowerShell
$env:EM_API_KEY="your_api_key_here"
```

## 核心能力

### 1. 金融市场分析

支持自然语言获取多维度市场分析，涵盖市场趋势研判、技术面解析、基本面评估、资金面监测及市场情绪量化分析等，覆盖A港美等全球主要市场指数与板块表现。

**适用场景**：每日复盘、趋势跟踪、策略制定、风险预警及市场情绪研判等，辅助投资决策。

### 2. 金融热点事件解读

支持自然语言追踪并深度解读资本市场重大事件、突发政策、行业变革及公司公告等热点内容，提供事件逻辑梳理、影响路径分析、产业链传导效应及投资机会与风险评估。

**适用场景**：事件驱动策略、政策影响评估、市场情绪跟踪及投资机遇挖掘等。

### 3. 金融数据查询

支持自然语言查询金融数据，覆盖A港美、基金、债券等多种资产，含实时行情、公司信息、估值、财务报表等。

**适用场景**：投资研究、交易复盘、市场监控、行业分析、信用研究、财报审计、资产配置等，适配机构与个人多元需求。

### 4. 金融资讯搜索

支持自然语言搜索全网最新公告、研报、财经新闻、交易所动态及官方政策等，覆盖全球市场标的。

**适用场景**：热点捕捉、舆情监控、研报速览、公告精读及投资决策等。

### 5. 宏观经济数据查询

支持自然语言查询全球宏观经济数据，涵盖国民经济核算、价格指数、货币金融、财政收支、对外贸易、就业民生、产业运行等多个领域。

**适用场景**：宏观经济研究、市场分析、政策解读等多元专业场景。

### 6. 选股 / 选板块 / 选基金

支持通过自然语言输入筛选A港美股、基金、债券等多种资产，支持多元指标筛选，含技术面、消息面、基本面及市场情绪等。

**适用场景**：全球资产速筛、跨市场监控、投资组合构建、策略回测等。

### 7. 金融百科知识问答

支持自然语言问答形式查询金融专业术语、投资理论、交易规则、市场机制及产品详情等基础知识，覆盖股票、基金、债券、衍生品、宏观经济学等多个知识领域。

**适用场景**：投资入门学习、专业概念速查、业务流程理解、金融知识科普及投资者教育等，降低专业金融知识获取门槛。

---

## 处理流程

以用户自然语言输入问句作为入参，调用 `scripts/generate_answer.py` 金融问答脚本，返回结果为总结内容纯 Markdown：

```bash
python3 {baseDir}/scripts/generate_answer.py --query "用户原始问题"
```

如需开启深度思考模式：

```bash
python3 {baseDir}/scripts/generate_answer.py --query "用户原始问题" --deep-think
```

**模式选择规则**：
- 默认使用标准模式
- 当用户明确要求"深度分析"、"深度思考"、"详细分析"、"仔细想想"等表述时，开启深度思考模式

---

## 脚本输出结构

脚本返回 JSON，核心字段：

| 字段 | 类型 | 说明 |
|---|---|---|
| `ok` | Boolean | 是否成功 |
| `answer` | String | 模型回答（Markdown 格式，即接口 `data.displayData`） |
| `references` | Array | 溯源参考列表（即接口 `data.refIndexList`） |

### references 元素说明

| 字段 | 类型 | 说明 |
|---|---|---|
| `refId` | Number | 引用编号（如 1） |
| `type` | String | 数据类型：`查数` `公告` `研报` `资讯` `选股/基` |
| `referenceType` | String | `CITED_REFERENCE`（直接引用）/ `OTHER_REFERENCE`（扩展引用） |
| `markdown` | String | type=查数、选股/基 时存在，结构化数据表格（Markdown 格式） |
| `title` | String | type=资讯 时存在，资讯标题 |
| `jumpUrl` | String | type=资讯 时可能存在，原始文档链接（部分无跳转链接） |
| `source` | String | 资讯/舆情等来源站点名；脚本从接口项顶层 `source` 或嵌套 `data.source` 提取（如「赢家财富网」） |

---

## 输出格式规范

接口返回后，按以下格式组织响应内容：

### 回答正文

直接展示 `answer` 字段内容（已为 Markdown 格式）。

### 溯源参考

根据 `references` 中每项的 `type` 分类展示。**不要在条目前添加 `[refId]` 编号前缀**（如 `[1]`、`[2]` 等），直接以列表形式展示内容：

```
### 溯源参考

**查数/选股数据：**
{对 type=查数 或 type=选股/基 的引用，直接展示其 markdown 字段的表格内容，不加 [refId] 编号}

**资讯引用：**
- [{title}]({jumpUrl})（来源：{source}）  // 有 jumpUrl 且有 source 时
- [{title}]({jumpUrl})                    // 有 jumpUrl、无 source
- {title}（来源：{source}）               // 无 jumpUrl 但有 source
- {title}                                 // jumpUrl、source 均无或为空时仅展示标题

**公告引用：**
- [{title}]({jumpUrl})（来源：{source}）  // 有 jumpUrl 且有 source 时
- [{title}]({jumpUrl})                    // 有 jumpUrl、无 source
- {title}（来源：{source}）               // 无 jumpUrl 但有 source
- {title}                                 // jumpUrl、source 均无或为空时仅展示标题

**研报引用：**
- [{title}]({jumpUrl})（来源：{source}）  // 有 jumpUrl 且有 source 时
- [{title}]({jumpUrl})                    // 有 jumpUrl、无 source
- {title}（来源：{source}）               // 无 jumpUrl 但有 source
- {title}                                 // jumpUrl、source 均无或为空时仅展示标题

注意：
- **禁止**在溯源条目前添加 `[1]`、`[2]` 等 refId 编号前缀，refId 仅用于内部数据关联，不对外展示
- 仅展示 `referenceType` 为 `CITED_REFERENCE`（直接引用）的条目为主要参考
- `OTHER_REFERENCE`（扩展引用）可作为补充阅读展示
- 如 `references` 为空，则省略溯源参考部分

---

## 公式格式要求

严格遵照以下格式：
- 行内公式：使用 `\(...\)` 格式（不使用 `$...$`）
- 行间公式：使用 `\[...\]` 格式
- 行间公式块内部内容保持不变

---

## 语言要求

始终使用中文进行交互和输出。如用户使用其他语言，仍以中文生成回答内容，但交互提示可跟随用户语言。

---

## 错误处理

| 错误码 | 含义 | 用户侧话术 |
|---|---|---|
| `BAD_REQUEST` | 缺少问题参数 | "请输入您想问的问题。" |
| `API_ERROR` | 接口返回非 200 状态码 | "金融问答服务暂时不可用，请稍后重试。" |
| `HTTP_ERROR` | HTTP 请求失败 | "金融问答服务暂时不可用，请稍后重试。" |
| `TIMEOUT` | 请求超时 | "请求超时，请稍后重试。" |
| `NETWORK_ERROR` | 网络错误 | "网络连接异常，请检查网络后重试。" |
| `EMPTY_RESPONSE` | 回答内容为空 | "未获取到有效回答，请稍后重试。" |
| 其他异常 | 未知异常 | "金融问答服务暂时不可用，请稍后重试。" |

---

## 脚本/文件说明

| 脚本/文件 | 功能 |
| --- | --- |
| `scripts/generate_answer.py` | 调用金融问答接口，传入用户问题及模式参数，返回回答结果和溯源参考 |