docs: add prerequisites section and reorganize README structure across all languages

README.md

@@ -50,40 +50,12 @@ Join our Telegram developer community: **[NOFX Developer Community](https://t.me
 
 ---
 
-## Screenshots
+## Before You Begin
 
-### Config Page
-| AI Models & Exchanges | Traders List |
-|:---:|:---:|
-| <img src="screenshots/config-ai-exchanges.png" width="400" alt="Config - AI Models & Exchanges"/> | <img src="screenshots/config-traders-list.png" width="400" alt="Config - Traders List"/> |
+To use NOFX, you'll need:
 
-### Competition & Backtest
-| Competition Mode | Backtest Lab |
-|:---:|:---:|
-| <img src="screenshots/competition-page.png" width="400" alt="Competition Page"/> | <img src="screenshots/backtest-lab.png" width="400" alt="Backtest Lab"/> |
-
-### Dashboard
-| Overview | Market Chart |
-|:---:|:---:|
-| <img src="screenshots/dashboard-page.png" width="400" alt="Dashboard Overview"/> | <img src="screenshots/dashboard-market-chart.png" width="400" alt="Dashboard Market Chart"/> |
-
-| Trading Stats | Position History |
-|:---:|:---:|
-| <img src="screenshots/dashboard-trading-stats.png" width="400" alt="Trading Stats"/> | <img src="screenshots/dashboard-position-history.png" width="400" alt="Position History"/> |
-
-| Positions | Trader Details |
-|:---:|:---:|
-| <img src="screenshots/dashboard-positions.png" width="400" alt="Dashboard Positions"/> | <img src="screenshots/details-page.png" width="400" alt="Trader Details"/> |
-
-### Strategy Studio
-| Strategy Editor | Indicators Config |
-|:---:|:---:|
-| <img src="screenshots/strategy-studio.png" width="400" alt="Strategy Studio"/> | <img src="screenshots/strategy-indicators.png" width="400" alt="Strategy Indicators"/> |
-
-### Debate Arena
-| AI Debate Session | Create Debate |
-|:---:|:---:|
-| <img src="screenshots/debate-arena.png" width="400" alt="Debate Arena"/> | <img src="screenshots/debate-create.png" width="400" alt="Create Debate"/> |
+1. **Exchange Account** - Register on any supported exchange and create API credentials with trading permissions
+2. **AI Model API Key** - Get from any supported provider (DeepSeek recommended for cost-effectiveness)
 
 ---
 
@@ -122,6 +94,43 @@ Join our Telegram developer community: **[NOFX Developer Community](https://t.me
 
 ---
 
+## Screenshots
+
+### Config Page
+| AI Models & Exchanges | Traders List |
+|:---:|:---:|
+| <img src="screenshots/config-ai-exchanges.png" width="400" alt="Config - AI Models & Exchanges"/> | <img src="screenshots/config-traders-list.png" width="400" alt="Config - Traders List"/> |
+
+### Competition & Backtest
+| Competition Mode | Backtest Lab |
+|:---:|:---:|
+| <img src="screenshots/competition-page.png" width="400" alt="Competition Page"/> | <img src="screenshots/backtest-lab.png" width="400" alt="Backtest Lab"/> |
+
+### Dashboard
+| Overview | Market Chart |
+|:---:|:---:|
+| <img src="screenshots/dashboard-page.png" width="400" alt="Dashboard Overview"/> | <img src="screenshots/dashboard-market-chart.png" width="400" alt="Dashboard Market Chart"/> |
+
+| Trading Stats | Position History |
+|:---:|:---:|
+| <img src="screenshots/dashboard-trading-stats.png" width="400" alt="Trading Stats"/> | <img src="screenshots/dashboard-position-history.png" width="400" alt="Position History"/> |
+
+| Positions | Trader Details |
+|:---:|:---:|
+| <img src="screenshots/dashboard-positions.png" width="400" alt="Dashboard Positions"/> | <img src="screenshots/details-page.png" width="400" alt="Trader Details"/> |
+
+### Strategy Studio
+| Strategy Editor | Indicators Config |
+|:---:|:---:|
+| <img src="screenshots/strategy-studio.png" width="400" alt="Strategy Studio"/> | <img src="screenshots/strategy-indicators.png" width="400" alt="Strategy Indicators"/> |
+
+### Debate Arena
+| AI Debate Session | Create Debate |
+|:---:|:---:|
+| <img src="screenshots/debate-arena.png" width="400" alt="Debate Arena"/> | <img src="screenshots/debate-create.png" width="400" alt="Create Debate"/> |
+
+---
+
 ## Quick Start
 
 ### One-Click Install (Recommended)

docs/i18n/ja/README.md

@@ -30,6 +30,50 @@ Telegram 開発者コミュニティに参加: **[NOFX 開発者コミュニテ
 
 ---
 
+## 始める前に
+
+NOFXを使用するには以下が必要です:
+
+1. **取引所アカウント** - サポートされている取引所に登録し、取引権限付きのAPI認証情報を作成
+2. **AI モデル API キー** - サポートされているプロバイダーから取得（コスト効率の良いDeepSeekを推奨）
+
+---
+
+## サポート取引所
+
+### CEX (中央集権型取引所)
+
+| 取引所 | ステータス | 登録 (手数料割引) |
+|----------|--------|-------------------------|
+| **Binance** | ✅ サポート | [登録](https://www.binance.com/join?ref=NOFXENG) |
+| **Bybit** | ✅ サポート | [登録](https://partner.bybit.com/b/83856) |
+| **OKX** | ✅ サポート | [登録](https://www.okx.com/join/1865360) |
+| **Bitget** | ✅ サポート | [登録](https://www.bitget.com/referral/register?from=referral&clacCode=c8a43172) |
+
+### Perp-DEX (分散型永久先物取引所)
+
+| 取引所 | ステータス | 登録 (手数料割引) |
+|----------|--------|-------------------------|
+| **Hyperliquid** | ✅ サポート | [登録](https://app.hyperliquid.xyz/join/AITRADING) |
+| **Aster DEX** | ✅ サポート | [登録](https://www.asterdex.com/en/referral/fdfc0e) |
+| **Lighter** | ✅ サポート | [登録](https://app.lighter.xyz/?referral=68151432) |
+
+---
+
+## サポート AI モデル
+
+| AI モデル | ステータス | API キー取得 |
+|----------|--------|-------------|
+| **DeepSeek** | ✅ サポート | [API キー取得](https://platform.deepseek.com) |
+| **Qwen** | ✅ サポート | [API キー取得](https://dashscope.console.aliyun.com) |
+| **OpenAI (GPT)** | ✅ サポート | [API キー取得](https://platform.openai.com) |
+| **Claude** | ✅ サポート | [API キー取得](https://console.anthropic.com) |
+| **Gemini** | ✅ サポート | [API キー取得](https://aistudio.google.com) |
+| **Grok** | ✅ サポート | [API キー取得](https://console.x.ai) |
+| **Kimi** | ✅ サポート | [API キー取得](https://platform.moonshot.cn) |
+
+---
+
 ## クイックスタート
 
 ### オプション 1: Docker デプロイ（推奨）

docs/i18n/ko/README.md

@@ -30,6 +30,50 @@ Telegram 개발자 커뮤니티 참여: **[NOFX 개발자 커뮤니티](https://
 
 ---
 
+## 시작하기 전에
+
+NOFX를 사용하려면 다음이 필요합니다:
+
+1. **거래소 계정** - 지원되는 거래소에 등록하고 거래 권한이 있는 API 자격 증명 생성
+2. **AI 모델 API 키** - 지원되는 제공업체에서 획득 (비용 효율성을 위해 DeepSeek 권장)
+
+---
+
+## 지원 거래소
+
+### CEX (중앙화 거래소)
+
+| 거래소 | 상태 | 등록 (수수료 할인) |
+|----------|--------|-------------------------|
+| **Binance** | ✅ 지원 | [등록](https://www.binance.com/join?ref=NOFXENG) |
+| **Bybit** | ✅ 지원 | [등록](https://partner.bybit.com/b/83856) |
+| **OKX** | ✅ 지원 | [등록](https://www.okx.com/join/1865360) |
+| **Bitget** | ✅ 지원 | [등록](https://www.bitget.com/referral/register?from=referral&clacCode=c8a43172) |
+
+### Perp-DEX (탈중앙화 영구 선물 거래소)
+
+| 거래소 | 상태 | 등록 (수수료 할인) |
+|----------|--------|-------------------------|
+| **Hyperliquid** | ✅ 지원 | [등록](https://app.hyperliquid.xyz/join/AITRADING) |
+| **Aster DEX** | ✅ 지원 | [등록](https://www.asterdex.com/en/referral/fdfc0e) |
+| **Lighter** | ✅ 지원 | [등록](https://app.lighter.xyz/?referral=68151432) |
+
+---
+
+## 지원 AI 모델
+
+| AI 모델 | 상태 | API 키 받기 |
+|----------|--------|-------------|
+| **DeepSeek** | ✅ 지원 | [API 키 받기](https://platform.deepseek.com) |
+| **Qwen** | ✅ 지원 | [API 키 받기](https://dashscope.console.aliyun.com) |
+| **OpenAI (GPT)** | ✅ 지원 | [API 키 받기](https://platform.openai.com) |
+| **Claude** | ✅ 지원 | [API 키 받기](https://console.anthropic.com) |
+| **Gemini** | ✅ 지원 | [API 키 받기](https://aistudio.google.com) |
+| **Grok** | ✅ 지원 | [API 키 받기](https://console.x.ai) |
+| **Kimi** | ✅ 지원 | [API 키 받기](https://platform.moonshot.cn) |
+
+---
+
 ## 빠른 시작
 
 ### 옵션 1: Docker 배포 (권장)

docs/i18n/ru/README.md

@@ -30,6 +30,50 @@
 
 ---
 
+## Перед началом
+
+Для использования NOFX вам понадобится:
+
+1. **Аккаунт биржи** - Зарегистрируйтесь на поддерживаемой бирже и создайте API ключи с правами торговли
+2. **API ключ AI модели** - Получите от любого поддерживаемого провайдера (рекомендуется DeepSeek для экономии)
+
+---
+
+## Поддерживаемые биржи
+
+### CEX (Централизованные биржи)
+
+| Биржа | Статус | Регистрация (скидка) |
+|----------|--------|-------------------------|
+| **Binance** | ✅ Поддерживается | [Регистрация](https://www.binance.com/join?ref=NOFXENG) |
+| **Bybit** | ✅ Поддерживается | [Регистрация](https://partner.bybit.com/b/83856) |
+| **OKX** | ✅ Поддерживается | [Регистрация](https://www.okx.com/join/1865360) |
+| **Bitget** | ✅ Поддерживается | [Регистрация](https://www.bitget.com/referral/register?from=referral&clacCode=c8a43172) |
+
+### Perp-DEX (Децентрализованные биржи)
+
+| Биржа | Статус | Регистрация (скидка) |
+|----------|--------|-------------------------|
+| **Hyperliquid** | ✅ Поддерживается | [Регистрация](https://app.hyperliquid.xyz/join/AITRADING) |
+| **Aster DEX** | ✅ Поддерживается | [Регистрация](https://www.asterdex.com/en/referral/fdfc0e) |
+| **Lighter** | ✅ Поддерживается | [Регистрация](https://app.lighter.xyz/?referral=68151432) |
+
+---
+
+## Поддерживаемые AI модели
+
+| AI Модель | Статус | Получить API ключ |
+|----------|--------|-------------|
+| **DeepSeek** | ✅ Поддерживается | [Получить](https://platform.deepseek.com) |
+| **Qwen** | ✅ Поддерживается | [Получить](https://dashscope.console.aliyun.com) |
+| **OpenAI (GPT)** | ✅ Поддерживается | [Получить](https://platform.openai.com) |
+| **Claude** | ✅ Поддерживается | [Получить](https://console.anthropic.com) |
+| **Gemini** | ✅ Поддерживается | [Получить](https://aistudio.google.com) |
+| **Grok** | ✅ Поддерживается | [Получить](https://console.x.ai) |
+| **Kimi** | ✅ Поддерживается | [Получить](https://platform.moonshot.cn) |
+
+---
+
 ## Быстрый старт
 
 ### Вариант 1: Docker развёртывание (рекомендуется)

docs/i18n/uk/README.md

@@ -30,6 +30,50 @@
 
 ---
 
+## Перед початком
+
+Для використання NOFX вам знадобиться:
+
+1. **Акаунт біржі** - Зареєструйтесь на підтримуваній біржі та створіть API ключі з правами торгівлі
+2. **API ключ AI моделі** - Отримайте від будь-якого підтримуваного провайдера (рекомендується DeepSeek для економії)
+
+---
+
+## Підтримувані біржі
+
+### CEX (Централізовані біржі)
+
+| Біржа | Статус | Реєстрація (знижка) |
+|----------|--------|-------------------------|
+| **Binance** | ✅ Підтримується | [Реєстрація](https://www.binance.com/join?ref=NOFXENG) |
+| **Bybit** | ✅ Підтримується | [Реєстрація](https://partner.bybit.com/b/83856) |
+| **OKX** | ✅ Підтримується | [Реєстрація](https://www.okx.com/join/1865360) |
+| **Bitget** | ✅ Підтримується | [Реєстрація](https://www.bitget.com/referral/register?from=referral&clacCode=c8a43172) |
+
+### Perp-DEX (Децентралізовані біржі)
+
+| Біржа | Статус | Реєстрація (знижка) |
+|----------|--------|-------------------------|
+| **Hyperliquid** | ✅ Підтримується | [Реєстрація](https://app.hyperliquid.xyz/join/AITRADING) |
+| **Aster DEX** | ✅ Підтримується | [Реєстрація](https://www.asterdex.com/en/referral/fdfc0e) |
+| **Lighter** | ✅ Підтримується | [Реєстрація](https://app.lighter.xyz/?referral=68151432) |
+
+---
+
+## Підтримувані AI моделі
+
+| AI Модель | Статус | Отримати API ключ |
+|----------|--------|-------------|
+| **DeepSeek** | ✅ Підтримується | [Отримати](https://platform.deepseek.com) |
+| **Qwen** | ✅ Підтримується | [Отримати](https://dashscope.console.aliyun.com) |
+| **OpenAI (GPT)** | ✅ Підтримується | [Отримати](https://platform.openai.com) |
+| **Claude** | ✅ Підтримується | [Отримати](https://console.anthropic.com) |
+| **Gemini** | ✅ Підтримується | [Отримати](https://aistudio.google.com) |
+| **Grok** | ✅ Підтримується | [Отримати](https://console.x.ai) |
+| **Kimi** | ✅ Підтримується | [Отримати](https://platform.moonshot.cn) |
+
+---
+
 ## Швидкий старт
 
 ### Варіант 1: Docker розгортання (рекомендовано)

docs/i18n/vi/README.md

@@ -30,6 +30,50 @@ Tham gia cộng đồng Telegram: **[NOFX Developer Community](https://t.me/nofx
 
 ---
 
+## Trước Khi Bắt Đầu
+
+Để sử dụng NOFX, bạn cần:
+
+1. **Tài khoản sàn giao dịch** - Đăng ký trên sàn được hỗ trợ và tạo API key với quyền giao dịch
+2. **API Key mô hình AI** - Lấy từ nhà cung cấp được hỗ trợ (khuyến nghị DeepSeek để tiết kiệm chi phí)
+
+---
+
+## Sàn Giao Dịch Được Hỗ Trợ
+
+### CEX (Sàn Tập Trung)
+
+| Sàn | Trạng thái | Đăng ký (Giảm phí) |
+|----------|--------|-------------------------|
+| **Binance** | ✅ Hỗ trợ | [Đăng ký](https://www.binance.com/join?ref=NOFXENG) |
+| **Bybit** | ✅ Hỗ trợ | [Đăng ký](https://partner.bybit.com/b/83856) |
+| **OKX** | ✅ Hỗ trợ | [Đăng ký](https://www.okx.com/join/1865360) |
+| **Bitget** | ✅ Hỗ trợ | [Đăng ký](https://www.bitget.com/referral/register?from=referral&clacCode=c8a43172) |
+
+### Perp-DEX (Sàn Phi Tập Trung)
+
+| Sàn | Trạng thái | Đăng ký (Giảm phí) |
+|----------|--------|-------------------------|
+| **Hyperliquid** | ✅ Hỗ trợ | [Đăng ký](https://app.hyperliquid.xyz/join/AITRADING) |
+| **Aster DEX** | ✅ Hỗ trợ | [Đăng ký](https://www.asterdex.com/en/referral/fdfc0e) |
+| **Lighter** | ✅ Hỗ trợ | [Đăng ký](https://app.lighter.xyz/?referral=68151432) |
+
+---
+
+## Mô Hình AI Được Hỗ Trợ
+
+| Mô hình AI | Trạng thái | Lấy API Key |
+|----------|--------|-------------|
+| **DeepSeek** | ✅ Hỗ trợ | [Lấy API Key](https://platform.deepseek.com) |
+| **Qwen** | ✅ Hỗ trợ | [Lấy API Key](https://dashscope.console.aliyun.com) |
+| **OpenAI (GPT)** | ✅ Hỗ trợ | [Lấy API Key](https://platform.openai.com) |
+| **Claude** | ✅ Hỗ trợ | [Lấy API Key](https://console.anthropic.com) |
+| **Gemini** | ✅ Hỗ trợ | [Lấy API Key](https://aistudio.google.com) |
+| **Grok** | ✅ Hỗ trợ | [Lấy API Key](https://console.x.ai) |
+| **Kimi** | ✅ Hỗ trợ | [Lấy API Key](https://platform.moonshot.cn) |
+
+---
+
 ## Bắt Đầu Nhanh
 
 ### Tùy chọn 1: Triển khai Docker (Khuyến nghị)

docs/i18n/zh-CN/README.md

@@ -42,19 +42,12 @@
 
 ---
 
-## 截图
+## 开始之前
 
-### 竞赛模式 - 实时 AI 对战
-![竞赛页面](../../../screenshots/competition-page.png)
-*多 AI 排行榜，实时性能对比*
+使用 NOFX 你需要准备:
 
-### 仪表板 - 市场图表视图
-![仪表板市场图表](../../../screenshots/dashboard-market-chart.png)
-*专业交易仪表板，TradingView 风格图表*
-
-### 策略工作室
-![策略工作室](../../../screenshots/strategy-studio.png)
-*多数据源策略配置与 AI 测试*
+1. **交易所账户** - 在任意支持的交易所注册并创建具有交易权限的 API 凭证
+2. **AI 模型 API Key** - 从任意支持的提供商获取（推荐 DeepSeek，性价比最高）
 
 ---
 
@@ -67,6 +60,7 @@
 | **Binance** | ✅ 已支持 | [注册](https://www.binance.com/join?ref=NOFXENG) |
 | **Bybit** | ✅ 已支持 | [注册](https://partner.bybit.com/b/83856) |
 | **OKX** | ✅ 已支持 | [注册](https://www.okx.com/join/1865360) |
+| **Bitget** | ✅ 已支持 | [注册](https://www.bitget.com/referral/register?from=referral&clacCode=c8a43172) |
 
 ### Perp-DEX (去中心化永续交易所)
 
@@ -92,6 +86,22 @@
 
 ---
 
+## 截图
+
+### 竞赛模式 - 实时 AI 对战
+![竞赛页面](../../../screenshots/competition-page.png)
+*多 AI 排行榜，实时性能对比*
+
+### 仪表板 - 市场图表视图
+![仪表板市场图表](../../../screenshots/dashboard-market-chart.png)
+*专业交易仪表板，TradingView 风格图表*
+
+### 策略工作室
+![策略工作室](../../../screenshots/strategy-studio.png)
+*多数据源策略配置与 AI 测试*
+
+---
+
 ## 快速开始
 
 ### 一键安装 (推荐)

kernel/schema.go

@@ -1,7 +1,5 @@
 package kernel
 
-import "fmt"
-
 // ============================================================================
 // Trading Data Schema - 交易数据字典
 // ============================================================================
@@ -481,18 +479,6 @@ func getSchemaPromptZH() string {
 		prompt += formatFieldDefZH(key, field)
 	}
 
-	// 交易规则
-	prompt += "\n## ⚖️ 交易规则\n\n"
-	prompt += "### 风险管理\n"
-	for name, rule := range TradingRules.RiskManagement {
-		prompt += "- **" + name + "**: " + rule.DescZH + "\n  理由：" + rule.ReasonZH + "\n"
-	}
-
-	prompt += "\n### 出场信号\n"
-	for name, rule := range TradingRules.ExitSignals {
-		prompt += "- **" + name + "**: " + rule.DescZH + "\n  理由：" + rule.ReasonZH + "\n"
-	}
-
 	// OI解读
 	prompt += "\n## 💹 持仓量(OI)变化解读\n\n"
 	prompt += "- **OI增加 + 价格上涨**: " + OIInterpretation.OIUp_PriceUp.ZH + "\n"
@@ -500,14 +486,6 @@ func getSchemaPromptZH() string {
 	prompt += "- **OI减少 + 价格上涨**: " + OIInterpretation.OIDown_PriceUp.ZH + "\n"
 	prompt += "- **OI减少 + 价格下跌**: " + OIInterpretation.OIDown_PriceDown.ZH + "\n"
 
-	// 常见错误
-	prompt += "\n## ⚠️ 常见错误（请避免）\n\n"
-	for i, mistake := range CommonMistakes {
-		prompt += fmt.Sprintf("**错误%d**: %s\n", i+1, mistake.ErrorZH)
-		prompt += "- 错误示例：" + mistake.ExampleZH + "\n"
-		prompt += "- 正确做法：" + mistake.CorrectZH + "\n\n"
-	}
-
 	return prompt
 }
 
@@ -540,18 +518,6 @@ func getSchemaPromptEN() string {
 		prompt += formatFieldDefEN(key, field)
 	}
 
-	// Trading Rules
-	prompt += "\n## ⚖️ Trading Rules\n\n"
-	prompt += "### Risk Management\n"
-	for name, rule := range TradingRules.RiskManagement {
-		prompt += "- **" + name + "**: " + rule.DescEN + "\n  Reason: " + rule.ReasonEN + "\n"
-	}
-
-	prompt += "\n### Exit Signals\n"
-	for name, rule := range TradingRules.ExitSignals {
-		prompt += "- **" + name + "**: " + rule.DescEN + "\n  Reason: " + rule.ReasonEN + "\n"
-	}
-
 	// OI Interpretation
 	prompt += "\n## 💹 Open Interest (OI) Change Interpretation\n\n"
 	prompt += "- **OI Up + Price Up**: " + OIInterpretation.OIUp_PriceUp.EN + "\n"
@@ -559,14 +525,6 @@ func getSchemaPromptEN() string {
 	prompt += "- **OI Down + Price Up**: " + OIInterpretation.OIDown_PriceUp.EN + "\n"
 	prompt += "- **OI Down + Price Down**: " + OIInterpretation.OIDown_PriceDown.EN + "\n"
 
-	// Common Mistakes
-	prompt += "\n## ⚠️ Common Mistakes to Avoid\n\n"
-	for i, mistake := range CommonMistakes {
-		prompt += fmt.Sprintf("**Mistake %d**: %s\n", i+1, mistake.ErrorEN)
-		prompt += "- Bad Example: " + mistake.ExampleEN + "\n"
-		prompt += "- Correct Approach: " + mistake.CorrectEN + "\n\n"
-	}
-
 	return prompt
 }
 

kernel/schema_test.go

@@ -147,10 +147,7 @@ func TestGetSchemaPrompt(t *testing.T) {
 			"交易指标",
 			"持仓指标",
 			"市场数据",
-			"交易规则",
-			"风险管理",
 			"持仓量(OI)变化解读",
-			"常见错误",
 		}
 
 		for _, keyword := range mustContain {
@@ -174,10 +171,7 @@ func TestGetSchemaPrompt(t *testing.T) {
 			"Trade Metrics",
 			"Position Metrics",
 			"Market Data",
-			"Trading Rules",
-			"Risk Management",
 			"Open Interest",
-			"Common Mistakes",
 		}
 
 		for _, keyword := range mustContain {