安裝與使用 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 服務和行情數據時，請安裝 Longbridge CLI。

按照 Longbridge CLI 安裝指南完成安裝，然後登入：

longbridge auth login

接下來可前往快速開始，編寫腳本並使用 Longbridge 行情數據執行。完整命令選項請參閱 longbridge quant run 文件。

用於開發的 Navi CLI

在本機開發或調試 .nv 文件，或者在 CI 中驗證腳本時，可以安裝獨立的 navi CLI。

macOS 或 Linux：

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

Windows PowerShell：

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

確認安裝：

navi --version

獨立 CLI 不包含行情數據，但可以執行腳本：navi check 和 navi fmt 提供編譯和格式化檢查，navi run 則用你從 stdin 以 NDJSON 提供的數據執行腳本，把每根 K 線的 plot 數值和告警寫到 stdout。navi check 和 navi fmt 都接受檔案、目錄和 glob 模式，一條命令即可校驗整個專案。執行 navi update 可原地升級二進位檔。

VS Code 擴充功能

Navi VS Code 擴充功能為 .nv 檔案提供語法高亮、診斷、自動完成、懸停提示、跳轉定義和格式化。它內置了 WebAssembly 語言伺服器，無需額外安裝即可使用——在網頁版 VS Code（vscode.dev / github.dev）中也能執行。

下載 VS Code 擴充功能（.vsix）

透過命令列安裝：

code --install-extension navi-vscode.vsix

或在 VS Code 中：開啟擴充功能檢視，使用 ··· 選單 → 從 VSIX 安裝…，選擇下載的檔案。

如需使用原生 navi-lsp 執行檔而非內置的 WebAssembly 伺服器，將 navi.server.mode 設為 native，並把 navi.server.path 指向該執行檔。

下一步

• 快速開始 — 編寫並驗證第一個 Navi 腳本
• 語言基礎 — 學習 Navi 語法和命名規範
• AI 助手 — 安裝 Navi 編寫 skill