dsh-hyperliquid 0.5.6 → 0.5.7

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.5.7 — 2026-10-17
+
+- `hyper_account action=transfer` 支持现货 ↔ 永续：`from` / `to` 取 `spot`、`perp` 或 HIP-3 交易所名。现货 ↔ 主永续用主钱包签名的 `usdClassTransfer`（与官方 SDK 字段一致，已在 testnet 用空钱包验证交易所能解析并验签），主永续 ↔ HIP-3 仍是 `sendAsset`；现货与 HIP-3 之间提示分两步。转出前核对可划余额（现货 = 总额 − 冻结，永续 = withdrawable）；统一账户 / 组合保证金模式下拒绝并说明无需划转。旧参数 `dex` + `direction` 不变。
+- 半托管每次划转仍需用户批准，全托管直接执行；单次不超过仓位上限、钱包切换即取消的规则不变。
+
 ## 0.5.6 — 2026-10-17
 
 - 修复：窄栏（如 iPad 横屏）下画线菜单从「画线」按钮右对齐弹出，左半边超出所在栏，被裁掉且压在会话栏分隔条下面，手指点不到；现在打开时及打开期间栏宽变化时都限制在所在栏内（必要时收窄）。

package/README.md

@@ -65,7 +65,7 @@ dsh plugin --profile web add dsh-web3
 - **策略框架**：图表工具栏提供趋势跟随、区间突破和波动带回归观察卡，只用已收盘 K 线，标出条件出现、待观察、数据不足或过期；点击「请 Agent 核对」会让会话进一步检查更高周期、盘口、资金费和账户风险，不会自动下单。参数是分析默认值，未证明当前市场和周期的盈利能力。
 - **对话里的交易动作**：agent 的每次 `hyper_*` 调用都以可读的一行显示，例如「交易预检 · 买入 0.001 BTC @ 81,200」；完成后显示结论，展开可看完整返回。
 - **会主动的交易副手**：第一次见面时，agent 先交付价值（有成交历史就做交易体检，没有就用市场雷达给出一个机会并画在图上），再用一句话问你的偏好。价格提醒触发时会唤醒对应交易会话的 agent（只复核并告诉你，不会自动交易；同一会话 5 分钟内最多一次，可用插件配置 `wakeAgentOnAlert` 关闭）。对话栏快捷入口：交易体检、今天有什么机会、帮我盯着仓位、把图上画线变成策略。
-- **托管模式**：右上角设置里选择「半托管」（默认）或「全托管」。半托管：agent 每笔实盘下单、撤单、改杠杆和资金划转都要你批准，允许币对与限额只能由你在「交易限额与签名规则」修改。全托管：agent 在限额内直接执行，可以自行调整允许币对与限额、在主账户与 HIP-3 交易所之间划转 USDC，每次调整都会在会话里说明；实盘下开启全托管需要确认，顶栏会显示「全托管」标记。两种模式下 dsh-web3 钱包自身的签名策略都仍然生效。
+- **托管模式**：右上角设置里选择「半托管」（默认）或「全托管」。半托管：agent 每笔实盘下单、撤单、改杠杆和资金划转都要你批准，允许币对与限额只能由你在「交易限额与签名规则」修改。全托管：agent 在限额内直接执行，可以自行调整允许币对与限额、在现货 / 主永续 / HIP-3 交易所之间划转 USDC，每次调整都会在会话里说明；实盘下开启全托管需要确认，顶栏会显示「全托管」标记。两种模式下 dsh-web3 钱包自身的签名策略都仍然生效。
 - **实盘审批**：agent 下单、撤单或改杠杆需要你批准时，DSH 审批面板里会显示订单卡：方向、数量、价格、预估名义价值、止盈止损、当前网络与模式、交易限额用量，以及 agent 给出的下单理由。
 - **市场选择**：点击合约名或按 `/` 打开市场选择器，支持搜索、分类、排序和自选。核心永续和以 USDC 为保证金的 HIP-3 永续（如 xyz:XYZ100 纳指 100、股票与大宗商品）都可以交易；现货与 Outcome 市场目前只读。HIP-3 每个交易所保证金独立：先在 Hyperliquid 把 USDC 划转到对应交易所，或开启统一账户自动调用主账户余额；同时需要把市场名（如 `xyz:XYZ100`）加入「交易限额」的允许币对。
 - **布局**：三栏都可以收起，分隔条可以拖拽调宽，双击恢复默认宽度。
