项目档案插件 / 扩展

TradingAgents-AstrBot：AstrBot多智能体金融分析插件，支持A股港股美股智能报告生成与安装使用指南

TradingAgents-AstrBot是基于多智能体辩论架构的AstrBot金融分析插件，支持A股、港股、美股及ETF的智能分析报告生成，本文档覆盖项目介绍、安装方式、使用指令及技术架构说明。

22PythonStar 于 2026年7月7日2026年9月7日更新

AI 总结

TradingAgents-AstrBot 是基于多智能体辩论架构的 AstrBot 金融分析插件，支持 A 股、港股、美股及 A 股 ETF 的智能分析报告生成，降低普通投资者的专业分析门槛。

中文项目介绍

TradingAgents-AstrBot 是 AstrBot 平台的多智能体金融分析插件，核心功能是通过聊天指令输入股票代码或名称，自动生成包含技术面、基本面、舆情、多空观点与风险评估的结构化分析报告，当前已支持 A 股、港股、美股及 A 股 ETF 的分析，待实现多市场全覆盖、多数据源与多模型结合能力。插件基于 LangGraph 编排多智能体工作流，整合市场、基本面、新闻三类分析师的分析能力，通过多空研究员辩论、研究主管汇总、风险裁判评估的流程输出最终报告，同时提供跳过辩论环节的快速分析模式，大幅降低普通投资者的专业分析门槛，适配移动端查看报告的场景。

详细信息与使用说明

1. 项目定位与用途

TradingAgents-AstrBot 是 AstrBot 生态下的金融分析类插件，核心定位是通过多智能体协作自动生成股票分析报告。用户仅需输入股票代码或名称，即可获得整合技术面、基本面、舆情信息，结合多空观点碰撞与风险评估的结构化投资分析结果，适配 AstrBot 的聊天交互场景，为非专业投资者提供便捷的金融分析工具。

2. 解决的问题

普通投资者进行股票分析时，往往需要手动分散查询技术指标、财务数据、相关新闻等多维度信息，整合成本高且缺乏专业分析能力，难以形成系统性的投资判断。本插件通过多智能体自动完成多维度信息采集与分析，结合多空辩论机制碰撞不同投资观点，最终输出结构化的分析报告与风险提示，解决普通投资者专业分析能力不足、信息整合效率低的问题。

3. 适用场景

主要适用于四类场景：一是个人投资者需要快速获取个股、ETF的多维度分析报告，辅助投资决策；二是 AstrBot 用户希望通过聊天指令便捷查询股票基本信息、技术面走势与投资建议；三是需要多空观点碰撞与风险评估参考的投资决策场景；此外也支持跳过辩论环节的快速分析模式，适配需要快速获取简析结果的场景。

4. 安装方式

插件支持两种安装方式：一是在 AstrBot 插件市场搜索插件标识 `tradingassistant` 直接安装；二是手动将仓库克隆到 AstrBot 的插件目录 `AstrBot/data/plugins/` 下完成安装，克隆命令为 `git clone https://github.com/YYY7C/TradingAgents-AstrBot.git`。安装后需在 AstrBot WebUI 的插件配置页完成 API 参数配置才可使用。

5. 使用方式

安装配置完成后，可通过 AstrBot 聊天指令触发分析功能：输入 `/股票分析 <股票代码/名称>` 生成含多空辩论的完整分析报告，输入 `/快速分析 <股票代码/名称>` 跳过辩论环节快速生成报告，`/查股 <代码>` 可查询股票基本信息，`/年报 <代码>` 可生成股票报告。支持 A 股代码/名称、港股带 .HK 后缀代码、美股代码等多种输入格式，也支持 A 股各类 ETF 代码的自动识别与分析。

6. 实现特点与补充说明

插件基于 LangGraph 实现多智能体工作流编排，通过 AgentState 状态体在节点间传递数据，流程可扩展；数据获取层封装了 akshare、yfinance 等多数据源，支持异步调用与异常降级，东方财富数据源不可用时自动切换至腾讯财经接口；LLM 调用层支持 OpenAI 兼容协议的各种模型，推荐使用支持 Function Calling 的模型以获得最佳效果；报告支持 PDF、Markdown 分模块、TXT 三种导出格式，若系统缺少 PDF 依赖会自动降级为 TXT 导出，适配移动端查看。

思维导图

TradingAgents-AstrBot

核心功能

智能股票分析

快速分析模式

A股ETF支持

多空辩论机制

风险评估裁判

多数据源容灾

技术架构

LangGraph工作流编排

多智能体分层设计

异步数据获取封装

LLM统一调用封装

使用方式

插件市场安装

手动克隆安装

WebUI参数配置

聊天指令触发分析

依赖组件

数据源：akshare/yfinance

编排框架：langgraph/langchain-core

工具库：aiohttp/curl-cffi/openai

报告导出：markdown/weasyprint

常见问题

这个插件目前支持哪些市场的股票分析？

当前已实现A股、港股、美股及A股ETF的智能分析，待实现功能中包含A股沪深、港股、美股全覆盖的规划，后续会逐步完善多市场支持。

使用插件需要配置哪些参数？

需要在AstrBot WebUI插件配置页填写OpenAI兼容API的api_key（必填）、api_base、model等参数，推荐使用支持Function Calling的模型以获得最佳分析效果。

分析报告支持哪些导出格式？

默认支持PDF导出，若系统缺少PDF依赖会自动降级为TXT文本导出，也可在配置中关闭PDF导出开关，以Markdown分模块形式逐段发送报告。

快速分析和完整分析有什么区别？

快速分析模式跳过多空辩论环节，生成报告的速度更快；完整分析会经过多空研究员辩论、研究主管汇总、风险裁判评估的全流程，分析维度更全面。

插件的股票数据来源是什么？

主要使用akshare获取A股/港股数据、yfinance获取美股数据，同时支持东方财富与腾讯财经数据源的自动容灾降级，单一数据源不可用时会自动切换。