⚠️ 警告： 本软件仅供教育和信息参考。本仓库中的任何内容均不构成财务、投资、法律或税务建议。

MAHORAGA

一个由 LLM 驱动的自动交易智能体，全天候（24/7）运行在 Cloudflare Workers 上。

MAHORAGA 通过 StockTwits 和 Reddit 监控社交媒体情绪，利用 AI（通过 AI SDK 集成的 OpenAI、Anthropic、Google、xAI、DeepSeek）分析信号，并通过 Alpaca 执行交易。它作为 Cloudflare Durable Object 运行，具备持久化状态、自动重启功能，并支持 24/7 加密货币交易。

特性

• 24/7 全天候运行 — 运行在 Cloudflare Workers 上，无需本地机器。
• 多来源信号 — 整合 StockTwits、Reddit（4 个子版块）以及 Twitter 确认信息。
• 多模型 LLM 支持 — 通过 AI SDK 或 Cloudflare AI Gateway 支持 OpenAI、Anthropic、Google、xAI、DeepSeek。
• 加密货币交易 — 全天候交易 BTC、ETH、SOL。
• 期权支持 — 支持高置信度的期权交易策略。
• 陈旧信号检测 — 自动平掉失去动能的持仓。
• 盘前分析 — 在市场开盘前准备交易计划。
• Discord 通知 — 获取买入（BUY）信号提醒。
• 插件化策略系统 — 无需修改核心文件即可创建自定义策略。

环境要求

• Node.js 18+
• Cloudflare 账户（免费层级即可）
• Alpaca 账户（免费，支持模拟交易）
• LLM API Key（OpenAI, Anthropic, Google, xAI, DeepSeek）或 Cloudflare AI Gateway 凭证

快速开始

1. 克隆项目并安装依赖

git clone https://github.com/ygwyg/MAHORAGA.git
cd mahoraga
npm install

2. 创建 Cloudflare 资源

# 创建 D1 数据库
npx wrangler d1 create mahoraga-db
# 将 database_id 复制到 wrangler.jsonc

# 创建 KV 命名空间
npx wrangler kv namespace create CACHE
# 将 id 复制到 wrangler.jsonc

# 执行数据库迁移
npx wrangler d1 migrations apply mahoraga-db

3. 设置密钥

# 必需
npx wrangler secret put ALPACA_API_KEY
npx wrangler secret put ALPACA_API_SECRET

# API 认证 - 生成一个安全的随机令牌（建议 64 位以上字符）
# 示例: openssl rand -base64 48
npx wrangler secret put MAHORAGA_API_TOKEN

# LLM 提供商（选择一种模式）
npx wrangler secret put LLM_PROVIDER  # "openai-raw" (默认), "ai-sdk", 或 "cloudflare-gateway"
npx wrangler secret put LLM_MODEL     # 例如 "gpt-4o-mini" 或 "anthropic/claude-sonnet-4"

# LLM API 密钥（根据所选模式配置）
npx wrangler secret put OPENAI_API_KEY         # 适用于 openai-raw 或带有 OpenAI 的 ai-sdk
npx wrangler secret put OPENAI_BASE_URL        # 可选：覆盖 openai-raw 和 ai-sdk (OpenAI 模型) 的 base URL
# npx wrangler secret put ANTHROPIC_API_KEY    # 适用于带有 Anthropic 的 ai-sdk
# npx wrangler secret put GOOGLE_GENERATIVE_AI_API_KEY  # 适用于带有 Google 的 ai-sdk
# npx wrangler secret put XAI_API_KEY          # 适用于带有 xAI/Grok 的 ai-sdk
# npx wrangler secret put DEEPSEEK_API_KEY     # 适用于带有 DeepSeek 的 ai-sdk
# npx wrangler secret put CLOUDFLARE_AI_GATEWAY_ACCOUNT_ID  # 适用于 cloudflare-gateway
# npx wrangler secret put CLOUDFLARE_AI_GATEWAY_ID          # 适用于 cloudflare-gateway
# npx wrangler secret put CLOUDFLARE_AI_GATEWAY_TOKEN       # 适用于 cloudflare-gateway

# 可选
npx wrangler secret put ALPACA_PAPER         # "true" 表示使用模拟交易（推荐）
npx wrangler secret put TWITTER_BEARER_TOKEN
npx wrangler secret put DISCORD_WEBHOOK_URL
npx wrangler secret put KILL_SWITCH_SECRET   # 紧急停机开关（与 API token 分离）

4. 部署

npx wrangler deploy

5. 启用智能体

所有 API 接口都需要通过 Bearer token 进行身份验证：

# 为了方便，将 API 令牌设置为环境变量
export MAHORAGA_TOKEN="your-api-token"

# 启用智能体
curl -H "Authorization: Bearer $MAHORAGA_TOKEN" \
  https://mahoraga.bernardoalmeida2004.workers.dev/agent/enable

6. 监控

# 检查状态
curl -H "Authorization: Bearer $MAHORAGA_TOKEN" \
  https://mahoraga.bernardoalmeida2004.workers.dev/agent/status

# 查看日志
curl -H "Authorization: Bearer $MAHORAGA_TOKEN" \
  https://mahoraga.bernardoalmeida2004.workers.dev/agent/logs

# 紧急停机开关（使用独立的 KILL_SWITCH_SECRET）
curl -H "Authorization: Bearer $KILL_SWITCH_SECRET" \
  https://mahoraga.bernardoalmeida2004.workers.dev/agent/kill

# 在本地运行仪表盘
cd dashboard && npm install && npm run dev

本地开发

# 终端 1 - 启动 wrangler
npx wrangler dev

# 终端 2 - 启动仪表盘
cd dashboard && npm run dev

# 终端 3 - 启用智能体
curl -H "Authorization: Bearer $MAHORAGA_TOKEN" \
  http://localhost:8787/agent/enable

自定义策略

Mahoraga 使用插件化策略系统。核心程序只是一个轻量级的编排器——所有可自定义的逻辑都位于策略模块中，你无需修改任何核心文件。