xtraderClient/docs/composables/useLightweightChart.md

useLightweightChart

路径：src/composables/useLightweightChart.ts

功能用途

TradingView Lightweight Charts 工具函数，用于将项目内 [timestamp_ms, value][] 格式转为图表所需格式，并提供创建折线/面积图的便捷方法。

核心能力

• toLwcData：将 [timestamp_ms, value][] 转为 { time: UTCTimestamp, value: number }[]，输入为毫秒（>=1e12）时自动除以 1000 转为秒，按时间升序排序并去重（同时间戳保留最新价格），时间轴显示用户当地时间
• toLwcPoint：将单点 [timestamp_ms, value] 转为 { time, value }，用于 series.update() 增量更新
• createLineChart：创建基础折线图实例（attributionLogo: false 隐藏 TradingView 图标）
• addLineSeries：添加折线系列（支持 percent/price 格式）
• addAreaSeries：添加面积系列（带渐变）

使用方式

import { toLwcData, toLwcPoint, createLineChart, addLineSeries } from '@/composables/useLightweightChart'

const points: [number, number][] = [[Date.now() - 3600000, 50], [Date.now(), 55]]
const lwcData = toLwcData(points)

const chart = createLineChart(containerEl, { width: 400, height: 320 })
const series = addLineSeries(chart, { color: '#2563eb', priceFormat: { type: 'percent', precision: 1 } })
series.setData(lwcData)

// 实时追加/更新单点时，使用 update() 替代 setData() 以获得更平滑的过渡效果
series.update(toLwcPoint([Date.now(), 52]))

扩展方式

• 新增图表类型：参考 addAreaSeries 使用 AreaSeries、CandlestickSeries 等
• 自定义主题：修改 createLineChart 的 layout、grid、rightPriceScale 等配置