gemini cli 给的设计文档

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

  1. 概述 (Overview)

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

与前版设计不同,本次重构将极大地丰富报告内容。除了核心的市场数据和K线图表,脚本还将通过网络搜索自动获取每个代币的项目Logo和详细的项目介绍。最终,所有这些定量和定性信息将被整合并渲染
到一个视觉丰满、信息全面的、具有现代化 Web3 风格的自包含HTML文件中。

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

  1. 核心技术栈 (Core Technology Stack)
  • 数据获取与处理 (Data Fetching & Processing):
    • Python 3, ccxt, Pandas
    • 新增:google_web_search (或类似的网络信息获取工具): 用于根据代币名称动态搜索并提取其项目简介。
  • 报告生成 (Report Generation):

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

    • 内联 CSS3, 内联 Chart.js
  1. 项目结构与执行流程 (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 文件中。
  1. 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线图 + 交易量柱状图。
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • """1.个性化消息: 将用户的姓名存到一个变量中,并向该用户显示一条消息。显示的消息应非常简单,如“Hello ...
    她即我命阅读 3,284评论 0 5
  • 为了让我有一个更快速、更精彩、更辉煌的成长,我将开始这段刻骨铭心的自我蜕变之旅!从今天开始,我将每天坚持阅...
    李薇帆阅读 1,909评论 0 3
  • 似乎最近一直都在路上,每次出来走的时候感受都会很不一样。 1、感恩一直遇到好心人,很幸运。在路上总是...
    时间里的花Lily阅读 1,353评论 0 1
  • 1、expected an indented block 冒号后面是要写上一定的内容的(新手容易遗忘这一点); 缩...
    庵下桃花仙阅读 517评论 0 1
  • 一、工具箱(多种工具共用一个快捷键的可同时按【Shift】加此快捷键选取)矩形、椭圆选框工具 【M】移动工具 【V...
    墨雅丫阅读 530评论 0 0