从 TradingView 迁移
基于 TradingView 图表库(Advanced Charts 或 Trading Platform)或 Lightweight Charts 构建的应用,迁移到 TradeCanvas 时后端无需改动。datafeed 保持原样,放在一层桥接之后。确实会变的名称,包括选项、featureset、 override、study、画线和方法,都收录在 MCP 服务器据以回答的对照表中, 因此编程智能体会逐个查询,而不是去猜。本页说明哪些内容可以沿用、哪些会变、哪些无法迁移。
保留 datafeed
feedFromJsApi 把为 JS API 编写的 datafeed(onReady、resolveSymbol、 getBars、subscribeBars,以及在实现了的情况下的 searchSymbols、 getQuotes、subscribeQuotes)转换成一个 DataFeed:
import { feedFromJsApi } from '@tradecanvas/chart'
import { ChartWidget } from '@tradecanvas/chart/widget'
const feed = feedFromJsApi(datafeed) // 应用原有的 datafeed,不做改动
await feed.ready() // onReady 已返回:已知道它提供的周期
const widget = new ChartWidget(document.getElementById('chart'), { feed, symbol: 'AAPL', timeframe: '1d' })桥接层为 datafeed 做的事:
- 每个品种只解析一次,并把它的 symbol info 交回给
getBars和subscribeBars; - 把图表的周期转换为 resolution(
'1h'→'60','1d'→'1D'),并把图表的countBack和before转换为以秒为单位的from、to和countBack; - 某个区间没有K线时,再从
nextTime请求一次; - 用订阅时的 guid 取消订阅,并在 datafeed 调用
onResetCacheNeeded时重新加载序列; - 把品种的
pricescale和minmov读作价格步长,把session读作交易时段, 并从supported_resolutions读取它提供的周期。
图表在连接 feed 时读取它提供的周期,并由这些周期构建其他周期(用 1 分钟K线构建 7 分钟图表)。 onReady 返回得更晚,因此请在创建 ChartWidget 之前 await feed.ready(),
或者自己传入这些周期:feedFromJsApi(datafeed, { supportedTimeframes: ['1m', '1h', '1d'] })。
UDF 服务器
支持 UDF 协议的服务器完全不需要编写 datafeed 代码:
import { udfFeed } from '@tradecanvas/chart'
const feed = udfFeed({ url: 'https://data.example.com/udf', updateFrequency: 10_000 })
await feed.ready() // 它的 /config 中的周期
new ChartWidget(el, { feed, symbol: 'AAPL', timeframe: '1d' })它读取 /config、/symbols、/search、/history 和 /quotes。UDF 没有推送,因此实时K线和报价每隔 updateFrequency 毫秒重新请求一次
(默认 10 秒)。headers 会随每个请求发送。
让智能体对照其余部分
MCP 服务器为迁移提供三个工具:
| 工具 | 作用 |
|---|---|
migration_plan | 按顺序列出步骤、要在应用代码中搜索什么,以及每次搜索的结果由哪个工具对照。 |
migration_lookup | 一个名称会变成什么:组件选项、featureset、override 键、study、画线形状、组件或图表的方法、datafeed 或 broker 的成员,或一个 resolution。它给出对应的选项、功能开关、样式键、指标 id(附默认值和线条键)、画线类型 (附其锚点)或调用;没有对应项时会直接说明,并给出替代做法。 |
convert_widget_options | 把 new TradingView.widget({...}) 的整个选项对象(包括 featureset 和 override)转换为 ChartWidget 选项;或把 Lightweight Charts 的 createChart 选项转换为 Chart 选项。它还会列出图表创建后需要进行的调用以及无处安放的部分,并像 validate_options 一样检查结果。 |
连接服务器后,直接让智能体完成迁移:它会先调用 migration_plan,然后据此逐步处理整个应用。
对于没有连接服务器的智能体,agent skill 中有相同的步骤。
会变的部分
| TradingView | TradeCanvas |
|---|---|
new TradingView.widget({ container: 'id' })、library_path | new ChartWidget(element, options);无需托管任何文件 |
onChartReady(cb) | onReady 选项,或写在构造函数之后的代码 |
widget.activeChart().createStudy(...) | widget.getChart().addIndicator(id, params);id 很短:'rsi'、'bb' |
createShape({ time, price }, { shape }),时间以秒为单位 | addDrawing({ type, anchors: [{ time, price }] }),时间以毫秒为单位 |
resolution:'60'、'1D'、'W' | 周期:'1h'、'1d'、'1w'(resolutionToTimeframe、timeframeToResolution) |
disabled_features、enabled_features | features:每个开关默认开启,除非设为 false |
overrides、applyOverrides | 样式键,写在 chartOptions.overrides 中或通过 chart.applyOverrides();线型用名称表示 |
save_load_adapter | layouts: { storage } 配合一个 LayoutStorage(list、load、save、remove) |
| Broker API、订单线和持仓线 | 一个 ExecutionAdapter、setOrders、setPositions 和订单事件(交易) |
| Lightweight Charts:K线和标记以秒为单位 | 毫秒:time * 1000 |
无法迁移的部分
- 已保存的图表。以 TradingView 格式保存的布局、画线和指标无法加载:用户需要新建布局。
- 为
custom_indicators_getter编写的自定义指标需要改写为 指标插件,除非 134 个内置指标中已有功能相同的。 - 部分画线工具和 featureset 没有对应项。
migration_lookup会说明是哪些,并给出最接近的工具。 - 跨品种交易。
ExecutionAdapter的订单和持仓属于图表当前的品种;跨多个品种和账户的账户管理器 由应用自己实现。
这些对照表依据 TradingView 的公开文档编写(2026 年 11 月查阅),并在每次构建时与 TradeCanvas 自身的名称进行核对。 缺失或错误的名称属于 bug:请在 GitHub 上报告。