warterbili/perimeterx_re/skill

Skill: 构建 Node Bridge 补环境

🔝 后手 / 升级路径：**sdenv** — https://github.com/pysunday/sdenv（718⭐, jsdom fork + plugin, 公开补环境 ceiling）

何时切到 sdenv：见 `methodology.md §7`。

用户触发语句

• "给 \<site\> 做一个 node bridge fallback"
• "纯算 \<site\> 跑不通了，搞个 jsdom 补环境"
• "把 ifood 的 bridge 适配到 \<new_site\>"
• "Plan B 接 \<site\>"
• "PX SDK 升级了，纯算先废，给我搭个临时 bridge"

你（AI）要交付什么

node_bridge/<site>/
├── perimeterx/
│   └── <sdk_file>.js              ← 锁定的目标 SDK
├── px-node-env/
│   ├── env/                       ← 11 个 JSDOM 补环境模块（site 特化）
│   └── ...
├── px_node_bridge.js              ← IPC bridge (从 ifood 模板改 SDK path)
├── px_cookie_generator.py         ← Python 协调器 (curl_cffi chrome131)
├── package.json
└── README.md                      ← 本 site 实际跑通命令 + journal

外加：跑通的实测输出（拿到目标 cookie + 业务 API 200 + 完整 journal 入 stample/live_validation/journal/）。

前置 skill 依赖（必读）⭐

本 skill 不是 self-contained。Node bridge = 3 个上游 skill 的有机合成。先读这 3 个：

完整合成关系图见 `methodology.md §0`。

操作流程总览

已有参考资料

三层 fallback 决策（本 skill 在哪一层）

Layer 1: 纯算 (revers/ + stample/<site>/px_cookie/) — 主推
   ↓ 跑不通时
Layer 2: 我们 node_bridge (本 skill 教的)  ← 你在这一层
   ↓ 还跑不通时（碰到 typeof document.all / V8-level Proxy 检测）
Layer 3: sdenv (jsdom fork + plugin) — 后手

详见 `methodology.md §"何时升级到 sdenv"`。

别做的事

• ❌ 不要直接用 `generate_px.js` —— 它是 sourcing-cracked 留下的 standalone 调试版，Node 默认 TLS 会被 PX 识破。必须走 Python 协调器（px_cookie_generator.py）。
• ❌ 不要在 demo 代码里 hardcode 凭据 —— 代理 user/pass / 账号密码全走 env var（参考 stample/grub/px_cookie/business_api_demo.js）。
• ❌ 不要把 `node_modules/` 加进 git —— 用 npm install (package.json 已记录)。
• ❌ 不要试图 mock 全部 browser API —— 不可能也没必要。按 jni-env-patching 4 步法只补 SDK 实际查的。

快速 sanity check（开干前 30 秒）

# 1. 确认目标 site 有锁定 SDK
ls stample/<site>/source/
 
# 2. 确认 ifood 模板能跑（前置）
cd node_bridge/ifood
ls perimeterx/main.min.js
python -c "import curl_cffi; print('OK')"
 
# 3. 确认 cdp-browser skill 可用
which python && python -c "import websockets; print('OK')"
 
# 都 OK → 开干 new_site_guide.md

Skill 时间 2026-05-22 · iFood _px3 已跑通