┌─────────────────────────────────────────────────────────────────┐
│                        用户界面层                                │
│   ┌─────────────────────────────────────────────────────────┐   │
│   │         Web 前端 (HTML/CSS/JavaScript)                  │   │
│   │         - 仪表板、日志分析、报告查看、设置管理            │   │
│   └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│                        后端服务层                                │
│   ┌─────────────────────────────────────────────────────────┐   │
│   │            Flask REST API Server                         │   │
│   │    /api/status | /api/analyze | /api/reports | ...      │   │
│   └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│                        核心分析层                                │
│   ┌───────────────┐  ┌───────────────┐  ┌───────────────────┐   │
│   │ 综合分析器    │  │ 投诉分析器    │  │ 历史追溯分析器    │   │
│   │ Comprehensive │  │ Complaint     │  │ Historical Trace  │   │
│   └───────────────┘  └───────────────┘  └───────────────────┘   │
│   ┌───────────────────────────────────────────────────────────┐ │
│   │              报告生成器 (HTML/JSON/AI增强)                │ │
│   │     EnhancedDetailedReportGenerator + DeepSeek AI        │ │
│   └───────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│                        外部服务层                                │
│   ┌───────────────────────────────────────────────────────────┐ │
│   │        DeepSeek / OpenAI API (AI 智能分析增强)            │ │
│   └───────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘

# 进入项目目录
cd log_reader

# 安装 Python 依赖
pip install -r requirements.txt

# 启动后端服务 (默认端口 8080)
python backend/server.py

# 或使用启动脚本
python start_server.py

# 测试系统功能
python test_system.py

# 测试 API 连接
python test_api_connection.py

log_reader/
├── 📁 backend/                      # 后端服务
│   └── server.py                   # Flask Web 服务器
├── 📁 frontend/                     # 前端界面
│   ├── index.html                  # 主页面
│   ├── script.js                   # 前端逻辑
│   └── styles.css                  # 样式表
├── 📁 logs/                         # 日志文件目录 (输入)
│   ├── *.txt                       # 文本日志
│   ├── *.log                       # 标准日志
│   └── cartographer_node.*         # Cartographer 日志
├── 📁 reports/                      # 生成的报告 (输出)
├── 📁 temp_reports/                 # 临时报告
├── 📁 reports_new/                  # 新版报告
├── 📁 final_reports/                # 最终报告存档
│
├── 📄 核心分析模块
│   ├── comprehensive_robot_analyzer.py    # 综合分析器 (728行)
│   ├── advanced_log_analyzer.py           # 高级日志分析器 (585行)
│   ├── complaint_analyzer.py              # 投诉分析器 (602行)
│   ├── historical_trace_analyzer.py       # 历史追溯分析器 (626行)
│   └── complete_robot_log_analyzer.py     # 分析器入口
│
├── 📄 报告生成模块
│   ├── report_generator.py                       # 基础报告生成器
│   ├── enhanced_report_generator.py              # 增强报告生成器
│   ├── enhanced_detailed_report_generator.py     # 详细增强报告 (677行)
│   ├── deepseek_enhanced_report_generator.py     # AI增强报告 (1023行)
│   └── gpt_enhanced_report_generator.py          # GPT增强报告
│
├── 📄 配置与入口
│   ├── config.py                   # 配置文件 (API/路径/参数)
│   ├── start_server.py             # 服务启动脚本
│   ├── run_frontend.py             # 前端启动脚本
│   └── requirements.txt            # Python 依赖
│
├── 📄 测试文件
│   ├── test_system.py              # 系统功能测试
│   ├── test_api_connection.py      # API连接测试
│   ├── test_deepseek_connection.py # DeepSeek测试
│   └── test_*.py                   # 其他测试脚本
│
├── 📄 文档
│   ├── README.md                   # 项目说明 (本文件)
│   ├── architecture.md             # 架构文档
│   ├── task.md                     # 任务规划
│   └── README_SECURITY.md          # 安全说明
│
└── 📁 trickyuser/                   # 扩展用户模块
    ├── logs/
    └── src/

# 基础分析
curl -X POST http://localhost:8080/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"log_directory": "./logs", "enable_ai": false, "report_type": "basic"}'

# 综合分析 (含AI增强)
curl -X POST http://localhost:8080/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"log_directory": "./logs", "enable_ai": true, "report_type": "comprehensive"}'

