tradesync/CHANGELOG.md

Changelog

本文件记录项目所有值得注意的变更。 格式遵循 Keep a Changelog，版本号遵循 SemVer。

[Unreleased]

Fixed

• 将 TradeSnap 截图请求超时从 15 秒提高到 30 秒：每轮第一个截图请求（通常是 15m）需额外等待浏览器会话清理，约 16 秒完成，此前会被 15 秒超时误判为失败。
• 修复加仓成交被静默忽略的问题：开仓判断从 start_position == 0 改为使用 Hyperliquid 的 dir 字段（Open Long / Open Short），已有持仓时的加仓现在也会写入 Notion。
• 修复同一订单（oid）慢速多笔成交被截断的问题：聚合由「首笔成交后固定 500 毫秒窗口」改为「3 秒防抖」，每笔新成交重置计时器，静默 3 秒后才汇总发送，避免写入的数量小于实际成交量。
• PositionTradeEvent 现在携带真实的 start_pos / end_pos，并区分 Open（从零开仓）与 Increase（加仓）动作。

Added

• 支持对接 TradeSnap 截图服务，自动抓取新交易对应的 TradingView 图表快照。
• 新增 ENABLE_SCREENSHOT 与 TRADESNAP_URL 配置，控制截图的开关和请求地址。
• 新增 BTCUSDT_SNAPSHOT 配置，控制使用 BINANCE:{coin}USDT.P 还是 BINANCE:{coin}USDC.P 格式生成图表截图。
• 新增 SYMBOL_15M_SNAPSHOT、SYMBOL_1H_SNAPSHOT、SYMBOL_4H_SNAPSHOT、SYMBOL_1D_SNAPSHOT 四个独立的开关配置，精细控制所要插入截图的时间周期。
• 新建页面时，按配置周期顺序在 Notion 页面正文内自动追加文字标题（SYMBOL_{timeframe} Snapshot）、截图图片以及空白行间距。
• 添加 serde 依赖库（并开启 derive feature）以支持接口响应的反序列化。
• 支持根据 crossed 属性自动映射 Order Type 类型（MARKET / LIMIT）写入 Notion 数据库。
• 实现 NotionWriter 模块，支持将格式化交易记录批量写入 Notion 数据库。
• 实现 HyperliquidMonitor 针对同一订单（oid）在 500 毫秒内的多成交 tick 聚合功能，防止拆单造成多笔重复写入。
• 定义 NotionRowData 与 TradeAction 结构，提供结构化的 Notion 写入数据模型。
• 新增 examples/fetch_notion_db.rs 用于实时抓取 Notion Database 列配置的开发脚本。
• 实现 HyperliquidMonitor 用于实时订阅以太坊/Hyperliquid钱包账户的交易与开仓事件。
• 添加 alloy、chrono 与 serde_json 库依赖。
• 新增 integration test tests/monitor_test.rs 与使用示例 examples/demo.rs。
• 添加外部参考库作为 Git 子模块：noc (notion-client) 与 hype (hyperliquid-rust-sdk)。

Changed

• 将项目与 Crate 命名从 nosync 统一重命名为 tradesync，并同步更新了所有 Rust 源码包导入和 Docker 镜像名称。
• 更新 Docker Compose 配置，移除了 tradesnap 和 tradesync （原 nosync）多余的 volumes 目录挂载，并统一使用 :latest 镜像标签以替代固定版本。
• 移除 Level 字段的相关计算与 Notion 写入逻辑（交由用户后续手动设置）。
• 重构 src/main.rs，实现从 Hyperliquid WebSocket 捕获开仓事件并自动格式化写入 Notion Database 的闭环服务。
• 将 hyperliquid_rust_sdk 与 notion-client 依赖方式更改为指向官方 Git 仓库 of 远程依赖，移除本地 Path 依赖。

Removed

• 移除初始化模版中未使用的占位模块 (ModuleA, ModuleB) 及其对应测试文件。

[0.1.0] - 2026-05-30

Added

• 初始化 Rust 工程项目结构与核心配置
• 实现 ModuleA 与 ModuleB 业务类及接口设计
• 配置 tokio 异步运行时、thiserror 自定义错误与 anyhow 二进制入口错误处理
• 集成 tracing 结构化日志与 dotenvy 环境配置读取
• 新增集成测试与示例代码