Merge pull request #500 from CoderMageFox/feature/aster-field-help-tooltips

feat: add help tooltips for Aster exchange configuration fields
2026-07-02 10:31:04 +08:00 · 2025-11-05 15:04:27 +08:00
parent 5d247d38fe ba31078d92
commit 552b54d8a3
4 changed files with 185 additions and 10 deletions
--- a/trader/aster_trader.go
+++ b/trader/aster_trader.go
@@ -438,13 +438,23 @@ func (t *AsterTrader) GetBalance() (map[string]interface{}, error) {
 		return nil, err
 	}

+	// 🔍 调试：打印原始API响应
+	log.Printf("🔍 Aster API原始响应: %s", string(body))
+
 	// 查找USDT余额
 	totalBalance := 0.0
 	availableBalance := 0.0
 	crossUnPnl := 0.0

 	for _, bal := range balances {
+		// 🔍 调试：打印每条余额记录
+		log.Printf("🔍 余额记录: %+v", bal)
+
 		if asset, ok := bal["asset"].(string); ok && asset == "USDT" {
+			// 🔍 调试：打印USDT余额详情
+			log.Printf("🔍 USDT余额详情: balance=%v, availableBalance=%v, crossUnPnl=%v",
+				bal["balance"], bal["availableBalance"], bal["crossUnPnl"])
+
 			if wb, ok := bal["balance"].(string); ok {
 				totalBalance, _ = strconv.ParseFloat(wb, 64)
 			}
@@ -458,11 +468,25 @@ func (t *AsterTrader) GetBalance() (map[string]interface{}, error) {
 		}
 	}

+	// ✅ Aster API完全兼容Binance API格式
+	// balance字段 = wallet balance（不包含未实现盈亏）
+	// crossUnPnl = unrealized profit（未实现盈亏）
+	// crossWalletBalance = balance + crossUnPnl（全仓钱包余额，包含盈亏）
+	//
+	// 参考Binance官方文档：
+	// - Account Information V2: marginBalance = walletBalance + unrealizedProfit
+	// - Balance V3: crossWalletBalance = balance + crossUnPnl
+
+	log.Printf("✓ Aster API返回: 钱包余额=%.2f, 未实现盈亏=%.2f, 可用余额=%.2f",
+		totalBalance,
+		crossUnPnl,
+		availableBalance)
+
 	// 返回与Binance相同的字段名，确保AutoTrader能正确解析
 	return map[string]interface{}{
-		"totalWalletBalance":    totalBalance,
+		"totalWalletBalance":    totalBalance,    // 钱包余额（不含未实现盈亏）
 		"availableBalance":      availableBalance,
-		"totalUnrealizedProfit": crossUnPnl,
+		"totalUnrealizedProfit": crossUnPnl,      // 未实现盈亏
 	}, nil
 }

--- a/web/src/components/AITradersPage.tsx
+++ b/web/src/components/AITradersPage.tsx
@@ -23,6 +23,7 @@ import {
  Users,
  AlertTriangle,
  BookOpen,
+  HelpCircle,
 } from 'lucide-react'

 // 获取友好的AI模型名称
@@ -1064,6 +1065,51 @@ export function AITradersPage({ onTraderSelect }: AITradersPageProps) {
  )
 }

