Fundamental_Analysis/frontend/public/user-guide.md

Fundamental Analysis Platform 用户指南 (v2.1 - Dynamic Refactor)

日期: 2025-11-30 版本: 2.1

1. 简介

Fundamental Analysis Platform 是一个基于 AI Agent 的深度基本面投研平台，旨在通过自动化工作流聚合多源金融数据，并利用 LLM（大语言模型）生成专业的财务分析报告。

v2.1 版本引入了动态配置架构、增强的实时日志流和结构化的数据报表展示，提供了更稳定和可视化的分析体验。

2. 核心功能

2.1 仪表盘 (Dashboard)

平台首页，提供简洁的分析入口。

• 股票代码: 支持输入 A股 (如 600519.SS)、美股 (如 AAPL) 或港股代码。
• 市场选择: 下拉选择 CN (中国)、US (美国) 或 HK (香港)。
• 开始分析: 点击“生成分析报告”按钮即可启动分析流程。

2.2 分析报告页 (Report View)

核心工作区，采用双栏布局：左侧为实时状态监控，右侧为多标签页详情展示。

左侧：工作流状态 (Workflow Status)

• 可视化 DAG (Visualizer):
  • 展示当前的分析任务依赖图。节点显示人类可读的任务名称 (如 "新闻分析", "财务数据获取")。
  • 节点颜色: 灰色(等待)、蓝色(运行中)、绿色(完成)、红色(失败)。
  • 动态连线: 任务运行时显示流光动画，指示数据流向。
• 实时日志 (Real-time Logs):
  • 位于左侧底部（或独立面板），实时滚动展示所有后台任务的执行日志。
  • 历史回放: 即使刷新页面或断线重连，系统也会自动拉取完整的历史日志，确保信息不丢失。

右侧：详情面板 (Detail Tabs)

右侧区域根据分析流程动态生成多个标签页：

• Overview (总览):
  • 展示整体分析进度、任务完成统计和总耗时。
  • 如果任务失败，会在此处显示具体的错误信息摘要。
• 任务详情页 (Task Tabs):
  • 每个工作流节点（如 "Financial Data", "News Analysis"）都有独立的标签页。
  • 智能渲染:
    • 分析报告: AI 生成的文本以 Markdown 格式渲染，支持富文本排版。
    • 财务数据: 原始财务数据（特别是 Tushare A股数据）现在自动转换为结构化 Markdown 表格，按年份和报表类型分组，数值经过格式化（如 "14.20 亿"），便于阅读。
  • Inspector (调试器): 点击右上角的 "Inspector" 按钮，可以打开侧边栏，查看该任务的输入/输出文件差异 (Diff) 和上下文信息，方便调试。

2.3 系统配置 (Config)

集中管理平台的所有外部连接和参数。

• AI Provider:
  • 管理 LLM 供应商 (OpenAI, Anthropic, Local Ollama 等)。
  • 支持配置 API Key、Base URL 和模型选择。
• 数据源配置 (Dynamic Data Sources):
  • 动态加载: 支持的数据源列表（Tushare, Finnhub, AlphaVantage 等）及其配置项由后端动态下发，无需升级前端即可支持新数据源。
  • 功能: 支持输入 Token/Key，并提供 "Test Connection" (测试连接) 按钮以验证配置是否有效。
• 分析模板:
  • 查看当前的分析流程模板及各模块使用的 Prompt。
• 系统状态:
  • 监控微服务集群 (API Gateway, Orchestrator 等) 的健康状态。

3. 快速开始

1. 进入 配置页 -> AI Provider，添加您的 OpenAI API Key。
2. 进入 配置页 -> 数据源配置，选择 Tushare (或其他源)，输入 Token 并点击 Test Connection 确认连通性，最后保存。
3. 回到 首页，输入 600519.SS，选择 CN 市场。
4. 点击 生成分析报告。
5. 在报告页观察左侧 DAG 运行状态，随着任务完成，点击右侧对应的标签页查看数据和分析结果。

4. 常见问题

• Q: 报告生成卡住怎么办？
  • A: 检查左侧“实时日志”，查看是否有 API 连接超时或配额耗尽的错误。也可以在 "Overview" 标签页查看是否有任务标记为失败。
• Q: 如何添加本地模型？
  • A: 在 AI Provider 页添加新的 Provider，Base URL 填入 http://localhost:11434/v1 (Ollama 默认地址)。
• Q: 为什么看不到某些数据源？
  • A: 数据源列表由后端服务动态注册。请确保对应的 Provider 微服务（如 tushare-provider-service）已正常启动并注册到网关。