zerolaunch-plugin-sdk-rust 0.2.1

Rust SDK for writing ZeroLaunch third-party plugins.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

use std::future::Future;
use tracing::Instrument;
use zerolaunch_plugin_api::PluginContext;

/// 根据 PluginContext 创建 tracing span。
pub fn span_for(ctx: &PluginContext) -> tracing::Span {
    tracing::info_span!(
        "plugin",
        trace_id = %ctx.trace_id,
        plugin_id = ?ctx.plugin_id,
        query_id = ?ctx.query_id,
    )
}

/// 同步闭包包装：在 span 内执行同步代码。
pub fn with_trace<R>(ctx: &PluginContext, f: impl FnOnce() -> R) -> R {
    let span = span_for(ctx);
    let _enter = span.enter();
    f()
}

/// 异步 Future 包装：在 span 内执行异步代码。
pub fn instrument<F: Future>(ctx: &PluginContext, fut: F) -> tracing::instrument::Instrumented<F> {
    fut.instrument(span_for(ctx))
}