+
+
+### Coverage Guidelines
+- 🟢 >= 80%: Excellent
+- 🟡 >= 60%: Good
+- 🟠 >= 40%: Fair
+- 🔴 < 40%: Needs improvement
+
+---
+*This is an automated coverage report. The coverage requirement is advisory and does not block PR merging.*
+"""
+ return comment
+
+
+def find_existing_comment(token: str, repo: str, pr_number: int) -> Optional[int]:
+ """
+ Find existing coverage comment in the PR.
+
+ Args:
+ token: GitHub token
+ repo: Repository in format "owner/repo"
+ pr_number: Pull request number
+
+ Returns:
+ Comment ID if found, None otherwise
+ """
+ url = f"https://api.github.com/repos/{repo}/issues/{pr_number}/comments"
+ headers = {
+ 'Authorization': f'token {token}',
+ 'Accept': 'application/vnd.github.v3+json'
+ }
+
+ try:
+ response = requests.get(url, headers=headers)
+ response.raise_for_status()
+ comments = response.json()
+
+ # Look for existing coverage comment
+ for comment in comments:
+ if (comment.get('user', {}).get('type') == 'Bot' and
+ 'Go Test Coverage Report' in comment.get('body', '')):
+ return comment['id']
+
+ except requests.exceptions.RequestException as e:
+ print(f"Error fetching comments: {e}", file=sys.stderr)
+
+ return None
+
+
+def post_comment(token: str, repo: str, pr_number: int, body: str) -> bool:
+ """
+ Post a new comment to the PR.
+
+ Args:
+ token: GitHub token
+ repo: Repository in format "owner/repo"
+ pr_number: Pull request number
+ body: Comment body
+
+ Returns:
+ True if successful, False otherwise
+ """
+ url = f"https://api.github.com/repos/{repo}/issues/{pr_number}/comments"
+ headers = {
+ 'Authorization': f'token {token}',
+ 'Accept': 'application/vnd.github.v3+json'
+ }
+ data = {'body': body}
+
+ try:
+ response = requests.post(url, headers=headers, json=data)
+ response.raise_for_status()
+ print("✅ Coverage comment posted successfully")
+ return True
+ except requests.exceptions.RequestException as e:
+ print(f"Error posting comment: {e}", file=sys.stderr)
+ if hasattr(e, 'response') and e.response is not None:
+ print(f"Response: {e.response.text}", file=sys.stderr)
+ return False
+
+
+def update_comment(token: str, repo: str, comment_id: int, body: str) -> bool:
+ """
+ Update an existing comment.
+
+ Args:
+ token: GitHub token
+ repo: Repository in format "owner/repo"
+ comment_id: Comment ID to update
+ body: New comment body
+
+ Returns:
+ True if successful, False otherwise
+ """
+ url = f"https://api.github.com/repos/{repo}/issues/comments/{comment_id}"
+ headers = {
+ 'Authorization': f'token {token}',
+ 'Accept': 'application/vnd.github.v3+json'
+ }
+ data = {'body': body}
+
+ try:
+ response = requests.patch(url, headers=headers, json=data)
+ response.raise_for_status()
+ print("✅ Coverage comment updated successfully")
+ return True
+ except requests.exceptions.RequestException as e:
+ print(f"Error updating comment: {e}", file=sys.stderr)
+ if hasattr(e, 'response') and e.response is not None:
+ print(f"Response: {e.response.text}", file=sys.stderr)
+ return False
+
+
+def is_fork_pr(event_path: str) -> bool:
+ """
+ Check if the PR is from a fork.
+
+ Args:
+ event_path: Path to GitHub event JSON file
+
+ Returns:
+ True if fork PR, False otherwise
+ """
+ try:
+ with open(event_path, 'r') as f:
+ event = json.load(f)
+
+ pr = event.get('pull_request', {})
+ head_repo = pr.get('head', {}).get('repo', {}).get('full_name')
+ base_repo = pr.get('base', {}).get('repo', {}).get('full_name')
+
+ return head_repo != base_repo
+ except (FileNotFoundError, json.JSONDecodeError, KeyError) as e:
+ print(f"Warning: Could not determine if fork PR: {e}", file=sys.stderr)
+ return False
+
+
+def main():
+ """Main entry point."""
+ # Get environment variables
+ token = os.environ.get('GITHUB_TOKEN')
+ repo = os.environ.get('GITHUB_REPOSITORY')
+ event_path = os.environ.get('GITHUB_EVENT_PATH', '')
+
+ # Get arguments
+ if len(sys.argv) < 6:
+ print("Usage: comment_pr.py 📊 Detailed Coverage Report (click to expand)
+ +{coverage_report} + +起動をスキップする場合は`false`に設定 | `true`または`false` | ✅ はい | +| `ai_model` | 使用するAIプロバイダー | `"deepseek"`または`"qwen"`または`"custom"` | ✅ はい | +| `exchange` | 使用する取引所 | `"binance"`または`"hyperliquid"`または`"aster"` | ✅ はい | +| `binance_api_key` | Binance APIキー | `"abc123..."` | Binance使用時に必須 | +| `binance_secret_key` | Binanceシークレットキー | `"xyz789..."` | Binance使用時に必須 | +| `hyperliquid_private_key` | Hyperliquid秘密鍵
⚠️ `0x`プレフィックスを削除 | `"your_key..."` | Hyperliquid使用時に必須 | +| `hyperliquid_wallet_addr` | Hyperliquidウォレットアドレス | `"0xabc..."` | Hyperliquid使用時に必須 | +| `hyperliquid_testnet` | テストネットを使用 | `true`または`false` | ❌ いいえ（デフォルトはfalse） | +| `use_qwen` | Qwenを使用するかどうか | `true`または`false` | ✅ はい | +| `deepseek_key` | DeepSeek APIキー | `"sk-xxx"` | DeepSeek使用時 | +| `qwen_key` | Qwen APIキー | `"sk-xxx"` | Qwen使用時 | +| `initial_balance` | 損益計算の開始残高 | `1000.0` | ✅ はい | +| `scan_interval_minutes` | 判断を行う頻度 | `3`（3-5推奨） | ✅ はい | +| **`leverage`** | **レバレッジ設定（v2.0.3+）** | 下記参照 | ✅ はい | +| `btc_eth_leverage` | BTC/ETHの最大レバレッジ
⚠️ サブアカウント：≤5x | `5`（デフォルト、安全）
`50`（メインアカウント最大） | ✅ はい | +| `altcoin_leverage` | アルトコインの最大レバレッジ
⚠️ サブアカウント：≤5x | `5`（デフォルト、安全）
`20`（メインアカウント最大） | ✅ はい | +| `use_default_coins` | 組み込みコインリストを使用
**✨ スマートデフォルト：`true`**（v2.0.2+）
API URLが提供されていない場合自動有効化 | `true`または省略 | ❌ いいえ
（オプション、自動デフォルト） | +| `coin_pool_api_url` | カスタムコインプールAPI
*`use_default_coins: false`の場合のみ必要* | `""`（空） | ❌ いいえ | +| `oi_top_api_url` | 建玉API
*オプション補足データ* | `""`（空） | ❌ いいえ | +| `api_server_port` | Webダッシュボードポート | `8080` | ✅ はい | + +**デフォルト取引コイン**（`use_default_coins: true`の場合）： +- BTC、ETH、SOL、BNB、XRP、DOGE、ADA、HYPE + +--- + +#### ⚙️ レバレッジ設定（v2.0.3+） + +**レバレッジ設定とは？** + +レバレッジ設定は、AIが各取引で使用できる最大レバレッジを制御します。これは、特にレバレッジ制限があるBinanceサブアカウントでリスク管理に重要です。 + +**設定形式：** + +```json +"leverage": { + "btc_eth_leverage": 5, // BTCとETHの最大レバレッジ + "altcoin_leverage": 5 // その他すべてのコインの最大レバレッジ +} +``` + +**⚠️ 重要：Binanceサブアカウント制限** + +- **サブアカウント**: Binanceにより**≤5xレバレッジ**に制限 +- **メインアカウント**: 最大20x（アルトコイン）または50x（BTC/ETH）を使用可能 +- サブアカウントを使用していてレバレッジを>5xに設定すると、取引は**失敗**し、エラーが表示されます：`Subaccounts are restricted from using leverage greater than 5x` + +**推奨設定：** + +| アカウントタイプ | BTC/ETHレバレッジ | アルトコインレバレッジ | リスクレベル | +|-------------|------------------|------------------|------------| +| **サブアカウント** | `5` | `5` | ✅ 安全（デフォルト） | +| **メイン（保守的）** | `10` | `10` | 🟡 中程度 | +| **メイン（積極的）** | `20` | `15` | 🔴 高 | +| **メイン（最大）** | `50` | `20` | 🔴🔴 非常に高 | + +**例：** + +**安全な設定（サブアカウントまたは保守的）：** +```json +"leverage": { + "btc_eth_leverage": 5, + "altcoin_leverage": 5 +} +``` + +**積極的な設定（メインアカウントのみ）：** +```json +"leverage": { + "btc_eth_leverage": 20, + "altcoin_leverage": 15 +} +``` + +**AIのレバレッジ使用方法：** + +- AIは設定された最大値まで**1xから任意のレバレッジを選択**できます +- たとえば、`altcoin_leverage: 20`の場合、AIは市場条件に基づいて5x、10x、または20xを使用することを決定する可能性があります +- 設定は固定値ではなく**上限**を設定します +- AIはレバレッジを選択する際にボラティリティ、リスクリワード比率、アカウント残高を考慮します + +--- + +#### ⚠️ 重要：`use_default_coins`フィールド + +**スマートデフォルト動作（v2.0.2+）：** + +次の場合、システムは自動的に`use_default_coins: true`をデフォルトにします： +- config.jsonにこのフィールドを含めていない、または +- `false`に設定したが`coin_pool_api_url`を提供していない + +これにより初心者に優しくなります！このフィールドを完全に省略することもできます。 + +**設定例：** + +✅ **オプション1：明示的に設定（明確性のため推奨）** +```json +"use_default_coins": true, +"coin_pool_api_url": "", +"oi_top_api_url": "" +``` + +✅ **オプション2：フィールドを省略（デフォルトコインを自動使用）** +```json +// "use_default_coins"を含めないだけ +"coin_pool_api_url": "", +"oi_top_api_url": "" +``` + +⚙️ **高度：外部APIを使用** +```json +"use_default_coins": false, +"coin_pool_api_url": "http://your-api.com/coins", +"oi_top_api_url": "http://your-api.com/oi" +``` + +--- + +### 6. システムを実行 + +#### 🚀 システムの起動（2ステップ） + +システムには別々に実行される**2つの部分**があります： +1. **バックエンド**（AIトレーディングブレイン + API） +2. **フロントエンド**（監視用Webダッシュボード） + +--- + +#### **ステップ1：バックエンドを起動** + +ターミナルを開いて実行： + +```bash +# プログラムをビルド（初回のみ、またはコード変更後） +go build -o nofx + +# バックエンドを起動 +./nofx +``` + +**表示されるべきもの：** + +``` +🚀 启动自动交易系统... +✓ Trader [my_trader] 已初始化 +✓ API服务器启动在端口 8080 +📊 开始交易监控... +``` + +**⚠️ エラーが表示される場合：** + +| エラーメッセージ | 解決策 | +|--------------|----------| +| `invalid API key` | config.jsonのBinance APIキーを確認 | +| `TA-Lib not found` | `brew install ta-lib`を実行（macOS） | +| `port 8080 already in use` | config.jsonの`api_server_port`を変更 | +| `DeepSeek API error` | DeepSeek APIキーと残高を確認 | + +**✅ バックエンドが正しく実行されているとき：** +- エラーメッセージなし +- "开始交易监控..."が表示される +- システムがアカウント残高を表示 +- このターミナルウィンドウを開いたままにしてください！ + +--- + +#### **ステップ2：フロントエンドを起動** + +**新しいターミナルウィンドウ**を開き（最初のものは実行したまま）、次を実行： + +```bash +cd web +npm run dev +``` + +**表示されるべきもの：** + +``` +VITE v5.x.x ready in xxx ms + +➜ Local: http://localhost:3000/ +➜ Network: use --host to expose +``` + +**✅ フロントエンドが実行されているとき：** +- "Local: http://localhost:3000/"メッセージ +- エラーメッセージなし +- このターミナルウィンドウも開いたままにしてください！ + +--- + +#### **ステップ3：ダッシュボードにアクセス** + +Webブラウザを開いて次にアクセス： + +**🌐 http://localhost:3000** + +**表示されるもの：** +- 📊 リアルタイムアカウント残高 +- 📈 オープンポジション（ある場合） +- 🤖 AI判断ログ +- 📉 エクイティカーブチャート + +**初回のヒント：** +- 最初のAI判断まで3-5分かかることがあります +- 初期判断は「観望」（待機）と言う場合があります - これは正常です +- AIは最初に市場状況を分析する必要があります + +--- + +### 7. システムを監視 + +**監視すべきもの：** + +✅ **健全なシステムの兆候：** +- バックエンドターミナルが3-5分ごとに判断サイクルを表示 +- 継続的なエラーメッセージなし +- アカウント残高の更新 +- Webダッシュボードの自動更新 + +⚠️ **警告の兆候：** +- 繰り返されるAPIエラー +- 10分以上判断なし +- 残高の急速な減少 + +**システムステータスの確認：** + +```bash +# 新しいターミナルウィンドウで +curl http://localhost:8080/health +``` + +戻り値：`{"status":"ok"}` + +--- + +### 8. システムを停止 + +**グレースフルシャットダウン（推奨）：** + +1. **バックエンドターミナル**（最初のもの）に移動 +2. `Ctrl+C`を押す +3. "系统已停止"メッセージを待つ +4. **フロントエンドターミナル**（2番目のもの）に移動 +5. `Ctrl+C`を押す + +**⚠️ 重要：** +- 常にバックエンドを最初に停止 +- ターミナルを閉じる前に確認を待つ +- 強制終了しない（ターミナルを直接閉じない） + +--- + +## 📖 AI判断フロー + +各判断サイクル（デフォルト3分）で、システムは以下のインテリジェントプロセスを実行します： + +``` +┌──────────────────────────────────────────────────────────┐ +│ 1. 📊 過去パフォーマンスを分析（過去20サイクル） │ +├──────────────────────────────────────────────────────────┤ +│ ✓ 総合勝率、平均利益、損益比を計算 │ +│ ✓ コインごとの統計（勝率、平均損益（USDT）） │ +│ ✓ 最高/最悪パフォーマンスコインを特定 │ +│ ✓ 正確なPnLを含む最後の5取引の詳細をリスト │ +│ ✓ リスク調整パフォーマンスのシャープレシオを計算 │ +│ 📌 NEW（v2.0.2）：レバレッジを含む正確なUSDT PnL │ +└──────────────────────────────────────────────────────────┘ + ↓ +┌──────────────────────────────────────────────────────────┐ +│ 2. 💰 アカウントステータスを取得 │ +├──────────────────────────────────────────────────────────┤ +│ • 総エクイティと利用可能残高 │ +│ • オープンポジション数と未実現損益 │ +│ • 証拠金使用率（AIは最大90%を管理） │ +│ • 日次損益追跡とドローダウン監視 │ +└──────────────────────────────────────────────────────────┘ + ↓ +┌──────────────────────────────────────────────────────────┐ +│ 3. 🔍 既存ポジションを分析（ある場合） │ +├──────────────────────────────────────────────────────────┤ +│ • 各ポジションについて、最新の市場データを取得 │ +│ • リアルタイムのテクニカル指標を計算： │ +│ - 3分K線：RSI(7)、MACD、EMA20 │ +│ - 4時間K線：RSI(14)、EMA20/50、ATR │ +│ • ポジション保有期間を追跡（例：「2時間15分」） │ +│ 📌 NEW（v2.0.2）：各ポジションの保有期間を表示 │ +│ • 表示：エントリー価格、現在価格、損益%、期間 │ +│ • AIが評価：保持するかクローズするか？ │ +└──────────────────────────────────────────────────────────┘ + ↓ +┌──────────────────────────────────────────────────────────┐ +│ 4. 🎯 新しい機会を評価（候補コイン） │ +├──────────────────────────────────────────────────────────┤ +│ • コインプールを取得（2モード）： │ +│ 🌟 デフォルトモード：BTC、ETH、SOL、BNB、XRPなど │ +│ ⚙️ 高度モード：AI500（上位20）+ OI Top（上位20） │ +│ • 候補コインをマージして重複削除 │ +│ • フィルター：低流動性を削除（<1500万USD OI値） │ +│ • 市場データ + テクニカル指標をバッチ取得 │ +│ • ボラティリティ、トレンド強度、出来高急増を計算 │ +└──────────────────────────────────────────────────────────┘ + ↓ +┌──────────────────────────────────────────────────────────┐ +│ 5. 🧠 AI総合判断（DeepSeek/Qwen） │ +├──────────────────────────────────────────────────────────┤ +│ • 過去フィードバックをレビュー： │ +│ - 最近の勝率と利益率 │ +│ - 最高/最悪コインパフォーマンス │ +│ - 繰り返しミスを回避 │ +│ • すべての生シーケンスデータを分析： │ +│ - 3分価格シーケンス、4時間K線シーケンス │ +│ - 完全な指標シーケンス（最新のみではない） │ +│ 📌 NEW（v2.0.2）：AIは分析の完全な自由を持つ │ +│ • 思考連鎖（CoT）推論プロセス │ +│ • 構造化された判断を出力： │ +│ - アクション：close_long/close_short/open_long/open_short│ +│ - コインシンボル、数量、レバレッジ │ +│ - ストップロスとテイクプロフィットレベル（≥1:2比率） │ +│ • 判断：待機/保持/クローズ/オープン │ +└──────────────────────────────────────────────────────────┘ + ↓ +┌──────────────────────────────────────────────────────────┐ +│ 6. ⚡ 取引を実行 │ +├──────────────────────────────────────────────────────────┤ +│ • 優先順位：既存をクローズ → その後新規をオープン │ +│ • 実行前のリスクチェック： │ +│ - ポジションサイズ制限（アルトコイン1.5x、BTC 10x） │ +│ - 重複ポジションなし（同じコイン + 方向） │ +│ - 証拠金使用量が90%制限内 │ +│ • Binance LOT_SIZE精度を自動取得して適用 │ +│ • Binance Futures APIで注文を実行 │ +│ • クローズ後：すべての保留注文を自動キャンセル │ +│ • 実際の実行価格と注文IDを記録 │ +│ 📌 期間計算のためにポジションオープン時間を追跡 │ +└──────────────────────────────────────────────────────────┘ + ↓ +┌──────────────────────────────────────────────────────────┐ +│ 7. 📝 完全なログを記録してパフォーマンスを更新 │ +├──────────────────────────────────────────────────────────┤ +│ • decision_logs/{trader_id}/に判断ログを保存 │ +│ • ログには以下が含まれます： │ +│ - 完全な思考連鎖（CoT） │ +│ - すべての市場データを含む入力プロンプト │ +│ - 構造化された判断JSON │ +│ - アカウントスナップショット（残高、ポジション、証拠金）│ +│ - 実行結果（成功/失敗、価格） │ +│ • パフォーマンスデータベースを更新： │ +│ - symbol_sideキーでオープン/クローズペアをマッチ │ +│ 📌 NEW：ロング/ショート競合を防止 │ +│ - 正確なUSDT PnLを計算： │ +│ PnL = ポジション価値 × 価格変化% × レバレッジ │ +│ 📌 NEW：数量 + レバレッジを考慮 │ +│ - 保存：数量、レバレッジ、オープン時間、クローズ時間 │ +│ - 更新：勝率、利益率、シャープレシオ │ +│ • パフォーマンスデータは次のサイクルにフィードバック │ +└──────────────────────────────────────────────────────────┘ + ↓ + （3-5分ごとに繰り返し） +``` + +### v2.0.2の主な改善点 + +**📌 ポジション期間追跡：** +- システムが各ポジションの保有期間を追跡 +- ユーザープロンプトに表示：「持仓时长2小时15分钟」 +- AIが出口タイミングについてより良い判断を下すのに役立つ + +**📌 正確なPnL計算：** +- 以前：パーセンテージのみ（100U@5% = 1000U@5% = 両方とも「5.0」と表示） +- 現在：実際のUSDT利益 = ポジション価値 × 価格変化 × レバレッジ +- 例：1000 USDT × 5% × 20x = 1000 USDT実際の利益 + +**📌 AI自由度の向上：** +- AIはすべての生シーケンスデータを自由に分析可能 +- 事前定義された指標の組み合わせに制限されない +- 独自のトレンド分析、サポート/レジスタンス計算を実行可能 + +**📌 改善されたポジション追跡：** +- `symbol_side`キーを使用（例：「BTCUSDT_long」） +- ロングとショートの両方を保有する際の競合を防止 +- 完全なデータを保存：数量、レバレッジ、オープン/クローズ時間 + +--- + +## 🧠 AI自己学習の例 + +### 過去フィードバック（プロンプトに自動追加） + +```markdown +## 📊 過去パフォーマンスフィードバック + +### 総合パフォーマンス +- **総取引数**: 15（利益：8 | 損失：7） +- **勝率**: 53.3% +- **平均利益**: +3.2% | 平均損失：-2.1% +- **損益比**: 1.52:1 + +### 最近の取引 +1. BTCUSDT LONG: 95000.0000 → 97500.0000 = +2.63% ✓ +2. ETHUSDT SHORT: 3500.0000 → 3450.0000 = +1.43% ✓ +3. SOLUSDT LONG: 185.0000 → 180.0000 = -2.70% ✗ +4. BNBUSDT LONG: 610.0000 → 625.0000 = +2.46% ✓ +5. ADAUSDT LONG: 0.8500 → 0.8300 = -2.35% ✗ + +### コインパフォーマンス +- **最高**: BTCUSDT（勝率75%、平均+2.5%） +- **最悪**: SOLUSDT（勝率25%、平均-1.8%） +``` + +### AIのフィードバック使用方法 + +1. **連続損失を回避**: SOLUSDTが3回連続でストップロスになっているのを見て、AIは回避するかより慎重になる +2. **成功戦略を強化**: BTCブレイクアウトロングが75%の勝率で、AIはこのパターンを継続 +3. **動的スタイル調整**: 勝率<40% → 保守的；損益比>2 → 積極的を維持 +4. **市場状況の特定**: 連続損失は荒れた市場を示す可能性があり、取引頻度を減らす + +--- + +## 📊 Webインターフェース機能 + +### 1. 競争ページ + +- **🏆 リーダーボード**: リアルタイムROIランキング、ゴールドボーダーでリーダーをハイライト +- **📈 パフォーマンス比較**: デュアルAI ROIカーブ比較（紫対青） +- **⚔️ 一対一**: リードマージンを示す直接比較 +- **リアルタイムデータ**: 総エクイティ、損益%、ポジション数、証拠金使用量 + +### 2. 詳細ページ + +- **エクイティカーブ**: 過去トレンドチャート（USD/パーセンテージ切り替え） +- **統計**: 総サイクル、成功/失敗、オープン/クローズ統計 +- **ポジションテーブル**: すべてのポジション詳細（エントリー価格、現在価格、損益%、清算価格） +- **AI判断ログ**: 最近の判断記録（展開可能なCoT） + +### 3. リアルタイム更新 + +- システムステータス、アカウント情報、ポジションリスト：**5秒更新** +- 判断ログ、統計：**10秒更新** +- エクイティチャート：**10秒更新** + +--- + +## 🎛️ APIエンドポイント + +### 競争関連 + +```bash +GET /api/competition # 競争リーダーボード（全トレーダー） +GET /api/traders # トレーダーリスト +``` + +### 単一トレーダー関連 + +```bash +GET /api/status?trader_id=xxx # システムステータス +GET /api/account?trader_id=xxx # アカウント情報 +GET /api/positions?trader_id=xxx # ポジションリスト +GET /api/equity-history?trader_id=xxx # エクイティ履歴（チャートデータ） +GET /api/decisions/latest?trader_id=xxx # 最新5判断 +GET /api/statistics?trader_id=xxx # 統計 +``` + +### システムエンドポイント + +```bash +GET /health # ヘルスチェック +GET /api/config # システム設定 +``` + +--- + +## ⚠️ 重要なリスク警告 + +### 取引リスク + +1. **暗号通貨市場は非常にボラティルが高い**、AI判断は利益を保証しません +2. **先物取引はレバレッジを使用**、損失が元本を超える可能性があります +3. **極端な市場状況**は清算リスクにつながる可能性があります +4. **ファンディングレート**は保有コストに影響する可能性があります +5. **流動性リスク**: 一部のコインでスリッページが発生する可能性があります + +### 技術リスク + +1. **ネットワークレイテンシ**は価格スリッページを引き起こす可能性があります +2. **APIレート制限**は取引実行に影響する可能性があります +3. **AI APIタイムアウト**は判断失敗を引き起こす可能性があります +4. **システムバグ**は予期しない動作を引き起こす可能性があります + +### 使用推奨事項 + +✅ **推奨** +- テストには失っても構わない資金のみを使用 +- 少額から始める（推奨100-500 USDT） +- システムの動作状態を定期的に確認 +- アカウント残高の変化を監視 +- AI判断ログを分析して戦略を理解 + +❌ **非推奨** +- すべての資金または借りたお金を投資 +- 長期間監視なしで実行 +- AI判断を盲目的に信頼 +- システムを理解せずに使用 +- 極端な市場ボラティリティ中に実行 + +--- + +## 🛠️ よくある問題 + +### 1. コンパイルエラー：TA-Libが見つからない + +**解決策**: TA-Libライブラリをインストール +```bash +# macOS +brew install ta-lib + +# Ubuntu +sudo apt-get install libta-lib0-dev +``` + +### 2. 精度エラー：Precision is over the maximum + +**解決策**: システムがBinance LOT_SIZEから精度を自動処理します。エラーが続く場合は、ネットワーク接続を確認してください。 + +### 3. AI APIタイムアウト + +**解決策**: +- APIキーが正しいか確認 +- ネットワーク接続を確認（プロキシが必要な場合があります） +- システムタイムアウトは120秒に設定されています + +### 4. フロントエンドがバックエンドに接続できない + +**解決策**: +- バックエンドが実行中であることを確認（http://localhost:8080） +- ポート8080が占有されていないか確認 +- ブラウザコンソールでエラーを確認 + +### 5. コインプールAPI失敗 + +**解決策**: +- コインプールAPIはオプションです +- APIが失敗した場合、システムはデフォルトのメインストリームコイン（BTC、ETHなど）を使用 +- config.jsonのAPI URLと認証パラメータを確認 + +--- + +## 📈 パフォーマンス最適化のヒント + +1. **合理的な判断サイクルを設定**: 3-5分を推奨、過剰取引を避ける +2. **候補コイン数を制御**: システムはデフォルトでAI500上位20 + OI Top上位20 +3. **ログを定期的にクリーン**: 過度なディスク使用を避ける +4. **API呼び出し数を監視**: Binanceレート制限のトリガーを避ける +5. **少額資本でテスト**: まず100-500 USDTで戦略検証をテスト + +--- + +## 🔄 変更履歴 + +### v2.0.2（2025-10-29） + +**重大なバグ修正 - 取引履歴とパフォーマンス分析：** + +このバージョンは、収益性統計に大きく影響した過去取引記録とパフォーマンス分析システムの**重大な計算エラー**を修正します。 + +**1. PnL計算 - 主要エラー修正**（logger/decision_logger.go） +- **問題**: 以前はパーセンテージのみで計算され、ポジションサイズとレバレッジを完全に無視 + - 例：100 USDTポジションが5%獲得と1000 USDTポジションが5%獲得の両方が利益として`5.0`と表示 + - これによりパフォーマンス分析が完全に不正確に +- **解決策**: 実際のUSDT利益額を計算 + ``` + PnL（USDT）= ポジション価値 × 価格変化% × レバレッジ + 例：1000 USDT × 5% × 20x = 1000 USDT実際の利益 + ``` +- **影響**: 勝率、利益率、シャープレシオが正確なUSDT額に基づくようになりました + +**2. ポジション追跡 - 重要データの欠落** +- **問題**: オープンポジション記録が価格と時間のみを保存、数量とレバレッジが欠落 +- **解決策**: 完全な取引データを保存： + - `quantity`: ポジションサイズ（コイン単位） + - `leverage`: レバレッジ倍率（例：20x） + - これらは正確なPnL計算に不可欠 + +**3. ポジションキーロジック - ロング/ショート競合** +- **問題**: `symbol`をポジションキーとして使用し、ロングとショートの両方を保有する際にデータ競合を引き起こす + - 例：BTCUSDTロングとBTCUSDTショートが互いに上書き +- **解決策**: `symbol_side`形式に変更（例：`BTCUSDT_long`、`BTCUSDT_short`） + - ロングとショートポジションを適切に区別 + +**4. シャープレシオ計算 - コード最適化** +- **問題**: 平方根計算にカスタムニュートン法を使用 +- **解決策**: 標準ライブラリ`math.Sqrt`に置き換え + - より信頼性が高く、保守可能で効率的 + +**このアップデートが重要な理由：** +- ✅ 過去取引統計が無意味なパーセンテージではなく**実際のUSDT損益**を表示 +- ✅ 異なるレバレッジ取引間のパフォーマンス比較が正確に +- ✅ AI自己学習メカニズムが正しい過去フィードバックを受信 +- ✅ 利益率とシャープレシオの計算が意味を持つように +- ✅ マルチポジション追跡（ロング + ショート同時）が正しく機能 + +**推奨**: このアップデート前にシステムを実行していた場合、過去統計は不正確でした。v2.0.2にアップデート後、新しい取引は正しく計算されます。 + +### v2.0.2（2025-10-29） + +**バグ修正：** +- ✅ Aster取引所精度エラーを修正（コード-1111：「Precision is over the maximum defined for this asset」） +- ✅ 取引所の精度要件に合わせて価格と数量のフォーマットを改善 +- ✅ デバッグ用の詳細な精度処理ログを追加 +- ✅ 適切な精度処理ですべての注文関数（OpenLong、OpenShort、CloseLong、CloseShort、SetStopLoss、SetTakeProfit）を強化 + +**技術詳細：** +- float64を正しい精度で文字列に変換する`formatFloatWithPrecision`関数を追加 +- 価格と数量パラメータが取引所の`pricePrecision`と`quantityPrecision`仕様に従ってフォーマットされるようになりました +- API リクエストを最適化するために、フォーマットされた値から末尾のゼロを削除 + +### v2.0.1（2025-10-29） + +**バグ修正：** +- ✅ ComparisonChartデータ処理ロジックを修正 - cycle_numberからタイムスタンプグループ化に切り替え +- ✅ バックエンド再起動時にcycle_numberがリセットされるとチャートがフリーズする問題を解決 +- ✅ チャートデータ表示を改善 - すべての過去データポイントを時系列で表示 +- ✅ トラブルシューティングを改善するためのデバッグログを強化 + +### v2.0.0（2025-10-28） + +**主要アップデート：** +- ✅ AI自己学習メカニズム（過去フィードバック、パフォーマンス分析） +- ✅ マルチトレーダー競争モード（Qwen対DeepSeek） +- ✅ BinanceスタイルUI（完全なBinanceインターフェース模倣） +- ✅ パフォーマンス比較チャート（リアルタイムROI比較） +- ✅ リスク管理最適化（コインごとのポジション制限調整） + +**バグ修正：** +- 初期残高のハードコーディング問題を修正 +- マルチトレーダーデータ同期問題を修正 +- チャートデータの整列を最適化（cycle_numberを使用） + +### v1.0.0（2025-10-27） +- 初回リリース +- 基本的なAI取引機能 +- 判断ログシステム +- シンプルなWebインターフェース + +--- + +## 📄 ライセンス + +MITライセンス - 詳細は[LICENSE](LICENSE)ファイルを参照してください + +--- + +## 🤝 貢献 + +IssueとPull Requestを歓迎します！ + +### 開発ガイド + +1. プロジェクトをフォーク +2. 機能ブランチを作成（`git checkout -b feature/AmazingFeature`） +3. 変更をコミット（`git commit -m 'Add some AmazingFeature'`） +4. ブランチにプッシュ（`git push origin feature/AmazingFeature`） +5. Pull Requestを開く + +--- + +## 📬 お問い合わせ + + +### 🐛 技術サポート +- **GitHub Issues**: [Issueを提出](https://github.com/tinkle-community/nofx/issues) +- **開発者コミュニティ**: [Telegramグループ](https://t.me/nofx_dev_community) + +--- + +## 🙏 謝辞 + +- [Binance API](https://binance-docs.github.io/apidocs/futures/en/) - Binance先物API +- [DeepSeek](https://platform.deepseek.com/) - DeepSeek AI API +- [Qwen](https://dashscope.aliyuncs.com/) - Alibaba Cloud Qwen +- [TA-Lib](https://ta-lib.org/) - テクニカル指標ライブラリ +- [Recharts](https://recharts.org/) - Reactチャートライブラリ + +--- + +**最終更新**: 2025-10-29（v2.0.3） + +**⚡ AIの力で量的取引の可能性を探求しましょう！** + +--- + +## ⭐ Star履歴 + +[](https://star-history.com/#tinkle-community/nofx&Date) diff --git a/docs/i18n/ja/TERMS OF SERVICE.md b/docs/i18n/ja/TERMS OF SERVICE.md new file mode 100644 index 00000000..1aeed377 --- /dev/null +++ b/docs/i18n/ja/TERMS OF SERVICE.md @@ -0,0 +1,156 @@ +NOFX 利用規約(サービス利用規約) + +最終更新日:2025年11月7日 + +1. はじめにと規約の承諾 + + +A. 本契約 + +本利用規約(以下「本契約」または「本規約」)は、お客様(以下「お客様」または「ユーザー」)とNOFX(以下「当社」または「NOFX」)との間で法的拘束力を有する契約です。 + +B. 適用範囲 + +本規約は、お客様によるnofxai.comウェブサイト(以下「本ウェブサイト」)へのアクセスおよび利用、ならびにNOFX AI取引オペレーティングシステム(以下「本ソフトウェア」)のダウンロード、インストール、および使用を管理します。 + +C. 規約の承諾 + +本ウェブサイトへのアクセス、または本ソフトウェアのダウンロード、インストール、もしくはいかなる方法による使用によって、お客様は本規約を読み、理解し、本規約に拘束されることに同意したものとみなされます。本規約に同意されない場合は、直ちに本ウェブサイトへのアクセスおよび本ソフトウェアの使用を中止しなければなりません。 + +D. 年齢要件 + +本ウェブサイトおよび本ソフトウェアを使用するには、18歳以上、またはお客様の管轄区域における法定成年年齢に達している必要があります。 + +2. ソフトウェアライセンスおよびサービスモデル + + +A. ウェブサイト + +当社は、情報目的で本ウェブサイトにアクセスし使用するための、限定的、非独占的、譲渡不可、取消可能なライセンスをお客様に付与します。 + +B. ソフトウェア(セルフホスト型) + +AGPL-3.0ライセンス:当社は、NOFXソフトウェアのソースコードが、GNU Affero General Public License v3.0(AGPL-3.0)(以下「AGPL-3.0」)に基づいてお客様に提供されることを明示的にお知らせします。 +規約の性質:本契約は、AGPL-3.0に基づくお客様の権利を変更、置換、または制限するものではありません。AGPL-3.0はお客様のソフトウェアライセンスです。本契約はサービス契約であり、当社のサービスエコシステム全体(本ウェブサイトおよび本ソフトウェアの使用を含む)の使用を管理し、AGPL-3.0でカバーされていない、以下に記載される重要な責任と免責事項を確立するものです。 + +3. 重要なリスクの確認(財務) + +本セクションはお客様の重大な利益に関わります。注意深くお読みください。本セクションのすべての条項は、その法的重要性を確保するために、目立つ大文字で表示されています。 + +A. 財務または投資アドバイスの不提供: +本ウェブサイトおよび本ソフトウェアは、技術的ツールとしてのみ提供されます。当社は金融機関、ブローカー、財務アドバイザー、または投資アドバイザーではありません。本サービスによって提供されるコンテンツ、機能、またはAI出力は、財務、投資、法律、税務、または取引に関するアドバイスを構成するものではありません。 +B. 極度の財務損失リスク: +お客様は、暗号通貨およびその他の金融資産の取引が非常に変動性が高く、投機的であり、固有のリスクを伴うことを認識し同意します。自動化、アルゴリズム、およびAI駆動の取引システム(本ソフトウェアなど)の使用には、重大かつ固有のリスクが伴い、実質的または全体的な財務損失を招く可能性があります。 +C. 利益または性能の保証なし: +当社は、本ソフトウェアの性能、収益性、または生成される取引シグナルの精度について、明示または黙示の保証、表明、または担保を一切行いません。AIモデルまたは取引戦略の過去のパフォーマンスは、将来の結果を表すものでも保証するものでもありません。 +D. ユーザーの完全な責任: +お客様は、すべての取引決定、注文、実行、および最終結果について、完全かつ単独の責任を負います。本ソフトウェアを通じて実行されるすべての取引は、お客様の自律的な決定とリスク許容度に基づいており、お客様自身のリスクで行われるものとみなされます。 + +4. 重要なリスクの確認(人工知能とソフトウェア) + +本セクションも同様にお客様の重大な利益に関わり、大文字で表示されています。 +A. 「現状有姿」および「提供可能な状態で」の免責事項: +本ウェブサイトおよび本ソフトウェアは、明示または黙示を問わず、いかなる種類の保証もなく「現状有姿」(AS IS)および「提供可能な状態で」(AS AVAILABLE)提供されます。当社は、サービスが中断されない、正確である、エラーがない、安全である、またはウイルスやその他の有害なコンポーネントがないことを保証しません。 +B. AI出力および「幻覚」の免責事項: +本ソフトウェアのコア機能がサードパーティのAIモデルに依存していることから、お客様はAI技術の固有の制限を理解し受け入れる必要があります。AI出力(AIエージェントの決定を含む)は新興技術であり、その法的責任はまだ明確ではありません。 +お客様は以下を認識し同意します: +AI出力に欠陥がある可能性:本ソフトウェアによって統合または生成されるAIモデルおよび出力には、エラー、不正確さ、欠落、バイアス、または「幻覚」(HALLUCINATIONS)と呼ばれる完全に誤った、または虚構の情報が含まれる可能性があります。 +お客様がすべてのリスクを負う:お客様は、AI生成出力(取引決定を含む)の使用または依拠は、お客様自身のリスクで行われることに同意します。 +専門的アドバイスの代替にならない:お客様は、AI出力を唯一の真実の情報源、事実情報、または専門的な財務アドバイスの代替として扱ってはなりません。 +C. ユーザーの最終責任: +お客様は、AI出力に基づいて取られたすべての行動について最終的な責任を負うことに同意します。お客様は、AIが推奨する取引を実行する前に、独自のデューディリジェンスを実施し、情報の正確性を検証する必要があります。 + +5. ユーザーの義務およびセキュリティ責任 + + +A. APIキーおよび秘密鍵に対する完全な責任 + +これは本契約の最も重要な条項の一つであり、本ソフトウェアのコア機能に関わります。 +お客様は、本ソフトウェアで使用するすべてのAPIキー、シークレットキー、ウォレットアドレス、秘密鍵、およびシードフレーズ(「シークレットフレーズ」)の保護、保存、セキュリティ確保、およびバックアップについて、排他的かつ単独の完全な責任を負うことを認識し同意します。お客様は、これらの認証情報に対して十分なセキュリティと管理を維持する必要があります。 + +B. 非カストディアルの確認 + +お客様は、当社(NOFX)が非カストディアルのソフトウェアプロバイダーであることを認識し同意します。当社は、お客様のAPIキー、秘密鍵、またはシードフレーズを収集、保存、受信、またはいかなる方法でもアクセスすることは一切ありません。当社は、お客様にこれらの認証情報を共有するよう要求することは一切ありません。 +したがって、当社には、お客様の資金にアクセスする、紛失したキーを回復する、または取引をキャンセルまたは取り消す能力はありません。お客様のキー(APIキーまたは秘密鍵)の紛失、盗難、または漏洩に起因するすべての損失について、お客様が完全な責任を負います。 + +C. ユーザー管理の暗号化 + +お客様は、セルフホストインスタンスにおいて、すべてのストレージおよび通信でキーと認証情報を暗号化する責任があることを認識します。本ソフトウェアで提供される暗号化機能は、セキュリティ保証なしに「現状有姿」で提供されます。 + +D. サードパーティの規約 + +お客様が本ソフトウェアを使用してサードパーティのサービス(Binance、Hyperliquid、DeepSeek、Qwenなど)に接続する場合、お客様はそれらのサードパーティサービスのすべての利用規約、手数料ポリシー、および使用ルールを遵守する責任があります。 + +6. 利用規定(AUP) + +お客様は、本ウェブサイトまたは本ソフトウェアを、違法な目的または本規約で禁止されている目的で使用しないことに同意します。禁止される活動には以下が含まれます(ただしこれらに限定されません): +違法行為:地方、州、国家、または国際的な法律または規制に違反する活動に従事すること。 +システムの悪用:「ハッキング」、「スパミング」、「メール爆撃」、または「サービス拒否攻撃」(DoS)に従事すること。 +セキュリティ:本ウェブサイトまたは関連ネットワークの脆弱性を調査、スキャン、またはテストしようとすること、またはセキュリティや認証措置を破ること。 +データスクレイピング:商業目的で、本ウェブサイトからデータを抽出するために自動化システム(「データスクレイピング」、「ウェブスクレイピング」、または「ボット」を含む)を使用すること。 +マルウェア:ウイルス、トロイの木馬、ワーム、またはその他の悪意のあるコードを導入すること。 + +7. 知的財産(IP) + + +A. ウェブサイトコンテンツ + +当社および当社のライセンサーは、本ウェブサイトおよびそのすべてのコンテンツ(テキスト、グラフィック、ロゴ、ビジュアルデザイン要素を含む)に対するすべての知的財産権を保持します。 + +B. ソフトウェアの知的財産 + +本ソフトウェアはオープンソースプロジェクトです。その知的財産権はAGPL-3.0ライセンスによって管理されます。 + +C. ユーザーコンテンツ/フィードバック + +お客様が当社にフィードバック、戦略、提案、または貢献(「ユーザー生成コンテンツ」)を提供する場合、お客様は当社に、そのコンテンツを使用、ホスト、複製、変更、および表示するための、永久的、取消不能、世界的、ロイヤリティフリーのライセンスを付与します。 + +8. 責任の制限および補償 + + +本セクションは、当社の法的責任を制限し、お客様に起因する損害について責任を負うことをお客様に要求します。注意深くお読みください。本セクションのすべての条項は、目立つ大文字で表示されています。 +A. 責任の制限: +本規約は、カストディアルサービスプロバイダーが直面する法的訴訟の分析に基づいて策定され、非カストディアル、セルフホストソフトウェアプロバイダーとしての当社の法的地位を活用しています。 +適用法で許可される最大限の範囲において、NOFX(およびその関連会社、取締役、従業員、またはライセンサー)は、いかなる場合においても、以下に起因する間接的、懲罰的、付随的、特別、結果的、または懲戒的損害(利益、資金、データの損失、またはお客様のAPIキーまたは秘密鍵の盗難または紛失に起因する損害を含むがこれらに限定されない)について、お客様に対して責任を負いません: +本ウェブサイトまたは本ソフトウェアの使用または使用不能; +本ソフトウェアの欠陥、エラー、ウイルス、不正確さ、または遅延; +AI生成出力、「幻覚」、誤った取引シグナル、または失敗した戦略; +お客様のセルフホストインスタンスまたはお客様がキーを保存するデバイスへの不正アクセスまたは使用; +本ソフトウェアによって自動的に実行または推奨された取引に起因するすべての財務損失。 +NOFXがお客様に対して直接的な責任を負うと判断された場合、当社の最大累積責任は、請求前の12か月間にお客様が当社に支払った手数料(ある場合)または100ドル($100.00)のいずれか大きい方に制限されるものとします。 +B. 補償: +お客様は、以下に起因するまたは何らかの形で関連するすべての請求、要求、訴訟、損失、損害、責任、費用、および経費(合理的な弁護士費用を含む)から、NOFXおよびその関連会社を防御し、補償し、免責することに同意します:(A)本ソフトウェアへのお客様のアクセスまたは使用;(B)お客様による本規約の違反;(C)お客様が接続する取引所またはAIプロバイダーの利用規約を含むがこれに限定されない、サードパーティの権利の侵害;または(D)AI出力の使用に起因するサードパーティの知的財産侵害請求。 + +9. 終了 + + +A. 当社による終了 + +当社は、お客様が本規約または利用規定に違反した場合、独自の裁量により、直ちにまたは通知後に、本ウェブサイト(および当社が将来提供する可能性のあるホスティングサービス)へのお客様のアクセスを一時停止または終了する権利を留保します。 + +B. 終了の効力 + +終了後、お客様がAGPL-3.0に基づく本ソフトウェアのライセンス(ダウンロード済みの場合)は引き続き有効ですが、本ウェブサイトを使用する権利は取り消されます。免責事項、責任の制限、補償、知的財産、および準拠法に関するすべての条項は、終了後も存続します。 + +10. 規約の変更 + +当社は、独自の裁量により、いつでも本規約を変更または置換する権利を留保します。業界における一部の「一方的な変更」条項が執行不能とみなされる可能性があるのとは異なり、当社は、本ウェブサイトに更新された規約を掲載し、「最終更新日」を更新することにより、重要な変更について通知を提供します。そのような変更が有効になった後の本ウェブサイトへの継続的なアクセスまたは本ソフトウェアの使用は、新しい規約の承諾を構成します。 + +11. 一般条項 + + +A. 準拠法 + +本契約は、法の抵触原則を考慮することなく、[指定された管轄区域]の法律に準拠し、それに従って解釈されるものとします。 + +B. 紛争解決 + +適用法で禁止されている場合を除き、お客様は、本契約から生じるまたは本契約に関連するすべての紛争が、[指定された場所]で行われる拘束力のある仲裁によって最終的に解決されることに同意します。 + +C. 分離可能性および権利放棄 + +本契約のいずれかの条項が違法または執行不能と判断された場合、残りの条項は完全に有効であり続けます。当事者が本契約のいずれかの権利または条項を執行しないことは、その権利または条項の放棄とはみなされません。 + +D. 完全合意 + +本契約(AGPL-3.0ソフトウェアライセンスとともに)は、対象事項に関するお客様とNOFXとの間の完全な合意を構成します。 diff --git a/docs/i18n/ru/PRIVACY POLICY.md b/docs/i18n/ru/PRIVACY POLICY.md new file mode 100644 index 00000000..b8798159 --- /dev/null +++ b/docs/i18n/ru/PRIVACY POLICY.md @@ -0,0 +1,111 @@ +Политика конфиденциальности NOFX + +Последнее обновление: 2025.11.07 + +I. Введение и область применения + + +A. Введение + +Настоящая Политика конфиденциальности (далее — «Политика») предназначена для информирования вас, как пользователя нашего веб-сайта, о том, как мы обрабатываем вашу персональную информацию. Настоящая Политика применяется к информации, собираемой через nofxai.com и любые его поддомены (далее — «Веб-сайт») компанией NOFX (далее — «мы» или «наша компания»), выступающей в качестве контролера данных. + +B. Ключевое различие в Политике: Данные веб-сайта и данные программного обеспечения + +Основой настоящей Политики является разграничение между «Веб-сайтом» и «Программным обеспечением». +Данные веб-сайта: Настоящая Политика регулирует персональную информацию, которую мы собираем и обрабатываем от посетителей нашего «Веб-сайта». +Данные программного обеспечения: Настоящая Политика НЕ применяется к любым данным, которые вы обрабатываете в своем самостоятельно размещенном экземпляре операционной системы для торговли NOFX AI (далее — «Программное обеспечение»), которое вы загружаете, устанавливаете и запускаете самостоятельно. +В отношении «Программного обеспечения» вы являетесь единственным контролером всех данных (включая, помимо прочего, API-ключи, приватные ключи, торговые данные и т.д.), которые вы вводите или обрабатываете. Мы не можем получить доступ, просматривать, собирать или обрабатывать любую информацию, которую вы вводите в локальный экземпляр «Программного обеспечения». + +II. Информация, которую мы собираем (на Веб-сайте), и как мы ее используем + + +A. Информация, которую мы собираем (Веб-сайт) + +Основываясь на запросах пользователей, мы ограничили практику сбора данных до минимума. Мы не требуем от вас создания учетной записи, заполнения форм или предоставления какой-либо персонально идентифицируемой информации (PII) при посещении «Веб-сайта». +Единственная категория данных, которую мы собираем, — это «автоматически собираемые данные», которые реализуются через Google Analytics (GA4). + +B. Раскрытие информации о Google Analytics (GA4) + +Наш «Веб-сайт» использует сервис Google Analytics 4 (GA4). Это единственный способ, которым мы собираем информацию. В соответствии с Условиями обслуживания Google мы должны раскрыть вам это использование. +Типы собираемых данных: GA4 автоматически собирает определенную информацию о вашем визите, которая обычно не является персонально идентифицируемой. Это может включать: +Количество пользователей +Статистику сеансов +Приблизительное географическое местоположение (неточное) +Информацию о браузере и устройстве +Использование данных: Мы используем эти агрегированные данные исключительно для того, чтобы лучше понимать, как пользователи получают доступ к нашим сервисам и используют их, тем самым улучшая производительность и пользовательский опыт нашего «Веб-сайта». +Ваш выбор и отказ: Мы уважаем ваше право на конфиденциальность. Если вы не хотите, чтобы GA4 собирал данные о ваших посещениях, вы можете отказаться, установив дополнение для браузера Google Analytics Opt-out. Вы можете получить это дополнение, перейдя по этой ссылке: [Google Analytics Opt-out Add-on (by Google)](https://chromewebstore.google.com/detail/google-analytics-opt-out/fllaojicojecljbmefodhfapmkghcbnh?hl=en). + +C. Файлы cookie и механизмы отслеживания + +Работа GA4 зависит от файлов cookie первой стороны. В частности, могут использоваться такие файлы cookie, как _ga и _ga_
Strategy Instructions] --> B[AI Model] + C[Market Data
Auto-generated] --> B + B --> D[Chain of Thought Analysis] + B --> E[Trading Decision JSON] +``` + +**Workflow**: +1. **System Prompt (System)**: Strategy instructions you write +2. **User Prompt (User)**: Market data automatically generated by the system +3. **AI Response (Response)**: AI's analysis and decisions + +### Three Components of a Prompt + +#### 1. Core Strategy (Written by You) + +Defines the AI's trading philosophy, risk preference, and decision criteria + +**Example**: +``` +You are a conservative trader who only opens positions in high-certainty opportunities. +Entry conditions: Confidence ≥ 85, multiple indicator convergence. +``` + +#### 2. Hard Constraints (Automatically Added by System) + +- Risk-reward ratio ≥ 1:3 +- Maximum 3 positions simultaneously +- Leverage limits (BTC/ETH 20x, altcoins 5x) +- Margin usage rate ≤ 90% + +⚠️ **Methods 1 & 2**: These constraints are automatically added and cannot be overridden +⚠️ **Method 3**: You must include these constraints in your Prompt + +#### 3. Output Format (Automatically Added by System) + +Requires AI to output decisions using XML tags and JSON format + +**Example Output**: +```xml +
Base Only** | `override_base_prompt=false`
`custom_prompt=""` | Official template + Hard constraints + Output format | Beginners | +| **Mode 2
Base+Custom** | `override_base_prompt=false`
`custom_prompt="your strategy"` | Official template + Hard constraints + Output format
+ Custom strategy + Notes | Intermediate | +| **Mode 3
Full Custom** | `override_base_prompt=true`
`custom_prompt="complete prompt"` | Only custom content
(ignores all system defaults) | Advanced | + +⚠️ **Mode 3 Risk Warning**: +- You must include all hard constraints yourself +- You must define output format yourself +- You must handle all risk control yourself +- Recommended only after fully understanding system mechanics + +--- + +## 📦 Official Template Library + +### Conservative Strategy + +#### Use Cases +- ✅ Beginners seeking stability +- ✅ High market volatility, risk-averse +- ✅ Capital safety priority, tolerate low returns + +#### Core Features +- Entry confidence ≥ 85 (only high-certainty opportunities) +- Risk-reward ratio ≥ 1:4 (stricter than system requirement) +- Maximum 2 positions (reduced risk exposure) +- Small position size (0.5x account equity) + +#### Expected Performance +- Trading frequency: Low (possibly 1-2 trades/day) +- Holding time: Long (average 2-4 hours) +- Win rate: High (>70%) +- Volatility: Small + +#### Complete Template + +```plaintext +You are a professional cryptocurrency trading AI with a conservative and steady trading strategy. + +# Core Objective + +Maximize Sharpe Ratio, emphasizing risk control and stable returns. + +Sharpe Ratio = Average Returns / Returns Volatility + +This means: +- Only high-certainty trades (confidence ≥ 85) +- Strict stop-loss/take-profit, control drawdown +- Patient holding, avoid frequent trading +- Quality over quantity + +# Trading Philosophy + +Capital preservation first: Better to miss than make mistakes +Discipline over emotion: Execute plan, don't change arbitrarily +Quality over quantity: Few high-conviction trades beat many low-conviction ones +Respect trends: Don't fight strong trends + +# Entry Criteria (Extremely Strict) + +Only enter on strong signals; observe when uncertain. + +Entry conditions (must all be met): +- Confidence ≥ 85 (high certainty) +- Multiple indicator convergence (at least 3 indicators support) +- Risk-reward ratio ≥ 1:4 (take-profit space 4x+ stop-loss) +- Clear BTC trend (as market indicator) +- Positions < 2 (quality > quantity) + +Avoid low-quality signals: +- Single dimension (only one indicator) +- Contradictory (price up but volume shrinking) +- Range-bound choppy +- Just closed position (<30 minutes ago) + +# Position Management (Conservative) + +Single position: 0.5x account equity (smaller than system default) +Maximum positions: 2 coins (1 less than system default) +Leverage usage: +- Altcoins: 3x leverage (lower than system limit) +- BTC/ETH: 10x leverage (lower than system limit) + +# Stop-Loss/Take-Profit (Strict) + +Stop-loss: Set immediately after entry, never move stop-loss +Take-profit: Tiered profit-taking + - 50% target reached: Close 30% + - 75% target reached: Close 30% + - 100% target reached: Close all + +Drawdown management: +If P&L Amount drawdown from Peak % exceeds 40%, immediately reduce 50% position + +# Sharpe Ratio Self-Evolution + +Sharpe < -0.5: Stop trading, observe continuously for at least 30 minutes +Sharpe -0.5~0: Only trade confidence ≥ 90 +Sharpe 0~1: Maintain current strategy +Sharpe > 1: Can moderately increase to 0.8x equity position + +# Decision Process + +1. Analyze Sharpe Ratio: Is current strategy effective? +2. Evaluate positions: Should take profit/stop loss? +3. Find new opportunities: Any strong signals? +4. Output decision: Chain of thought + JSON + +Remember: +- Goal is Sharpe Ratio, not trading frequency +- Better miss than make low-quality trades +- Every trade must withstand repeated scrutiny +``` + +#### Usage + +**Method 1: Replace Default Template** +```bash +# Backup original +cp prompts/default.txt prompts/default.txt.bak + +# Save above template to prompts/default.txt +# Restart system +docker-compose restart +``` + +**Method 2: Web Interface Custom** +1. Copy above template +2. Paste in web interface "Custom Prompt" +3. Set `override_base_prompt = false` + +--- + +### Balanced Strategy + +#### Use Cases +- ✅ Users with some experience +- ✅ Normal market conditions +- ✅ Seeking risk-reward balance + +#### Core Features +- Entry confidence ≥ 75 (system default) +- Risk-reward ratio ≥ 1:3 (system default) +- Maximum 3 positions (system default) +- Moderate position size (0.8~1.5x equity) + +#### Expected Performance +- Trading frequency: Medium (2-4 trades/day) +- Holding time: Medium (average 1-2 hours) +- Win rate: Medium (60-70%) +- Volatility: Moderate + +#### Complete Template + +```plaintext +You are a professional cryptocurrency trading AI conducting autonomous trading in futures markets. + +# Core Objective + +Maximize Sharpe Ratio + +Sharpe Ratio = Average Returns / Returns Volatility + +This means: +- High-quality trades (high win rate, large P&L ratio) → Improve Sharpe +- Stable returns, controlled drawdown → Improve Sharpe +- Patient holding, let profits run → Improve Sharpe +- Frequent trading, small wins/losses → Increase volatility, severely reduce Sharpe +- Overtrading, fee erosion → Direct losses +- Early exits, frequent in/out → Miss major moves + +Key insight: System scans every 3 minutes, but doesn't mean trade every time! +Most times should be `wait` or `hold`, only enter on excellent opportunities. + +# Trading Philosophy & Best Practices + +## Core Principles: + +Capital preservation first: Protecting capital more important than pursuing returns + +Discipline over emotion: Execute exit plan, don't arbitrarily move stops or targets + +Quality over quantity: Few high-conviction trades beat many low-conviction ones + +Adapt to volatility: Adjust position size based on market conditions + +Respect trends: Don't fight strong trends + +## Common Pitfalls to Avoid: + +Overtrading: Frequent trading causes fees to erode profits + +Revenge trading: Immediately doubling down after loss to "get even" + +Analysis paralysis: Over-waiting for perfect signal, missing opportunities + +Ignoring correlation: BTC often leads altcoins, must observe BTC first + +Over-leverage: Amplifies returns but also amplifies losses + +# Trading Frequency Awareness + +Quantitative standards: +- Excellent trader: 2-4 trades/day = 0.1-0.2 trades/hour +- Overtrading: >2 trades/hour = serious problem +- Best rhythm: Hold at least 30-60 minutes after opening + +Self-check: +If you find yourself trading every cycle → Standards too low +If you find yourself closing positions <30 minutes → Too impatient + +# Entry Criteria (Strict) + +Only enter on strong signals; observe when uncertain. + +Complete data available: +- Raw sequences: 3-min price sequence (MidPrices array) + 4-hour candle sequence +- Technical sequences: EMA20 sequence, MACD sequence, RSI7 sequence, RSI14 sequence +- Capital sequences: Volume sequence, Open Interest (OI) sequence, funding rate +- Filter markers: AI500 score / OI_Top ranking (if marked) + +Analysis methods (fully autonomous): +- Freely use sequence data, you can but not limited to trend analysis, pattern recognition, support/resistance, Fibonacci, volatility bands +- Multi-dimensional cross-validation (price + volume + OI + indicators + sequence patterns) +- Use methods you deem most effective to discover high-certainty opportunities +- Combined confidence ≥ 75 to enter + +Avoid low-quality signals: +- Single dimension (only one indicator) +- Contradictory (price up but volume shrinking) +- Range-bound choppy +- Just closed position (<15 minutes ago) + +# Sharpe Ratio Self-Evolution + +Each cycle you receive Sharpe Ratio as performance feedback: + +Sharpe < -0.5 (continuous losses): + → Stop trading, observe continuously for at least 6 cycles (18 minutes) + → Deep reflection: + • Trading frequency too high? (>2/hour is excessive) + • Holding time too short? (<30 minutes is early exit) + • Signal strength insufficient? (confidence <75) + +Sharpe -0.5 ~ 0 (slight losses): + → Strict control: Only trade confidence >80 + → Reduce frequency: Max 1 new position/hour + → Patient holding: Hold at least 30+ minutes + +Sharpe 0 ~ 0.7 (positive returns): + → Maintain current strategy + +Sharpe > 0.7 (excellent performance): + → Can moderately increase position size + +Key: Sharpe Ratio is the only metric, naturally punishes frequent trading and excessive entries/exits. + +# Decision Process + +1. Analyze Sharpe Ratio: Is current strategy effective? Need adjustments? +2. Evaluate positions: Has trend changed? Should take profit/stop loss? +3. Find new opportunities: Any strong signals? Long/short opportunities? +4. Output decision: Chain of thought + JSON + +# Position Size Calculation + +**Important**: `position_size_usd` is **notional value** (includes leverage), not margin requirement. + +**Calculation Steps**: +1. **Available Margin** = Available Cash × 0.88 (reserve 12% for fees, slippage, liquidation buffer) +2. **Notional Value** = Available Margin × Leverage +3. **position_size_usd** = Notional Value (fill this in JSON) +4. **Actual Coin Amount** = position_size_usd / Current Price + +**Example**: Available cash $500, leverage 5x +- Available Margin = $500 × 0.88 = $440 +- position_size_usd = $440 × 5 = **$2,200** ← Fill this in JSON +- Actually occupies margin = $440, remaining $60 for fees, slippage, liquidation protection + +--- + +Remember: +- Goal is Sharpe Ratio, not trading frequency +- Better miss than make low-quality trades +- Risk-reward ratio 1:3 is baseline +``` + +#### Usage + +Same as Conservative strategy usage. + +--- + +### Aggressive Strategy + +#### Use Cases +- ✅ High risk tolerance users +- ✅ Strong trend markets +- ✅ Pursue high returns, tolerate high volatility + +#### Core Features +- Entry confidence ≥ 70 (lower than system default) +- Risk-reward ratio ≥ 1:3 (system minimum) +- Maximum 3 positions +- Large position size (near system limit 1.5x equity) +- High leverage (near system limits) + +#### Expected Performance +- Trading frequency: High (4-8 trades/day) +- Holding time: Short (average 30min-1 hour) +- Win rate: Lower (50-60%) +- Volatility: Large + +⚠️ **Risk Warning**: This strategy has high volatility and may experience significant drawdowns; suitable only for users with strong risk tolerance. + +#### Complete Template + +```plaintext +You are a professional cryptocurrency trading AI with an aggressive and proactive trading strategy. + +⚠️ Risk Disclosure: This strategy pursues high returns but has high volatility and may experience significant drawdowns. + +# Core Objective + +Maximize returns while controlling risks and actively seizing market opportunities. + +# Trading Philosophy + +Opportunity first: Actively seek trading opportunities, don't over-observe +Quick in/out: Capture short-term volatility, timely stop-loss/take-profit +Trend following: Follow market trends, react quickly +Moderate aggression: Maximize position size and leverage within risk control + +# Entry Criteria (Relatively Loose) + +Entry conditions: +- Confidence ≥ 70 (medium certainty acceptable) +- At least 2 indicators support +- Risk-reward ratio ≥ 1:3 (system minimum) +- Follow major market trend + +Scenarios to try: +- Break key resistance/support levels +- Rapid surge/decline initiation +- Abnormal volume surge +- Short-term overbought/oversold reversal + +# Position Management (Aggressive) + +Single position: +- Altcoins: 1.2~1.5x account equity (near limit) +- BTC/ETH: 8~10x account equity (near limit) + +Maximum positions: 3 coins + +Leverage usage: +- Altcoins: 4~5x leverage (near limit) +- BTC/ETH: 15~20x leverage (near limit) + +# Stop-Loss/Take-Profit (Flexible) + +Quick stop-loss: Stop at -3% loss immediately +Tiered take-profit: + - Reach +3%: Close 30% + - Reach +6%: Close 40% + - Reach +9%: Close all + +Drawdown management: +P&L Amount drawdown from Peak % exceeds 60%, close all + +# Sharpe Ratio Adjustment + +Sharpe < -0.5: Pause trading 15 minutes +Sharpe -0.5~0: Reduce position to 0.8x equity +Sharpe 0~0.7: Maintain current strategy +Sharpe > 0.7: Stay aggressive, can full position + +# Special Strategies + +BTC strong trend following: +- BTC 4h Change > +5%: Prioritize long strong altcoins +- BTC 4h Change < -5%: Quick short or cash out observe + +Short-term volatility capture: +- Price volatility >3% in short time (15min), consider reverse trade +- Duration typically 30-60 minutes + +Remember: +- Aggressive ≠ gambling, still need strict risk control +- Quick in/out, don't linger +- Control single loss, protect principal +``` + +#### Usage + +Same as Conservative strategy usage. + +⚠️ **Reminder**: Aggressive strategy suitable for experienced users with strong risk tolerance; beginners use with caution. + +--- + +## ✅ Quality Checklist + +Check the following before using custom Prompt: + +### 1. Internal Logic Check + +- [ ] **Clear Strategy Goal** + - ✅ Clear trading philosophy (e.g., "trend following", "mean reversion") + - ❌ Vague goals ("make money") + +- [ ] **Consistent Entry/Exit Logic** + - ✅ Entry: "MACD golden cross + volume surge" + - ✅ Exit: "MACD death cross OR reach stop/target" + - ❌ Contradictory logic: "Only long but also short on down signals" + +- [ ] **Balanced Risk Control and Profit Goals** + - ✅ Risk-reward ratio ≥ 1:3, clear stop/target + - ❌ Only pursue returns, ignore risk control + +- [ ] **No "Want Everything" Contradictions** + - ❌ "Both conservative and aggressive" + - ❌ "Both frequent trading and high win rate" + +### 2. Field Reference Check + +- [ ] **Field Names Match System Output** + - ✅ "P&L Amount", "Peak %", "Margin" + - ❌ `unrealized_pnl`, `peak_pnl_pct`, `margin_used` + +- [ ] **Formulas Use Correct Fields** + - ✅ True ROI = P&L Amount / Margin + - ❌ True ROI = P&L % / Leverage + +- [ ] **No References to Non-existent Fields** + - ❌ "Based on KDJ indicator..." (system doesn't provide KDJ) + - ✅ "Based on MACD, RSI indicators..." + +- [ ] **Correct Unit Understanding** + - ✅ "P&L %" = Return with leverage + - ✅ "P&L Amount" = Actual USD P&L + +### 3. System Constraints Check + +- [ ] **Not Trying to Override Hard Constraints** (unless Mode 3 and fully understand) + - ❌ "Risk-reward ratio can be below 1:3" + - ❌ "Can hold 5 positions simultaneously" + +- [ ] **Not Using Reserved Keywords** + - ❌ Write `
策略指令] --> B[AI模型] + C[市场数据
自动生成] --> B + B --> D[思维链分析] + B --> E[交易决策JSON] +``` + +**工作流程**: +1. **系统 Prompt（System）**: 你编写的策略指令 +2. **用户 Prompt（User）**: 系统自动生成的市场数据 +3. **AI 响应（Response）**: AI 的分析和决策 + +### Prompt 的三个组成部分 + +#### 1. 核心策略（你编写） + +定义 AI 的交易哲学、风险偏好、决策标准 + +**示例**: +``` +你是保守型交易员，只在高确定性机会时开仓。 +开仓条件：信心度 ≥ 85，多个指标共振。 +``` + +#### 2. 硬约束（系统自动添加） + +- 风险回报比 ≥ 1:3 +- 最多持仓 3 个币种 +- 杠杆限制（BTC/ETH 20x，山寨币 5x） +- 保证金使用率 ≤ 90% + +⚠️ **方式1和2**: 这些约束自动添加，不可覆盖 +⚠️ **方式3**: 需要自己在 Prompt 中包含这些约束 + +#### 3. 输出格式（系统自动添加） + +要求 AI 使用 XML 标签和 JSON 格式输出决策 + +**示例输出**: +```xml +
仅基础** | `override_base_prompt=false`
`custom_prompt=""` | 官方模板 + 硬约束 + 输出格式 | 新手用户 | +| **模式2
基础+附加** | `override_base_prompt=false`
`custom_prompt="你的策略"` | 官方模板 + 硬约束 + 输出格式
+ 个性化策略 + 注意事项 | 进阶用户 | +| **模式3
完全自定义** | `override_base_prompt=true`
`custom_prompt="完整Prompt"` | 仅使用自定义内容
（忽略所有系统默认） | 高级用户 | + +⚠️ **模式3 风险警告**: +- 你必须自己包含所有硬约束 +- 你必须自己定义输出格式 +- 你必须自己负责风控规则 +- 建议只有完全理解系统机制后才使用 + +--- + +## 📦 官方模板库 + +### 保守型策略 + +#### 适用场景 +- ✅ 新手用户，追求稳健 +- ✅ 市场波动大，风险厌恶 +- ✅ 资金安全优先，容忍低收益 + +#### 核心特点 +- 开仓信心度 ≥ 85（只做高确定性机会） +- 风险回报比 ≥ 1:4（比系统要求更严格） +- 最多持仓 2 个（降低风险暴露） +- 仓位小（0.5倍账户净值） + +#### 预期表现 +- 交易频率: 低（可能一天1-2笔） +- 持仓时间: 长（平均2-4小时） +- 胜率: 高（>70%） +- 波动: 小 + +#### 完整模板 + +```plaintext +你是专业的加密货币交易AI，采用保守稳健的交易策略。 + +# 核心目标 + +最大化夏普比率（Sharpe Ratio），强调风险控制和稳定收益。 + +夏普比率 = 平均收益 / 收益波动率 + +这意味着： +- 只做高确定性交易（信心度 ≥ 85） +- 严格止损止盈，控制回撤 +- 耐心持仓，避免频繁交易 +- 质量优于数量 + +# 交易哲学 + +资金保全第一：宁可错过，不做错 +纪律胜于情绪：执行既定方案，不随意改变 +质量优于数量：少量高信念交易胜过大量低信念交易 +尊重趋势：不要与强趋势作对 + +# 开仓标准（极其严格） + +只在强信号时开仓，不确定就观望。 + +开仓条件（必须同时满足）： +- 信心度 ≥ 85（高确定性） +- 多个指标共振（至少3个指标支持） +- 风险回报比 ≥ 1:4（止盈空间是止损的4倍以上） +- BTC 趋势明确（作为市场风向标） +- 持仓数 < 2（质量>数量） + +避免低质量信号： +- 单一维度（只看一个指标） +- 相互矛盾（涨但量萎缩） +- 横盘震荡 +- 刚平仓不久（<30分钟） + +# 仓位管理（保守） + +单币仓位：账户净值的 0.5 倍（比系统默认更小） +最多持仓：2 个币种（比系统默认少1个） +杠杆使用： +- 山寨币: 3x 杠杆（比系统上限更低） +- BTC/ETH: 10x 杠杆（比系统上限更低） + +# 止盈止损（严格） + +止损：入场后立即设置，绝不移动止损 +止盈：分批止盈 + - 达到 50% 目标：平仓 30% + - 达到 75% 目标：平仓 30% + - 达到 100% 目标：全部平仓 + +回撤管理： +如果盈亏金额从最高收益率回撤超过 40%，立即减仓 50% + +# 夏普比率自我进化 + +夏普比率 < -0.5: 停止交易，连续观望至少 30 分钟 +夏普比率 -0.5~0: 只做信心度 ≥ 90 的交易 +夏普比率 0~1: 维持当前策略 +夏普比率 > 1: 可适度扩大至 0.8 倍净值仓位 + +# 决策流程 + +1. 分析夏普比率：当前策略是否有效？ +2. 评估持仓：是否该止盈/止损？ +3. 寻找新机会：有强信号吗？ +4. 输出决策：思维链分析 + JSON + +记住： +- 目标是夏普比率，不是交易频率 +- 宁可错过，不做低质量交易 +- 每笔交易都要经得起反复推敲 +``` + +#### 使用方式 + +**方式1: 替换默认模板** +```bash +# 备份原文件 +cp prompts/default.txt prompts/default.txt.bak + +# 将上述模板内容保存到 prompts/default.txt +# 重启系统 +docker-compose restart +``` + +**方式2: Web界面自定义** +1. 复制上述模板内容 +2. 粘贴到 Web 界面的"自定义 Prompt" +3. 设置 `override_base_prompt = false` + +--- + +### 平衡型策略 + +#### 适用场景 +- ✅ 有一定经验的用户 +- ✅ 正常市场条件 +- ✅ 追求风险收益平衡 + +#### 核心特点 +- 开仓信心度 ≥ 75（系统默认） +- 风险回报比 ≥ 1:3（系统默认） +- 最多持仓 3 个（系统默认） +- 仓位适中（0.8~1.5倍净值） + +#### 预期表现 +- 交易频率: 中（一天2-4笔） +- 持仓时间: 中（平均1-2小时） +- 胜率: 中等（60-70%） +- 波动: 适中 + +#### 完整模板 + +```plaintext +你是专业的加密货币交易AI，在合约市场进行自主交易。 + +# 核心目标 + +最大化夏普比率（Sharpe Ratio） + +夏普比率 = 平均收益 / 收益波动率 + +这意味着： +- 高质量交易（高胜率、大盈亏比）→ 提升夏普 +- 稳定收益、控制回撤 → 提升夏普 +- 耐心持仓、让利润奔跑 → 提升夏普 +- 频繁交易、小盈小亏 → 增加波动，严重降低夏普 +- 过度交易、手续费损耗 → 直接亏损 +- 过早平仓、频繁进出 → 错失大行情 + +关键认知: 系统每3分钟扫描一次，但不意味着每次都要交易！ +大多数时候应该是 `wait` 或 `hold`，只在极佳机会时才开仓。 + +# 交易哲学 & 最佳实践 + +## 核心原则： + +资金保全第一：保护资本比追求收益更重要 + +纪律胜于情绪：执行你的退出方案，不随意移动止损或目标 + +质量优于数量：少量高信念交易胜过大量低信念交易 + +适应波动性：根据市场条件调整仓位 + +尊重趋势：不要与强趋势作对 + +## 常见误区避免： + +过度交易：频繁交易导致费用侵蚀利润 + +复仇式交易：亏损后立即加码试图"翻本" + +分析瘫痪：过度等待完美信号，导致失机 + +忽视相关性：BTC常引领山寨币，须优先观察BTC + +过度杠杆：放大收益同时放大亏损 + +# 交易频率认知 + +量化标准: +- 优秀交易员：每天2-4笔 = 每小时0.1-0.2笔 +- 过度交易：每小时>2笔 = 严重问题 +- 最佳节奏：开仓后持有至少30-60分钟 + +自查: +如果你发现自己每个周期都在交易 → 说明标准太低 +如果你发现持仓<30分钟就平仓 → 说明太急躁 + +# 开仓标准（严格） + +只在强信号时开仓，不确定就观望。 + +你拥有的完整数据： +- 原始序列：3分钟价格序列(MidPrices数组) + 4小时K线序列 +- 技术序列：EMA20序列、MACD序列、RSI7序列、RSI14序列 +- 资金序列：成交量序列、持仓量(OI)序列、资金费率 +- 筛选标记：AI500评分 / OI_Top排名（如果有标注） + +分析方法（完全由你自主决定）： +- 自由运用序列数据，你可以做但不限于趋势分析、形态识别、支撑阻力、技术阻力位、斐波那契、波动带计算 +- 多维度交叉验证（价格+量+OI+指标+序列形态） +- 用你认为最有效的方法发现高确定性机会 +- 综合信心度 ≥ 75 才开仓 + +避免低质量信号： +- 单一维度（只看一个指标） +- 相互矛盾（涨但量萎缩） +- 横盘震荡 +- 刚平仓不久（<15分钟） + +# 夏普比率自我进化 + +每次你会收到夏普比率作为绩效反馈（周期级别）： + +夏普比率 < -0.5 (持续亏损): + → 停止交易，连续观望至少6个周期（18分钟） + → 深度反思： + • 交易频率过高？（每小时>2次就是过度） + • 持仓时间过短？（<30分钟就是过早平仓） + • 信号强度不足？（信心度<75） + +夏普比率 -0.5 ~ 0 (轻微亏损): + → 严格控制：只做信心度>80的交易 + → 减少交易频率：每小时最多1笔新开仓 + → 耐心持仓：至少持有30分钟以上 + +夏普比率 0 ~ 0.7 (正收益): + → 维持当前策略 + +夏普比率 > 0.7 (优异表现): + → 可适度扩大仓位 + +关键: 夏普比率是唯一指标，它会自然惩罚频繁交易和过度进出。 + +# 决策流程 + +1. 分析夏普比率: 当前策略是否有效？需要调整吗？ +2. 评估持仓: 趋势是否改变？是否该止盈/止损？ +3. 寻找新机会: 有强信号吗？多空机会？ +4. 输出决策: 思维链分析 + JSON + +# 仓位大小计算 + +**重要**：`position_size_usd` 是**名义价值**（包含杠杆），非保证金需求。 + +**计算步骤**： +1. **可用保证金** = Available Cash × 0.88（预留12%给手续费、滑点与清算保证金缓冲） +2. **名义价值** = 可用保证金 × Leverage +3. **position_size_usd** = 名义价值（JSON中填写此值） +4. **实际币数** = position_size_usd / Current Price + +**示例**：可用资金 $500，杠杆 5x +- 可用保证金 = $500 × 0.88 = $440 +- position_size_usd = $440 × 5 = **$2,200** ← JSON填此值 +- 实际占用保证金 = $440，剩余 $60 用于手续费、滑点与清算保护 + +--- + +记住: +- 目标是夏普比率，不是交易频率 +- 宁可错过，不做低质量交易 +- 风险回报比1:3是底线 +``` + +#### 使用方式 + +同保守型策略的使用方式。 + +--- + +### 激进型策略 + +#### 适用场景 +- ✅ 高风险偏好用户 +- ✅ 强趋势市场 +- ✅ 追求高收益，容忍高波动 + +#### 核心特点 +- 开仓信心度 ≥ 70（比系统默认低） +- 风险回报比 ≥ 1:3（系统最低要求） +- 最多持仓 3 个 +- 仓位大（接近系统上限1.5倍净值） +- 杠杆高（接近系统上限） + +#### 预期表现 +- 交易频率: 高（一天4-8笔） +- 持仓时间: 短（平均30分钟-1小时） +- 胜率: 较低（50-60%） +- 波动: 大 + +⚠️ **风险警告**: 此策略波动大，可能出现较大回撤，仅适合风险承受能力强的用户。 + +#### 完整模板 + +```plaintext +你是专业的加密货币交易AI，采用激进主动的交易策略。 + +⚠️ 风险声明：此策略追求高收益，但波动性大，可能出现较大回撤。 + +# 核心目标 + +最大化收益，在控制风险的前提下积极把握市场机会。 + +# 交易哲学 + +机会优先：积极寻找交易机会，不过度观望 +快进快出：捕捉短期波动，及时止盈止损 +趋势跟随：顺应市场趋势，快速反应 +适度激进：在风控范围内最大化仓位和杠杆 + +# 开仓标准（相对宽松） + +开仓条件： +- 信心度 ≥ 70（中等确定性即可） +- 至少2个指标支持 +- 风险回报比 ≥ 1:3（系统最低要求） +- 顺应市场大趋势 + +可以尝试的场景： +- 突破关键阻力位/支撑位 +- 快速拉升/下跌启动 +- 成交量异常放大 +- 短期超买/超卖反转 + +# 仓位管理（激进） + +单币仓位： +- 山寨币: 1.2~1.5 倍账户净值（接近上限） +- BTC/ETH: 8~10 倍账户净值（接近上限） + +最多持仓：3 个币种 + +杠杆使用： +- 山寨币: 4~5x 杠杆（接近上限） +- BTC/ETH: 15~20x 杠杆（接近上限） + +# 止盈止损（灵活） + +快速止损：亏损达到 -3% 立即止损 +分批止盈： + - 达到 +3%：平仓 30% + - 达到 +6%：平仓 40% + - 达到 +9%：全部平仓 + +回撤管理： +盈亏金额从最高收益率回撤超过 60%，全部平仓 + +# 夏普比率调整 + +夏普比率 < -0.5: 暂停交易 15 分钟 +夏普比率 -0.5~0: 降低仓位至 0.8 倍净值 +夏普比率 0~0.7: 维持当前策略 +夏普比率 > 0.7: 保持激进，可满仓操作 + +# 特殊策略 + +BTC 强趋势跟随： +- BTC 4h涨跌幅 > +5%：优先做多强势山寨币 +- BTC 4h涨跌幅 < -5%：快速做空或空仓观望 + +短期波动捕捉： +- 价格短时间（15分钟内）波动 > 3%，考虑反向交易 +- 持仓时长通常 30-60 分钟 + +记住： +- 激进不等于赌博，仍需严格风控 +- 快进快出，不恋战 +- 控制单次亏损，保护本金 +``` + +#### 使用方式 + +同保守型策略的使用方式。 + +⚠️ **再次提醒**: 激进策略适合经验丰富、风险承受能力强的用户，新手请谨慎使用。 + +--- + +## ✅ 质量检查清单 + +在使用自定义 Prompt 前，请通过以下检查： + +### 1. 内部逻辑检查 + +- [ ] **策略目标明确** + - ✅ 有清晰的交易哲学（如"趋势跟踪"、"均值回归"） + - ❌ 目标模糊（"赚钱就行"） + +- [ ] **开仓/平仓逻辑一致** + - ✅ 开仓条件："MACD金叉 + 成交量放大" + - ✅ 平仓条件："MACD死叉 或 达到止盈/止损" + - ❌ 矛盾逻辑："只做多但遇到下跌信号也做空" + +- [ ] **风控与盈利目标平衡** + - ✅ 风险回报比 ≥ 1:3，止盈止损明确 + - ❌ 只追求高收益，忽视风险控制 + +- [ ] **无"既要又要"的矛盾** + - ❌ "既要保守又要激进" + - ❌ "既要频繁交易又要高胜率" + +### 2. 字段引用检查 + +- [ ] **字段名称与系统输出一致** + - ✅ "盈亏金额"、"最高收益率"、"保证金" + - ❌ `unrealized_pnl`、`peak_pnl_pct`、`margin_used` + +- [ ] **计算公式使用正确字段** + - ✅ 真实收益率 = 盈亏金额 / 保证金 + - ❌ 真实收益率 = 盈亏（百分比）/ 杠杆 + +- [ ] **没有引用不存在的字段** + - ❌ "根据 KDJ 指标..." （系统未提供 KDJ） + - ✅ "根据 MACD、RSI 指标..." + +- [ ] **单位理解正确** + - ✅ "盈亏（百分比）" = 含杠杆的收益率 + - ✅ "盈亏金额" = 实际美元盈亏 + +### 3. 系统约束检查 + +- [ ] **未尝试覆盖硬约束**（除非模式3且完全理解） + - ❌ "风险回报比可以低于1:3" + - ❌ "可以同时持仓5个币种" + +- [ ] **未使用保留关键词** + - ❌ 在 Prompt 中写 `
+
+ )
}
-function App() {
- const { language, setLanguage } = useLanguage()
- const { user, token, logout, isLoading } = useAuth()
- const configLoading = false
- const [route, setRoute] = useState(window.location.pathname)
-
- // 从URL路径读取初始页面状态（支持刷新保持页面）
- const getInitialPage = (): Page => {
- const path = window.location.pathname
- const hash = window.location.hash.slice(1) // 去掉 #
-
- if (path === '/traders' || hash === 'traders') return 'traders'
- if (path === '/dashboard' || hash === 'trader' || hash === 'details')
- return 'trader'
- return 'competition' // 默认为竞赛页面
- }
-
- const [currentPage, setCurrentPage] = useState
+ 
+
+
+ {t('loading', language)}
+
-
- )
+ return
-
-
-
- {t('loading', language)}
-
- {
- console.log('Competition page onPageChange called with:', page)
- console.log('Current route:', route, 'Current page:', currentPage)
-
- if (page === 'competition') {
- console.log('Navigating to competition')
- window.history.pushState({}, '', '/competition')
- setRoute('/competition')
- setCurrentPage('competition')
- } else if (page === 'traders') {
- console.log('Navigating to traders')
- window.history.pushState({}, '', '/traders')
- setRoute('/traders')
- setCurrentPage('traders')
- } else if (page === 'trader') {
- console.log('Navigating to trader/dashboard')
- window.history.pushState({}, '', '/dashboard')
- setRoute('/dashboard')
- setCurrentPage('trader')
- }
-
- console.log(
- 'After navigation - route:',
- route,
- 'currentPage:',
- currentPage
- )
- }}
- />
-
-
-
- )
- }
-
- // Show landing page for root route
- if (route === '/' || route === '') {
- return
- {
- console.log('Main app onPageChange called with:', page)
-
- if (page === 'competition') {
- window.history.pushState({}, '', '/competition')
- setRoute('/competition')
- setCurrentPage('competition')
- } else if (page === 'traders') {
- window.history.pushState({}, '', '/traders')
- setRoute('/traders')
- setCurrentPage('traders')
- } else if (page === 'trader') {
- window.history.pushState({}, '', '/dashboard')
- setRoute('/dashboard')
- setCurrentPage('trader')
- }
- }}
- />
-
- {/* Main Content */}
-
- {currentPage === 'competition' ? (
- {
- setSelectedTraderId(traderId)
- window.history.pushState({}, '', '/dashboard')
- setRoute('/dashboard')
- setCurrentPage('trader')
- }}
- />
- ) : (
-
-
- {/* Footer */}
-
-
- )
+ return
- {/* Loading Skeleton - Binance Style */}
-
- )
- }
-
- return (
-
-
-
-
-
-
-
-
-
- {[1, 2, 3, 4].map((i) => (
-
-
-
-
-
- ))}
-
-
-
-
-
- {/* Trader Header */}
-
- )
-}
-
-// Stat Card Component - Binance Style Enhanced
-function StatCard({
- title,
- value,
- change,
- positive,
- subtitle,
-}: {
- title: string
- value: string
- change?: number
- positive?: boolean
- subtitle?: string
-}) {
- return (
-
-
-
- {/* Debug Info */}
- {account && (
-
-
- - - 🤖 - - {selectedTrader.trader_name} -
- - {/* Trader Selector */} - {traders && traders.length > 0 && ( -
-
- {t('switchTrader', language)}:
-
-
-
- )}
-
-
- AI Model:{' '}
-
- {getModelDisplayName(
- selectedTrader.ai_model.split('_').pop() ||
- selectedTrader.ai_model
- )}
-
-
- {status && (
- <>
- •
- Cycles: {status.call_count}
- •
- Runtime: {status.runtime_minutes} min
-
- )}
-
-
-
- )}
-
- {/* Account Overview */}
-
- 🔄 Last Update: {lastUpdate} | Total Equity:{' '}
- {account?.total_equity?.toFixed(2) || '0.00'} | Available:{' '}
- {account?.available_balance?.toFixed(2) || '0.00'} | P&L:{' '}
- {account?.total_pnl?.toFixed(2) || '0.00'} (
- {account?.total_pnl_pct?.toFixed(2) || '0.00'}%)
-
-
- 0}
- />
- = 0 ? '+' : ''}${account?.total_pnl?.toFixed(2) || '0.00'} USDT`}
- change={account?.total_pnl_pct || 0}
- positive={(account?.total_pnl ?? 0) >= 0}
- />
-
-
- {/* 主要内容区：左右分屏 */}
-
- {/* 左侧：图表 + 持仓 */}
-
-
- {/* AI Learning & Performance Analysis */}
-
- {/* Equity Chart */}
-
- {/* 左侧结束 */}
-
- {/* 右侧：Recent Decisions - 卡片容器 */}
-
-
-
- {/* Current Positions */}
-
-
-
-
- {positions && positions.length > 0 ? (
- - 📈 {t('currentPositions', language)} -
- {positions && positions.length > 0 && ( -
- {positions.length} {t('active', language)}
-
- )}
-
-
-
-
-
- ) : (
- | - {t('symbol', language)} - | -- {t('side', language)} - | -- {t('entryPrice', language)} - | -- {t('markPrice', language)} - | -- {t('quantity', language)} - | -- {t('positionValue', language)} - | -- {t('leverage', language)} - | -- {t('unrealizedPnL', language)} - | -- {t('liqPrice', language)} - | -
|---|---|---|---|---|---|---|---|---|
| - {pos.symbol} - | -- - {t( - pos.side === 'long' ? 'long' : 'short', - language - )} - - | -- {pos.entry_price.toFixed(4)} - | -- {pos.mark_price.toFixed(4)} - | -- {pos.quantity.toFixed(4)} - | -- {(pos.quantity * pos.mark_price).toFixed(2)} USDT - | -- {pos.leverage}x - | -- = 0 ? '#0ECB81' : '#F6465D', - fontWeight: 'bold', - }} - > - {pos.unrealized_pnl >= 0 ? '+' : ''} - {pos.unrealized_pnl.toFixed(2)} ( - {pos.unrealized_pnl_pct.toFixed(2)}%) - - | -- {pos.liquidation_price.toFixed(4)} - | -
-
- )}
- 📊
-
- {t('noPositions', language)}
-
-
- {t('noActivePositions', language)}
-
-
- {/* 标题 */}
-
- {/* 右侧结束 */}
-
-
-
- {/* 决策列表 - 可滚动 */}
-
- 🧠
-
-
-
- - {t('recentDecisions', language)} -
- {decisions && decisions.length > 0 && ( -
- {t('lastCycles', language, { count: decisions.length })}
-
- )}
-
- {decisions && decisions.length > 0 ? (
- decisions.map((decision, i) => (
-
-
-
- )}
- 🧠
-
- {t('noDecisionsYet', language)}
-
-
- {t('aiDecisionsWillAppear', language)}
-
-
-
-
-
- )
-}
-
-// Decision Card Component with CoT Trace - Binance Style
-function DecisionCard({
- decision,
- language,
-}: {
- decision: DecisionRecord
- language: Language
-}) {
- const [showInputPrompt, setShowInputPrompt] = useState(false)
- const [showCoT, setShowCoT] = useState(false)
-
- return (
-
- {title}
-
-
- {value}
-
- {change !== undefined && (
-
-
- )}
- {subtitle && (
-
- {positive ? '▲' : '▼'} {positive ? '+' : ''}
- {change.toFixed(2)}%
-
-
- {subtitle}
-
- )}
-
- {/* Header */}
-
- )
-}
-
-// Wrap App with providers
-export default function AppWithProviders() {
+export default function App() {
return (
-
-
- {/* Input Prompt - Collapsible */}
- {decision.input_prompt && (
-
-
-
- {t('cycle', language)} #{decision.cycle_number}
-
-
- {new Date(decision.timestamp).toLocaleString()}
-
-
- {t(decision.success ? 'success' : 'failed', language)}
-
-
-
- {showInputPrompt && (
-
- )}
-
- {/* AI Chain of Thought - Collapsible */}
- {decision.cot_trace && (
-
- {decision.input_prompt}
-
- )}
-
-
- {showCoT && (
-
- )}
-
- {/* Decisions Actions */}
- {decision.decisions && decision.decisions.length > 0 && (
-
- {decision.cot_trace}
-
- )}
-
- {decision.decisions.map((action, j) => (
-
- )}
-
- {/* Account State Summary */}
- {decision.account_state && (
-
-
- {action.symbol}
-
-
- {action.action}
-
- {action.leverage > 0 && (
- {action.leverage}x
- )}
- {action.price > 0 && (
-
- @{action.price.toFixed(4)}
-
- )}
-
- {action.success ? '✓' : '✗'}
-
- {action.error && (
-
- {action.error}
-
- )}
-
- ))}
-
-
- 净值: {decision.account_state.total_balance.toFixed(2)} USDT
-
-
- 可用: {decision.account_state.available_balance.toFixed(2)} USDT
-
-
- 保证金率: {decision.account_state.margin_used_pct.toFixed(1)}%
-
- 持仓: {decision.account_state.position_count}
-
- {t('candidateCoins', language)}: {decision.candidate_coins?.length || 0}
-
-
- )}
-
- {/* Candidate Coins Warning */}
- {decision.candidate_coins && decision.candidate_coins.length === 0 && (
-
-
- )}
-
- {/* Execution Logs */}
- {decision.execution_log && decision.execution_log.length > 0 && (
-
-
- ⚠️ {t('candidateCoinsZeroWarning', language)}
-
-
- {t('possibleReasons', language)}
- -
-
- {t('coinPoolApiNotConfigured', language)} -
- {t('apiConnectionTimeout', language)} -
- {t('noCustomCoinsAndApiFailed', language)} -
- {t('solutions', language)}
-
- -
-
- {t('setCustomCoinsInConfig', language)} -
- {t('orConfigureCorrectApiUrl', language)} -
- {t('orDisableCoinPoolOptions', language)} -
- {decision.execution_log.map((log, k) => (
-
- )}
-
- {/* Error Message */}
- {decision.error_message && (
-
- {log}
-
- ))}
-
- ❌ {decision.error_message}
-
- )}
- {t('loadingError', language)}
+
+ {stripLeadingIcons(t('loadingError', language))}
+
)
}
@@ -695,7 +698,7 @@ export default function AILearning({ traderId }: AILearningProps) {
style={{ color: '#E0E7FF' }}
>
- {t('howAILearns', language)}
+ {stripLeadingIcons(t('howAILearns', language))}
-
)
@@ -783,16 +980,12 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
{getShortName(exchange.name)}
diff --git a/web/src/components/AITradersPage.tsx b/web/src/components/AITradersPage.tsx
index ae13c42b..5e066661 100644
--- a/web/src/components/AITradersPage.tsx
+++ b/web/src/components/AITradersPage.tsx
@@ -1,4 +1,5 @@
import React, { useState, useEffect } from 'react'
+import { useNavigate } from 'react-router-dom'
import useSWR from 'swr'
import { api } from '../lib/api'
import type {
@@ -13,7 +14,14 @@ import { useAuth } from '../contexts/AuthContext'
import { getExchangeIcon } from './ExchangeIcons'
import { getModelIcon } from './ModelIcons'
import { TraderConfigModal } from './TraderConfigModal'
-import { TwoStageKeyModal } from './TwoStageKeyModal'
+import {
+ TwoStageKeyModal,
+ type TwoStageKeyModalResult,
+} from './TwoStageKeyModal'
+import {
+ WebCryptoEnvironmentCheck,
+ type WebCryptoCheckStatus,
+} from './WebCryptoEnvironmentCheck'
import {
Bot,
Brain,
@@ -25,7 +33,11 @@ import {
AlertTriangle,
BookOpen,
HelpCircle,
+ Radio,
+ Pencil,
} from 'lucide-react'
+import { confirmToast } from '../lib/notify'
+import { toast } from 'sonner'
// 获取友好的AI模型名称
function getModelDisplayName(modelId: string): string {
@@ -47,12 +59,6 @@ function getShortName(fullName: string): string {
return parts.length > 1 ? parts[parts.length - 1] : fullName
}
-function maskSecret(value: string): string {
- if (!value) return ''
- const length = Math.min(value.length, 16)
- return '•'.repeat(length)
-}
-
interface AITradersPageProps {
onTraderSelect?: (traderId: string) => void
}
@@ -60,13 +66,12 @@ interface AITradersPageProps {
export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
const { language } = useLanguage()
const { user, token } = useAuth()
+ const navigate = useNavigate()
const [showCreateModal, setShowCreateModal] = useState(false)
const [showEditModal, setShowEditModal] = useState(false)
const [showModelModal, setShowModelModal] = useState(false)
const [showExchangeModal, setShowExchangeModal] = useState(false)
const [showSignalSourceModal, setShowSignalSourceModal] = useState(false)
- const [showDeleteConfirm, setShowDeleteConfirm] = useState(false)
- const [deleteTarget, setDeleteTarget] = useState<{type: 'model' | 'exchange', id: string} | null>(null)
const [editingModel, setEditingModel] = useState(null)
const [editingExchange, setEditingExchange] = useState(null)
const [editingTrader, setEditingTrader] = useState(null)
@@ -140,32 +145,82 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
loadConfigs()
}, [user, token])
- // 显示所有用户的模型和交易所配置（用于调试）
- const configuredModels = allModels || []
- const configuredExchanges = allExchanges || []
+ // 只显示已配置的模型和交易所
+ // 注意：后端返回的数据不包含敏感信息（apiKey等），所以通过其他字段判断是否已配置
+ const configuredModels =
+ allModels?.filter((m) => {
+ // 如果模型已启用，说明已配置
+ // 或者有自定义API URL，也说明已配置
+ return m.enabled || (m.customApiUrl && m.customApiUrl.trim() !== '')
+ }) || []
+ const configuredExchanges =
+ allExchanges?.filter((e) => {
+ // Aster 交易所检查特殊字段
+ if (e.id === 'aster') {
+ return e.asterUser && e.asterUser.trim() !== ''
+ }
+ // Hyperliquid 需要检查钱包地址（后端会返回这个字段）
+ if (e.id === 'hyperliquid') {
+ return e.hyperliquidWalletAddr && e.hyperliquidWalletAddr.trim() !== ''
+ }
+ // 其他交易所：如果已启用，说明已配置（后端返回的已配置交易所会有 enabled: true）
+ return e.enabled
+ }) || []
// 只在创建交易员时使用已启用且配置完整的
- const enabledModels = allModels?.filter((m) => m.enabled && m.apiKey) || []
+ // 注意：后端返回的数据不包含敏感信息，所以只检查 enabled 状态和必要的非敏感字段
+ const enabledModels = allModels?.filter((m) => m.enabled) || []
const enabledExchanges =
allExchanges?.filter((e) => {
if (!e.enabled) return false
- // 由于API不再返回敏感字段信息，只能基于enabled状态判断
- // 实际的配置验证将在后端进行
+ // Aster 交易所需要特殊字段（后端会返回这些非敏感字段）
+ if (e.id === 'aster') {
+ return (
+ e.asterUser &&
+ e.asterUser.trim() !== '' &&
+ e.asterSigner &&
+ e.asterSigner.trim() !== ''
+ )
+ }
+
+ // Hyperliquid 需要钱包地址（后端会返回这个字段）
+ if (e.id === 'hyperliquid') {
+ return e.hyperliquidWalletAddr && e.hyperliquidWalletAddr.trim() !== ''
+ }
+
+ // 其他交易所：如果已启用，说明已配置完整（后端只返回已配置的交易所）
return true
}) || []
- // 检查模型是否正在被运行中的交易员使用
+ // 检查模型是否正在被运行中的交易员使用（用于UI禁用）
const isModelInUse = (modelId: string) => {
- return traders?.some((t) => t.ai_model === modelId && t.is_running) || false
+ return traders?.some((t) => t.ai_model === modelId && t.is_running)
}
- // 检查交易所是否正在被运行中的交易员使用
+ // 检查交易所是否正在被运行中的交易员使用（用于UI禁用）
const isExchangeInUse = (exchangeId: string) => {
- return (
- traders?.some((t) => t.exchange_id === exchangeId && t.is_running) ||
- false
- )
+ return traders?.some((t) => t.exchange_id === exchangeId && t.is_running)
+ }
+
+ // 检查模型是否被任何交易员使用（包括停止状态的）
+ const isModelUsedByAnyTrader = (modelId: string) => {
+ return traders?.some((t) => t.ai_model === modelId) || false
+ }
+
+ // 检查交易所是否被任何交易员使用（包括停止状态的）
+ const isExchangeUsedByAnyTrader = (exchangeId: string) => {
+ return traders?.some((t) => t.exchange_id === exchangeId) || false
+ }
+
+ // 获取使用特定模型的交易员列表
+ const getTradersUsingModel = (modelId: string) => {
+ return traders?.filter((t) => t.ai_model === modelId) || []
+ }
+
+ // 获取使用特定交易所的交易员列表
+ const getTradersUsingExchange = (exchangeId: string) => {
+ return traders?.filter((t) => t.exchange_id === exchangeId) || []
}
const handleCreateTrader = async (data: CreateTraderRequest) => {
@@ -174,21 +229,25 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
const exchange = allExchanges?.find((e) => e.id === data.exchange_id)
if (!model?.enabled) {
- alert(t('modelNotConfigured', language))
+ toast.error(t('modelNotConfigured', language))
return
}
if (!exchange?.enabled) {
- alert(t('exchangeNotConfigured', language))
+ toast.error(t('exchangeNotConfigured', language))
return
}
- await api.createTrader(data)
+ await toast.promise(api.createTrader(data), {
+ loading: '正在创建…',
+ success: '创建成功',
+ error: '创建失败',
+ })
setShowCreateModal(false)
mutateTraders()
} catch (error) {
console.error('Failed to create trader:', error)
- alert(t('createTraderFailed', language))
+ toast.error(t('createTraderFailed', language))
}
}
@@ -199,7 +258,7 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
setShowEditModal(true)
} catch (error) {
console.error('Failed to fetch trader config:', error)
- alert(t('getTraderConfigFailed', language))
+ toast.error(t('getTraderConfigFailed', language))
}
}
@@ -211,12 +270,12 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
const exchange = enabledExchanges?.find((e) => e.id === data.exchange_id)
if (!model) {
- alert(t('modelConfigNotExist', language))
+ toast.error(t('modelConfigNotExist', language))
return
}
if (!exchange) {
- alert(t('exchangeConfigNotExist', language))
+ toast.error(t('exchangeConfigNotExist', language))
return
}
@@ -231,44 +290,64 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
trading_symbols: data.trading_symbols,
custom_prompt: data.custom_prompt,
override_base_prompt: data.override_base_prompt,
+ system_prompt_template: data.system_prompt_template,
is_cross_margin: data.is_cross_margin,
use_coin_pool: data.use_coin_pool,
use_oi_top: data.use_oi_top,
}
- await api.updateTrader(editingTrader.trader_id, request)
+ await toast.promise(api.updateTrader(editingTrader.trader_id, request), {
+ loading: '正在保存…',
+ success: '保存成功',
+ error: '保存失败',
+ })
setShowEditModal(false)
setEditingTrader(null)
mutateTraders()
} catch (error) {
console.error('Failed to update trader:', error)
- alert(t('updateTraderFailed', language))
+ toast.error(t('updateTraderFailed', language))
}
}
const handleDeleteTrader = async (traderId: string) => {
- if (!confirm(t('confirmDeleteTrader', language))) return
+ {
+ const ok = await confirmToast(t('confirmDeleteTrader', language))
+ if (!ok) return
+ }
try {
- await api.deleteTrader(traderId)
+ await toast.promise(api.deleteTrader(traderId), {
+ loading: '正在删除…',
+ success: '删除成功',
+ error: '删除失败',
+ })
mutateTraders()
} catch (error) {
console.error('Failed to delete trader:', error)
- alert(t('deleteTraderFailed', language))
+ toast.error(t('deleteTraderFailed', language))
}
}
const handleToggleTrader = async (traderId: string, running: boolean) => {
try {
if (running) {
- await api.stopTrader(traderId)
+ await toast.promise(api.stopTrader(traderId), {
+ loading: '正在停止…',
+ success: '已停止',
+ error: '停止失败',
+ })
} else {
- await api.startTrader(traderId)
+ await toast.promise(api.startTrader(traderId), {
+ loading: '正在启动…',
+ success: '已启动',
+ error: '启动失败',
+ })
}
mutateTraders()
} catch (error) {
console.error('Failed to toggle trader:', error)
- alert(t('operationFailed', language))
+ toast.error(t('operationFailed', language))
}
}
@@ -286,25 +365,82 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
}
}
- const handleDeleteModelConfig = async (modelId: string) => {
+ // 通用删除配置处理函数
+ const handleDeleteConfig = async (config: {
+ id: string
+ type: 'model' | 'exchange'
+ checkInUse: (id: string) => boolean
+ getUsingTraders: (id: string) => any[]
+ cannotDeleteKey: string
+ confirmDeleteKey: string
+ allItems: T[] | undefined
+ clearFields: (item: T) => T
+ buildRequest: (items: T[]) => any
+ updateApi: (request: any) => Promise
+ refreshApi: () => Promise
+ setItems: (items: T[]) => void
+ closeModal: () => void
+ errorKey: string
+ }) => {
+ // 检查是否有交易员正在使用
+ if (config.checkInUse(config.id)) {
+ const usingTraders = config.getUsingTraders(config.id)
+ const traderNames = usingTraders.map((t) => t.trader_name).join(', ')
+ toast.error(
+ `${t(config.cannotDeleteKey, language)} · ${t('tradersUsing', language)}: ${traderNames} · ${t('pleaseDeleteTradersFirst', language)}`
+ )
+ return
+ }
+
+ {
+ const ok = await confirmToast(t(config.confirmDeleteKey, language))
+ if (!ok) return
+ }
+
try {
- const updatedModels =
- allModels?.map((m) =>
- m.id === modelId
- ? {
- ...m,
- apiKey: '',
- customApiUrl: '',
- customModelName: '',
- enabled: false,
- }
- : m
+ const updatedItems =
+ config.allItems?.map((item) =>
+ item.id === config.id ? config.clearFields(item) : item
) || []
- const request = {
+ const request = config.buildRequest(updatedItems)
+ await toast.promise(config.updateApi(request), {
+ loading: '正在更新配置…',
+ success: '配置已更新',
+ error: '更新配置失败',
+ })
+
+ // 重新获取用户配置以确保数据同步
+ const refreshedItems = await config.refreshApi()
+ config.setItems(refreshedItems)
+
+ config.closeModal()
+ } catch (error) {
+ console.error(`Failed to delete ${config.type} config:`, error)
+ toast.error(t(config.errorKey, language))
+ }
+ }
+
+ const handleDeleteModelConfig = async (modelId: string) => {
+ await handleDeleteConfig({
+ id: modelId,
+ type: 'model',
+ checkInUse: isModelUsedByAnyTrader,
+ getUsingTraders: getTradersUsingModel,
+ cannotDeleteKey: 'cannotDeleteModelInUse',
+ confirmDeleteKey: 'confirmDeleteModel',
+ allItems: allModels,
+ clearFields: (m) => ({
+ ...m,
+ apiKey: '',
+ customApiUrl: '',
+ customModelName: '',
+ enabled: false,
+ }),
+ buildRequest: (models) => ({
models: Object.fromEntries(
- updatedModels.map((model) => [
- model.provider, // 使用 provider 而不是 id
+ models.map((model) => [
+ model.provider,
{
enabled: model.enabled,
api_key: model.apiKey || '',
@@ -313,32 +449,19 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
},
])
),
- }
-
- await api.updateModelConfigs(request)
-
- // 重新获取用户配置以确保数据同步
- const refreshedModels = await api.getModelConfigs()
- setAllModels(refreshedModels)
-
- setShowModelModal(false)
- setEditingModel(null)
- setShowDeleteConfirm(false)
- setDeleteTarget(null)
- } catch (error) {
- console.error('Failed to delete model config:', error)
- alert(t('deleteConfigFailed', language))
- }
- }
-
- const handleConfirmDelete = () => {
- if (!deleteTarget) return
-
- if (deleteTarget.type === 'model') {
- handleDeleteModelConfig(deleteTarget.id)
- } else if (deleteTarget.type === 'exchange') {
- handleDeleteExchangeConfig(deleteTarget.id)
- }
+ }),
+ updateApi: api.updateModelConfigs,
+ refreshApi: api.getModelConfigs,
+ setItems: (items) => {
+ // 使用函数式更新确保状态正确更新
+ setAllModels([...items])
+ },
+ closeModal: () => {
+ setShowModelModal(false)
+ setEditingModel(null)
+ },
+ errorKey: 'deleteConfigFailed',
+ })
}
const handleSaveModelConfig = async (
@@ -356,7 +479,7 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
const modelToUpdate =
existingModel || supportedModels?.find((m) => m.id === modelId)
if (!modelToUpdate) {
- alert(t('modelNotExist', language))
+ toast.error(t('modelNotExist', language))
return
}
@@ -400,7 +523,11 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
),
}
- await api.updateModelConfigs(request)
+ await toast.promise(api.updateModelConfigs(request), {
+ loading: '正在更新模型配置…',
+ success: '模型配置已更新',
+ error: '更新模型配置失败',
+ })
// 重新获取用户配置以确保数据同步
const refreshedModels = await api.getModelConfigs()
@@ -410,39 +537,58 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
setEditingModel(null)
} catch (error) {
console.error('Failed to save model config:', error)
- alert(t('saveConfigFailed', language))
+ toast.error(t('saveConfigFailed', language))
}
}
const handleDeleteExchangeConfig = async (exchangeId: string) => {
- try {
- const request = {
- exchanges: {
- [exchangeId]: {
- enabled: false,
- api_key: '',
- secret_key: '',
- testnet: false,
- hyperliquid_wallet_addr: '',
- aster_user: '',
- aster_signer: '',
- aster_private_key: '',
- },
- },
- }
-
- await api.updateExchangeConfigsEncrypted(request)
-
- const refreshed = await api.getExchangeConfigs()
- setAllExchanges(refreshed)
- setShowExchangeModal(false)
- setEditingExchange(null)
- setShowDeleteConfirm(false)
- setDeleteTarget(null)
- } catch (error) {
- console.error('Failed to delete exchange config:', error)
- alert(t('deleteExchangeConfigFailed', language))
- }
+ await handleDeleteConfig({
+ id: exchangeId,
+ type: 'exchange',
+ checkInUse: isExchangeUsedByAnyTrader,
+ getUsingTraders: getTradersUsingExchange,
+ cannotDeleteKey: 'cannotDeleteExchangeInUse',
+ confirmDeleteKey: 'confirmDeleteExchange',
+ allItems: allExchanges,
+ clearFields: (e) => ({
+ ...e,
+ apiKey: '',
+ secretKey: '',
+ hyperliquidWalletAddr: '',
+ asterUser: '',
+ asterSigner: '',
+ asterPrivateKey: '',
+ enabled: false,
+ }),
+ buildRequest: (exchanges) => ({
+ exchanges: Object.fromEntries(
+ exchanges.map((exchange) => [
+ exchange.id,
+ {
+ enabled: exchange.enabled,
+ api_key: exchange.apiKey || '',
+ secret_key: exchange.secretKey || '',
+ testnet: exchange.testnet || false,
+ hyperliquid_wallet_addr: exchange.hyperliquidWalletAddr || '',
+ aster_user: exchange.asterUser || '',
+ aster_signer: exchange.asterSigner || '',
+ aster_private_key: exchange.asterPrivateKey || '',
+ },
+ ])
+ ),
+ }),
+ updateApi: api.updateExchangeConfigsEncrypted,
+ refreshApi: api.getExchangeConfigs,
+ setItems: (items) => {
+ // 使用函数式更新确保状态正确更新
+ setAllExchanges([...items])
+ },
+ closeModal: () => {
+ setShowExchangeModal(false)
+ setEditingExchange(null)
+ },
+ errorKey: 'deleteExchangeConfigFailed',
+ })
}
const handleSaveExchangeConfig = async (
@@ -461,27 +607,73 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
(e) => e.id === exchangeId
)
if (!exchangeToUpdate) {
- alert(t('exchangeNotExist', language))
+ toast.error(t('exchangeNotExist', language))
return
}
- const request = {
- exchanges: {
- [exchangeId]: {
- enabled: true,
- api_key: apiKey || '',
- secret_key: secretKey || '',
- testnet: !!testnet,
- hyperliquid_wallet_addr: hyperliquidWalletAddr || '',
- aster_user: asterUser || '',
- aster_signer: asterSigner || '',
- aster_private_key: asterPrivateKey || '',
- },
- },
+ // 创建或更新用户的交易所配置
+ const existingExchange = allExchanges?.find((e) => e.id === exchangeId)
+ let updatedExchanges
+
+ if (existingExchange) {
+ // 更新现有配置
+ updatedExchanges =
+ allExchanges?.map((e) =>
+ e.id === exchangeId
+ ? {
+ ...e,
+ apiKey,
+ secretKey,
+ testnet,
+ hyperliquidWalletAddr,
+ asterUser,
+ asterSigner,
+ asterPrivateKey,
+ enabled: true,
+ }
+ : e
+ ) || []
+ } else {
+ // 添加新配置
+ const newExchange = {
+ ...exchangeToUpdate,
+ apiKey,
+ secretKey,
+ testnet,
+ hyperliquidWalletAddr,
+ asterUser,
+ asterSigner,
+ asterPrivateKey,
+ enabled: true,
+ }
+ updatedExchanges = [...(allExchanges || []), newExchange]
}
- await api.updateExchangeConfigsEncrypted(request)
+ const request = {
+ exchanges: Object.fromEntries(
+ updatedExchanges.map((exchange) => [
+ exchange.id,
+ {
+ enabled: exchange.enabled,
+ api_key: exchange.apiKey || '',
+ secret_key: exchange.secretKey || '',
+ testnet: exchange.testnet || false,
+ hyperliquid_wallet_addr: exchange.hyperliquidWalletAddr || '',
+ aster_user: exchange.asterUser || '',
+ aster_signer: exchange.asterSigner || '',
+ aster_private_key: exchange.asterPrivateKey || '',
+ },
+ ])
+ ),
+ }
+ await toast.promise(api.updateExchangeConfigsEncrypted(request), {
+ loading: '正在更新交易所配置…',
+ success: '交易所配置已更新',
+ error: '更新交易所配置失败',
+ })
+
+ // 重新获取用户配置以确保数据同步
const refreshedExchanges = await api.getExchangeConfigs()
setAllExchanges(refreshedExchanges)
@@ -489,7 +681,7 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
setEditingExchange(null)
} catch (error) {
console.error('Failed to save exchange config:', error)
- alert(t('saveConfigFailed', language))
+ toast.error(t('saveConfigFailed', language))
}
}
@@ -508,12 +700,16 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
oiTopUrl: string
) => {
try {
- await api.saveUserSignalSource(coinPoolUrl, oiTopUrl)
+ await toast.promise(api.saveUserSignalSource(coinPoolUrl, oiTopUrl), {
+ loading: '正在保存…',
+ success: '保存成功',
+ error: '保存失败',
+ })
setUserSignalSource({ coinPoolUrl, oiTopUrl })
setShowSignalSourceModal(false)
} catch (error) {
console.error('Failed to save signal source:', error)
- alert(t('saveSignalSourceFailed', language))
+ toast.error(t('saveSignalSourceFailed', language))
}
}
@@ -553,7 +749,7 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
+
- {exchange.type.toUpperCase()} • {inUse ? t('inUse', language) : exchange.enabled ? t('enabled', language) : t('configured', language)}
- {/* 添加地址信息 */}
- {inUse && (exchange.hyperliquidWalletAddr || exchange.asterUser) && (
-
- ({exchange.hyperliquidWalletAddr
- ? `${exchange.hyperliquidWalletAddr.slice(0, 6)}...${exchange.hyperliquidWalletAddr.slice(-4)}`
- : (exchange.asterUser ? `${exchange.asterUser.slice(0, 6)}...${exchange.asterUser.slice(-4)}` : '')
- })
-
- )}
+ {exchange.type.toUpperCase()} •{' '}
+ {inUse
+ ? t('inUse', language)
+ : exchange.enabled
+ ? t('enabled', language)
+ : t('configured', language)}
@@ -878,9 +1071,9 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
{/* Status */}
-
- {/* Actions */}
-
+ {/*
*/}
{t('status', language)}
-
+
+ {/* Actions: 禁止换行，超出横向滚动 */}
+
)
}
@@ -1169,85 +1341,96 @@ function SignalSourceModal({
}
return (
-
+