快速開始

前提條件

• Rust（stable）及 Cargo

從源碼構建

克隆倉庫並構建：

git clone https://github.com/longbridge/openpine.git
cd openpine
cargo build

運行測試

# 所有測試
cargo test --all-features

# 特定 crate
cargo test -p openpine-parser
cargo test -p openpine-visitor
cargo test -p openpine-vm
cargo test -p openpine-lsp

你的第一個腳本

在 Cargo.toml 中添加 openpine-vm：

[dependencies]
openpine-vm = { path = "crates/vm" }

然後編寫一個簡單的程式：

use openpine_vm::{Candlestick, Instance, TimeFrame};

#[tokio::main]
async fn main() -> Result<(), openpine_vm::Error> {
    let source = r#"
//@version=6
indicator("Hello OpenPine")
plot(close)
plot(ta.sma(close, 5), "SMA 5")
"#;

    let timeframe = TimeFrame::days(1);
    let symbol = "NASDAQ:AAPL";

    let bars = vec![
        Candlestick::new(1700000000000, 150.0, 155.0, 149.0, 153.0, 1000.0, 0.0, Default::default()),
        Candlestick::new(1700086400000, 153.0, 158.0, 152.0, 157.0, 1200.0, 0.0, Default::default()),
        Candlestick::new(1700172800000, 157.0, 160.0, 155.0, 159.0, 900.0, 0.0, Default::default()),
    ];

    let mut instance = Instance::builder(bars, source, timeframe, symbol)
        .build().await?;

    // 執行腳本，從 provider 讀取所有 K 線
    instance.run_to_end(symbol, timeframe).await?;

    // 讀取輸出
    for (_id, graph) in instance.chart().series_graphs() {
        if let Some(plot) = graph.as_plot() {
            println!("Plot: {}", plot.title.as_deref().unwrap_or("unnamed"));
            for i in 0..plot.series.len() {
                println!("  bar {}: {:?}", i, plot.series[i]);
            }
        }
    }

    Ok(())
}

下一步

• 語言基礎 — 學習 Pine Script 語法
• 集成 — openpine-vm 庫的詳細指南
• C/C++ API — 在 C++ 項目中嵌入 OpenPine