完整实战两例

// 从网址的问号后面取出 key 的值，这里是 "gh"
const key = url.searchParams.get("key");

// 把请求体当纯文本读出来，这里是目标网址
const target = await request.text();

// 两个参数只要缺一个，就回 400（意思是：你参数没给全）
if (!key || !target) {
  return new Response("参数缺失", { status: 400 });
}

// 把这条短链存进 KV 柜子：名字是 key，内容是目标网址
await env.LINKS.put(key, target);

// 回一个 JSON 结果，告诉对方存好了
return Response.json({ ok: true, key });

// 按 key 去 KV 里取出目标网址
const target = await env.LINKS.get(key);

// 读这条短链现在的计数。计数单独存一份，
// 名字是 "count:" 加上 key，比如 "count:gh"
const n = Number(await env.LINKS.get("count:" + key)) || 0;

// 计数加 1 再存回去。注意：KV 里存的全是字符串，
// 所以要用 String() 把数字变回文字再存
await env.LINKS.put("count:" + key, String(n + 1));

// 302 跳转：把访客送到真正的网址去
return Response.redirect(target, 302);

标记 = type=http-response, pattern=^https://api\.example\.com/user, script-path=本脚本, requires-body=true

(function () {
  try {
    // $response 是环境递进来的现场，.body 是响应的正文（一段文字）
    // JSON.parse 把这段文字变成可以改的对象；body 为空时用 "{}" 兜底
    const obj = JSON.parse($response.body || "{}");

    // 给对象加一个自己的字段，当作"我来过"的标记
    obj._patchedBy = "my-module";

    // 如果不是会员（vip 是 false）并且带着试用数据，
    // 就顺手把试用横幅的数据删掉
    if (obj.vip === false && obj.trial) {
      delete obj.trial;
    }

    // 把改好的对象变回文字，交给 $done 交卷，替换掉原来的 body
    $done({ body: JSON.stringify(obj) });
  } catch (e) {
    // 出错了：记一行日志方便排查……
    console.log("[标记脚本] " + e.message);
    // ……然后照样交卷（不带修改），失败放行，永不拦路
    $done();
  }
})();

// 假 KV：一个对象 + get / put 两个方法
const store = {};
const LINKS = {
  get: (k) => (k in store ? store[k] : null), // 取不到回 null，和真 KV 一样
  put: (k, v) => { store[k] = String(v); }    // 存进去的全是字符串
};

// 第一步：存短链 gh → example.com
LINKS.put("gh", "https://example.com");
打印("已存入短链 gh → https://example.com");

// 第二步：访问 gh，跳转并计数
function 访问(key) {
  const target = LINKS.get(key);                          // 取目标网址
  const n = Number(LINKS.get("count:" + key)) || 0;       // 读旧计数，没有就是 0
  LINKS.put("count:" + key, String(n + 1));                // +1 存回去
  打印("跳转到 " + target + "，这是第 " + (n + 1) + " 次访问");
}

访问("gh");  // 第一次：计数 0 → 1
访问("gh");  // 第二次：计数 1 → 2
打印("最后 KV 里存的是：" + JSON.stringify(store));

// 假的现场：$response 是服务器回来的响应
const $response = { body: '{"vip":false,"trial":{"text":"试用"}}' };

// 假的 $done：不真交卷，只把交卷内容记下来给我们看
let 交卷内容 = null;
function $done(result) { 交卷内容 = result || {}; }

打印("改之前：" + $response.body);

// —— 下面就是实战二的脚本逻辑，一字不差 ——
try {
  const obj = JSON.parse($response.body || "{}");  // 文字变对象
  obj._patchedBy = "my-module";                    // 加标记字段
  if (obj.vip === false && obj.trial) {            // 不是会员且有试用数据
    delete obj.trial;                              // 删掉试用横幅数据
  }
  $done({ body: JSON.stringify(obj) });            // 变回文字，交卷
} catch (e) {
  打印("[标记脚本] 出错：" + e.message);
  $done();                                         // 失败也交卷，放行
}

打印("改之后：" + 交卷内容.body);

// 第一次读计数：KV 里没有，get 回来是 null
const 读到的 = null;

打印("get 回来的是：" + 读到的);                    // null
打印("Number(null) 是：" + Number(读到的));         // 0
打印("Number(null) || 0 是：" + (Number(读到的) || 0)); // 0

// 对比一下：已经有计数时，读到的是字符串 "5"
打印('Number("5") || 0 是：' + (Number("5") || 0));  // 5，不受影响