Back to search
hello-js-reverse-skill
SkillWorks with Claude CodeGitHub
通用 Web API 采集与前端签名问题的方法论。只要任务涉及抓接口或写 Node/Python 协议程序、sign/token/动态 Cookie/自定义头、 本地生成的值服务端不认、HTTP 200 却是业务错误或空数据、浏览器能过本地不过、SDK 或接口改版失效、 混淆/JSVMP/WASM/补环境/Hook/插桩、参数跟踪与版本归档,就使用本 Skill,即使用户没有提到“逆向”。 配套 Camoufox MCP 取证,交付可验证的采集程序,支持分页、断点续采和改版回归。 仅用于自有或已授权接口;微信小程序 wxapkg 解包使用对应小程序技能。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/whitenightshadow--hello-js-reverse-skill)HTML
<a href="/listings/whitenightshadow--hello-js-reverse-skill"><img src="/api/listings/whitenightshadow--hello-js-reverse-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 155 lines
- ---
- name: hello-js-reverse-skill
- description: >
- 通用 Web API 采集与前端签名问题的方法论。只要任务涉及抓接口或写 Node/Python 协议程序、sign/token/动态 Cookie/自定义头、
- 本地生成的值服务端不认、HTTP 200 却是业务错误或空数据、浏览器能过本地不过、SDK 或接口改版失效、
- 混淆/JSVMP/WASM/补环境/Hook/插桩、参数跟踪与版本归档,就使用本 Skill,即使用户没有提到“逆向”。
- 配套 Camoufox MCP 取证,交付可验证的采集程序,支持分页、断点续采和改版回归。
- 仅用于自有或已授权接口;微信小程序 wxapkg 解包使用对应小程序技能。
- metadata:
- version: "3.15.0"
- mcp-compatible: "1.8.0(旧工作流兼容 1.6.x / 1.7.x;新参数需对应工具 schema;hook_jsvmp_interpreter 需 1.9.3;tap_stage_calls 需 1.9.4;rewrite_source、日志切片、环境包导出需 1.10.0;rdp_debugger 原生断点需 1.11.0+)"
- ---
- # 通用采集与签名分析
- 本 Skill 是方法论,回答三件事:问题在哪一层、走哪条链路、做到什么证据才算收口。
- 它不记录站点规则。域名、接口路径、字段、算法、错误码和 SDK 行为都来自当前目标。`cases/` 里的经验只是待验证的候选假设,换站点、换接口、换版本甚至换一天都可能不成立。`camoufox-reverse-mcp` 提供浏览器取证工具,同样不写站点特例。方法不绑定工具,换用其他浏览器或抓包工具时判断顺序不变。
- ## 启动与任务范围
- **首次任务检查一次,继续操作复用,相关状态变化时只复查受影响项。** 规则见 [任务级检查](references/task-preflight.md)。
- 1. **按任务选路径**:代码维护和离线验签检查运行时与已有样本;普通采集确认鉴权、业务成功条件和分页;浏览器分析首次调用 `check_environment()`,并读 [浏览器取证契约](references/browser-evidence-contract.md)。不用浏览器的任务不必过浏览器门槛。
- 2. **复用证据**:先读需求工作区已有代码、任务记录与 `project-manifest.json`。遇到相应逆向特征时才查 [cases](cases/README.md),命中后验证当前适用性。
- 3. **状态变化再重查**:浏览器重启或断连查环境与当前页;导航或 Frame 变化只查页面;SDK 或鉴权变化查相关基线和样本。`has_residuals` 可能是当前证据,不自动 reset。
- 4. **交付约定延续**:默认独立 Node.js/Python 协议程序,沿用用户已确认的字段、分页、鉴权和输出。用户明确要求页面自动化时可交付浏览器程序并声明依赖。
- 用户已提供的授权与偏好持续有效。沿现有实现完成当前需求,仅在缺少关键登录态、访问条件或无法推断的业务约定时请求必要信息。仓库发布按当前用户授权执行,Skill 自身不扩大授权。
- ## 先定义成功,再定位失败
- 成功分四层,下层推不出上层:
- | 层级 | 含义 | 不算数的证据 |
- |---|---|---|
- | S1 能生成 | 本地产物结构合法 | 能跑出一个值 |
- | S2 被接受 | 服务端没有拒绝 | HTTP 200 |
- | S3 命中目标 | 响应正是请求的那份数据 | 响应非空 |
- | S4 可持续 | 多目标、连续、续期、跨天都成立 | 单条成功、离线等价 |
- 失败分六层:传输、会话、请求形态、动态值、运行环境、服务端策略。403、空数据、错误码都可能来自任何一层,现象不定层,对照实验才定层。详见 [问题路由](references/problem-routing.md)。
- ## 问题路由
- 先按现象找到这一行,避开“先别下的结论”,再做第一步。
- | 现象 | 先别下的结论 | 第一步 | 链路 |
- |---|---|---|---|
- | 只要数据,接口看起来没有签名 | 需要逆向 | 确认鉴权、业务成功条件和分页 | [通用采集](references/general-collection.md) |
- | 带 sign、token 或自定义头,还没动手 | 这个参数一定要算 | 重放成功请求,再按组删减 | [链路 A](references/problem-routing.md#链路-a这个参数到底要不要算) |
- | 别的接口或别的端需要某个头 | 这里也需要 | 按本接口单独验证,多发也可能被拒 | [链路 A](references/problem-routing.md#链路-a这个参数到底要不要算) |
- | HTTP 200 里是错误码、空数据或错误页 | 签名或环境错了 | 读业务码,对比同期成功样本 | [链路 B](references/problem-routing.md#链路-b服务端拒绝) |
- | 本地值结构合法但被拒 | 算法错了 | 恢复控制组,做来源替换 | [链路 B](references/problem-routing.md#链路-b服务端拒绝) |
- | 控制组也失败 | 候选失败了 | 停止归因,先恢复基线 | [控制组失效](references/controlled-experiments.md#控制组失效) |
- | 超时、连接失败、没发出去 | 被拒绝了 | 单独分类,确认实际尝试次数 | [结果分类](references/controlled-experiments.md#结果分类) |
- | 改了一项没变化 | 这一项无关 | 可能两道闸门并联,做交叉矩阵 | [交叉矩阵](references/controlled-experiments.md#单变量没有翻转时) |
- | 同一构造时好时坏 | 修好了或坏了 | 开稳定性批次,报成功数和翻转数 | [稳定性批次](references/controlled-experiments.md#结果时好时坏) |
- | 浏览器能过,本地同样的头不过 | TLS 指纹 | 先排除已用值和会话,再做传输对照 | [链路 C](references/problem-routing.md#链路-c浏览器能过本地同样的头不过) |
- | 之前能用,现在不行 | 代码坏了 | 比对 SDK 哈希,从最后成功基线回归 | [链路 D](references/problem-routing.md#链路-d之前能用现在不行) |
- | SDK 本地报错 | 补上报错这一项就好 | 沿调用链找真实缺口 | [链路 F](references/problem-routing.md#链路-fsdk-在本地跑不起来) |
- | SDK 能跑,值不被接受 | 再多补些环境 | 做读值差异,查首次读取缓存 | [链路 E](references/problem-routing.md#链路-e本地值能生成但不被接受) |
- | 固定输入下值和浏览器不同 | 算法全错 | 逐环节找首个偏差 | [签名值不一致](references/troubleshooting.md#签名值不一致排查) |
- | 值带随机掩码,无法逐字比较 | 无从下手 | 分批采样,分析信封和结构 | [不透明令牌](references/opaque-token-analysis.md) |
- | 混淆或 VM 挡住定位 | 一定要读懂 | 先问是否需要读懂,再定 I/O 边界 | [链路 G](references/problem-routing.md#链路-g混淆或-vm-挡住定位) |
- | 响应加密、WASM、WebSocket、字体映射 | 通用手段都能解 | 按对应场景取证 | [场景配方](references/analysis-scenarios.md) |
- | 动态 Cookie 来源不明 | 是 JS 写的 | 同时看 Set-Cookie 和 JS 写入 | [Cookie 归因](references/analysis-scenarios.md#cookie-归因分析) |
- | 首屏挑战、反调试 | 先装 Hook | 首次不加 Hook,先看响应链 | [反调试](references/anti-debug.md) |
- | Hook 没日志、插桩后行为变了 | 目标没执行或有检测 | 查 world、Frame、覆盖,比较原始与插桩 | [链路 I](references/problem-routing.md#链路-i观测本身有问题) |
- | 单条成功,批量失败 | 算法不稳 | 看失败与次数、时间、账号的相关性 | [链路 H](references/problem-routing.md#链路-h单条成功批量失败) |
- | 429、验证页、账号受限 | 换个身份继续 | 停止当批,确定影响范围,恢复后用原目标复验 | [链路 K](references/problem-routing.md#链路-k频控验证或账号受限) |
- | 单条耗时不符合预期 | 接口慢 | 拆开调度、初始化、出值、网络 | [链路 J](references/problem-routing.md#链路-j慢) |
- | 要持续跟踪参数或版本 | 记一份结论就够 | 分开记录版本身份,结论带范围 | [参数跟踪](references/version-tracking.md) |
- ## 路线选择
- **诊断从重到轻,交付从轻到重。** 诊断时先用最接近真实的路径证明此刻做得成,再一次拿掉一个依赖,第一个让结果变坏的依赖就是问题所在。交付时选能成立的依赖最少的路线。
- | 路线 | 做法 | 上移的信号 |
- |---|---|---|
- | R0 不生成 | 接口不校验这一项,直接不发 | 换接口或换日期复验失败 |
- | R1 纯算法 | Node/Python 库复现 | 算法依赖闭包状态或环境 |
- | R2 片段执行 | 提取函数放进 vm/execjs | 依赖 DOM、存储或大量全局状态 |
- | R3 补环境 | jsdom/vm 运行 SDK,按读值补齐 | 补丁不收敛,或静态值对齐后仍被拒 |
- | R4 浏览器级运行时 | 真实引擎运行原始 SDK | 所需状态只存在于真实长驻页面 |
- | R5 页面出值、本地发送 | 页面生成未使用的值,本地 HTTP 发送 | 传输确实绑定页面 |
- | R6 页面内请求 | 请求由页面自身发出,需用户接受此依赖 | 无 |
- 不必为了还原算法而还原,目标是取得可用的值。R4、R5 仍依赖外部提供会话,不能写成“无浏览器”。详见 [路线阶梯](references/problem-routing.md#路线阶梯)、[原始 SDK 运行](references/original-sdk-runtime.md)、[签名来源隔离](references/signature-source-isolation.md)。
- ## 在线实验的纪律
- 在线请求会消耗账号额度、一次性值和风控状态,所以用尽量少的请求排除假设。完整方法见 [对照实验](references/controlled-experiments.md)。
- - **先有控制组**。真实路径此刻成立,候选的结果才有意义。控制组失败时停止归因,不写“候选失败”。
- - **发送前过门禁**。版本一致、凭据余量够、值未用过、输入成套,不满足就不发。
- - **单变量要回读**。用实际发出的请求核对只改了声称的变量,再写结论,脚本意图不算数。
- - **单变量没翻转不等于无关**。可能两道闸门并联,用交叉矩阵确认后才能排除。
- - **测量手段先过对照**。工具没看到差异,要先证明它看得见。
- - **结果分类不合并**。`not_sent`、`transport_error`、`rejected`、`accepted`、`target_ok` 分开记录,超时不是拒绝,未发送不是失败。
- - **遇拒绝停止当批**。继续前要能说清这次和上次差在哪、预期是什么,不用重试或加速碰运气。
- - **结论带范围和强度**。写明接口、版本、日期,用观察、支持、排除、证明表达强度。避免“唯一”“必须”“硬墙”。
- - **组合成功不等于单项根因**。要归因到某一项需要消融,业务不需要时可以不做,但不能那样写。
- - **写错了就纠偏**。原始证据不动,在结论处加日期化说明,并写清哪些结论不受影响。
- `scripts/experiment-ledger.py` 提供门禁、台账和回读核对。
- ## 通用采集
- 普通 JSON API 不必进入逆向流程,先读 [general-collection.md](references/general-collection.md)。
- - `templates/python-request/collect.py` 是可运行的通用入口,`utils/collector.py` 可接入自定义签名与鉴权回调,支持去重、JSONL 和断点恢复。核心只用标准库;有依赖限制时配 urllib 回调即可。
- - 空中间页、显式 has_more、临时重复游标、业务重试与页数限制按接口契约启用,默认行为保持兼容。模板不是无需适配的全站方案。
- - 每次请求现算动态签名。凭据来自用户配置、合法登录态或协议刷新过程,不把一次抓取的临时 Cookie 写死到公共模板。
- - 默认重试只用于 GET/HEAD/OPTIONS。POST 等请求发生不确定失败时,先确认幂等条件再重放。
- ## 验证、交付与改版
- - 验收按任务类型选择:采集和 API 签名任务用代表性新输入、分页、结束和失败路径验证(建议至少 5 次,遵循用户约定并记录实际数量);WASM 和脚本取证验证来源、完整字节、哈希和真实调用;代码维护运行相关回归。不要为了统一清单制造无关请求或额外项目。
- - 单条通过、离线等价、多目标、连续、续期、跨天分别标状态,未运行的不得宣称通过。模板 `npm test` 与 `python test.py` 是离线组件测试,不能替代任务验收。
- - 交付程序、配置说明、数据样本、验证结果和已知限制。协议模式最终运行不依赖浏览器;依赖外部会话时写清谁提供、谁续期。无法完成时记录事实、已尝试路径与剩余依赖,不伪造签名或成功响应。
- - 收口时写五项:到达层级、当前路线与外部依赖、适用范围、结论强度、失效条件。格式见 [收口格式](references/problem-routing.md#收口格式)。
- - 用 `scripts/project-baseline.py` 记录 SDK、签名代码和脱敏 fixture 的哈希与版本身份,改版时先 `check` 定位差异。哈希未变不代表接口行为未变,仍需回归。
- - 新发现先记录在需求工作区。一条经验只有在不依赖站点时才进入 `references/`:能在不同体系上成立,或能用公开样本复现。否则按 [cases/_template.md](cases/_template.md) 脱敏留在案例里,标明版本、日期和验证边界。不把登录态、真实密钥或私有请求样本提交到公共仓库。
- ## 按需参考
- | 当前需要 | 参考 |
- |---|---|
- | 完整链路、路线阶梯、收口格式 | [problem-routing.md](references/problem-routing.md) |
- | 实验设计、门禁、归因 | [controlled-experiments.md](references/controlled-experiments.md) |
- | 未使用的值、绑定、新鲜度 | [signature-source-isolation.md](references/signature-source-isolation.md) |
- | 运行原始 SDK、状态回放、生命周期 | [original-sdk-runtime.md](references/original-sdk-runtime.md) |
- | 令牌信封与版式 | [opaque-token-analysis.md](references/opaque-token-analysis.md) |
- | 版本身份、结论范围、归档 | [version-tracking.md](references/version-tracking.md) |
- | 浏览器抓包、Hook、插桩、原生断点与追踪的证据边界 | [browser-evidence-contract.md](references/browser-evidence-contract.md) |
- | 首检复用与状态失效重查 | [task-preflight.md](references/task-preflight.md) |
- | 通用采集、恢复、自定义签名与基线 | [general-collection.md](references/general-collection.md) |
- | 工具参数和兼容边界 | [mcp-tool-reference.md](references/mcp-tool-reference.md) |
- | 深度分析阶段 | [phase-details.md](references/phase-details.md) |
- | JSVMP 路径 A / B、源码插桩 | [path-a-four-tools.md](references/path-a-four-tools.md) / [path-b-env-emulation.md](references/path-b-env-emulation.md) / [jsvmp-source-instrumentation.md](references/jsvmp-source-instrumentation.md) |
- | 环境补丁与 UA 一致性 | [jsdom-env-patches.md](references/jsdom-env-patches.md) |
- | 反混淆改写的语义验证 | [transform-validation.md](references/transform-validation.md) |
- | 传输层与协议问题 | [protocol-analysis.md](references/protocol-analysis.md) |
- | 具体场景与常见误判 | [analysis-scenarios.md](references/analysis-scenarios.md) / [common-pitfalls.md](references/common-pitfalls.md) / [troubleshooting.md](references/troubleshooting.md) |
- | 公开样本的本地实战 | [real-source-cases.md](references/real-source-cases.md) |
- | 维护 Skill/MCP 的独立 Agent 评测 | [agent-validation.md](references/agent-validation.md) |
- ## 更新记录
- - v3.15.0(2026-11-18):新增 jsdom 子 Realm 原型链与 `toString` 修补、实例/原型属性描述符对齐、`Document.prototype.all` 引擎级 undetectable 活性集合补丁,以及在线改写路由残留核查、定长码点流逐槽反解与同侧 A/A 自抖动槽过滤方法及脱敏案例;工具快照同步至 MCP v1.11.1。
- - v3.14.0(2026-11-15):配合 MCP v1.11.0 补充原生断点调试(如 `rdp_debugger`)的独立观察会话与时序证据边界,同步 42 个工具快照;补充等长流式护甲、固定密文前缀与粗粒度布尔判决分层锁死的方法判断及脱敏案例。
- - v3.13.0(2026-11-12):配合 MCP v1.10.0:插桩默认只记读取、大文件阈值和跳过原因、按 `seq`/`stage` 切片、`rewrite_source` 离线插桩、preset 改装主世界;新增 `templates/env-bundle/`,把 `compare_env` 导出的环境包套到 jsdom;MCP 工具快照更新到 v1.10.0。
- - v3.12.0(2026-11-10):新增平坦化分发的阶段对照,用 MCP v1.9.4 的 `tap_stage_calls` 记录浏览器和本地补环境的状态序列,找第一个分叉的状态;MCP 工具快照更新到 v1.9.4。
- - 历史版本与详细差异见 Git tags / Releases。模板目录和引用路径保持不变,避免已有引用失效。
README.md · README · 301 lines
- # JS 逆向分析 Skill
- 面向 Web API 采集、前端签名分析与改版回归的方法论 Skill。它回答三件事:问题在哪一层、走哪条链路、做到什么证据才算收口。站点规则不进主干,只作为待验证的案例留在 `cases/`。
- 配套 [Camoufox MCP](https://github.com/WhiteNightShadow/camoufox-reverse-mcp) 捕获网络、定位源码和调试 Hook,交付可验证的采集程序。
- ## 核心能力
- - **问题路由**:按现象定位失败层,给出第一步、对应链路和收口标准
- - **对照实验**:控制组、来源替换、单变量回读、结果分类、结论强度
- - **签名来源隔离**:取得未使用的值,拆开出值、会话和传输,验证绑定关系与新鲜度
- - **原始 SDK 运行**:入口定位、状态回放、生命周期与读值差异,不必还原内部算法
- - **不透明令牌分析**:信封、掩码、版式和批次对比
- - **参数跟踪**:版本身份分开记录,结论带范围,换版有回归路径
- - **双语言算法还原**:Node.js (`crypto` / `crypto-js`) 与 Python (`hashlib` / `pycryptodome`) 双路径实现
- - **JS 混淆与 JSVMP**:OB 混淆、控制流平坦化、eval 打包、自定义 VM 的分析策略,实际有效性按目标样本验证
- - **Cookie 归因**:分清 HTTP Set-Cookie 与 JS 写入
- - **WASM 逆向**:WebAssembly 模块的加载、环境补全和调用
- - **协议层诊断**:用对照实验确认 TLS、HTTP/2、频率限制是否真的是原因
- - **通用采集**:分页、去重、JSONL、断点恢复
- ## 快速使用
- ### 方式一:AI 对话框直接安装(推荐)
- 在你的 AI 编码工具(Cursor / Claude Code / codex 等)的对话框中输入:
- ```
- 帮我安装下这个skill:hello-js-reverse-skill
- 项目地址:https://github.com/WhiteNightShadow/hello_js_reverse_skill
- 安装目录名:hello-js-reverse-skill
- ```
- AI 会自动完成下载、配置,并在后续 JS 逆向相关任务中自动调用该 Skill。
- ### 方式二:手动安装
- 将本仓库克隆到对应 AI 工具的 skills 目录下:
- **Cursor:**
- ```bash
- git clone https://github.com/WhiteNightShadow/hello_js_reverse_skill.git ~/.cursor/skills/hello-js-reverse-skill
- ```
- **Codex:**
- ```bash
- git clone https://github.com/WhiteNightShadow/hello_js_reverse_skill.git ~/.codex/skills/hello-js-reverse-skill
- ```
- **VSCode(Copilot / Cline 等插件):**
- ```bash
- git clone https://github.com/WhiteNightShadow/hello_js_reverse_skill.git ~/.vscode/skills/hello-js-reverse-skill
- ```
- > 目录名需与 `SKILL.md` 里的 `name` 一致,都是 `hello-js-reverse-skill`;仓库名仍是 `hello_js_reverse_skill`,所以克隆时要写明目录名。v3.10.0 及更早版本装在 `hello_js_reverse_skill` 目录的,更新后把目录改名为 `hello-js-reverse-skill`。
- >
- > 安装完成后,AI Agent 会自动读取 `SKILL.md`。当你在对话中涉及接口采集、签名分析、动态 Cookie、混淆 JS、WASM 或浏览器环境调试等场景时,Skill 会自动激活。
- ## 项目结构
- ```
- hello-js-reverse-skill/
- ├── SKILL.md # 技能入口:成功分层、问题路由、路线选择、实验纪律
- ├── README.md
- │
- ├── references/ # 按需读取
- │ ├── problem-routing.md # 主干:完整链路、路线阶梯、收口格式
- │ ├── controlled-experiments.md # 对照实验与归因
- │ ├── signature-source-isolation.md # 未使用的值、绑定、新鲜度
- │ ├── original-sdk-runtime.md # 原始 SDK 运行、状态回放、生命周期
- │ ├── opaque-token-analysis.md # 令牌信封与版式
- │ ├── version-tracking.md # 参数跟踪与版本归档
- │ ├── browser-evidence-contract.md # 抓包、Hook、插桩、原生追踪的证据边界
- │ ├── task-preflight.md # 任务级检查与失效重查
- │ ├── general-collection.md # 通用采集、恢复与基线
- │ ├── phase-details.md # 深度分析操作清单
- │ ├── analysis-scenarios.md # 专项场景配方
- │ ├── path-a-four-tools.md # JSVMP 算法追踪
- │ ├── path-b-env-emulation.md # JSVMP 环境复现
- │ ├── jsvmp-analysis.md / jsvmp-source-instrumentation.md
- │ ├── jsdom-env-patches.md / environment-patch.md
- │ ├── crypto-patterns.md / obfuscation-guide.md / transform-validation.md
- │ ├── hook-techniques.md / anti-debug.md / protocol-analysis.md
- │ ├── common-pitfalls.md / troubleshooting.md
- │ ├── mcp-tool-reference.md / mcp-tools.json
- │ └── agent-validation.md / real-source-cases.md
- │
- ├── cases/ # 站点案例,唯一可以出现站点名的地方
- ├── evals/ # 方法层的行为回归场景,全部虚构
- ├── docs/ # 版本说明与公开方案调研
- │
- ├── scripts/
- │ ├── experiment-ledger.py # 在线门禁、尝试台账、单变量回读
- │ ├── opaque-token-inspect.py # 令牌批次结构分析
- │ ├── project-baseline.py # SDK/签名代码/fixture 哈希与版本身份
- │ ├── check-deps.py / check-mcp-contract.py
- │ ├── crypto-identifier.js / hook-generator.js / sandbox-runner.js
- │ └── real_cases/ # 真实开源案例的准备与验证
- │
- ├── templates/
- │ ├── python-request/ / node-request/ # R1 纯算法
- │ ├── vm-sandbox/ # R2 片段执行
- │ ├── wasm-loader/ # WASM
- │ ├── browser-auto/ # R6 浏览器自动化
- │ ├── env-bundle/ # 浏览器环境包套到 jsdom
- │ └── param-tracking/ # 参数跟踪与实验单模板
- │
- └── examples/demo-analysis.md
- ```
- ## 快速开始
- ### 1. 环境检查
- ```bash
- bash scripts/check-deps.sh
- ```
- ### 2. 作为 Cursor Skill 使用
- 将本目录以 `hello-js-reverse-skill` 为名放置到 `.cursor/skills/` 下,AI Agent 会自动读取 `SKILL.md` 获取逆向分析能力。
- ### 3. 工具脚本
- **加密算法识别**:
- ```bash
- node scripts/crypto-identifier.js "e10adc3949ba59abbe56e057f20f883e"
- ```
- **生成 Hook 代码**:
- ```bash
- node scripts/hook-generator.js --type=cookie
- node scripts/hook-generator.js --type=xhr --target="/api/data"
- node scripts/hook-generator.js --type=all
- ```
- **VM 沙箱执行**:
- ```bash
- node scripts/sandbox-runner.js obfuscated.js --extract-cookie --verbose
- ```
- **令牌批次结构分析**:
- ```bash
- python scripts/opaque-token-inspect.py samples.txt --encoding base64 --xor-align
- ```
- **在线门禁与单变量回读**:
- ```bash
- python scripts/experiment-ledger.py gate --ledger runs/ledger.jsonl --batch b1 --budget 3
- python scripts/experiment-ledger.py audit --base a.json --candidate b.json --allow x-sign
- ```
- ### 4. 使用项目模板
- 根据分析结果选择合适的模板:
- | 场景 | 语言 | 模板 | 何时使用 |
- |------|------|------|---------|
- | 标准加密算法 | Node.js | `templates/node-request/` | 加密可用 crypto 库还原 |
- | 标准加密算法 | Python | `templates/python-request/` | 加密可用 hashlib/pycryptodome 还原 |
- | 动态 Cookie | Node.js | `templates/vm-sandbox/` | 服务端返回 JS 生成 Cookie |
- | WASM 加密 | Node.js | `templates/wasm-loader/` | 加密在 .wasm 中实现 |
- | TLS/环境依赖 | Node.js | `templates/browser-auto/` | 无法脱离浏览器环境 |
- | 环境对齐 | Node.js | `templates/env-bundle/` | 把 `compare_env(output_path=...)` 导出的环境包套到 jsdom(MCP v1.10.0) |
- **Node.js 项目:**
- ```bash
- cp -r templates/node-request/ my_project/
- cd my_project && npm install
- # 修改 main.js 中的配置和加密逻辑
- node main.js
- ```
- **Python 项目:**
- ```bash
- cp -r templates/python-request/ my_project/
- cd my_project && pip install -r requirements.txt
- # 修改 main.py 中的配置和 utils/sign.py 中的签名逻辑
- python main.py
- ```
- ## MCP 工具集成
- 本 Skill 围绕 [`camoufox-reverse` MCP](https://github.com/WhiteNightShadow/camoufox-reverse-mcp) 服务器组织能力(Camoufox 反检测浏览器与统一 API):
- - 源码级插桩 `instrumentation(action='install', mode="ast")` — MCP 侧 esprima 实现,挑战页可用
- - 低干扰观察 `hook_jsvmp_interpreter(mode="transparent")` — 仅替换 prototype getter,日志在页面主世界
- - Cookie 归因 — `network_capture` 与 Cookie Hook 配合,区分 Set-Cookie 与 document.cookie
- - 响应链追踪 `navigate` 返回 `redirect_chain`/`final_status`,首次不加 Hook 先看响应链
- | 核心工具 | 用途 |
- |---------|------|
- | `launch_browser` / `navigate` | 启动反检测浏览器并导航到目标页面 |
- | `search_code(keyword, script_url=None)` | 在所有/指定 JS 中搜索关键词 |
- | `scripts(action='list'\|'get'\|'save')` | 列出/获取/保存脚本 |
- | `evaluate_js(..., world='isolated'\|'main')` | 执行 JS;默认隔离上下文保持兼容,可显式进入页面主世界并按 Frame 定位 |
- | `hook_function(mode='intercept'\|'trace')` | 自定义 Hook / 函数追踪;可选择主世界与 Frame,跨导航或有界等待动态挂载需设置 `persistent=True` |
- | `get_trace_data` | 读取或清理函数 Trace,可按 world 与 Frame 过滤 |
- | `inject_hook_preset` | 一键预设 Hook(xhr/fetch/crypto/websocket/debugger_bypass/cookie/runtime_probe);MCP v1.10.0 起装在页面主世界,日志用 `world='main'` 读 |
- | `hook_jsvmp_interpreter` | 一键插桩 JSVMP 解释器(proxy / transparent 两种模式) |
- | `instrumentation(action='install'\|'log'\|'stop'\|'reload'\|'rewrite_source')` | 源码级插桩:HTTP 层改写 VMP + 日志 + 重载;`tap_stage_calls` 按状态记录平坦化分发(MCP v1.9.4);日志按 `seq`/`stage` 切片、`rewrite_source` 离线改写本地源码(MCP v1.10.0) |
- | `network_capture(action='start'\|'stop')` | 网络捕获(支持 capture_body) |
- | `list_network_requests` / `get_network_request` | 列出/获取捕获的请求 |
- | `get_request_initiator` | 获取发起请求的 JS 调用栈(黄金路径) |
- | `intercept_request` | 拦截/修改/Mock 网络请求 |
- | `cookies(action='get'\|'set'\|'delete')` | Cookie 管理 |
- | `compare_env` | 采集 JS 环境基线;其他属性需通过 `properties` 或分批 `evaluate_js` 扩展;MCP v1.10.0 起 `output_path` 导出完整环境包 |
- | `trace_property_access(action=...)` | reverse.5 的 77 点 Gecko 原生追踪(旧兼容构建为 75 点);支持 start→操作→stop、kind/site 过滤和覆盖边界 |
- | `rdp_debugger(action=...)` | Firefox 原生 RDP 断点调试:真断点、单步、调用栈、词法作用域、暂停帧求值与 `xhr_breakpoint` 发包前断点(独立观察会话,MCP v1.11.0) |
- | `verify_signer_offline` | 用真实样本离线验证签名代码 |
- | `export_state` / `import_state` | 保存/恢复浏览器状态 |
- | `check_environment` / `reset_browser_state` | 环境自检 / 清理残留状态 |
- 证据边界见 [浏览器取证契约](references/browser-evidence-contract.md),场景配方见 [analysis-scenarios.md](references/analysis-scenarios.md)。
- ## 逆向场景覆盖
- | 场景 | 技术点 | 参考文档 |
- |------|--------|---------|
- | 请求参数签名 | MD5/HMAC/自定义哈希 | `crypto-patterns.md` |
- | 动态 Cookie | eval首包/api预热/指纹Cookie | `hook-techniques.md` |
- | 响应数据加密 | AES/DES/RC4解密 | `crypto-patterns.md` |
- | OB混淆 | 字符串还原/CFF/变量重命名 | `obfuscation-guide.md` |
- | **JSVMP 虚拟机保护** | **Hook/插桩/日志分析三板斧** | **`jsvmp-analysis.md`** |
- | 自定义VM | I/O追踪/Hook解释器 | `obfuscation-guide.md` |
- | WASM加密 | 加载/环境补全/导出函数调用 | `environment-patch.md` |
- | 疑似 TLS 指纹 | 传输层诊断实验/curl_cffi | `protocol-analysis.md` |
- | HTTP/2 | Node.js http2模块/Python httpx | `protocol-analysis.md` |
- | 字体反爬 | 字体文件解析/CMAP映射 | `analysis-scenarios.md` |
- | WebSocket | WS消息分析/协议解析 | `analysis-scenarios.md` |
- | 反调试 | debugger绕过/检测对抗 | `anti-debug.md` |
- | 环境检测 | webdriver/蜜罐/指纹 | `environment-patch.md` |
- | 首屏挑战 | 响应链观察/低干扰观测 | `analysis-scenarios.md` |
- | **请求失败排查** | **Cookie/Header/时间戳/签名对比** | **`troubleshooting.md`** |
- | **通用 JSVMP 源码级插桩** | **HTTP 层源码改写 + hot_keys 指纹学习法** | **`jsvmp-source-instrumentation.md`** |
- | **Cookie 归因分析** | **HTTP Set-Cookie vs JS document.cookie** | **`analysis-scenarios.md`** |
- | **本地值被拒** | **来源替换、读值差异、状态回放** | **`problem-routing.md`** |
- | **令牌结构** | **信封、掩码、版式、批次对比** | **`opaque-token-analysis.md`** |
- | **版本跟踪** | **身份分开记录、结论范围、换版回归** | **`version-tracking.md`** |
- ## 技术栈
- ### Node.js
- - **crypto** (内置): MD5/SHA/AES/DES/HMAC
- - **crypto-js**: CryptoJS 兼容实现
- - **node-forge**: RSA/PKI
- - **axios**: HTTP 请求
- - **vm** (内置): 沙箱执行
- - **WebAssembly** (内置): WASM 加载
- - **http2** (内置): HTTP/2 请求
- - **playwright-core**: 浏览器自动化
- ### Python
- - **requests** / **httpx**: HTTP 请求(httpx 支持 HTTP/2)
- - **pycryptodome**: AES/DES/RSA/3DES 加密
- - **hashlib** (内置): MD5/SHA 系列
- - **hmac** (内置): HMAC 签名
- - **base64** (内置): Base64 编解码
- - **execjs**: 执行 JS 代码
- - **curl_cffi**: 带浏览器 TLS 指纹模拟的 HTTP 客户端
- ### 调试工具
- - **[camoufox-reverse MCP](https://github.com/WhiteNightShadow/camoufox-reverse-mcp) v1.11.1**: 反检测浏览器逆向分析(统一 API,含主世界/Frame Hook、源码级插桩、Firefox 原生 RDP 断点调试与可选 Gecko 原生属性追踪)
- ## 版本记录
- | 版本 | 日期 | 要点 |
- |------|------|------|
- | v3.15.0 | 2026-11-18 | 新增 jsdom 子 Realm 原型链与 `toString`、自有/原型描述符对齐、`Document.prototype.all` 活性集合补丁;补充在线改写路由残留核查、定长码点流逐槽反解消融与脱敏案例,同步 MCP v1.11.1 快照 |
- | v3.14.0 | 2026-11-15 | 配合 MCP v1.11.0:补充原生断点调试(`rdp_debugger`)证据边界并同步 42 工具快照;新增等长流式护甲与布尔判决分层锁死方法及脱敏案例 |
- | v3.13.0 | 2026-11-12 | 配合 MCP v1.10.0:插桩默认值、日志切片、离线插桩、preset 主世界;新增环境包套用模板 `templates/env-bundle/` |
- | v3.12.0 | 2026-11-10 | 平坦化分发的阶段对照(`tap_stage_calls`),MCP 工具快照更新到 v1.9.4 |
- | v3.11.1 | 2026-11-10 | JSVMP 探针日志改到页面主世界读取,配合 camoufox-reverse-mcp v1.9.3 |
- | v3.11.0 | 2026-11-10 | Skill 名称改为 `hello-js-reverse-skill`,符合 Agent Skills 命名规范,安装目录名随之调整 |
- | v3.10.0 | 2026-11-05 | 问题路由与路线阶梯、对照实验与参数跟踪方法、配套脚本、清理单站全局规则和失效工具名、文档门禁测试 |
- | v3.9.0 | 2026-09-08 | 真实开源案例公开复现、现代解析/低副作用观测、精确数据与独立Agent复验 |
- | v3.8.0 | 2026-09-08 | 公开方案研究、任务级检查、三轮Agent实操反馈、证据诊断与可选分页恢复增强 |
- | v3.7.0 | 2026-09-07 | 通用采集与断点恢复、独立验签、模板修复、三平台 CI 和契约基线 |
- | v3.6.1 | 2026-09-07 | 对齐 MCP v1.5.1:补充 Trace 清理、未来 Frame 预注册、执行失败不重放和 Hook 卸载边界 |
- | v3.6.0 | 2026-09-04 | 对齐 MCP v1.5.0;新增主世界与 Frame 选择、动态目标持久 Hook、`pending` 状态和 Trace 数据读取规范 |
- | v3.5.1 | 2026-09-03 | 对齐 MCP v1.4.1 / Camoufox Reverse reverse.5;LocalStorage 覆盖迁移至 Firefox 152 LSNG,并纳入可达的 partitioned 分支,protocol 1 不变 |
- | v3.5.0 | 2026-09-03 | 对齐 MCP v1.4.0 / Camoufox Reverse reverse.4;默认保留 sandbox,新增交互式原生追踪、75 点证据边界、安全 snapshot 与 side-by-side 安装规则 |
- | v3.4.1 | 2026-07-29 | 增加 AST 源码插桩执行健康门禁;对齐 camoufox-reverse MCP v1.1.1;保持正常插桩流程不变,仅在异常时进入安全降级 |
- | v3.3.1 | 2026-04-21 | 经验法则精简:移除单站点经验,合并 evaluate_js 相关为 1 条,总数从 24 压缩到 22 条 |
- | v3.3.0 | 2026-04-19 | 核心层回归扩容:Phase 1-5 详细动作 + 10 个场景速查 + 经验法则回迁核心层;案例层强化(禁动清单 + UA 分支矩阵) |
- | v3.2.1 | 2026-04-19 | Phase 0.5.1 强化案例复用策略;经验法则第 11 条重写 |
- | v3.2.0 | 2026-04-18 | 移除 MCP session 依赖,Checklist 压缩到三项,cases/ 成为唯一经验库 |
- | v3.1.0 | 2026-04-18 | SKILL.md 瘦身,references/ 拆分子文档,工具引用对齐 MCP 合并 API |
- | v3.0.0 | 2026-04-18 | 硬约束 Checklist + 红线四条 + 经验法则压缩 |
- ## 社区贡献者
- - [@Moojing-jianchuan](https://github.com/Moojing-jianchuan) — 等长字节码流式变换与粗粒度布尔判决分层隔离实践案例(#8),位打包双分发器定长槽位消融与 jsdom 原生性/子 Realm 校准实践案例(#9),以及配套 MCP 的阶段插桩、离线插桩与 Firefox RDP 断点调试反馈与共建
- ## 许可证
- 本仓库以 [Apache License 2.0](LICENSE) 发布。Copyright © 2026 WhiteNightShadow。
- `scripts/real_cases/` 里自写的准备与验证脚本、测试输入按该目录的 [LICENSE](scripts/real_cases/LICENSE) 以 CC0-1.0 放弃权利;按配方下载的上游源码和依赖沿用各自原有的许可证。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.