安装与使用 Navi

Navi 可以在多种环境中使用，请根据实际工作流选择：

使用环境	适用场景
Longbridge App 或桌面端	直接在交易图表中使用指标和策略
Longbridge CLI	使用 Longbridge 行情数据运行脚本、自动化、选股和回测
`navi` CLI	本地编写、格式化、类型检查、调试和 CI 验证

日常和正式使用时，建议选择 Longbridge App、桌面端或 Longbridge CLI。独立的 navi CLI 主要是开发工具，不能替代 Longbridge 产品中的完整使用体验。

Longbridge App 和桌面端

需要在图表中交互式使用 Navi 时，请使用 Longbridge App 或桌面端。Navi 运行时已经集成在产品中，无需另行安装 Navi CLI。

需要通过命令行使用 Longbridge 服务和行情数据时，请安装 Longbridge CLI。

按照 Longbridge CLI 安装指南完成安装，然后登录：

bash

longbridge auth login

接下来可前往快速开始，编写脚本并使用 Longbridge 行情数据运行。完整命令选项请参阅 longbridge quant run 文档。

在本地开发或调试 .nv 文件，或者在 CI 中验证脚本时，可以安装独立的 navi CLI。

macOS 或 Linux：

bash

curl -fsSL https://navi-lang.org/install.sh | sh

Windows PowerShell：

powershell

irm https://navi-lang.org/install.ps1 | iex

确认安装：

bash

navi --version

独立 CLI 不包含行情数据，只提供基础的编译、lint、格式化和运行能力，方便开发者及 AI 验证脚本正确性。因此 navi run 必须通过 --data 接收调用方提供的 OHLCV CSV。快速开始会介绍如何构造模拟验证数据，以及需要时如何获取真实 K 线。