// @mode serverless
// @cors reflective
// @token my-secret-key
return { message: 'Hello!', time: Date.now() };
# 实时地址:
https://proj-cont-exec-1.us1.containers.hoody.com/hello
两种模式。一条注释。
每个脚本选择一种模式。Worker 适用于有状态实时应用,Serverless 适用于隔离的临时执行。一条注释即可切换。
Worker 模式
- 持久 V8 隔离——永久保持热态
- 所有请求共享状态
- 支持 WebSocket
- 首次请求后零冷启动
Serverless 模式
- 每次请求创建新的 V8 隔离
- 完全隔离,无状态泄漏
- 通过 @concurrent 配置并发数
- 适用于 Webhook 和零散流量
所有行为。一行搞定。
在文件顶部加一条注释。无需改动代码,无需配置文件,无需中间件。修改注释——行为立即改变。
执行模式
在持久 Worker VM 与每次请求独立的 Serverless 隔离之间切换,决定状态、WebSocket 和冷启动行为。
CORS 控制
使用 'reflective' 镜像请求来源,使用 '*' 开放所有来源,或指定具体 URL 进行生产锁定。无需任何中间件。
请求超时
设置超时时间(毫秒)。默认 30 秒。使用 0 或 'unlimited' 支持长运行脚本,防止请求失控。
并发上限
仅 Serverless 模式:限制同时执行数。设为 'false' 串行处理——Webhook 有序消费的必备选项。
接口鉴权
使用共享密钥保护任意接口。客户端可通过 Bearer、Basic、X-Token 头或查询参数进行认证,采用恒时比较。
WebSocket 支持
开启实时双向连接,需配合 Worker 模式使用。ws.message、ws.open、ws.close 处理器自动注入。
AI 助手
从 Vercel AI SDK 注入 generateText、streamText、generateObject,无需导入,无需配置 API Key,模型已预配置。
AI 模型选择
Override the default AI model per script. Default: google/gemini-2.5-flash-lite. Supports 300+ models from 15+ providers.
AWS 集成
一条注释在脚本中启用 AWS SDK。直接访问 S3、DynamoDB、Lambda 及任意 AWS 服务。
完整魔法注释参考。
每条注释、每个值、每个默认设置——全部汇聚于此。
设置脚本执行模式。'worker' 创建持久 VM;'serverless'(默认)每次请求创建新的 VM。
语法
从 Webhook 到 WebSocket,分钟级完成。
六种模式,覆盖完整范围——从即时 HTTP API 到实时 AI 代理。
即时 API
完全跳过 Express 配置。创建一个文件——立即成为实时 HTTP 接口。Worker 模式应对高流量,Serverless 模式保障隔离性。
Webhook 接收器
以 Serverless 隔离接收 Stripe、GitHub、Slack Webhook。使用 @concurrent false 串行处理,保证有序消费。
WebSocket 服务器
聊天服务器、实时仪表盘、SSE 流。Worker 模式维护持久连接,共享房间状态。
AI 中间人代理
拦截并控制 AI 请求。在一个脚本中完成安全检查、提示词修改、敏感数据屏蔽和用量追踪。
限速
在 Worker 模式的共享对象中跟踪每 IP 请求数。内存限速无需额外组件。
脚本组合
每个脚本都是 HTTP 接口。通过 fetch() 调用其他脚本,将简单函数组合为微服务——无需消息队列,无需服务发现。
全部 API,集于一处。
脚本执行、管理、验证、模板、路由、监控和魔法注释控制——全部汇聚于一套 API。
监控与魔法 API
8 个接口GET /api/v1/exec/monitor/stats
执行与脚本
7 个接口GET/POST /:path
验证
6 个接口POST /api/v1/exec/validate/script
模板与路由
6 个接口GET /api/v1/exec/templates/list