hello-js-reverse-skill

JS 逆向分析 Skill

面向 Web API 通用采集、接口签名分析与改版回归的 Skill。已有协议与样本时直接验证 Node.js/Python 调用；需要页面取证时使用 Camoufox MCP 捕获网络、定位源码和调试 Hook，再交付可验证的采集程序。

v3.9.0：真实开源案例与实操反馈

• 可重复准备 KProtect VM、javascript-obfuscator CFF、CryptoJS/FingerprintJS，并通过真实 MCP 验证原始/插桩、加解密及原生 trace。
• 对齐 MCP v1.8.0 的主世界/Frame 日志、现代语法解析、保守改写、精确 Unicode 返回及同步异常 Hook。
• 延续“任务首次检查、后续复用、变化时局部复查”，移除旧索引重复扫描和未经验证的覆盖率描述。

见 v3.9.0、实战经验、准备与复现。

v3.8.0：任务级检查与多轮实操迭代

• 首次按任务检查，后续复用；浏览器/Frame/鉴权/SDK等相关状态变化时局部复查，避免反复审查或误清理。
• 对齐 MCP v1.7.0 的请求差异、响应文件、哈希单位与失败诊断，按任务类型验收。
• 采集核心增加显式结束字段、空中间页、可选重试和本次页数上限，保留既有默认语义。
• 经过三轮独立 Agent 的真实 MCP/HTTP 实操，保存失败记录并修正；最后一轮三个产物全部通过独立验收。

使用说明见 通用采集、任务级检查、v3.8.0 版本说明。

v3.7.0：通用采集与改版回归

配套 MCP v1.6.0，保留现有 Skill 名称和模板路径。默认协议采集；浏览器自动化仅用于用户明确选择的交付方式。

• Python 模板新增可配置 JSON API 采集：page/offset/cursor 分页、业务校验、主键去重、JSONL、页级 checkpoint 和恢复校验。
• MCP 新增增量捕获、带截断/丢弃状态的导出，以及可选 Node.js 独立验签；修复并发响应归属、Cookie 删除和无效验签样本误通过。
• 模板 npm test / node main.js --test 为离线测试；修复 VM 地址、location、定时器和 Python Cookie；请求默认不自动重放 POST。
• 使用 project-baseline.py 保存 SDK/签名代码/fixture 哈希，check-mcp-contract.py 校验工具契约，依赖自检按任务模式选择。

使用说明见 通用采集指南，完整版本说明见 v3.7.0。

核心能力

• 双语言算法还原: Node.js (crypto / crypto-js) 与 Python (hashlib / pycryptodome) 双路径实现
• 加密算法还原: MD5/SHA/AES/DES/RSA/HMAC/Base64 等常见加密算法的纯算法复现
• JS 混淆还原: OB混淆、控制流平坦化、eval打包、自定义VM/JSVMP 等混淆类型的分析策略
• JSVMP 行为追踪: Hook/插桩/日志/源码级插桩四板斧（v2.5.0 新增第四板斧），从行为层面追踪 JS 虚拟机保护的签名生成链路，提供通用调查路径，实际有效性需按目标样本验证（详见专项指南）
• Cookie 归因分析: analyze_cookie_sources 融合 HTTP Set-Cookie 与 JS document.cookie 日志，一次性解答"这个 Cookie 到底是谁写的"（v2.5.0 新增）
• 反爬类型分档决策（v2.6.0）：签名型（RS/Akamai）/ 行为型（TK/JY）/ 纯混淆 三类反爬的工具路径完全不同，内置顶层决策框架，避免"observer effect 破坏签名"的经典陷阱
• 动态 Cookie 逆向: eval首包、api预热、浏览器指纹等 Cookie 生成机制的破解
• WASM 逆向: WebAssembly 加密模块的加载、环境补全和调用
• 协议层对抗: TLS 指纹检测、HTTP/2 强制、频率限制等协议层防护的应对
• 反检测浏览器: Camoufox C++ 引擎级指纹配置，用于反爬与环境依赖分析，站点可用性按实测判断
• 单 MCP 工作流: 统一使用 camoufox-reverse 完成源码搜索、Hook 注入、函数追踪、网络分析、请求拦截与反检测验证
• 错误排查体系: 完整的请求失败排查流程和签名值不一致排查方法论
• Codex/Claude Code 完整适配: 内置 Agent 授权指令框架，确保 AI 全力协助完成分析任务

快速使用

方式一：AI 对话框直接安装（推荐）

在你的 AI 编码工具（Cursor / Claude Code / codex 等）的对话框中输入：

帮我安装下这个skill：hello_js_reverse_skill
项目地址：https://github.com/WhiteNightShadow/hello_js_reverse_skill

AI 会自动完成下载、配置，并在后续 JS 逆向相关任务中自动调用该 Skill。

方式二：手动安装

将本仓库克隆到对应 AI 工具的 skills 目录下：

Cursor：

git clone https://github.com/WhiteNightShadow/hello_js_reverse_skill.git ~/.cursor/skills/hello_js_reverse_skill

Codex：

git clone https://github.com/WhiteNightShadow/hello_js_reverse_skill.git ~/.codex/skills/hello_js_reverse_skill

