专题研究报告
通过自然语言 query生成专题研究报告，返回 Markdown 正文及分享信息，适用场景包括：
- 事件驱动研究（政策、国际事件、宏观变化）
- 主题投资研究（赛道、技术趋势、概念演化）
- 跨行业影响分析（单一行业难覆盖的问题）
- 快速输出可分享的专题深度内容
密钥来源与安全说明
- 本技能仅使用一个环境变量：
EM_API_KEY。
EM_API_KEY 由东方财富妙想服务（https://ai.eastmoney.com/mxClaw）签发，用于接口鉴权。- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。
功能范围
基础生成能力
- 输入专题 query，调用专题研究接口生成完整报告
- 返回报告标题、正文、文章ID、分享链接及附件路径等结构化字段
- 若返回
wordBase64/pdfBase64，自动解码保存为本地 .docx/.pdf 附件
触发规则（何时使用本技能）
- 用户明确要求“专题研究/深度分析/研究报告”
- 研究对象为主题、事件、政策、趋势、跨行业议题
- 典型问法：
东方财富专题研究、美联储加息对A股影响、AI Agent产业链专题
不触发规则（何时不要使用本技能）
- 用户只问单行业基础研究（应走行业研究技能）
- 用户只问单只股票/基金买卖判断（应走诊断技能）
- 用户要求指标级计算、回测、量化建模（应走量化类能力）
触发示例
| 触发（专题研究） | 不触发（其他能力） |
|---|
| 东方财富专题研究 | 半导体行业最新景气度（行业研究） |
| 美联储加息对A股影响 | 海康威视值得买吗（个股诊断） |
| 一带一路主题投资机会 | 永赢先锋半导体风险大吗（基金诊断） |
| ChatGPT对教育行业冲击 | 丹化科技MACD是否金叉（指标计算） |
前提条件
1. 注册东方财富妙想账号
访问 https://ai.eastmoney.com/mxClaw 注册账号并获取 API Key。
2. 配置 Token
# macOS 添加到 ~/.zshrc，Linux 添加到 ~/.bashrc
export EM_API_KEY="your_api_key_here"
然后根据系统执行对应的命令：
macOS：
source ~/.zshrc
Linux：
source ~/.bashrc
快速开始
1. 命令行调用
python3 {baseDir}/scripts/get_data.py --query "东方财富专题研究"
输出示例
Title: 东方财富日报专题研究报告
ShareUrl: http://aife-test.eastmoney.com:9001/researchShare?shareId=xxx&scene=research
DOCX: /path/to/workspace/topic_research_report/5f14e352-cd8e-4169-9d69-7399f1eb8328_docx.docx
PDF: /path/to/workspace/topic_research_report/5f14e352-cd8e-4169-9d69-7399f1eb8328_pdf.pdf
（随后输出 Markdown 正文内容）
参数说明：
| 参数 | 说明 | 必填 |
|---|
--query | 用户原始专题研究问句 | ✅（--query 或 stdin 二选一） |
--no-save | 保留参数（兼容旧调用，当前对本技能无影响） | 否 |
注意：禁止调用 任何「后台执行、稍后汇报」的方式跑本脚本，只能在当前会话中同步等待到命令完成，拿到 stdout 的结果后再继续，否则会导致本 Skill 失败。
2. 代码调用
import asyncio
from pathlib import Path
from scripts.get_data import generate_topic_research_report
async def main():
result = await generate_topic_research_report(
query="东方财富专题研究",
output_dir=Path("workspace/topic_research_report"),
save_to_file=True,
)
if "error" in result:
print(result["error"])
else:
print(result["title"])
print(result["share_url"])
print(result["content"])
if result.get("output_path"):
print("已保存至:", result["output_path"])
asyncio.run(main())
输出文件说明
| 文件 | 说明 |
|---|
<articleId>_docx.docx | 由 wordBase64 解码得到的 Word 附件（若返回） |
<articleId>_pdf.pdf | 由 pdfBase64 解码得到的 PDF 附件（若返回） |
返回字段说明
title：报告标题（来源于 data.title）。article_id：报告 ID（来源于 data.articleId）。share_url：报告分享链接（来源于 data.shareUrl）。content：报告正文（优先 data.content）。attachments：附件列表（解析 wordBase64/pdfBase64 后的本地路径）。raw：原始接口返回，便于调试或二次处理。error：接口调用失败时返回错误信息。
输出格式规范
接口返回后，必须严格按以下模板输出：
输出格式
## {title}
**正文：**
已经生成专题研究报告。此处仅展示部分正文内容，请下载附件查看报告详情和参考信息。
{content}
**附件：**
- 📄 **PDF版完整报告地址**：{pdf_file_path}
- 📝 **Word版完整报告地址**：{word_file_path}
**分享链接：**
{share_url}
字段映射规则：
{title} = 脚本返回的 title{content} = 脚本返回的 content{pdf_file_path} = 脚本返回的 attachments中的pdf_file_path{word_file_path} = 脚本返回的 attachments中的word_file_path{share_url} = 脚本返回的 share_url
常见问题
错误：EM_API_KEY is required.
→ 需先配置 EM_API_KEY，请联系官网获取并手动配置。
如何只看输出，不落盘？
python3 -m scripts.get_data --query "东方财富专题研究" --no-save
注意：专题研究报告接口响应时间较久，请耐心等待~
→ 在当前会话中同步等待到命令完成，拿到 stdout 的结果后再继续输出，否则会导致本 Skill 失败。
异常场景
| 异常场景 | 处理方式 |
|---|
| 接口调用超时 | 原样返回："报告生成服务暂时不可用，请稍后重试。" |
| 接口返回空数据 | 返回兜底话术："内容涉及敏感信息，请尝试其它主题。" |
| 接口返回格式异常 | 原样返回："内容无法解析" |
合规说明
- 研究内容仅供参考，不构成投资建议，输出时应附风险提示。
- 禁止在代码或提示词中硬编码账号 ID、会话 ID 或 token。
- 环境变量按敏感信息处理，不在日志或回复中泄露。
- 接口失败时不得编造结论，应返回明确错误或不确定性说明。
