# Fundamental Analysis Platform 用户指南 (v2.0 - Vite Refactor)
日期: 2025-11-22
版本: 2.0

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

v2.0 版本采用了全新的 Vite + React SPA 架构，提供了更流畅的交互体验和实时的分析状态可视化。

## 2. 核心功能

### 2.1 仪表盘 (Dashboard)
平台首页，提供简洁的分析入口。
*   **股票代码**: 支持输入 A股 (如 `600519.SS`)、美股 (如 `AAPL`) 或港股代码。
*   **市场选择**: 下拉选择 CN (中国)、US (美国) 或 HK (香港)。
*   **开始分析**: 点击“生成分析报告”按钮即可启动分析流程。

### 2.2 分析报告页 (Report View)
核心工作区，分为左侧状态栏和右侧详情区。

#### 左侧：工作流状态
*   **可视化 DAG**: 展示当前的分析任务依赖图。
    *   **节点颜色**: 灰色(等待)、蓝色(运行中)、绿色(完成)、红色(失败)。
    *   **动态连线**: 当任务运行时，连接线会有流光动画指示数据流向。
*   **实时日志**: 滚动展示所有后台任务的执行日志，支持实时查看数据抓取和分析进度。

#### 右侧：详情面板
*   **Analysis Report**: 展示由 AI 生成的最终分析报告。支持 Markdown 格式（标题、表格、加粗、引用），并带有打字机生成特效。
*   **Fundamental Data**: (开发中) 展示抓取到的原始财务数据表格。
*   **Stock Chart**: (开发中) 展示股价走势图。

### 2.3 系统配置 (Config)
集中管理平台的所有外部连接和参数。

*   **AI Provider**:
    *   管理 LLM 供应商 (OpenAI, Anthropic, Local Ollama 等)。
    *   配置 API Key 和 Base URL。
    *   刷新并选择可用的模型 (GPT-4o, Claude-3.5 等)。
*   **数据源配置**:
    *   启用/禁用金融数据源 (Tushare, Finnhub, AlphaVantage)。
    *   输入对应的 API Token。
    *   支持连接测试。
*   **分析模板**:
    *   查看当前的分析流程模板（如 "Quick Scan"）。
    *   查看每个模块使用的 Prompt 模板及模型配置。
*   **系统状态**:
    *   监控微服务集群 (API Gateway, Orchestrator 等) 的健康状态。

## 3. 快速开始

1.  进入 **配置页** -> **AI Provider**，添加您的 OpenAI API Key。
2.  进入 **配置页** -> **数据源配置**，启用 Tushare 并输入 Token。
3.  回到 **首页**，输入 `600519.SS`，选择 `CN` 市场。
4.  点击 **生成分析报告**，观察工作流运行及报告生成。

## 4. 常见问题

*   **Q: 报告生成卡住怎么办？**
    *   A: 检查左侧“实时日志”，查看是否有 API 连接超时或配额耗尽的错误。
*   **Q: 如何添加本地模型？**
    *   A: 在 AI Provider 页添加新的 Provider，Base URL 填入 `http://localhost:11434/v1` (Ollama 默认地址)。


