用途:生成专业深色主题的交易总结卡片 PNG 图片,风格参照 TradingView/Hyperliquid 美学,展示币种、方向、杠杆、开仓/平仓价、PnL、ROE。当用户需要可视化交易回顾、盈利海报或可分享的交易图片时使用。
主要能力:以 config 字典或 CLI 参数输入交易数据,输出 PNG 图片。配置字段中 coin(资产符号,如 BTC、ETH)、entry(开仓价)、exit(平仓/当前价)、size(以基础资产计的头寸规模)、side("long" 或 "short")为必填;leverage(杠杆倍数,默认 1)、status("open" 或 "closed",默认 "closed")、notes(交易描述/策略备注)可选。输出为 PNG,保存至 output/ 目录,文件名自动生成为 {coin}{side}{timestamp}.png 或自定义路径,分辨率 800×520px,深色主题。
使用方式:可从 Agent 代码调用,import sys 后 sys.path.insert(0, "skills/profit-poster/scripts"),再 from generate_poster import generate_poster,构造 config 字典后调用 generate_poster(config, "output/btc_trade.png")。也可从 CLI 运行,使用 python3 skills/profit-poster/scripts/generate_poster.py 传入 --config 的 JSON 字符串与 --output 路径。
工作流程:收集交易数据(来自 hl_account、hl_fills 或用户输入),构建 config 字典,调用 generate_poster(config),图片保存至 output/。
依赖与限制:依赖 Pillow(PIL),可用 pip install Pillow --break-system-packages 安装;字体使用 DejaVu Sans(多数 Linux 已预装)。其余平台支持、收费、价格等细节暂未提供。