开发者工具

像 Stripe CLI 一样在本地测试 Webhook

将生产环境的 Webhook 转发到本地，测试 WebSocket 连接，并在不暴露开发服务器的情况下触发异步请求。.

监听模式 Webhook 转发 WebSocket 测试 请求触发

可视化

CLI 工作流

认证、监听 Webhook 并转发到您的本地服务器 —— 无需公网 URL。.

01

登录和配置

使用 API 密钥进行一次性设置

02

CLI 通过 WebSocket 连接

安全通道已建立

03

接收 Webhook 事件

来自生产环境的实时事件

04

转发到本地 (localhost)

http://localhost:3000/webhook

05

您的开发服务器进行处理

在本地测试、调试和迭代

Quick Start
# Install globally
npm install -g @modelriver/cli

# Login (one-time setup)
modelriver login

# Start listening for webhooks
modelriver listen --print

# Or use quick forward
modelriver forward
1

无需公网 URL

像 Stripe CLI 一样 —— 通过 WebSocket 接收 Webhook，无需 ngrok 或隧道。.

2

测试 WebSocket 流程

连接到 WebSocket 通道并接收实时 AI 响应。.

3

触发测试请求

从命令行发送异步 AI 请求并获取通道详情。.

安装

npm 全局

或使用 npx 进行快速测试。.

认证

安全 Token

CLI 的 24 小时 WebSocket Token。.

配置

自动保存

API 密钥和 URL 已保存至配置文件。.

常用命令

ModelRiver listen

通过 WebSocket 接收 Webhook 事件（类似于 stripe listen --print）。.

ModelRiver forward

使用保存的配置进行快速 Webhook 转发。.

ModelRiver websocket

Test WebSocket connections and receive 实时 responses.

ModelRiver trigger

Send 异步 AI requests and get channel details.

使用场景

  • ● 在开发过程中测试 Webhook 集成。.
  • ● 调试 WebSocket 连接和异步流程。.
  • ● 从命令行触发测试 AI 请求。.

独特之处

  • ● 无需公网 URL 或 ngrok 隧道。.
  • ● 内置用于异步工作流的 WebSocket 测试。.
  • ● 交互式登录并保存配置。.

安装和使用

全局安装或使用 npx

# Install globally
npm install -g @modelriver/cli

# Or use npx (no installation)
npx @modelriver/cli listen --print

# Login and configure (one-time)
modelriver login

# Start listening for webhooks
modelriver listen --print

# Test WebSocket connection
modelriver websocket --workflow my-workflow --message "Hello"

# Trigger async request
modelriver trigger --workflow my-workflow --message "Test"

完整命令参考和示例请见 CLI 文档.

在不暴露开发服务器的情况下测试 Webhook

安装 CLI，并在不到一分钟的时间内开始在本地接收生产环境的 Webhook。.

安装 CLI 查看文档