1. 项目定位与用途
ritmex-bot 是一个基于 Bun 和 TypeScript 开发的多交易所永续合约量化交易终端，定位为专业交易者的自动化工作台。项目提供统一的 CLI 界面，集成趋势跟随、防守监控与做市三种策略引擎，支持在多个去中心化交易所（如 Aster、StandX、GRVT 等）上自动化执行永续合约交易。其核心用途是降低手动交易的操作复杂度与情绪风险，通过程序化方式实现风险控制、实时行情处理和快速恢复，适合需要多平台策略部署的量化交易者使用。
项目档案命令行工具
discountry/ritmex-bot CLI 工具：安装、命令与使用场景
discountry/ritmex-bot：ritmex-bot 是一个基于 Bun 的多交易所永续合约量化交易终端，内置 SMA30 趋势跟随、Guardian 防守监控与双边做市策略，本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
ritmex-bot 是一个基于 Bun 的多交易所永续合约量化交易终端，内置 SMA30 趋势跟随、Guardian 防守监控与双边做市策略，支持实时行情订阅、自动风控与快速恢复能力。
中文项目介绍
ritmex-bot 是一个专为加密货币交易者设计的开源量化交易终端，专注于永续合约自动化交易。项目基于 Bun 运行时和 TypeScript 开发，采用模块化架构设计，旨在提供统一、可靠的多交易所交易解决方案。
该机器人内置三种核心策略引擎：SMA30 趋势跟随策略通过移动平均线穿越进行顺势交易；Guardian 防守策略实时监控仓位并自动设置止损止盈，防止裸奔风险；做市策略提供双边报价赚取价差。它解决了多交易所切换困难、手动交易情绪化、风控缺失、断线恢复等问题，通过实时 WebSocket 行情订阅、结构化日志和自动断线重连确保交易连续性。
项目采用 Ink 框架构建交互式 CLI 仪表盘，支持方向键操作和实时状态查看。交易所适配层抽象了 Aster、StandX、GRVT、Lighter、Backpack、Paradex、Nado 等平台的差异，配置完全由 .env 文件驱动。适用场景包括：在多个 DEX 平台自动化执行永续合约交易、使用趋势策略进行顺势交易、通过防守策略管理风险、运行做市策略提供流动性。
支持一键脚本安装和手动安装，提供 pm2 进程管理集成，支持 --dry-run 模拟执行和 --json 结构化输出，便于自动化系统集成和回测。
详细信息与使用说明
2. 解决的问题
项目主要解决以下问题：多交易所 API 差异导致的集成复杂度，通过抽象适配层统一操作接口；手动交易的情绪化决策风险，通过严格的风控规则（止损、移动止盈、浮盈锁盈）自动化执行；断线或异常情况下的交易连续性缺失，通过 WebSocket 自动重连和状态快照快速恢复；策略切换与配置管理的便利性，通过 .env 集中配置和 CLI 菜单快速选择；以及运维监控的困难，通过结构化日志和 Ink 仪表盘提供实时可见性。
3. 适用场景
适用场景包括：在多个 DEX 平台（Aster、StandX、GRVT、Lighter、Backpack、Paradex、Nado）自动化执行永续合约交易；使用 SMA30 趋势策略进行顺势交易，配合布林带过滤和步进锁盈；通过 Guardian 策略监控现有仓位并强制补挂止损单，防止因疏忽导致的大幅亏损；运行双边做市策略提供流动性，利用追价机制和风险阈值控制赚取价差；以及需要快速恢复能力的生产环境，在进程重启后自动同步订单和仓位状态。
4. 安装方式
支持两种安装方式：一键脚本安装（macOS/Linux/WSL）执行 curl -fsSL https://github.com/discountry/ritmex-bot/raw/refs/heads/main/setup.sh | bash，脚本会自动安装 Bun、项目依赖，收集 Aster API 凭证并生成 .env 文件；手动安装需先 git clone 仓库，安装 Bun（验证 bun -v），运行 bun install 安装依赖，复制 .env.example 为 .env 并配置至少一个交易所的 API 密钥。系统要求 Bun ≥ 1.2，支持 macOS、Linux 或 Windows (WSL)。
5. 使用方式
运行 bun run index.ts 启动 CLI，使用方向键选择策略（trend/maker/offset-maker/maker-points 等）后回车执行，Esc 返回菜单，Ctrl+C 退出。支持命令行参数覆盖配置，如 --exchange grvt --strategy maker 指定交易所和策略，--dry-run 模拟执行不实际下单，--json 输出结构化结果便于集成。可通过 pm2 后台持久运行，项目已提供 pm2 脚本示例（如 pm2 start bun --name ritmex-trend -- run index.ts --strategy trend --silent）。
6. 架构与实现特点
项目采用高度模块化的分层架构：核心层包含订单协调器（管理锁、超时、去重和标记价格保护）、订单计划生成器（匹配当前与目标订单）、速率限制控制器（动态调整频率应对交易所限流）；策略层实现趋势、防守、做市三种引擎；适配层通过 ExchangeAdapter 接口统一不同交易所的订单、行情和账户操作；交互层使用 Ink 构建终端仪表盘。配置完全由 .env 驱动，支持多交易所密钥和风险参数，风控集成在订单执行前检查，确保交易安全。
思维导图
ritmex-bot
核心策略引擎
趋势策略 (SMA30)
Guardian 防守策略
做市策略 (maker/offset-maker)
交易所适配层
Aster (USDT 永续)
StandX (USD 永续)
GRVT (USDT 永续)
Lighter (zkLighter 永续)
Backpack (USDC 永续)
Paradex (USDC 永续)
Nado (USDC 永续)
常见问题
discountry/ritmex-bot 是做什么的？
ritmex-bot 是一个基于 Bun 的多交易所永续合约量化交易终端，内置 SMA30 趋势跟随、Guardian 防守监控与双边做市策略，支持实时行情订阅、自动风控与快速恢复能力。
discountry/ritmex-bot 适合用在什么场景？
ritmex-bot 是一个基于 Bun 和 TypeScript 开发的多交易所永续合约量化交易终端，定位为专业交易者的自动化工作台。项目提供统一的 CLI 界面，集成趋势跟随、防守监控与做市三种策略引擎，支持在多个去中心化交易所（如 Aster、StandX、GRVT 等）上自动化执行永续合约交易。其核心用途是降低手动交易的操作复杂度与情绪风险，通过程序化方式实现风险控制、实时行情处理和快速恢复，适合需要多平台策略部署的量化交易者使用。
discountry/ritmex-bot 如何安装？
支持两种安装方式：一键脚本安装（macOS/Linux/WSL）执行 curl -fsSL https://github.com/discountry/ritmex-bot/raw/refs/heads/main/setup.sh | bash，脚本会自动安装 Bun、项目依赖，收集 Aster API 凭证并生成 .env 文件；手动安装需先 git clone 仓库，安装 Bun（验证 bun -v），运行 bun install 安装依赖，复制 .env.example 为 .env 并配置至少一个交易所的 API 密钥。系统要求 Bun ≥ 1.2，支持 macOS、Linux 或 Windows (WSL)。
discountry/ritmex-bot 如何开始使用？
运行 bun run index.ts 启动 CLI，使用方向键选择策略（trend/maker/offset-maker/maker-points 等）后回车执行，Esc 返回菜单，Ctrl+C 退出。支持命令行参数覆盖配置，如 --exchange grvt --strategy maker 指定交易所和策略，--dry-run 模拟执行不实际下单，--json 输出结构化结果便于集成。可通过 pm2 后台持久运行，项目已提供 pm2 脚本示例（如 pm2 start bun --name ritmex-trend -- run index.ts --strategy trend --silent）。