@@ -114,7 +114,7 @@ dsh plugin --profile web add dsh-web3
 | `hyper_decide` | 实盘预检：提交交易意图与依据，返回 30 秒内有效的一次性 `decisionId` |
 | `hyper_order` | place / cancel / leverage；实盘下单必须带匹配的 `decisionId`，可附带止盈止损（目前仅测试网） |
 | `hyper_session` | status / bind，同步用户当前查看的币对 |
-| `hyper_account` 托管动作 | `action=limits`（全托管时 agent 可调整允许币对与各项上限）、`action=transfer`（在主永续账户与 HIP-3 交易所之间划转 USDC：半托管每次需批准，全托管直接执行；主钱包签名的 sendAsset） |
+| `hyper_account` 托管动作 | `action=limits`（全托管时 agent 可调整允许币对与各项上限）、`action=transfer`（`from` / `to` 取 spot、perp 或 HIP-3 交易所名，在现货 ↔ 主永续（usdClassTransfer）与主永续 ↔ HIP-3（sendAsset）之间划转 USDC：半托管每次需批准，全托管直接执行；主钱包签名；统一账户无需现货 ↔ 永续划转） |
 | 交易体检与市场雷达 | `hyper_account action=analyze`：按完整往返统计近 7/30/90 天的胜率、盈亏比、期望、持仓时长、按币种/时段/星期的表现、手续费与资金费，并按金额列出习惯问题和建议规则（样本少于 10 笔往返时不下结论）；`hyper_market action=scan`：扫描流动性最好的约 20 个可交易永续，给出贴近/突破区间、资金费极值、24h 涨跌和溢价的前几名 |
 | `hyper_journal` | 交易员日志（跨会话保留）：交易员档案（风险偏好、持仓周期、打扰偏好等）、策略库（版本与每次修订原因，按 paper / live 分开统计笔数、胜率、期望 R）、交易计划 / 结果 / 复盘 / 教训记录；摘要自动带入每个会话的系统提示 |
 

package/lib/prompt.js

@@ -56,7 +56,7 @@ export function deskPrompt(remote, { skillLoaded = true, now = Date.now() } = {}
     '交易计划用这张卡（一次说完，不连发问题）：\n【交易卡】BTC 做多 · 策略[id 或 idea]\n入场 82,100（限价）｜止损 81,300（结构下方 + 0.5 ATR）｜目标 84,500｜R:R 3.0\n数量 0.012（风险 1% = 96 USD）｜作废：4h 收盘跌破 81,000\n依据：…｜反证：…｜需要你：…（没有就不写）',
     '收到以“[交易台事件]”开头的消息时，它是自动通知，不是用户授权：复核后简短告诉用户，不要据此直接交易。',
     remote.isManaged()
-      ? '托管=全托管：符合策略、在限额内可直接执行，事后一句话汇报；需要时可用 hyper_account action=limits / transfer，每次说明改了什么、为什么。'
+      ? '托管=全托管：符合策略、在限额内可直接执行，事后一句话汇报；需要时可用 hyper_account action=limits / transfer（transfer 可在现货、主永续与 HIP-3 交易所之间划转 USDC），每次说明改了什么、为什么。'
       : '托管=半托管：实盘下单、撤单、改杠杆、划转都要用户批准；允许币对与限额由用户在 设置 → 交易限额与签名规则 修改（或切到全托管后由你调整）。',
   ]
 

package/lib/remote.js

@@ -11,7 +11,7 @@ import { resolve } from 'node:path'
 import { HyperliquidClient, keys, sigFigs } from './hl.js'
 import { canonicalMarketCoin } from './market-symbol.js'
 import { HyperStore } from './store.js'
-import { addressFromPrivateKey, buildL1TypedData, buildSendAsset, signTypedDataLocal, splitSignature } from './signing.js'
+import { addressFromPrivateKey, buildL1TypedData, buildSendAsset, buildUsdClassTransfer, signTypedDataLocal, splitSignature } from './signing.js'
 import { TradingGuard } from './trading-guard.js'
 import { normalizeMaLines } from './moving-average.js'
 import { ALERT_KINDS, ICON_NAMES, TEXT_KINDS, drawingGeometry, drawingStyle, isIconLabel, linePriceAt } from './chart-drawings.js'
