findscripter 何时使用
适用：
- 把无服务器函数部署到 Cloudflare 边缘网络，靠近用户降低延迟。
- 接入边缘存储：KV（键值/读多写少）、D1（边缘 SQLite）、R2（对象存储）、Durable Objects（有状态协调、高并发）。
- 在边缘改写请求/响应、注入安全头、做边缘缓存与重定向。
- 用 Cloudflare Pages + Workers 搭建全栈应用。
不该用（负边界）：
- 任务面向传统 Node.js/Express 服务器应用。
- 目标平台是 AWS Lambda 或 Google Cloud Functions（请用对应技能）。
- 不涉及边缘特性的纯前端开发。
步骤 / 指令
- Wrangler 生态：用
wrangler.toml做配置，本地测试用npx wrangler dev。 - Fetch API：Workers 运行在 Web 标准 Fetch API 之上，不存在 Node.js 全局对象；用到
fs/path等需开启 Node.js 兼容模式（compatibility flags）。 - 绑定（Bindings）：所有 KV、D1、密钥等绑定都在
wrangler.toml中声明，并通过fetch处理器的env参数访问，如env.MY_KV_NAMESPACE。 - 冷启动：Workers 是 0ms 冷启动，但要控制打包体积，免费版上限 1MB，不要引入大型库。
- Durable Objects：需要有状态协调、强一致或高并发时使用。
- 非阻塞任务：响应发出后才需执行的日志、分析等异步任务，用
ctx.waitUntil()包裹，避免阻塞响应。
示例
示例 1：带 KV 绑定的基础 Worker（TypeScript）
export interface Env {
MY_KV_NAMESPACE: KVNamespace;
}
export default {
async fetch(
request: Request,
env: Env,
ctx: ExecutionContext,
): Promise<Response> {
const value = await env.MY_KV_NAMESPACE.get("my-key");
if (!value) {
return new Response("Not Found", { status: 404 });
}
return new Response(`Stored Value: ${value}`);
},
};
示例 2：在边缘改写响应、注入安全头（JavaScript）
export default {
async fetch(request, env, ctx) {
const response = await fetch(request);
const newResponse = new Response(response.body, response);
// 在边缘添加安全头
newResponse.headers.set("X-Content-Type-Options", "nosniff");
newResponse.headers.set(
"Content-Security-Policy",
"upgrade-insecure-requests",
);
return newResponse;
},
};
注意事项
最佳实践：
- 用
env.VAR_NAME读取密钥与环境变量。 - 用
Response.redirect()做干净的边缘重定向。 - 用
wrangler tail实时调试生产环境。 - 不要引入大型库；Workers 的内存与 CPU 时间有限。
- 不要直接用
fs、path等 Node.js 专属库，除非开启 Node.js 兼容模式。
排错：
- 问题：请求超出 CPU 时间限制。
- 解决：优化循环、减少
await调用数量、把同步重计算移出请求/响应路径；不阻塞响应的任务交给ctx.waitUntil()。
约束提醒：
- 仅在任务明确落在上述边缘计算范围内时使用本技能。
- 输出不能替代针对具体环境的验证、测试或专家评审。
- 缺少必要输入、权限、安全边界或验收标准时，先停下并询问澄清。
互见
- AWS Lambda / Google Cloud Functions：换用各自平台的 Serverless 技能。
- 传统 Node.js/Express 服务端：换用对应后端技能。
采编自 sickn33/antigravity-awesome-skills（MIT 许可）。