recipes API

完整接口目录 · 合成与挖掘用法 · 工具包下载

模块说明

Load raw recipe evidence for local Python interpretation.

Legacy prepare helpers remain available for persisted operation compatibility.
Neither path crafts items or refreshes inventory.

Recipes

class Recipes

SDK 说明：

Load a local RecipeBook, or prepare deprecated recipe business reads.

Pin continuation pages to the first page's connection_id, revision and
registry_hash so changed item-name projections cannot reuse old references.
References are returned by the catalog; recipe_id is an opaque identifier.
Submit once through Operations and inspect the unchanged terminal receipt.

Recipes.__init__

def __init__(self, operations: Operations)

Recipes.load_book

async def load_book(self, *, page_limit: int=32, max_bytes: int=196608)

SDK 说明：

Load typed raw evidence once, then interpret recipes locally in Python.

The legacy prepare helpers below remain compatible but are deprecated
for new recipe business logic. This path never falls back to them.

Recipes.catalog

def catalog(
    self,
    *,
    offset: int = 0,
    limit: int = 20,
    connection_id: str | None = None,
    revision: int | None = None,
    registry_hash: str | None = None,
    idempotency_key: str,
    deadline: str,
) -> OperationIntent

SDK 说明：

Read one catalog page, preserving its connection and revision binding.

Recipes.by_output

def by_output(
    self,
    output: str,
    *,
    offset: int = 0,
    limit: int = 20,
    connection_id: str | None = None,
    revision: int | None = None,
    registry_hash: str | None = None,
    idempotency_key: str,
    deadline: str,
) -> OperationIntent

SDK 说明：

Read recipes for an output item ID; no local recipe fallback.

Recipes.material_gaps

def material_gaps(
    self,
    reference: dict,
    *,
    crafts: int = 1,
    idempotency_key: str,
    deadline: str,
) -> OperationIntent

SDK 说明：

Compare one observed recipe with inventory; missing evidence stays unknown.