用途:指导在 nvtripy 中新增神经网络模块(如归一化、注意力、卷积层),实现带可学习参数的 Module 子类,或将现有算子封装为可复用组件。
主要能力:模块位于 nvtripy/frontend/module/,遵循固定模式——可选的独立辅助函数(用 @wrappers.interface 声明约束)实现数学逻辑;模块类为 Module 的 @dataclass 子类,带 @export.public_api 与 @constant_fields。参数使用 DefaultParameter(使用前必须赋值)或 OptionalParameter(可为 None)。Module 基类提供 state_dict()、load_state_dict(state_dict, strict=True)、setattr 校验和 call 调用 forward()。
使用方式:在 nvtripy/frontend/module/ 下创建 <module_name>.py,导入 export、utils、datatype、wrappers、Module、DefaultParameter/OptionalParameter、Tensor、constant_fields、op_utils 等;用 @constant_fields 标记 dtype、normalized_shape、quant_dtype 等编译期常量;init 调用 super().init() 并设置参数;实现 forward();补充含数学记号和可运行示例的文档字符串;在 nvtripy/frontend/module/init.py 中导入注册,模块即可通过 tp.MyLayer(...) 访问;在 tests/frontend/module/ 添加测试。
适用场景:新增层、封装算子、实现带权重的模块。
限制:资料未提供具体版本要求、性能数据或收费信息;DefaultParameter 必须在运行前替换为真实数据,@constant_fields 标记的字段会被固化进编译图、运行时不可更改。