Python API 参考

Core primitive、评测契约、runner 与 runtime 工具的源码驱动签名。

本页内容

与 CLI、Studio 调用的是同一套契约。各页先给选型说明,再展示从源码生成的签名。模型专属实现、vendored 上游代码与 benchmark 内部细节不在本参考范围内。

Core

共享的注意力、I/O、加载、分布式、配置与加速 primitive。

评测

可序列化契约、runner、metric、编排、证据与 runtime 工具。

Import 约定

优先使用公开 facade,避免直接依赖私有模块:

from worldfoundry.evaluation.api import (
    ArtifactRef,
    GenerationRequest,
    GenerationResult,
    Metric,
    WorldModelRunner,
)
from worldfoundry.evaluation.public import WorldFoundryRunRequest, run_worldfoundry
from worldfoundry.evaluation.reporting import build_scorecard
from worldfoundry.core import scaled_dot_product_attention

worldfoundry.core 惰性导出共享 primitive;评测契约在 worldfoundry.evaluation.api,编排在 worldfoundry.evaluation.public,证据构建在 worldfoundry.evaluation.reporting,路径与资产工具在 worldfoundry.runtime.*。

页面如何生成

签名、参数、方法和源码链接在文档构建时由 Python AST 重新生成(不 import Torch/CUDA)。选型说明与示例由人工编写。

cd docs/fumadocs
npm run api:generate
npm run api:check

若需要签名之外的工作流说明,请继续阅读设计文档、推理指南和评测概览。