内部实现

本页面面向维护者。普通用户优先阅读公开 API 文档。

运行时模型

每次调用操作函数都会创建内部节点，节点保存：

• 父依赖
• 操作标识
• 可序列化配置
• 名称和元数据
• 执行后的缓存输出

公开的 Graph 是这条惰性节点链的用户侧包装。

执行

Graph.compute() 创建执行运行时并递归求值依赖。在一次执行中，共享上游节点只会计算一次。运行时会在多输入组合前验证 domain 兼容性，把操作函数应用到 pandas frame，再把结果包装成 Panel。

动态资产池掩码会在衍生结果上重新应用，避免非成员资产影响后续计算。

哈希与缓存

Panel 和操作规格参与确定性缓存键。当前缓存仅在单次执行中存在。持久缓存、增量失效和并行调度是未来扩展。

操作注册表

内置操作模块使用与用户相同的 transformer 和 composer 装饰器。参考文档由导出的操作目录生成：

uv run python scripts/generate_operator_reference.py

新增、删除或修改操作元数据后，应重新生成参考文档。