SuperAPI AI 工具集

chart-setup

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:在 React 应用中加入生产级价格图表,使用 TradingView 的 lightweight-charts 库,是 command-dash 中 ChartCanvas 的实现基础。

适用场景:显示股票或加密货币的 OHLC/K线图;在价格图下方添加成交量柱;将现有 lightweight-charts 实例改为深色仪表盘配色;把图表接到 fetch('/api/...') 且返回 { time, open, high, low, close, volume }[] 的数据源。

安装:npm install lightweight-charts。注意 lightweight-charts v5+ 使用模块化 series API(addSeries(CandlestickSeries, ...)),旧版 v4 的 addCandlestickSeries(...) 写法无效;若项目用 v4,需升级到 v5 或全程使用 v4 API。

组件示例:创建 src/components/ChartPanel.tsx,导入 useEffect、useRef、useState 以及 createChart、CandlestickSeries、HistogramSeries 等;定义 Bar 接口(time 为 unix 秒、open/high/low/close/volume 为数值);Props 含 symbol 与 fetchBars;在 useEffect 中用 createChart 创建图表并 addSeries 加入 K 线与成交量序列,用 setData 灌入数据并 fitContent。

关键要求:createChart 选项中设 autoSize: true,可自动填满容器并在尺寸变化时重排,无需手动 resizeObserver;容器必须有明确高度,h-full 需所有祖先元素也受高度约束(flexbox 或 grid);time 用 unix 秒(UTCTimestamp),不是毫秒或 ISO 字符串,需将 Date.now() 除以 1000;调用 setData 前按时间升序排序;TS 中用 as never 转换 time 以避免类型摩擦。

配色(TradersPost 深蓝):背景 #1d2939、坐标轴与刻度边框 #344054、坐标轴文字 #98a2b3、网格线 #293548、上涨 K 线 #12b76a、下跌 K 线 #f04438、叠加线与权益曲线 #2e90fa。

参考实现位于 apps/web/src/components/dashboard/ChartCanvas.tsx,含 symbol/timeframe/图表类型/指标叠加等受控属性、Vite 代理到返回 Polygon OHLC 的 FastAPI 后端、以及等待尺寸的 requestAnimationFrame 模式;权益曲线图见 StrategyReport.tsx 的 OverviewTab。缺失信息:未提供具体收费、价格或使用步骤。