> 👤 作者名片：本技能由 老登（SkillHub @user_11d2869f）开发维护。
> 作者作品集：📚 第二大脑操作系统 · 交付就绪进化器 · 技能编排交付 · 调研Master · 多AI协作Loop+Graph · 多智能体社会模拟器 · 招商引资工作台 · 券商研报搜索与解读 · 工作台资源管家
> 喜欢本技能请点 ⭐ 收藏；欢迎留言反馈与定制需求，作者持续更新中。
券商研报搜索与解读（research-report-reader）
一个纯本地、零云依赖的研报工具：搜得券商公开研报、用大模型把研报读成小白能懂的大白话。
后端仅用 Python 标准库（urllib），前端是单文件 HTML，密钥全程留在本机。
一、能做什么
- 🔍 搜研报：按股票代码（如
600519）或板块关键词（如白酒新能源半导体）拉取东方财富公开研报元数据，含机构、评级、机构预测的 EPS/PE/目标价（均为机构观点展示，仅供参考）。 - 📖 读懂研报：对一条研报生成三件套——
- 研报经验：700–950 字大白话深度解读（1000 字以内，不足自动扩写、超长自动截断）；
- 一图看懂：关键数据与关系的可视化小图（节点 + 连线）；
- 七问速读：7 个角度各一句话（这公司干啥 / 怎么赚钱 / 景气 / 为何机构推 / 风险 / 贵不贵 / 一句话结论）。
- 两种解读来源：
- 基于元数据（搜来的报告自带）：不贴原文也能读，标注「未读全文」；
- 基于原文（手动粘贴研报全文）：解读更精准，标注「基于原文」。
- 本机存档：保存的研报/查询历史落盘到
yb_store.json，跨浏览器、重启不丢（解决双击 file:// 打开时 localStorage 被禁导致保存失败的问题）。 - 多厂商兜底：已接入 DeepSeek / 通义千问 / Kimi / 豆包，任一可用即自动切换；前端有 AI 服务状态灯 + 模型切换。
二、安装与启动
技能自带全部文件，无需 pip 安装。启动本地服务：
# 用受管 Python（或直接 python3）
python <技能目录>/scripts/report_bridge.py --serve
# 自定义端口：--port 9000
启动后浏览器打开 http://localhost:8788/ 即可使用（端口可用 ?port= 在页面 URL 覆盖）。
停止：终端按 Ctrl+C。
> 也可用一行命令后台常驻：nohup python <技能目录>/scripts/report_bridge.py --serve > rr.log 2>&1 &
三、大模型密钥（必须）
解读功能依赖大模型。密钥只留本机，不上传任何服务器：
- 在 WorkBuddy 标准密钥位新建文件
~/.workbuddy/secrets/llm_keys.env，写入（留哪些算哪些）：
DEEPSEEK_API_KEY=你的key QWEN_API_KEY=你的key MOONSHOT_API_KEY=你的key DOUBAO_API_KEY=你的key - 或用环境变量直接注入（无需密钥文件）：
export DEEPSEEK_API_KEY=你的key - 或自定义密钥文件路径：
export LLM_KEYS_FILE=/path/to/your_keys.env
至少配一家即可；多家则自动兜底。搜索功能不需要密钥（只调东方财富公开接口）。
四、数据隐私与边界
- 全本地：服务只监听
127.0.0.1，仅本机可访问；研报保存到本机文件，密钥留本机。 - 数据源边界：东方财富免费接口只返回研报元数据，不含全文正文。「自动粘贴原文」免费源做不到，需手动粘贴或接付费研报源（Wind / 见微 / 慧眼等）。基于元数据的解读会诚实标注「未读全文」。
> ⚠️ 重要合规声明（本技能铁律）
> 1. 本工具不提供任何投资建议：所有「研报经验 / 一图看懂 / 七问」均由 AI 基于给定内容生成，AI 绝不输出「买入 / 卖出 / 持有 / 加仓 / 减仓」等任何买卖操作建议，也不做「该买 / 不该买 / 可以买 / 别买」之类的判断。
> 2. 解读中的「买入 / 增持 / 持有」等评级词，全部是转述券商机构在研报中的观点（机构评级是研报自带元数据），不是 AI 的建议。
> 3. 本工具定位是「教你看懂研报在说什么」的学习工具，不是投资决策工具。投资决策请结合自身情况、独立判断，并咨询持牌投资顾问。
> 4. 据此操作，风险自负。请勿将本工具输出作为任何买卖依据。
五、文件结构
research-report-reader/
├── SKILL.md
├── scripts/
│ ├── report_bridge.py # 本地桥接服务：搜研报 + LLM 解读 + 本机存档 + 托管 HTML
│ └── report-viewer.html # 单文件前端查看台（搜索 / 读懂 / 存档）
└── references/
└── README.md # 用户向导（同本说明精简版）
六、适用触发词
「搜研报」「读懂研报」「把这篇研报讲成人话」「研报怎么看」「券商研报解读」「帮我看一份研报」。
