SuperAPI AI 工具集

1k-tradingview-communication

编程与开发

查看项目

更新于 10-16 10:21

技能介绍

用途:本技能用于梳理 OneKey 应用仓库与独立 TradingView 图表仓库之间的桥接通信,避免重复排查两端消息机制。不要假设固定本地路径,应使用 rg 按符号名定位文件。

主要能力:应用通过 WebView/iframe 加载图表,双方交换普通消息对象。图表到应用为带 scope、origin、method、data 的 $private 载荷;应用到图表通过 webRef.current.sendMessageViaInjectedScript(message),在图表内表现为 window.postMessage(message)。Web/扩展使用 iframe postMessage,原生/桌面注入脚本调用 window.postMessage。市场模式数据通常来自应用/后台服务;Perps/Hyperliquid K 线由图表直接获取,但标记、价格刻度、符号同步和图表线条仍走应用桥接。

消息契约:市场 K 线由图表请求 tradingview_getKLineData,应用经 handleKLineDataRequest 拉取并返回 kLineData;实时更新以 autoKLineUpdate 推送。标记请求用 tradingview_getMarks,响应 MARKS_RESPONSE,推送 MARKS_UPDATE(operation 为 incremental/replace/clear)。Hyperliquid 价格刻度请求 tradingview_getHyperliquidPriceScale,响应 HYPERLIQUID_PRICESCALE_RESPONSE。Perps 符号同步用 SYMBOL_CHANGE;Perps 线条用 PERPS_TV_LINES_SYNC/PATCH/CLEAR 及订单价格更新拒绝回滚,图表向应用发送 tradingview_perpsReady、perpsOrderCancel、perpsOrderDraftCreate、perpsOrderPriceUpdate、chartExpand 等。恢复时应用发送 FORCE_RECOVER_WS,图表发 tradingview_touchScroll。

使用方式与限制:URL 参数由 useTradingViewUrl 集中生成,常见有 timezone、locale、platform、theme 等。改动消息时需同步两端常量与类型、保留 requestId、保持载荷稳定、为应用至图表消息添加监听、图表至应用经 sendMessage 路由、遵守 revision 顺序与符号规范化,Hyperliquid 符号使用原始 coin id 作 API/缓存键。不得绕过 $private 路由、交易启用检查、订单拒绝回滚或来源校验。桥接机制变更需同时测试 Web iframe 与原生/桌面注入脚本行为。验证:应用侧改动运行相关 TypeScript/lint 命令,提交前用 yarn agent:check --profile commit;图表仓库改动运行 npm run build 或 yarn build,触及 lint 敏感代码时运行 npm run lint 或 yarn lint。本地手动测试需在开发设置启用 use local TradingView URL,并在 localhost:5173 运行图表开发服务器(Android 模拟器用 10.0.2.2:5173)。