Ginv 搜索词判定工作台

架构：前台与后台彻底分离

• 页面（前台）：只有界面与交互，仓库里没有 Key、没有 Worker 地址、没有暗号，公开也不泄露任何信息
• Worker（后台）：只有你知道地址与暗号，负责转发请求；日志可在 Cloudflare 控制台随时关闭或清空
• Key 只存在于：你的浏览器内存/localStorage 与请求头中，不落任何仓库

准备

• GitHub 账号（github.com 注册）
• Cloudflare 账号（dash.cloudflare.com 注册，免费，无需信用卡）
• 本页对应的 index.html 文件

第 1 步 · GitHub 建仓并上传页面

1. 登录 GitHub → 右上角加号 → New repository
2. 仓库名如 jev-workbench，选择 Private（私有更符合隐私要求，Cloudflare Pages 支持私有仓库且免费）→ Create
3. 页面中间点 uploading an existing file，把 index.html 拖入 → Commit changes

第 2 步 · Cloudflare Pages 上线前台

1. 登录 dash.cloudflare.com → 左侧 Workers & Pages → Create → 切到 Pages 标签 → Connect to Git
2. 选 GitHub → 授权（可只授权刚才这一个仓库）→ 选中仓库 → Begin setup
3. 配置：Project name 自定；Framework preset 选 None；Build command 留空；Build output directory 填 /
4. Save and Deploy，一两分钟后得到你的页面地址：https://项目名.pages.dev
5. 打开该地址能看到本界面即前台完成（此时还不能判定，因为端点未配置）

第 3 步 · 创建 Worker 中转（后台）

1. Workers & Pages → Create → Create Worker → 名字填 jev-proxy → Deploy（先部署默认示例）
2. 点 Edit code，全选删除默认代码，粘贴下面「推荐版」代码
3. 把代码第一行的 REPLACE_WITH_YOUR_SECRET 改成你自己的暗号（一串随意字符，越随机越好）
4. 点右上 Deploy → 记下你的地址：https://jev-proxy.你的子域.workers.dev

const SECRET = "REPLACE_WITH_YOUR_SECRET"; // 改成你自己的暗号
const cors = {
  "Access-Control-Allow-Origin": "*",
  "Access-Control-Allow-Methods": "POST, OPTIONS",
  "Access-Control-Allow-Headers": "Authorization, Content-Type, X-App-Secret",
  "Access-Control-Max-Age": "86400"
};
export default {
  async fetch(request) {
    if (request.method === "OPTIONS") return new Response(null, { status: 204, headers: cors });
    if (request.headers.get("X-App-Secret") !== SECRET) {
      return new Response("forbidden", { status: 403, headers: cors });
    }
    try {
      const url = new URL(request.url);
      const upstream = await fetch("https://api.typesafe.ai" + url.pathname + url.search, {
        method: "POST",
        headers: {
          "Authorization": request.headers.get("Authorization") || "",
          "Content-Type": "application/json"
        },
        body: await request.text()
      });
      const out = new Response(upstream.body, upstream);
      Object.entries(cors).forEach(([k, v]) => out.headers.set(k, v));
      return out;
    } catch (e) {
      return new Response(JSON.stringify({ error: "proxy_error" }),
        { status: 502, headers: { ...cors, "Content-Type": "application/json" } });
    }
  }
};

export default {
  async fetch(request) {
    const cors = {
      "Access-Control-Allow-Origin": "*",
      "Access-Control-Allow-Methods": "POST, OPTIONS",
      "Access-Control-Allow-Headers": "Authorization, Content-Type"
    };
    if (request.method === "OPTIONS") return new Response(null, { status: 204, headers: cors });
    const url = new URL(request.url);
    const upstream = await fetch("https://api.typesafe.ai" + url.pathname + url.search, {
      method: "POST",
      headers: {
        "Authorization": request.headers.get("Authorization") || "",
        "Content-Type": "application/json"
      },
      body: await request.text()
    });
    const out = new Response(upstream.body, upstream);
    Object.entries(cors).forEach(([k, v]) => out.headers.set(k, v));
    return out;
  }
};

第 4 步 · 页面连接后台

1. 打开你的 pages.dev 页面 →「连接与安全」
2. API 端点填：https://jev-proxy.你的子域.workers.dev/v1/systemone（结尾必须带路径）
3. 用了推荐版代码：校验头名称填 X-App-Secret，校验头值填你在 Worker 里设置的暗号
4. 填入 API Key → 点「测试连接」→ 提示连接成功即全链路打通

第 5 步 · 验证隐私（强烈建议做一次）

• 打开 GitHub 仓库：应看不到任何 Key、暗号、Worker 地址
• 页面上按 F12 → Network：判定时只出现对你 Worker 的请求，无其他域名
• F12 → Application → Local Storage：只有你勾选记住的字段；「清除本机全部数据」可一键抹掉
• Worker 不存储任何请求内容；如需彻底静默，可在 Cloudflare 控制台关闭 Workers 日志

第 6 步 · 日常维护

• 改页面：本地改 index.html → GitHub 提交 → Cloudflare Pages 自动重新部署
• 换暗号：Worker 代码里改 SECRET 并重新 Deploy，页面校验头值同步修改
• 公用电脑：不勾「记住 Key」，用完点「清除本机全部数据」

常见部署故障