VSCode（Copilot / Cline 等插件）：

git clone https://github.com/WhiteNightShadow/hello_js_reverse_skill.git ~/.vscode/skills/hello_js_reverse_skill

安装完成后，AI Agent 会自动读取 SKILL.md 获取 JS 逆向分析能力。当你在对话中涉及接口签名分析、反爬对抗、动态 Cookie、混淆 JS、WASM 或浏览器环境调试等场景时，Skill 会自动激活。

项目结构

hello_js_reverse_skill/
├── SKILL.md                        # 技能定义（AI Agent 读取的核心文件）
├── README.md                       # 项目文档
│
├── references/                     # 参考文档（深度背景，按需读取）
│   ├── workflow-overview.md        # 工作流总览与解法模式决策树
│   ├── phase-details.md            # Phase 0-5 详细操作（v3.7.0 按需读取）
│   ├── mcp-cookbook.md             # MCP 工具场景手册（v3.7.0 按需读取）
│   ├── mcp-tool-reference.md      # MCP 工具名迁移映射
│   ├── experience-rules-full.md   # 经验法则完整版（v3.7.0 按需读取）
│   ├── path-a-four-tools.md       # 路径 A 四板斧详细步骤
│   ├── path-b-env-emulation.md    # 路径 B 环境伪装六步法
│   ├── jsvmp-analysis.md          # JSVMP 字节码分析
│   ├── jsvmp-source-instrumentation.md # 源码级插桩专项
│   ├── jsdom-env-patches.md       # jsdom 环境补丁模板
│   ├── common-pitfalls.md         # 反模式清单
│   ├── crypto-patterns.md         # 加密算法识别与还原代码
│   ├── obfuscation-guide.md       # JS 混淆类型识别与还原策略
│   ├── hook-techniques.md         # Hook 技术大全
│   ├── anti-debug.md              # 反调试对抗手册
│   ├── environment-patch.md       # 环境补全指南
│   ├── protocol-analysis.md       # 协议层分析
│   └── troubleshooting.md         # 错误排查指南
│
├── cases/                          # 经验案例库（唯一经验库）
│   ├── README.md                   # 高频站点速查表
│   ├── _template.md                # 新案例模板
│   └── *.md                        # 各站点/场景案例
│
├── scripts/                        # 工具脚本
│   ├── check-deps.sh               # 环境依赖检查（Node.js + Python）
│   ├── sandbox-runner.js           # VM 沙箱执行器（CLI工具）
│   ├── hook-generator.js           # Hook 代码生成器（10种Hook模板）
│   └── crypto-identifier.js        # 加密算法识别器（密文特征分析）
│
├── templates/                      # 项目模板（按解法模式和语言分类）
│   ├── node-request/               # 模式A (Node.js)：纯算法还原
│   │   ├── main.js
│   │   ├── utils/encrypt.js
│   │   ├── utils/request.js
│   │   └── package.json
│   ├── python-request/             # 模式A (Python)：纯算法还原
│   │   ├── main.py
│   │   ├── utils/sign.py
│   │   ├── utils/request.py
│   │   ├── config/headers.json
│   │   ├── config/keys.json
│   │   └── requirements.txt
│   ├── vm-sandbox/                 # 模式B：VM 沙箱执行
│   │   ├── main.js
│   │   ├── utils/sandbox.js
│   │   ├── utils/request.js
│   │   └── package.json
│   ├── wasm-loader/                # 模式C：WASM 加载还原
│   │   ├── main.js
│   │   ├── utils/wasm-loader.js
│   │   ├── utils/env-patch.js
│   │   └── package.json
│   └── browser-auto/               # 模式D：浏览器自动化
│       ├── main.js
│       └── package.json
│
└── examples/                       # 示例
    └── demo-analysis.md            # 完整分析流程示例

快速开始

1. 环境检查

bash scripts/check-deps.sh

2. 作为 Cursor Skill 使用

将本目录放置到 .cursor/skills/ 下，AI Agent 会自动读取 SKILL.md 获取逆向分析能力。

3. 工具脚本

加密算法识别:

node scripts/crypto-identifier.js "e10adc3949ba59abbe56e057f20f883e"

生成 Hook 代码:

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 沙箱执行:

node scripts/sandbox-runner.js obfuscated.js --extract-cookie --verbose

4. 使用项目模板

根据分析结果选择合适的模板：

Node.js 项目：

cp -r templates/node-request/ my_project/
cd my_project && npm install
# 修改 main.js 中的配置和加密逻辑
node main.js

Python 项目：

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 服务器组织能力（Camoufox 反检测浏览器与统一 API）：

• 源码级插桩 instrumentation(action='install', mode="ast") — MCP 侧 esprima 实现，挑战页可用
• 签名安全观察 hook_jsvmp_interpreter(mode="transparent") — 仅 prototype getter 替换
• Cookie 归因 analyze_cookie_sources — 区分 Set-Cookie 与 document.cookie
• 响应链追踪 navigate 返回 redirect_chain/final_status，秒识反爬类型

详见 SKILL.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 v1.5.1: 反检测浏览器逆向分析（统一 API，含主世界/Frame Hook、源码级插桩、Cookie 归因与可选 Gecko 原生属性追踪）

版本记录