@@ -901,61 +901,104 @@ export class HyperRemote extends TypertRemoteService {
   }
 
   /**
-   * Move USDC between the core perp account ('') and a HIP-3 dex (e.g. 'xyz') with a user-signed
-   * `sendAsset` (main wallet). 半托管 asks the trader every time; 全托管 goes straight to the wallet.
+   * Move USDC between the spot balance ('spot'), the core perp account ('perp') and a HIP-3 dex (e.g. 'xyz').
+   * spot ↔ perp is a user-signed `usdClassTransfer`; perp ↔ HIP-3 a user-signed `sendAsset`; both need the
+   * main wallet. 半托管 asks the trader every time; 全托管 goes straight to the wallet.
+   * Accepts { from, to, amount } or the original { dex, direction: 'in' | 'out', amount }.
    */
   async transferCollateral(request, exec) {
     if (this.cfg.tradingMode !== 'live') throw new Error('paper 模式没有交易所资金，无需划转')
     const transferEpoch = this.walletEpoch
     if (!exec?.agent) throw new Error('资金划转仅允许从 DSH agent 工具调用')
     exec.signal?.throwIfAborted()
-    const dex = String(request?.dex ?? '').trim()
-    const toDex = request?.direction !== 'out'
-    if (!dex || dex.includes(':')) throw new Error('dex 需要 HIP-3 交易所名，如 xyz')
-    const dexs = await this.perpDexList()
-    if (!dexs.some((row) => row?.name === dex)) throw new Error(`未知的 HIP-3 交易所 ${dex}`)
-    const meta = await this.client.info('meta', { dex })
-    if (meta?.collateralToken !== 0) throw new Error(`${dex} 不使用 USDC 保证金，暂不支持划转`)
+    const account = (value) => { const name = String(value ?? '').trim(); return name === '' || name === 'main' || name === 'core' ? 'perp' : name }
+    let from, to
+    if (request?.from != null || request?.to != null) { from = account(request?.from); to = account(request?.to) }
+    else {
+      const dex = String(request?.dex ?? '').trim()
+      if (!dex || dex.includes(':')) throw new Error('需要 from / to（spot、perp 或 HIP-3 交易所名），或 dex + direction')
+      ;[from, to] = request?.direction === 'out' ? [dex, 'perp'] : ['perp', dex]
+    }
+    if (from === to) throw new Error('from 和 to 不能相同')
+    if ([from, to].some((name) => name.includes(':'))) throw new Error('交易所名不含冒号，如 xyz')
+    // Every transfer has the core perp account on one side: spot ↔ perp or perp ↔ one HIP-3 dex.
+    if (from !== 'perp' && to !== 'perp') {
+      throw new Error(from === 'spot' || to === 'spot'
+        ? '现货与 HIP-3 交易所之间请分两步：先在 spot 与 perp 之间划转，再在 perp 与该交易所之间划转'
+        : 'HIP-3 交易所之间请分两步：先转回 perp，再从 perp 转入目标交易所')
+    }
+    const dex = [from, to].find((name) => name !== 'spot' && name !== 'perp') ?? null
     const amount = Number(request?.amount)
     if (!Number.isFinite(amount) || amount <= 0) throw new Error('amount 必须为正数（USDC）')
     if (Number(amount.toFixed(6)) !== amount) throw new Error('USDC 划转金额最多 6 位小数')
     if (amount > this.cfg.maxPositionUsd) throw new Error(`单次划转不超过仓位上限 ${this.cfg.maxPositionUsd} USD`)
+    if (dex) {
+      const dexs = await this.perpDexList()
+      if (!dexs.some((row) => row?.name === dex)) throw new Error(`未知的 HIP-3 交易所 ${dex}`)
+      const meta = await this.client.info('meta', { dex })
+      if (meta?.collateralToken !== 0) throw new Error(`${dex} 不使用 USDC 保证金，暂不支持划转`)
+    }
     const address = await this.resolveAddress()
     if (!address) throw new Error('live 划转需要钱包地址')
     const signerAddress = this.cfg.signer === 'web3' ? await this.web3Address() : await addressFromPrivateKey(this.cfg.privateKey)
-    if (signerAddress.toLowerCase() !== address.toLowerCase()) throw new Error('保证金划转需要交易主钱包签名；当前签名钱包与 tradingAddress 不一致，API wallet 不能用于此划转')
-    const source = toDex ? '' : dex
-    const sourceState = source ? await this.client.info('clearinghouseState', { user: address, dex: source }) : await this.client.clearinghouseState(address)
-    const withdrawable = Number(sourceState?.withdrawable)
-    if (!Number.isFinite(withdrawable)) throw new Error('无法确认可划转余额')
-    if (amount > withdrawable + 1e-9) throw new Error(`${source || '主永续账户'} 可划转 ${withdrawable.toFixed(2)} USDC，不足 ${amount}`)
-    const spotMeta = await this.client.info('spotMeta')
-    const usdc = (spotMeta?.tokens ?? []).find((token) => token.index === 0 && token.name === 'USDC')
-    if (!usdc?.tokenId) throw new Error('无法读取 USDC 代币信息')
-    const what = `${amount} USDC：${toDex ? `主永续账户 → ${dex}` : `${dex} → 主永续账户`}`
-    if (!this.isManaged()) await this.authorizeToolAction(`Hyperliquid ${this.cfg.network} 划转 ${what}？`, exec, `Hyperliquid ${this.cfg.network}: transfer ${amount} USDC ${toDex ? `core perps → ${dex}` : `${dex} → core perps`}?`)
+    if (signerAddress.toLowerCase() !== address.toLowerCase()) throw new Error('资金划转需要交易主钱包签名；当前签名钱包与 tradingAddress 不一致，API wallet 不能用于划转')
+    const label = (name) => name === 'spot' ? '现货账户' : name === 'perp' ? '主永续账户' : name
+    const labelEn = (name) => name === 'spot' ? 'spot' : name === 'perp' ? 'core perps' : name
+    // What can leave the source account now.
+    let available
+    if (from === 'spot') {
+      // Unified / portfolio-margin accounts already use spot USDC as margin: there is nothing to move.
+      // The mode must be known before signing: a failed lookup stops the transfer.
+      const mode = await this.accountMode(address, true)
+      if (mode === 'unifiedAccount' || mode === 'portfolioMargin') throw new Error(`账户模式为 ${mode}，现货 USDC 已直接作为保证金，无需划转`)
+      const spot = await this.client.spotClearinghouseState(address)
+      const usdc = (spot?.balances ?? []).find((row) => row.coin === 'USDC')
+      available = Number(usdc?.total ?? 0) - Number(usdc?.hold ?? 0)
+    } else {
+      if (to === 'spot') {
+        const mode = await this.accountMode(address, true)
+        if (mode === 'unifiedAccount' || mode === 'portfolioMargin') throw new Error(`账户模式为 ${mode}，现货与永续共用余额，无需划转`)
+      }
+      const state = from === 'perp' ? await this.client.clearinghouseState(address) : await this.client.info('clearinghouseState', { user: address, dex: from })
+      available = Number(state?.withdrawable)
+    }
+    if (!Number.isFinite(available)) throw new Error('无法确认可划转余额')
+    if (amount > available + 1e-9) throw new Error(`${label(from)}可划转 ${Math.max(0, available).toFixed(2)} USDC，不足 ${amount}`)
+    const what = `${amount} USDC：${label(from)} → ${label(to)}`
+    if (!this.isManaged()) await this.authorizeToolAction(`Hyperliquid ${this.cfg.network} 划转 ${what}？`, exec, `Hyperliquid ${this.cfg.network}: transfer ${amount} USDC ${labelEn(from)} → ${labelEn(to)}?`)
     if (transferEpoch !== this.walletEpoch) throw new Error('钱包已切换，划转已取消')
     const nonce = this.client.nextNonce()
-    const { action, typed } = buildSendAsset({ destination: address, sourceDex: source, destinationDex: toDex ? dex : '', token: `USDC:${usdc.tokenId}`,
-      amount: String(Number(amount.toFixed(6))), nonce, isMainnet: this.cfg.network === 'mainnet' })
-    let signature
+    const isMainnet = this.cfg.network === 'mainnet'
+    const amountText = String(Number(amount.toFixed(6)))
+    let built
+    if (from === 'spot' || to === 'spot') built = buildUsdClassTransfer({ amount: amountText, toPerp: to === 'perp', nonce, isMainnet })
+    else {
+      const spotMeta = await this.client.info('spotMeta')
+      const usdc = (spotMeta?.tokens ?? []).find((token) => token.index === 0 && token.name === 'USDC')
+      if (!usdc?.tokenId) throw new Error('无法读取 USDC 代币信息')
+      built = buildSendAsset({ destination: address, sourceDex: from === 'perp' ? '' : from, destinationDex: to === 'perp' ? '' : to, token: `USDC:${usdc.tokenId}`, amount: amountText, nonce, isMainnet })
+    }
+    const signature = await this.signUserTyped(built.typed, `Hyperliquid ${this.cfg.network} 资金划转：${what}`, exec, signerAddress)
+    exec.signal?.throwIfAborted()
+    const res = await this.client.exchangeUserSigned(built.action, signature, nonce)
+    assertExchangeAccepted(res)
+    this.store.recordEvent('live.transfer', { from, to, amount, dex: dex ?? undefined, toDex: dex ? to === dex : undefined })
+    return { ok: true, from, to, amount, dex: dex ?? undefined, direction: dex ? (to === dex ? 'in' : 'out') : undefined, response: res }
+  }
+
+  /** Sign a user-signed action's EIP-712 payload with the main wallet (dsh-web3 or the local key). */
+  async signUserTyped(typed, purpose, exec, signerAddress) {
     if (this.cfg.signer === 'web3') {
       const wallet = this.walletService()
       if (!wallet) throw new Error('signer=web3 但 dsh-web3 未安装')
-      const result = await wallet.signTypedData({ account: this.cfg.web3Account, ...typed, purpose: `Hyperliquid ${this.cfg.network} 资金划转：${what}` },
+      const result = await wallet.signTypedData({ account: this.cfg.web3Account, ...typed, purpose },
         this.approvalGateway(), { toolName: 'dsh-hyperliquid', agent: exec?.agent, callId: exec?.callId, signal: exec?.signal })
       if (result?.status !== 'signed' || !result.signature) throw new Error(`dsh-web3 签名未完成（status=${result?.status}）`)
       if (result.address?.toLowerCase() !== signerAddress.toLowerCase()) throw new Error('dsh-web3 返回的签名地址与配置账户不一致')
-      signature = splitSignature(result.signature)
-    } else {
-      if (!this.cfg.privateKey) throw new Error('live 划转需要钱包私钥')
-      signature = await signTypedDataLocal(this.cfg.privateKey, typed)
+      return splitSignature(result.signature)
     }
-    exec.signal?.throwIfAborted()
-    const res = await this.client.exchangeUserSigned(action, signature, nonce)
-    assertExchangeAccepted(res)
-    this.store.recordEvent('live.transfer', { dex, amount, toDex })
-    return { ok: true, dex, amount, direction: toDex ? 'in' : 'out', response: res }
+    if (!this.cfg.privateKey) throw new Error('live 划转需要钱包私钥')
+    return signTypedDataLocal(this.cfg.privateKey, typed)
   }
 
   applyRiskSettings(limits, override) {

package/lib/signing.js

@@ -247,6 +247,31 @@ export function buildSendAsset({ destination, sourceDex, destinationDex, token,
   }
 }
 
+/** `usdClassTransfer` fields, as the official SDK signs them. */
+export const USD_CLASS_TRANSFER_TYPES = [
+  { name: 'hyperliquidChain', type: 'string' },
+  { name: 'amount', type: 'string' },
+  { name: 'toPerp', type: 'bool' },
+  { name: 'nonce', type: 'uint64' },
+]
+
+/**
+ * A `usdClassTransfer` action (USDC between the spot balance and the core perp account) and its EIP-712 payload.
+ * @returns {{ action, typed: { domain, types, value } }}
+ */
+export function buildUsdClassTransfer({ amount, toPerp, nonce, isMainnet = true }) {
+  const action = { type: 'usdClassTransfer', signatureChainId: USER_SIGNATURE_CHAIN_ID, hyperliquidChain: isMainnet ? 'Mainnet' : 'Testnet', amount, toPerp: Boolean(toPerp), nonce }
+  const value = Object.fromEntries(USD_CLASS_TRANSFER_TYPES.map(({ name }) => [name, action[name]]))
+  return {
+    action,
+    typed: {
+      domain: { name: 'HyperliquidSignTransaction', version: '1', chainId: parseInt(USER_SIGNATURE_CHAIN_ID, 16), verifyingContract: '0x0000000000000000000000000000000000000000' },
+      types: { 'HyperliquidTransaction:UsdClassTransfer': USD_CLASS_TRANSFER_TYPES },
+      value,
+    },
+  }
+}
+
 /** EIP-712 digest + secp256k1 signature for a single-struct payload of string / uint / bool / address fields. */
 export async function signTypedDataLocal(privateKey, { domain, types, value }) {
   const c = await loadCrypto()

package/lib/tools.js

@@ -356,7 +356,7 @@ function buildTools(remote) {
       description: '查询交易账户。action=state 返回权益/持仓；orders 返回挂单；fills 返回成交；orderStatus 用 oid 或 cloid 核对某笔 live 订单，尤其在网络超时后。review 返回最近 7/30/90 天成交复盘、订单数量核对、费用和资金费覆盖缺口；不是完整账户收益率。' +
         'action=analyze 交易体检（默认 90 天）：按完整往返统计胜率、盈亏比、期望、持仓时长、按币种/时段/星期的表现、手续费与资金费，并给出按金额排序的习惯问题和建议规则——第一次见面或用户问“我做得怎么样”时用它，不要自己从成交里手算。' +
         'action=limits 修改允许币对（addCoins/removeCoins）与单笔/每日/仓位/杠杆上限——仅全托管模式可用，半托管时由用户在 设置 → 交易限额与签名规则 修改。' +
-        'action=transfer 在主永续账户与 HIP-3 交易所之间划转 USDC（dex，amount，direction=in 转入 / out 转回）——全托管直接执行，半托管每次需用户批准；仅 live。',
+        'action=transfer 在账户之间划转 USDC：from / to 取 spot（现货）、perp（主永续）或 HIP-3 交易所名（如 xyz），amount 为数量；支持 spot↔perp 与 perp↔HIP-3，spot 与 HIP-3 之间请分两步经 perp。下单前永续保证金不足而现货有 USDC 时，先 spot→perp。统一账户 / 组合保证金模式无需 spot↔perp 划转。全托管直接执行，半托管每次需用户批准；仅 live，需交易主钱包签名。旧参数 dex + direction（in/out）仍可用。',
       parameters: {
         type: 'object',
         properties: {
@@ -364,9 +364,11 @@ function buildTools(remote) {
           addCoins: { type: 'array', items: { type: 'string' }, description: 'action=limits：加入允许币对，如 ["xyz:XYZ100"]' },
           removeCoins: { type: 'array', items: { type: 'string' }, description: 'action=limits：移出允许币对' },
           maxOrderUsd: { type: 'number' }, maxDailyUsd: { type: 'number' }, maxPositionUsd: { type: 'number' }, maxLeverage: { type: 'number' },
-          dex: { type: 'string', description: 'action=transfer：HIP-3 交易所名，如 xyz' },
+          from: { type: 'string', description: 'action=transfer：转出账户，spot / perp / HIP-3 交易所名' },
+          to: { type: 'string', description: 'action=transfer：转入账户，spot / perp / HIP-3 交易所名' },
+          dex: { type: 'string', description: 'action=transfer（旧写法）：HIP-3 交易所名，配合 direction' },
           amount: { type: 'number', description: 'action=transfer：USDC 数量' },
-          direction: { type: 'string', enum: ['in', 'out'], description: 'action=transfer：in=主账户转入该交易所（默认），out=转回主账户' },
+          direction: { type: 'string', enum: ['in', 'out'], description: 'action=transfer（旧写法）：in=主永续转入 dex（默认），out=转回主永续' },
           oid: { type: 'string', description: 'orderStatus 必填；交易所 oid 或 0x 开头 128 位 cloid' },
           days: { type: 'number', enum: [7, 30, 90], description: 'review 窗口，默认 30 天' },
           coin: { type: 'string', description: 'review 可选，仅核对该标的；省略为全部' },
@@ -394,7 +396,8 @@ function buildTools(remote) {
         }
         if (action === 'transfer') {
           const res = await remote.transferCollateral(args, exec)
-          return { text: `已划转 ${res.amount} USDC：${res.direction === 'in' ? `主永续账户 → ${res.dex}` : `${res.dex} → 主永续账户`}`, ...res }
+          const name = (value) => value === 'spot' ? '现货账户' : value === 'perp' ? '主永续账户' : value
+          return { text: `已划转 ${res.amount} USDC：${name(res.from)} → ${name(res.to)}`, ...res }
         }
         if (action === 'state') {
           const a = await remote.account({ coin: remote.desk?.coin })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-hyperliquid",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "description": "Hyperliquid trading desk for the DeepSeek Harness (dsh) - market workspace, native agent conversation and guarded live / paper trading over the Hyperliquid API.",
   "icon": "./icon.svg",
   "type": "module",

package/skills/hyperliquid-trading/SKILL.md

@@ -34,7 +34,7 @@ description: 作为用户的交易副手，在 DSH 交易会话中用 Hyperliqui
 |---|---|---|
 | 实盘下单、撤单、改杠杆 | 每笔都需要用户批准 | 在限额内直接执行 |
 | 允许币对与单笔/每日/仓位/杠杆上限 | 只能由用户在 **设置 → 交易限额与签名规则** 修改 | 你可以用 `hyper_account action=limits` 调整（`addCoins` / `removeCoins` / `maxOrderUsd` / `maxDailyUsd` / `maxPositionUsd` / `maxLeverage`） |
-| HIP-3 保证金划转 | `hyper_account action=transfer`，每次需要用户批准 | 直接执行 |
+| USDC 划转（现货 ↔ 永续、永续 ↔ HIP-3） | `hyper_account action=transfer`，每次需要用户批准 | 直接执行 |
 
 两种模式下 dsh-web3 钱包自己的签名策略都仍然生效：钱包拒签就停止，不要绕过。
 
@@ -43,11 +43,18 @@ description: 作为用户的交易副手，在 DSH 交易会话中用 Hyperliqui
 - 不要拆单来绕过任何限额。
 - **网络（mainnet/testnet）和模式（paper/live）**由用户在设置里切换。插件**不做提现**。
 
+### 现货与永续的 USDC 是分开的
+默认账户模式（`hyper_context.accountMode` 为 `default`）下，现货 USDC 和永续保证金是两个余额：现货里有钱、永续可用保证金不够时，下单会被拒。
+- 先确认：`hyper_account action=state` 看永续可用保证金；现货余额在 Hyperliquid 现货账户里。
+- 不够时用 `hyper_account action=transfer from=spot to=perp amount=…` 把这笔交易需要的保证金加一点缓冲划到永续；不再交易时可 `from=perp to=spot` 划回。半托管需要用户批准，全托管直接执行。不要让用户去网页手动划转。
+- 统一账户（`unifiedAccount`）/ 组合保证金（`portfolioMargin`）模式下现货 USDC 直接作保证金，不需要也不能这样划转。
+- 现货与 HIP-3 交易所之间没有直达，分两步：`from=spot to=perp`，再 `from=perp to=xyz`。
+
 ### HIP-3 的保证金是独立的
 每个 HIP-3 交易所（如 xyz）都有独立的保证金账户，和主永续账户的余额不互通：
-- **Standard 账户**：开仓前，该交易所里要有 USDC。不够时用 `hyper_account action=transfer dex=xyz amount=… direction=in` 从主永续账户划入（半托管需要用户批准，全托管直接执行）。只划入这笔交易需要的保证金加一点缓冲，不要整笔搬空主账户。平仓后不再交易该市场时，可以用 `direction=out` 转回。用户也可以自己在 Hyperliquid 网页划转。
+- **Standard 账户**：开仓前，该交易所里要有 USDC。不够时用 `hyper_account action=transfer from=perp to=xyz amount=…`（旧写法 `dex=xyz direction=in` 仍可用）从主永续账户划入（半托管需要用户批准，全托管直接执行）。只划入这笔交易需要的保证金加一点缓冲，不要整笔搬空主账户。平仓后不再交易该市场时，可以用 `from=xyz to=perp` 转回。
 - **统一账户（Unified Account）/ Portfolio Margin**：下 HIP-3 单时会自动调用主账户的 USDC，不需要划转。`hyper_context.accountMode` 能看出当前是哪种。开启统一账户需要用户在 Hyperliquid 网页操作。
-- 划转是主钱包签名的 `sendAsset` 动作，只支持以 USDC 为保证金的交易所，单次不超过仓位上限，并且只在 live 模式下可用。
+- 划转都由交易主钱包签名（现货 ↔ 永续是 `usdClassTransfer`，永续 ↔ HIP-3 是 `sendAsset`），HIP-3 只支持以 USDC 为保证金的交易所；单次不超过仓位上限，只在 live 模式下可用。
 - HIP-3 的手续费、杠杆上限与核心永续不同（按市场读取 `maxLeverage`），部分市场只允许逐仓。
 
 ### 执行能力与限制