# 用户使用文档

## 欢迎使用基本面分析系统

基本面分析系统是一个专业的股票分析平台，帮助投资者通过多维度的基本面分析，做出更明智的投资决策。

## 目录

- [快速开始](#快速开始)
- [主要功能](#主要功能)
- [使用指南](#使用指南)
- [常见问题](#常见问题)
- [系统配置](#系统配置)

## 快速开始

### 1. 生成分析报告

1. **访问首页**：在浏览器中打开系统首页
2. **输入股票代码**：在输入框中输入股票代码，例如：
   - 中国股票：`600519`（会自动识别为 600519.SH）或 `600519.SH`
   - 美国股票：`AAPL`
   - 香港股票：`00700.HK`
3. **选择交易市场**：从下拉菜单中选择对应的交易市场（中国、香港、美国、日本）
4. **生成报告**：点击"生成报告"按钮，系统将自动获取财务数据并生成分析报告

### 2. 查看报告

报告生成后，您将看到包含以下内容的综合报告：

- **股价图表**：来自 TradingView 的实时股价图表
- **财务数据**：多年财务指标对比，包括：
  - 主要指标：ROE、ROA、ROIC、毛利率、净利润率等
  - 费用指标：销售费用率、管理费用率、研发费用率等
  - 资产占比：现金占比、库存占比、应收款占比等
  - 周转能力：存货周转天数、应收款周转天数等
  - 人均效率：人均创收、人均创利、人均工资等
  - 市场表现：股价、市值、PE、PB、股东户数等
- **AI 分析模块**：基于财务数据的智能分析，包括：
  - 公司简介
  - 业务分析
  - 财务健康度评估
  - 投资建议等

### 3. 报告操作

- **开始分析**：点击"开始分析"按钮，系统将按顺序生成各个分析模块
- **停止**：在分析过程中，可以随时点击"停止"按钮中断分析
- **继续**：停止后可以点击"继续"按钮恢复分析
- **重新生成分析**：对任意分析模块，可以点击"重新生成分析"按钮重新生成

## 主要功能

### 1. 股票分析报告

系统提供全面的股票基本面分析，包括：

- **财务数据展示**：自动从 Tushare 等数据源获取最新的财务数据
- **多维度分析**：涵盖盈利能力、运营效率、财务健康度等多个维度
- **历史对比**：展示多年的财务指标变化趋势
- **实时图表**：集成 TradingView 高级图表组件，提供专业的股价图表

### 2. 智能分析模块

系统使用 AI 模型（如 Google Gemini）对财务数据进行深度分析：

- **自动生成**：根据财务数据自动生成业务分析和投资建议
- **模块化设计**：不同分析模块相互独立，可按需生成
- **依赖关系**：支持分析模块之间的依赖关系，确保分析的准确性
- **实时进度**：显示每个分析模块的生成进度和状态

### 3. 系统配置管理

系统提供完善的配置管理功能：

- **AI 服务配置**：配置 AI 模型的 API 密钥和端点
- **数据源配置**：配置 Tushare、Finnhub 等数据源的 API 密钥
- **分析模块配置**：自定义分析模块的名称、模型和提示词模板
- **配置测试**：支持测试各项配置的有效性
- **配置导入/导出**：支持配置的备份和恢复

### 4. 历史报告查询

系统支持查询历史生成的报告：

- **按市场和企业ID查询**：根据交易市场和企业ID查询历史报告
- **报告列表**：查看所有历史报告及其状态
- **报告详情**：查看完整的报告内容

## 使用指南

### 股票代码格式

不同市场的股票代码格式：

- **中国市场**：
  - 上交所：6 位数字，如 `600519`（系统会自动添加 `.SH` 后缀）
  - 深交所：6 位数字，如 `000001`（系统会自动添加 `.SZ` 后缀）
  - 完整格式：`600519.SH` 或 `000001.SZ`
- **美国市场**：直接输入股票代码，如 `AAPL`、`MSFT`
- **香港市场**：股票代码，如 `00700`
- **日本市场**：股票代码，如 `7203`

### 财务数据解读

系统展示的财务数据按以下方式组织：

1. **主要指标**：核心财务指标
   - ROE（净资产收益率）：衡量股东权益的盈利能力，>12% 为优秀
   - ROA（总资产收益率）：衡量资产利用效率
   - ROIC（投入资本回报率）：衡量资本使用效率，>12% 为优秀
   - 毛利率：反映产品或服务的盈利能力
   - 净利润率：反映整体盈利能力

2. **费用指标**：各项费用占收入的比例
   - 销售费用率、管理费用率、研发费用率等
   - 其他费用率：通过毛利率减去各项费用率计算得出

3. **资产占比**：各项资产占总资产的比例
   - 现金占比：反映资金充裕程度
   - 库存占比：反映库存管理水平
   - 应收款占比：反映应收账款风险
   - 商誉占比：反映并购活动的影响

4. **周转能力**：反映资产周转效率
   - 存货周转天数：存货变现的速度
   - 应收款周转天数：应收账款回收速度（>90天需注意）
   - 应付款周转天数：应付账款支付周期

5. **人均效率**：反映人力资源效率
   - 人均创收、人均创利：衡量员工贡献
   - 人均工资：反映员工待遇水平

6. **市场表现**：股票市场的表现指标
   - PE（市盈率）、PB（市净率）：估值指标
   - 股东户数：反映股东结构变化

### 分析模块说明

每个分析模块都有其特定的作用：

- **公司简介**：自动生成公司的基本介绍和业务概况
- **业务分析**：深度分析公司的业务模式和竞争优势
- **财务分析**：评估公司的财务健康状况
- **风险评估**：识别潜在的投资风险
- **投资建议**：提供基于分析的投资建议

分析模块会按依赖关系顺序执行，确保每个模块都能获得所需的前置分析结果。

### 执行详情

在报告页面的"执行详情"标签页，您可以查看：

- **执行概况**：财务数据获取的耗时、API 调用次数等
- **分析任务**：每个分析模块的执行状态、耗时、Token 消耗等
- **总体统计**：总耗时、完成的任务数量、总 Token 消耗等

这些信息有助于了解报告的生成过程和数据来源。

## 常见问题

### Q1: 为什么有些财务数据显示为 "-"？

A: 可能是以下原因：
- 该股票在对应年份没有数据
- 数据源暂时不可用
- 该指标不适用于该股票类型

### Q2: 分析模块生成失败怎么办？

A: 您可以：
- 点击"重新生成分析"按钮重试
- 检查系统配置中的 AI 服务配置是否正确
- 查看"执行详情"中的错误信息

### Q3: 如何查看历史报告？

A: 
1. 访问"查询"页面（如果已启用）
2. 选择交易市场和企业ID
3. 点击"查询"按钮查看历史报告列表

### Q4: 股票代码输入错误怎么办？

A: 系统会自动识别一些常见的代码格式，但如果识别失败，请：
- 中国市场：使用完整格式，如 `600519.SH` 或 `000001.SZ`
- 其他市场：按照该市场的标准格式输入

### Q5: 如何配置系统？

A: 
1. 访问"配置"页面
2. 在对应的标签页中配置各项设置
3. 使用"测试"按钮验证配置是否正确
4. 点击"保存所有配置"保存设置

### Q6: 分析报告生成需要多长时间？

A: 生成时间取决于：
- 财务数据的获取速度（通常几秒钟）
- AI 分析模块的数量和复杂度
- AI 服务的响应速度

完整的报告生成通常需要 1-5 分钟。

### Q7: 可以同时分析多只股票吗？

A: 目前系统每次只能分析一只股票。如需分析多只股票，请分别提交请求。

### Q8: 报告数据是实时的吗？

A: 
- 财务数据：来自 Tushare 等数据源，更新频率取决于数据源
- 股价图表：TradingView 提供实时股价数据
- AI 分析：基于当前获取的财务数据实时生成

## 系统配置

### 首次使用配置

首次使用系统时，需要配置以下内容：

1. **AI 服务配置**
   - API Key：输入您的 AI 服务 API 密钥
   - Base URL：输入 API 端点地址（如使用自建服务）

2. **数据源配置**
   - **Tushare**：输入 Tushare API Key（中国市场必需）
   - **Finnhub**：输入 Finnhub API Key（全球市场可选）

### 配置注意事项

- **敏感信息保护**：API 密钥等敏感信息在输入框中不会显示，留空表示保持当前值
- **配置验证**：保存前建议使用"测试"按钮验证各项配置
- **配置备份**：建议定期使用"导出配置"功能备份配置
- **配置恢复**：可使用"导入配置"功能恢复之前的配置

### 分析模块配置

在"配置"页面的"分析配置"标签页，您可以：

- **自定义模块名称**：修改分析模块的显示名称
- **选择 AI 模型**：为每个模块指定使用的 AI 模型
- **编辑提示词模板**：自定义每个模块的分析提示词
- **设置模块依赖**：配置分析模块之间的依赖关系

配置修改后，点击"保存分析配置"即可生效。

## 技术支持

如果您在使用过程中遇到问题，可以：

1. 查看"执行详情"中的错误信息
2. 检查系统配置是否正确
3. 查看系统日志（如果已启用）
4. 联系系统管理员获取支持

---

**最后更新**：2025年1月