Weather Station 交易引擎

版本： 1.0.0 最后更新： 2025-10-06

---

🚀 关于 Weather Station

Weather Station 是 TradingFlow 的核心交易执行引擎，为量化交易策略提供高性能、分布式、可靠的自动化执行能力。

核心价值：

• 🎯 智能交易自动化 - 通过可视化节点构建复杂交易策略

• ⚡ 高性能执行 - 分布式架构支持毫秒级交易响应

• 🔒 企业级可靠性 - 完善的状态管理和异常恢复机制

• 🌐 多链支持 - 原生支持 Aptos、Flow EVM 等多条区块链

---

📚 快速开始

从这里开始： Weather Station 文档索引

---

📂 文档结构

核心技术文档（本目录）

7_docs/zh/engineering-docs/
├── weather-station-index.md              # 📖 主索引（从这里开始）
├── weather-station-overview.md           # 🏗️ 引擎架构概述
├── weather-station-message-queue.md      # 📨 交易信号传递机制
├── weather-station-redis.md              # 💾 状态管理系统
├── weather-station-node-execution.md     # ⚙️ 交易节点执行流程
├── weather-station-flow-scheduling.md    # 🔄 策略调度机制
├── community-nodes-system.md             # 🌐 社区节点与版本控制
├── quest-system.md                       # 🎮 任务系统与游戏化
└── co-trading-system.md                  # 👥 共同投资（社交交易平台）

节点详情文档（独立页面）

位置： 7_docs/zh/node-details/

每个节点都有独立的详细文档页面，包含完整的参数说明、使用示例和最佳实践。

中文版本：

7_docs/zh/node-details/
├── index.md                          # 节点文档索引
├── binance-price-node.md             ✅ Binance 价格节点
├── x-listener-node.md                ✅ X 监听节点
├── dataset-input-node.md             ✅ 数据集输入节点
├── ai-model-node.md                  ✅ AI 模型节点
├── code-node.md                      ✅ 代码节点
├── swap-node.md                      ✅ 交换节点
├── buy-node.md                       ✅ 买入节点
├── sell-node.md                      ✅ 卖出节点
├── vault-node.md                     ✅ Vault 节点
├── dataset-output-node.md            ✅ 数据集输出节点
└── telegram-sender-node.md           ✅ Telegram 发送节点

英文版本：

7_docs/en/node-details/
├── index.md                          # Node Documentation Index
└── binance-price-node.md             ✅ Binance Price Node

---

🚀 推荐阅读路径

业务用户/产品经理路径（约 1 小时）

1. weather-station-index.md           # 了解交易引擎整体能力
2. weather-station-overview.md        # 理解核心架构和优势
3. ../node-details/index.md           # 查看可用交易节点

完整技术路径（约 3 小时）

1. weather-station-index.md           # 了解整体架构
2. weather-station-overview.md        # 深入核心概念
3. weather-station-message-queue.md   # 理解交易信号传递
4. weather-station-redis.md           # 掌握状态管理
5. weather-station-node-execution.md  # 学习节点执行机制
6. weather-station-flow-scheduling.md # 理解策略调度
7. ../node-details/index.md           # 查看具体节点实现

策略开发者路径（约 50 分钟）

1. weather-station-overview.md        # 核心概念
2. weather-station-node-execution.md  # 节点使用方法
3. ../node-details/index.md           # 节点能力速查

---

📊 文档统计

核心技术文档

文档	字数	状态
引擎架构概述	17,500	✅ 完成
交易信号传递机制	22,000	✅ 完成
状态管理系统	17,500	✅ 完成
节点执行流程	27,500	✅ 完成
策略调度机制	24,500	✅ 完成
总计	~109,000	100%

交易节点文档

分类	中文文档	英文文档
数据采集节点	3 篇	1 篇
AI 智能分析	2 篇	0 篇
交易执行节点	3 篇	0 篇
资产管理节点	1 篇	0 篇
数据输出节点	1 篇	0 篇
消息通知节点	1 篇	0 篇
总计	12 篇	1 篇

---

🎯 文档导航

按主题查找

• 系统架构: weather-station-overview.md

• 通信机制: weather-station-message-queue.md

• 状态存储: weather-station-redis.md

• 节点开发: weather-station-node-execution.md

• 调度机制: weather-station-flow-scheduling.md

• 社区节点: community-nodes-system.md

• 任务系统: quest-system.md

• 共同投资: co-trading-system.md

• 节点详情: ../zh/node-details/index.md

按角色查找

业务用户/产品经理：

主索引 → 引擎架构 → 交易节点能力

策略开发者：

引擎架构 → 节点使用指南 → 具体节点示例

技术架构师：

架构概述 → 信号传递机制 → 状态管理 → 调度系统

运维工程师：

状态管理系统 → 调度机制 → 执行流程监控

社区贡献者：

社区节点系统 → 节点创建指南 → 发布与分享

---

🔍 快速查询

常见问题

问题	文档位置
如何创建新节点？	节点执行流程 - 开发新节点
如何创建社区节点？	社区节点系统 - 用户指南
信号如何传递？	消息队列详解 - 信号传递流程
Redis 键如何设计？	Redis 状态管理 - Key 命名规范
Flow 如何调度？	Flow 调度机制 - 周期调度
节点状态有哪些？	节点执行流程 - 节点生命周期

节点快速查找

需求	推荐节点
获取价格数据	Binance Price Node
AI 分析决策	AI Model Node
自定义逻辑	Code Node
代币交换	Swap Node
读取 Google Sheets	Dataset Input Node
写入 Google Sheets	Dataset Output Node
发送通知	Telegram Sender Node
创建并分享自定义节点	Community Nodes System

---

📖 相关资源

代码位置

• 节点实现: 3_weather_cluster/tradingflow/station/nodes/

• 节点基类: 3_weather_cluster/tradingflow/station/nodes/node_base.py

• 调度器: 3_weather_cluster/tradingflow/station/flow/scheduler.py

• 消息队列: 4_weather_depot/tradingflow/depot/python/mq/

• 社区节点（Station）: 03_weather_station/core/ (version_manager, node_registry, community_node_executor)

• 社区节点（Control）: 02_weather_control/src/models/, src/services/, src/routes/community/

• 社区节点（Frontend）: 01_weather_frontend/src/pages/ (CommunityNodesPage, CommunityNodeDetailPage)

API 端点

• Weather Control API: http://localhost:8000/api/v1/flow/*

• Worker API: http://localhost:8080/execute

• 节点列表 API: http://localhost:8000/api/v1/nodes/types

• 社区节点 API: http://localhost:8000/api/v1/community/nodes

• 社区节点评论 API: http://localhost:8000/api/v1/community/nodes/:nodeId/comments

---

🤝 贡献指南

添加新文档

1. 核心文档放在 7_docs/developer/

2. 节点详情文档放在 7_docs/zh/node-details/（中文）或 7_docs/en/node-details/（英文）

3. 更新主索引 weather-station-index.md

4. 更新节点索引 ../zh/node-details/index.md

文档质量要求

• ✅ 清晰的标题和结构

• ✅ 完整的代码示例

• ✅ 实际可运行的示例

• ✅ 详细的参数说明

• ✅ 相关文档链接

---

维护者： TradingFlow 开发团队 反馈渠道： 通过项目 Issue 反馈 最后更新： 2025-10-06