用途:作为 OneKey Perps/Hyperliquid 的领域路由指南,仅在提示或文件路径明确涉及 OneKey Perps/Hyperliquid 时使用,帮助定位订单语义、实时订阅和 UI 与后台状态竞态的正确归属与验证路径。
主要能力:提供 60 秒分诊流程,先推断资产类型(永续/现货)、账户/DEX、订单模式与平台;通过归属矩阵选择主责文件,避免用下游展示层修补交易或实时契约。覆盖订单提交/取消/TWAP/缩放/TIF、L2/BBO/订单簿订阅、充值报价与状态、持仓/账户状态/资金费/保证金/清算、Perps TradingView/K 线/图表线,以及仅 UI 展示层。
使用方式:先加载一个匹配的参考文档,仅在需要归属、证明或实现时再加载 code-map.md 与 validation-recipes.md。编辑前用 rg 验证锚点。参考文档包括 code-map.md、order-contracts.md、state-subscriptions.md、tradingview-bridge.md、deposit-relay.md、positions-account-state.md、failure-patterns.md、validation-recipes.md、review-checklist.md、source-index.md。
适用场景:排查 TWAP 取消/列表/历史错误、缩放订单子单/精度/TIF、切换资产后订单簿显示旧数据、离线重连后 K 线空白、充值挂起/完成状态错误、持仓/PnL/资金费/保证金/清算/账户摘要过期,以及审查 Perps PR。
限制:不适用于通用 Market K 线、通用 TradingView 桥接、通用代币选择器或通用 Swap Relay 报价/状态。订单语义、TIF、TWAP、缩放、触发、只减仓等属于随 SDK 版本变化的契约事实,需对照源码与官方文档确认,不能依赖记忆。调试时禁止记录私钥、签名、助记词或敏感载荷;不得绕过启用交易、账户绑定、签名或风险校验;未经用户明确授权,不得用生产环境真实下单/取消/提现/充值作为验证。具体实现细节与验证配方需查阅对应参考文档,资料未提供完整代码示例。