qstash-js
专为无服务器和边缘环境设计的HTTP消息与调度SDK。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：qstash-js。 它的用途是：专为无服务器和边缘环境设计的HTTP消息与调度SDK。 完整的 Skill 内容见：https://321skill.com/skills/qstash-js/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在Next.js的API路由里集成一个功能，用户提交表单后，需要异步调用一个外部API生成报告，这个调用可能耗时较长，并且要确保即使我的服务重启了，报告生成请求也不会丢失。” 它会引导你使用QStash SDK，在表单处理逻辑中调用`client.publishJSON`将报告生成任务发布到QStash，并指定接收报告结果的回调URL。这样，主API可以快速响应，耗时的任务由QStash可靠地调度和执行。
介绍
QStash SDK 解决了在无服务器函数、边缘运行时（如Cloudflare Workers、Next.js Edge）等环境中，因缺少持久化TCP连接而难以实现可靠消息传递和任务调度的问题。它基于纯HTTP协议，将消息发布到QStash服务，由服务保证消息的持久化存储和至少一次投递，即使目标服务暂时不可用也会自动重试。
使用方式非常直接：开发者安装SDK后，使用从Upstash控制台获取的令牌初始化客户端，即可通过简单的API调用发布消息到目标URL或URL组。在接收端，使用配套的Receiver工具验证请求签名，确保消息来源的合法性和完整性。整个过程完全基于HTTP，无需管理消息队列基础设施。
该SDK特别适合前端、后端、全栈开发者在构建运行在无服务器或边缘环境的应用时，需要实现异步任务、延迟作业、事件驱动通信或跨服务调用的场景。例如，在Next.js API路由中触发一个耗时的数据处理任务，或从Cloudflare Worker调度一个定时提醒。
建议在开发阶段启用本地开发模式（设置QSTASH_DEV环境变量），SDK会自动连接本地开发服务器并使用预置的测试凭证，方便进行集成测试。注意，接收消息时需要正确处理HTTP请求头和签名验证，某些部署平台可能对请求头大小写敏感。
核心特点
核心区别在于其100%基于HTTP协议设计，专为无TCP连接能力的Serverless和Edge运行时而生，无需引入复杂的消息队列客户端或维护长连接。同时，它原生集成了对主流LLM提供商（如OpenAI）的调用与调度能力，可直接通过API发布LLM请求并指定回调。
注意事项
不适合需要极低延迟（微秒级）或高吞吐量流式消息处理的传统常驻服务场景。
常见问题
QStash和传统的消息队列（如RabbitMQ、Kafka）有什么区别？
QStash专为Serverless和Edge设计，使用HTTP作为传输协议，无需管理服务器或维护TCP长连接，而传统消息队列通常需要客户端与代理建立持久连接。
如何保证消息不会丢失？
QStash提供至少一次（at-least-once）投递保证。消息发布后会持久化存储，并自动重试投递直到接收方成功响应，因此接收方需要处理消息的幂等性。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/qstash-js/raw/index.md 读取 qstash-js 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/qstash-js/raw/index.md（查看排版版本）