快速开始

开始前，请先选择并配置 Navi 的使用方式。本指南使用 Longbridge CLI 和行情数据运行脚本，并将独立的 navi CLI 作为可选的本地开发检查工具。

编写第一个指标

创建 sma.nv：

indicator("SMA", overlay: true);

let len = input.int(14, "Length", minval: 1);
plot(ta.sma(close, len), "SMA", color: Color.BLUE);

AAPL · 1D · SMA 14

Loading chart…

蓝色线是该指标基于 AAPL 日 K 线计算出的 14 周期简单移动平均线。该脚本已使用 navi run 和同一份 OHLCV 数据实际执行。

本地检查（可选）

如果已安装用于开发的独立 navi CLI，可以在运行脚本前进行验证：

navi lint sma.nv

lint 会检查语法、类型、编译、导入和规范格式。独立 CLI 不包含行情数据。要验证运行行为，请准备 OHLCV CSV；模拟 K 线即可，但应覆盖脚本的回看周期和关键分支。然后执行：

navi run sma.nv --data bars.csv --symbol NASDAQ:AAPL --timeframe 1D

CSV 必须包含 time,open,high,low,close，可选包含 volume 和 turnover；time 使用 Unix 毫秒。运行 navi run --help 可查看当前 CSV 格式和所有选项。

需要真实 K 线时，已安装并登录的 Longbridge CLI 可以输出 JSON：

longbridge kline history AAPL.US \
  --start 2024-01-01 \
  --end 2024-12-31 \
  --format json

将返回的 OHLCV 字段转换为上述 CSV 格式即可。AI 环境若提供 Longbridge MCP，也可以通过其行情工具请求历史 K 线。两者均不可用时，可使用可靠的公开数据源，并核对授权、复权方式、时区、排序及缺失 K 线处理方式。

使用 Longbridge 运行

通过 Longbridge CLI 使用历史行情数据运行指标：

cat sma.nv | longbridge quant run AAPL.US \
  --start 2024-01-01 \
  --end 2024-12-31

数据周期、输入参数、输出格式和回测选项请参阅 longbridge quant run 文档。同一个脚本也可以在 Longbridge App 或桌面端中交互式使用。

编写策略

strategy("MA Cross", overlay: true);

let fast = ta.ema(close, input.int(10, "Fast"));
let slow = ta.ema(close, input.int(20, "Slow"));

if ta.cross_over(fast, slow) {
    strategy.close("Short");
    strategy.entry("Long", Direction.Long);
}
if ta.cross_under(fast, slow) {
    strategy.close("Long");
    strategy.entry("Short", Direction.Short);
}

plot(fast, "Fast EMA");
plot(slow, "Slow EMA");

navi lint ma_cross.nv
navi run ma_cross.nv --data bars.csv --symbol NASDAQ:AAPL --timeframe 1D

使用 500 根 AAPL 日 K 线运行该示例，CLI 输出为：

ran 500 bars; plots: 2; trades: 0 ; net profit: 0

运行 PineScript 文件 experimental

navi CLI 兼容 PineScript v6 语法。将脚本保存为 .pine 文件并传入全局 --pine 参数，即可直接编译或运行：

navi check my_indicator.pine --pine
navi run my_indicator.pine \
  --data bars.csv \
  --symbol NASDAQ:AAPL \
  --timeframe 1D \
  --pine

.pine 入口文件必须使用 --pine 参数；未传入该参数时，本地 CLI 接受 Navi .nv 文件。

转换为 Navi

下面两个示例都计算布林带。PineScript 填充上下轨区域，紧凑的 Navi 版本则使用趋势变色中轨和简洁的区间边界。

// @version=6
indicator("Bollinger Bands", overlay=true)

length = input.int(20, "Length")
mult   = input.float(2.0, "Multiplier")

[basis, upper, lower] = ta.bb(close, length, mult)

plot(basis, "Basis", color.blue)
upper_plot = plot(upper, "Upper", color.red)
lower_plot = plot(lower, "Lower", color.green)
fill(upper_plot, lower_plot, color.new(color.blue, 90))

indicator("Bollinger Range", overlay: true);

let price_source = input.source(close, "Source");
let period = input.int(20, "Period", minval: 1);
let deviation = input.float(2.0, "Deviation", minval: 0.1);

let (middle, upper_band, lower_band) = ta.bb(price_source, period, deviation);
let middle_color = middle > middle[1] ? Color.GREEN : Color.RED;

plot(middle, "Trend Basis", color: middle_color, line_width: 2);
plot(upper_band, "Upper Range", color: Color.BLUE);
plot(lower_band, "Lower Range", color: Color.BLUE);

下一步

• 语言基础
• 标准库