SuperAPI AI 工具集

maintain-dynamic-plugins

编程与开发

查看项目

更新于 10-16 02:34

技能介绍

用途:维护 NeMo Relay 动态插件相关代码,适用于 plugin.kind = "rust_dynamic"、plugin.kind = "worker",以及 nemo-relay-plugin、nemo-relay-worker、nemo-relay-worker-proto、nemo-relay-types 和 Python nemo-relay-plugin 包。不用于普通内置插件。

主要能力与规则:保持稳定边界明确,原生插件跨 C ABI,worker 插件跨 grpc-v1;不得跨原生动态库边界传递 Rust 运行时类型、trait 对象、future 或分配器持有的字符串。类型化原生中间件 future 运行在 SDK 自有的 Tokio 执行器上,订阅者保持同步并保留原始同步 ABI 注册。需要生成客户端强制字段时,在 protobuf 中定义封闭的 worker 传输结构;开放应用负载用 JsonValue 或 JsonEnvelope 保持无损,而非 google.protobuf.Value。relay-plugin.toml 动态记录与通用运行时组件分开;启用的动态记录可合成内部组件规格,禁用的记录可检查但不加载。Relay 0.8 确立原生 API 1 与 grpc-v1 的 ToolExecutionResult 基线,要求每个动态插件重新构建并声明排除 0.8 之前版本的 compat.relay 范围,推荐 >=0.8.0,<1.0。compat.relay 是插件作者的兼容性断言,不是重建证明,不添加旧版原始结果适配器。Relay 0.8 保留 grpc-v1 标识与 nemo.relay.worker.v1 包但更改工具结果 protobuf 类型,每个 worker 必须重新生成绑定并重建。原生 ABI v4 允许由 struct_size 保护的仅追加宿主表扩展,现有字段偏移冻结;不兼容的原生 JSON、字段重排或替换、不兼容的 worker protobuf 变更必须提升 native_api 或 worker_protocol。不要在 src 下添加测试,Rust 测试放在 crate 的 tests/ 目录,Python SDK 测试放在 python/tests。原生与 worker 插件均为受信任扩展:原生插件在进程内且无沙箱,worker 插件提供进程隔离但非安全沙箱。

检查清单:清单验证覆盖 kind、兼容性、加载契约、完整性、能力不匹配与禁用插件行为;原生加载器在注册回调清除前保持库存活,卸载前注销插件种类;worker 激活覆盖进程启动、令牌认证、握手、验证、声明式注册、代理回滚、取消与关闭;Rust 与 Python SDK 暴露所有支持的注册面;运行时辅助覆盖标记、作用域、延续与隔离作用域栈;plugins list、plugins inspect、plugins validate 报告生命周期与兼容状态且不泄露秘密配置;顶层 doctor 报告解析后的动态插件与宿主配置状态;详细指南将 Rust 原生、Python worker 与 grpc-v1 协议细节分页;justfile、Codecov 与 CI 包/测试工作流包含新插件 crate 与包。

验证:按变更层选择检查。清单或共享类型测试所属 Rust crate;原生加载器或 ABI 准备插件夹具并运行聚焦的原生插件集成测试;worker 协议或宿主测试 worker crate,仅当协议面变化时重新生成或测试 Python worker SDK;共享运行时行为运行 Rust 套件及可观察插件行为变化的绑定套件;文档或打包仅在变更时运行其针对性检查。规范面套件准备插件夹具,运行原始聚焦原生或 worker 集成测试前先执行 just build-test-plugin-fixtures,切勿在单个测试用例内编译夹具。

参考:crates/core/src/plugin/dynamic/、crates/plugin、crates/worker、crates/worker-proto、crates/types、python/plugin、examples/rust-native-plugin、docs/build-plugins、examples/python-grpc-worker-plugin。