# 带投诉时间的分析
curl -X POST http://localhost:8080/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"log_directory": "./logs", "complaint_time": "2025-10-15 14:30:00"}'

# 日志和报告路径
export LOG_DIRECTORY="./logs"
export REPORTS_DIRECTORY="./reports"
export TEMP_REPORTS_DIRECTORY="./temp_reports"

# OpenAI API (可选)
export OPENAI_API_KEY="sk-your-key"
export BASE_URL="https://api.openai.com/v1"

# DeepSeek API (可选，用于AI增强报告)
export DEEPSEEK_API_KEY="sk-your-deepseek-key"
export DEEPSEEK_BASE_URL="https://api.deepseek.com/v1"
export DEEPSEEK_MODEL="deepseek-chat"
export USE_DEEPSEEK="true"

# AI 请求参数
export MAX_TOKENS="1000"
export TEMPERATURE="0.7"
export REQUEST_TIMEOUT="30"

import os

# 目录配置
LOG_DIRECTORY = os.getenv("LOG_DIRECTORY", "./logs")
REPORTS_DIRECTORY = os.getenv("REPORTS_DIRECTORY", "./reports")
TEMP_REPORTS_DIRECTORY = os.getenv("TEMP_REPORTS_DIRECTORY", "./temp_reports")

# AI API 配置
OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
DEEPSEEK_API_KEY = os.getenv("DEEPSEEK_API_KEY")
USE_DEEPSEEK = os.getenv("USE_DEEPSEEK", "false").lower() == "true"

# 动态选择 API
API_KEY = DEEPSEEK_API_KEY if USE_DEEPSEEK else OPENAI_API_KEY

# 基础综合分析
python comprehensive_robot_analyzer.py -d ./logs -o ./reports

# 投诉问题分析
python complaint_analyzer.py -d ./logs --complaint-time "2025-10-15 14:30:00"

# 历史追溯分析
python historical_trace_analyzer.py -d ./logs -o ./reports

{
  "report_metadata": {
    "report_id": "comprehensive_report_20251128_125145",
    "generated_at": "2025-11-28T12:51:45",
    "analysis_type": "comprehensive"
  },
  "analysis_summary": {
    "total_log_files": 10,
    "total_anomalies": 5,
    "total_task_segments": 3
  },
  "task_segments": [...],
  "anomalies": [...],
  "recommendations": [...]
}

from comprehensive_robot_analyzer import ComprehensiveRobotAnalyzer

analyzer = ComprehensiveRobotAnalyzer('./logs')

# 自定义任务识别模式
analyzer.task_patterns['custom_task'] = [
    r'自定义任务模式',
    r'custom.*task.*pattern'
]

# 自定义异常检测模式
analyzer.anomaly_patterns['custom_anomaly'] = [
    r'自定义异常关键词',
    r'custom.*error'
]

# 执行分析
analyzer.analyze_all_logs()
report = analyzer.generate_comprehensive_report()

from enhanced_detailed_report_generator import EnhancedDetailedReportGenerator

class CustomReportGenerator(EnhancedDetailedReportGenerator):
    def add_custom_section(self, data):
        # 添加自定义报告章节
        pass

from deepseek_enhanced_report_generator import DeepSeekEnhancedReportGenerator

generator = DeepSeekEnhancedReportGenerator(
    analysis_report_path='./temp_reports/report.json',
    api_key='your-api-key',
    base_url='https://your-api-endpoint/v1'
)
generator.generate_detailed_report('./reports/ai_report.html')

# 检查端口占用
lsof -i :8080

# 使用其他端口
python backend/server.py --port 9090

# 升级 pip
pip install --upgrade pip

# 重新安装依赖
pip install -r requirements.txt --force-reinstall

# 测试 DeepSeek 连接
python test_deepseek_connection.py

# 检查 API Key 配置
python -c "from config import DEEPSEEK_API_KEY; print(bool(DEEPSEEK_API_KEY))"

import logging
logging.basicConfig(level=logging.DEBUG)

# 或在配置中启用
export FLASK_DEBUG=1

# 1. 克隆/下载项目
cd log_reader

# 2. 安装依赖
pip install -r requirements.txt

# 3. 启动服务
python backend/server.py

# 4. 打开浏览器访问
open http://localhost:8080