+// Tooltip Helper Component
+function Tooltip({
+  content,
+  children,
+}: {
+  content: string
+  children: React.ReactNode
+}) {
+  const [show, setShow] = useState(false)
+
+  return (
+    <div className="relative inline-block">
+      <div
+        onMouseEnter={() => setShow(true)}
+        onMouseLeave={() => setShow(false)}
+        onClick={() => setShow(!show)}
+      >
+        {children}
+      </div>
+      {show && (
+        <div
+          className="absolute z-10 px-3 py-2 text-sm rounded-lg shadow-lg w-64 left-1/2 transform -translate-x-1/2 bottom-full mb-2"
+          style={{
+            background: '#2B3139',
+            color: '#EAECEF',
+            border: '1px solid #474D57',
+          }}
+        >
+          {content}
+          <div
+            className="absolute left-1/2 transform -translate-x-1/2 top-full"
+            style={{
+              width: 0,
+              height: 0,
+              borderLeft: '6px solid transparent',
+              borderRight: '6px solid transparent',
+              borderTop: '6px solid #2B3139',
+            }}
+          />
+        </div>
+      )}
+    </div>
+  )
+}
+
 // Signal Source Configuration Modal Component
 function SignalSourceModal({
  coinPoolUrl,
@@ -1772,10 +1818,16 @@ function ExchangeConfigModal({
                <>
                  <div>
                    <label
-                      className="block text-sm font-semibold mb-2"
+                      className="block text-sm font-semibold mb-2 flex items-center gap-2"
                      style={{ color: '#EAECEF' }}
                    >
                      {t('user', language)}
+                      <Tooltip content={t('asterUserDesc', language)}>
+                        <HelpCircle
+                          className="w-4 h-4 cursor-help"
+                          style={{ color: '#F0B90B' }}
+                        />
+                      </Tooltip>
                    </label>
                    <input
                      type="text"
@@ -1794,10 +1846,16 @@ function ExchangeConfigModal({

                  <div>
                    <label
-                      className="block text-sm font-semibold mb-2"
+                      className="block text-sm font-semibold mb-2 flex items-center gap-2"
                      style={{ color: '#EAECEF' }}
                    >
                      {t('signer', language)}
+                      <Tooltip content={t('asterSignerDesc', language)}>
+                        <HelpCircle
+                          className="w-4 h-4 cursor-help"
+                          style={{ color: '#F0B90B' }}
+                        />
+                      </Tooltip>
                    </label>
                    <input
                      type="text"
@@ -1816,10 +1874,16 @@ function ExchangeConfigModal({

                  <div>
                    <label
-                      className="block text-sm font-semibold mb-2"
+                      className="block text-sm font-semibold mb-2 flex items-center gap-2"
                      style={{ color: '#EAECEF' }}
                    >
                      {t('privateKey', language)}
+                      <Tooltip content={t('asterPrivateKeyDesc', language)}>
+                        <HelpCircle
+                          className="w-4 h-4 cursor-help"
+                          style={{ color: '#F0B90B' }}
+                        />
+                      </Tooltip>
                    </label>
                    <input
                      type="password"
@@ -1873,6 +1937,9 @@ function ExchangeConfigModal({
                  </span>
                </div>
                <div className="text-xs space-y-1" style={{ color: '#848E9C' }}>
+                  {selectedExchange.id === 'aster' && (
+                    <div>{t('asterUsdtWarning', language)}</div>
+                  )}
                  <div>{t('exchangeConfigWarning1', language)}</div>
                  <div>{t('exchangeConfigWarning2', language)}</div>
                  <div>{t('exchangeConfigWarning3', language)}</div>
--- a/web/src/components/TraderConfigModal.tsx
+++ b/web/src/components/TraderConfigModal.tsx
@@ -68,6 +68,8 @@ export function TraderConfigModal({
  const [selectedCoins, setSelectedCoins] = useState<string[]>([])
  const [showCoinSelector, setShowCoinSelector] = useState(false)
  const [promptTemplates, setPromptTemplates] = useState<{ name: string }[]>([])
+  const [isFetchingBalance, setIsFetchingBalance] = useState(false)
+  const [balanceFetchError, setBalanceFetchError] = useState<string>('')

  useEffect(() => {
    if (traderData) {
@@ -182,6 +184,45 @@ export function TraderConfigModal({
    })
  }

+  const handleFetchCurrentBalance = async () => {
+    if (!isEditMode || !traderData?.trader_id) {
+      setBalanceFetchError('只有在编辑模式下才能获取当前余额');
+      return;
+    }
+
+    setIsFetchingBalance(true);
+    setBalanceFetchError('');
+
+    try {
+      const token = localStorage.getItem('token');
+      const response = await fetch(`/api/account?trader_id=${traderData.trader_id}`, {
+        headers: {
+          'Authorization': `Bearer ${token}`
+        }
+      });
+
+      if (!response.ok) {
+        throw new Error('获取账户余额失败');
+      }
+
+      const data = await response.json();
+
+      // total_equity = 当前账户净值（包含未实现盈亏）
+      // 这应该作为新的初始余额
+      const currentBalance = data.total_equity || data.balance || 0;
+
+      setFormData(prev => ({ ...prev, initial_balance: currentBalance }));
+
+      // 显示成功提示
+      console.log('已获取当前余额:', currentBalance);
+    } catch (error) {
+      console.error('获取余额失败:', error);
+      setBalanceFetchError('获取余额失败，请检查网络连接');
+    } finally {
+      setIsFetchingBalance(false);
+    }
+  };
+
  const handleSave = async () => {
    if (!onSave) return

@@ -346,9 +387,22 @@ export function TraderConfigModal({
                  </div>
                </div>
                <div>
-                  <label className="text-sm text-[#EAECEF] block mb-2">
-                    初始余额 ($)
-                  </label>
+                  <div className="flex items-center justify-between mb-2">
+                    <label className="text-sm text-[#EAECEF]">
+                      初始余额 ($)
+                      {!isEditMode && <span className="text-[#F0B90B] ml-1">*</span>}
+                    </label>
+                    {isEditMode && (
+                      <button
+                        type="button"
+                        onClick={handleFetchCurrentBalance}
+                        disabled={isFetchingBalance}
+                        className="px-3 py-1 text-xs bg-[#F0B90B] text-black rounded hover:bg-[#E1A706] transition-colors disabled:bg-[#848E9C] disabled:cursor-not-allowed"
+                      >
+                        {isFetchingBalance ? '获取中...' : '获取当前余额'}
+                      </button>
+                    )}
+                  </div>
                  <input
                    type="number"
                    value={formData.initial_balance}
@@ -360,8 +414,22 @@ export function TraderConfigModal({
                    }
                    className="w-full px-3 py-2 bg-[#0B0E11] border border-[#2B3139] rounded text-[#EAECEF] focus:border-[#F0B90B] focus:outline-none"
                    min="100"
-                    step="100"
+                    step="0.01"
                  />
+                  {!isEditMode && (
+                    <p className="text-xs text-[#F0B90B] mt-1 flex items-center gap-1">
+                      <svg xmlns="http://www.w3.org/2000/svg" className="w-3.5 h-3.5" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0Z"/><line x1="12" x2="12" y1="9" y2="13"/><line x1="12" x2="12.01" y1="17" y2="17"/></svg>
+                      请输入您交易所账户的当前实际余额。如果输入不准确，P&L统计将会错误。
+                    </p>
+                  )}
+                  {isEditMode && (
+                    <p className="text-xs text-[#848E9C] mt-1">
+                      点击"获取当前余额"按钮可自动获取您交易所账户的当前净值
+                    </p>
+                  )}
+                  {balanceFetchError && (
+                    <p className="text-xs text-red-500 mt-1">{balanceFetchError}</p>
+                  )}
                </div>
              </div>

--- a/web/src/i18n/translations.ts
+++ b/web/src/i18n/translations.ts
@@ -197,6 +197,14 @@ export const translations = {
      'Hyperliquid uses private key for trading authentication',
    hyperliquidWalletAddressDesc:
      'Wallet address corresponding to the private key',
+    asterUserDesc:
+      'Main wallet address - The EVM wallet address you use to log in to Aster',
+    asterSignerDesc:
+      'API wallet address - Generate from https://www.asterdex.com/en/api-wallet',
+    asterPrivateKeyDesc:
+      'API wallet private key - Get from https://www.asterdex.com/en/api-wallet (only used locally for signing, never transmitted)',
+    asterUsdtWarning:
+      'Important: Aster only tracks USDT balance. Please ensure you use USDT as margin currency to avoid P&L calculation errors caused by price fluctuations of other assets (BNB, ETH, etc.)',
    testnetDescription:
      'Enable to connect to exchange test environment for simulated trading',
    securityWarning: 'Security Warning',
@@ -658,7 +666,15 @@ export const translations = {
    enterPassphrase: '输入Passphrase (OKX必填)',
    hyperliquidPrivateKeyDesc: 'Hyperliquid 使用私钥进行交易认证',
    hyperliquidWalletAddressDesc: '与私钥对应的钱包地址',
-    testnetDescription: '启用后将连接到交易所测试环境，用于模拟交易',
+    asterUserDesc:
+      '主钱包地址 - 您用于登录 Aster 的 EVM 钱包地址',
+    asterSignerDesc:
+      'API 钱包地址 - 从 https://www.asterdex.com/zh-CN/api-wallet 生成',
+    asterPrivateKeyDesc:
+      'API 钱包私钥 - 从 https://www.asterdex.com/zh-CN/api-wallet 获取（仅在本地用于签名，不会被传输）',
+    asterUsdtWarning:
+      '重要提示：Aster 仅统计 USDT 余额。请确保您使用 USDT 作为保证金币种，避免其他资产（BNB、ETH等）的价格波动导致盈亏统计错误',
+    testnetDescription: '启用后将连接到交易所测试环境,用于模拟交易',
    securityWarning: '安全提示',
    saveConfiguration: '保存配置',