gemini cli 给的设计模板（全新开发）

Bitget 7日涨幅TOP10综合分析报告

1. 概述 (Overview)

本项目旨在将现有的多模块加密货币分析工具重构为一个独立的 Python 脚本。该脚本将专门连接 Bitget 交易所，计算并筛选出过去7天内涨幅最高的前10名代币（仅限USDT现货交易对）。

除了核心的市场数据和K线图表，脚本还将通过网络搜索自动获取每个代币的项目Logo和详细的项目介绍。最终，所有这些定量和定性信息将被整合并渲染
到一个视觉丰满、信息全面的、具有现代化 Web3 风格的自包含HTML文件中。

最终交付物只有一个文件：bitget_7d_comprehensive_report.html。

2. 核心技术栈 (Core Technology Stack)

• 数据获取与处理 (Data Fetching & Processing):
  • Python 3, ccxt, Pandas
  • 新增：google_web_search (或类似的网络信息获取工具): 用于根据代币名称动态搜索并提取其项目简介。

• 报告生成 (Report Generation):

  • Jinja2, HTML5

• 前端与可视化 (Frontend & Visualization):

  • 内联 CSS3, 内联 Chart.js

3. 项目结构与执行流程 (Project Structure & Execution Flow)

项目结构保持不变，但执行流程中加入了关键的“信息丰富化”步骤。

• 建议文件结构:

1 /crypto-report/
2 ├───generate_report.py # 主执行脚本
3 └───template.html # Jinja2 HTML 模板

• 执行流程 (已更新):
  1. 启动 & 初始化: 用户执行脚本，初始化ccxt。
  2. 计算7日涨幅TOP10: (流程同前一版) 获取所有USDT交易对，通过历史日线数据计算7日涨幅，并筛选出前10名。
  3. 信息丰富化 (关键新增步骤):
     a. 获取详细数据: 遍历涨幅前10的交易对列表。对于每一个代币：
     * 调用 fetch_ohlcv() 获取用于生成图表的小时级K线数据。
     * 从 ccxt 的市场数据中尝试提取项目Logo的URL（部分交易所会提供）。
     b. 获取项目描述:
     * 如果Logo无法直接获取，则跳过或使用占位符。
     * 构造一个搜索查询，例如 "What is Bitcoin (BTC) cryptocurrency project?"。
     * 调用 google_web_search 工具执行搜索。
     * 从搜索结果中提取最相关的文本片段（例如，来自CoinMarketCap, CoinGecko或项目官网的摘要）作为项目描述。脚本将包含一个简单的解析逻辑来提炼这段文字。
  4. 数据准备: 将前10名代币的所有信息（7日涨幅、当前价格、交易量、小时K线数据、项目Logo URL、项目描述）整合到一个列表结构中。
  5. 模板渲染: 加载 template.html，使用Jinja2的循环，为每个代币动态生成包含其所有新增信息的完整内容块。
  6. 文件输出: 将渲染完成的HTML内容写入到 bitget_7d_comprehensive_report.html 文件中。

4. HTML 报告设计 (HTML Report Design)

主题： "Crypto Deep Dive: Bitget 7-Day Top Gainers" - 一个结合了市场数据与基本面信息的综合仪表盘。

• 布局 (Layout - 已更新):
  • 头部: 报告主标题和生成时间。
  • 总览表格: (保持不变) 快速预览前10名代币的核心数据（排名、名称、7日涨幅等）。
  • 代币详情卡片 (Card-based Layout):
    • 取代原有的垂直详情区，我们将为每个代币设计一个独立的、内容丰富的“卡片”。
    • 卡片头部:
      • 左侧是项目Logo和代币名称 (例如: BTC/USDT)。
      • 右侧是醒目的7日涨幅百分比。
    • 卡片主体 - 左侧 (定性信息):
      • 一个专门的区域用来展示项目描述。这段文字将提供项目的核心价值和背景信息。
    • 卡片主体 - 右侧 (定量信息):
      • 一组玻璃拟态风格的指标卡片（当前价格、24h交易量等）。
    • 卡片底部 (图表):
      • 横跨整个卡片底部的交互式K线图，展示7日内的小时级价格和交易量走势。

• 风格 (Style - Web3 Aesthetic):
  • 风格设计保持不变（暗黑主题、玻璃拟态、辉光效果等），但将应用到更复杂的卡片式布局中，确保信息层次清晰，视觉效果统一。

• 内容与图表 (Content & Chart - 已更新):
  • 总览表格: 排名, Logo, 代币符号, 7日涨幅 (%), 当前价格, 24h交易量。
  • 每个代币的详情卡片:
    • 定性: Logo, 项目名称, 项目描述。
    • 定量: 7日涨幅, 当前价格, 24h高/低价, 24h交易量。
    • 图表: 7日小时级K线图 + 交易量柱状图。