跳到主要内容

版本与诊断

版本查询与本机环境自检。都会加载 native。

版本​

version()​

def version() -> tuple[int, int, int]

返回 (major, minor, patch)。会加载 native。

返回值:

  • tuple[int, int, int] — 与头文件 DARRA_VERSION_* 同一组数字

示例:

from darra_ai import version

print(version())  # (1, 0, 0)

version_string()​

def version_string() -> str

返回形如 1.0.0+runtime / 1.0.0+authoring 的静态字符串。会加载 native。

返回值:

  • str — 客户机必须看到 +runtime

示例:

from darra_ai import version_string

print(version_string())  # "1.0.0+runtime"
备注

major 在 dlopen 时已核对；不等抛 DarraLoadError。静态字符串，禁止释放。

诊断​

diagnostics.collect()​

def collect() -> dict

采集本机环境诊断，返回 JSON 对象。

返回值:

备注

覆盖：os/arch、CPU、GPU 型号 + 驱动版本 + CUDA 上限、已装 Provider 及版本、授权状态（去敏）、最近错误环形缓冲（去敏）。尽力而为：单个字段采不到时为 null 或缺席，整体不失败。不含密钥 / 密码 / token / 机器指纹字节。可能触发 WMI / NVML / sysfs，耗时数百毫秒，禁止在 PLC 扫描周期等实时路径调用。

示例:

from darra_ai import diagnostics

print(diagnostics.collect())