如何用FinSight AI生成AI投研报告:版本对比、报告Diff与Markdown/PDF导出一次讲透

原创2026-10-15 09:19:491,752 阅读

如何用FinSight AI生成AI投研报告:版本对比、报告Diff与Markdown/PDF导出一次讲透

FinSight AI 是一个开源的 A 股 AI 投研工作区:它基于行情、财务指标与公开资料生成带证据链的 AI 投研报告,并把每一份报告做成了不可变的版本化档案。你可以对任意两个版本做字段级 Diff 对比,也可以一键把报告导出为 Markdown 或 PDF,方便归档、分享和打印。本文将从零讲清完整流程。

FinSight AI 投研报告长什么样

先看一下产品界面。左侧是研究导航(公司研究、AI 分析、证据来源、近期事件、关注列表),右侧展示股价、走势与关键财务指标:

FinSight AI 投研工作区:公司研究、AI 分析与行情走势

理解报告功能前,先记住一个核心设计:每次分析完成都会落库一份全新的、不可变的报告版本,报告上绑定三个关键字段:

字段 含义
reportVersion 同一公司下的版本序号,逐次递增
dataSnapshotHash 生成该报告时输入数据的 SHA-256 快照指纹
contextHash 公司、行情、指标、证据等完整上下文的指纹

也就是说:数据一变,快照指纹就变,系统就会触发一次新的分析与新版本报告;数据没变则命中缓存,不会重复"烧钱"调模型。正是这个机制,让"版本对比"和"导出任意历史版本"成为可能。

快速上手:两条路径跑通报告生成

轻量预览(只需 Java 17 + Maven)

git clone https://gitcode.com/gh_mirrors/fi/FinSight-AI
cd FinSight-AI/backend
mvn spring-boot:run

打开 http://localhost:8080 即可体验界面与核心流程,使用内存适配器,无需任何外部服务。

完整研究栈(Docker Compose)

git clone https://gitcode.com/gh_mirrors/fi/FinSight-AI
cd FinSight-AI
docker compose up -d --build
./scripts/quick-demo.sh

一次拉起 PostgreSQL/pgvector、Redis、RabbitMQ、Spring Boot 后端与 FastAPI AI 侧车,约需 8 GB 内存。默认走本地 Ollama,模型不可用时会自动降级到确定性规则兜底,保证流程始终可跑。更多排障见 docs/troubleshooting.md。

生成第一份 AI 投研报告:三步完成

  1. 在界面中选择 AI 分析 工作区,输入 A 股代码(如 600519)触发分析;
  2. 后台工作流会拉取行情快照、财务指标、风险信号,并通过混合 RAG(全文 + 向量 + RRF 融合)检索证据片段,交给 AI 侧车生成结论;
  3. 完成后,研究档案 / 报告版本记录 中就会出现一条新记录,包含版本号、评级、生成时间、模型来源与数据快照。

FinSight AI 投研报告证据检索工作区:财报与公告可核验来源

报告中每个结论都能溯源:citations 字段列出引用来源,/api/research/reports/{symbol}/trace 接口还能返回为该结论检索到的证据块,方便你核查"结论为什么这么说"。

重复运行两次(比如等行情更新后再跑一次),你手上就有了至少两个版本——下面的版本对比就能用上了。

报告版本对比:Diff 到底比了什么

当同一公司存在 ≥2 个版本时,在报告版本记录中打开 与上一版对比 开关(或调用 Diff 接口),FinSight 会用 Myers diff 算法做字段级对比:

curl http://localhost:8080/api/research/stock/600519/reports/report-1/diff/report-2

对比覆盖五个字段:评级(rating)、结论摘要(summary)、支持观点、风险观点、引用来源。每个字段都返回 before / after 原始值,以及一段段带操作标记的 segments(EQUAL / INSERT / DELETE),前端据此渲染"之前 / 现在"双栏视图,每个小节还会额外标注 已变化 / 未变化,不依赖颜色也能判断差异。

响应中还有两个"溯源"布尔值,非常实用:

  • contextHashChanged:研究上下文是否变化(结论是"改写了"还是"基于新证据重写")
  • dataSnapshotHashChanged:底层数据快照是否变化
  • reportVersionDelta:两个版本相差几代

举个例子:评级从"谨慎"变为"积极"时,你会看到一段 DELETE "谨慎" + INSERT "积极" 的 segments,加上 contextHashChanged: true,就能立刻判断这是新数据驱动的结论翻转,而非模型抖动。相关实现在 ReportDiffService.java,摘要字段还会按中文句子切分(BreakIterator)再做 diff,粒度更细;算法本体在 MyersDiff.java。

报告导出:一键下载 Markdown 或 PDF

版本记录中每一行都有两个下载按钮,对应两个端点:

curl -OJ http://localhost:8080/api/research/stock/600519/reports/report-2.md
curl -OJ http://localhost:8080/api/research/stock/600519/reports/report-2.pdf
  • Markdown:UTF-8 的 CommonMark 文档,含评级、置信度、摘要、支持/风险要点、财务指标表、风险信号表、引用与快照哈希,可直接放进笔记或 Git 仓库继续编辑;
  • PDF:分页排版、内嵌中文字体的研究文档,适合分享与打印,服务端渲染后按报告维度缓存 24 小时,重复下载不重算。

文件名自动生成为 finsight-{代码}-{报告ID}.{md|pdf} 附件形式;导出与选定的不可变 reportId 绑定——之后再生成新版本,也不影响已下载的旧版文件。找不到报告或 ID 属于其他公司时返回 404。实现分别位于 ReportMarkdownExporter.java 与 ReportPdfExporter.java,Markdown 模板在 report.md.tmpl。

核心源码导读

想深入看实现,按调用链顺序读这几个文件即可:

功能 源码位置
版本 / Diff / 导出 API 入口 ReportDiffController.java
报告版本化落库 ReportPersistenceService.java
Diff 字段级对比 ReportDiffService.java
Markdown 导出 ReportMarkdownExporter.java
PDF 导出 ReportPdfExporter.java
设计背景(目标与取舍) RFC-004-report-diff-and-export.md

常见问题速答

Q:为什么要保存每一个报告版本? A:因为结论会随数据变化而改变。版本 + 快照哈希让"为什么这版和上版不一样"可以精确回答,Diff 正是这一价值的核心出口。

Q:报告生成有缓存吗? A:有。输入数据指纹不变则直接命中缓存(响应中带 cacheHit: true),不会重复调用模型。

Q:导出的报告能当投资建议吗? A:不能。FinSight 是研究辅助工具,输出仅供研究参考,不构成投资建议。

Q:接口细节在哪查? A:见 docs/api.md 的 "Report History, Diff, and Export" 一节与 docs/user-guide.md 的操作说明。


至此,从生成 AI 投研报告、用报告 Diff 对比版本变化,到导出 Markdown/PDF 归档分享,整个闭环已经跑通。下一步可以试试 POST /api/research/tasks 提交完整研究任务,观察工作流如何驱动"数据摄取 → 指标重算 → 索引重建 → 报告生成"的自动流水线。

登录后查看全文
FinSight-AI