软件包
客户端与 Prodantix 通信所需的一切都以软件包形式发布,可从你所用语言的注册表安装。每个包都是开源的,统一版本发布,并使用本手册其余部分描述的同一套 REST 与实时接口。
你需要哪一个
按代码运行的位置来选择,而不是按你想衡量的内容。每个客户端发送相同的事件、评估相同的功能开关,并读取相同的应用内收件箱。
| Package | Registry | Where it runs |
|---|---|---|
| @prodantix/sdk | npm | Browsers, Node, and edge runtimes |
| prodantix_sdk | pub.dev | Flutter and Dart apps |
| prodantix-sdk | PyPI | Python backends |
| @prodantix/react | npm | React apps, over @prodantix/sdk |
| prodantix_sdk_flutter | pub.dev | Flutter apps, over prodantix_sdk |
客户端与适配器
三个客户端承担实际工作,两个适配器为特定框架包装其中之一。适配器不添加自己的能力:它负责框架强加的生命周期,并把下层的客户端交给你。
版本与一致性
这些包统一发布版本,因此同一个版本号在每种语言中代表相同的接口。各客户端的方法名一致,只是服务端客户端在每次调用时都要传入用户 id。
功能开关的分桶由一份黄金向量文件固定,服务端和三个客户端都以它为准做测试,因此无论在哪里判断,用户都会落在灰度发布的同一侧。
它们使用哪些接口
每个客户端都使用 REST。TypeScript SDK 还会打开一个 WebSocket,消息助手正是跑在它上面。MCP 是面向外部智能体的服务端接口,任何客户端包都不使用它。