SuperAPI AI 工具集

sanity-check

测试与质量

查看项目

更新于 10-16 09:50

技能介绍

用途:对已发布的 rivetkit 版本做快速端到端冒烟验证,确认包能正确安装并运行。适用于预览发布后的可用性检查、正式发布后的安装与运行验证,或用户要求“sanity check”“smoke test”“verify the build”。

主要能力:从公共 npm registry 安装 rivetkit、@rivetkit/react 及平台相关的 @rivetkit/rivetkit-napi-* 原生绑定;复制 hello-world 示例,通过 registry.start() 在 6420 端口启动计数器 actor 服务器;HTTP 路径调用 increment(5)、increment(3)、getCount() 并断言结果;WebSocket 路径建立 .connect() 连接,订阅 newCount 事件,调用 increment(10),断言动作响应与广播事件值一致;最后报告解析到的版本。

使用方式:/sanity-check <version> 在主机临时目录运行;/sanity-check docker <version> 在 node:22 Docker 容器内运行;可附加自定义指令(如验证 KV、状态持久化、指定 pnpm 或 node 20)。version 为任意 npm 可解析的版本号、dist-tag 或 pkg-pr-new 预览版本;未提供时需向用户询问。

要求:Node.js 22+ 或 Docker node:22;需本地存在该仓库(仅用于复制 examples/hello-world/src 作为种子,不使用其 node_modules 或工作区链接)。

限制与规则:必须在全新临时目录运行,不得在仓库内执行;必须从公共 npm registry 或 pkg-pr-new 安装,禁用本地工作区链接;rivetkit 与 @rivetkit/react 需锁定用户指定版本;若裸 pkg-pr-new 版本解析失败,改用 https://pkg.pr.new/rivet-dev/rivet/<pkg>@<short-sha> 形式;服务器 30 秒内未就绪则输出最后 2KB 日志后失败;Docker 模式在容器退出后再删除临时目录。资料未提供其他扩展能力的具体实现细节。