mcp-js-reverse-playbook

name	mcp-js-reverse-playbook
description	在使用 js-reverse-mcp 做前端 JavaScript 逆向时使用，适用于签名链路定位、页面观察取证、运行时采样、本地补环境复现与证据化输出。优先适配当前环境里的 js-reverse_* 工具。

MCP 前端 JS 逆向作业规范

适用范围

Web JS 逆向默认先走 ruyi-reverse。只有同时满足以下条件，才使用本 skill：

• 任务明确需要 CDP 级暂停、单步、调用栈或作用域查看
• 目标没有强反检测、强指纹对抗、验证码绕过或 TLS/CDP 痕迹检测需求
• 需要用 js-reverse-mcp 对具体请求或脚本做断点级取证

当任务属于以下场景，且满足上面的 CDP 条件时使用本 skill：

• 定位接口签名、加密参数、风控字段
• 观察页面请求链路与脚本来源
• 在运行时抓取函数入参与返回值
• 追踪某个 XHR/Fetch/WebSocket 的触发点
• 把页面证据带回 Node 做本地复现与补环境

涉及反检测、指纹、Cloudflare/hCaptcha、行为模拟、Cookie/Storage 登录态准备时，先用 ruyi-reverse。需要把 ruyi 会话交给本 skill 继续 CDP 调试时，桥接顺序固定为 ruyi_export_session 导出 Cookie/Storage，再导入 js-reverse-mcp 页面后继续断点取证。

如果目标是二进制、APK、PE、ELF、DLL、SO，请改用 ida-reverse、radare2 或 reverse-engineering。

当前环境默认工具映射

本 skill 不假设存在裸工具名，而是默认绑定当前 OpenCode 环境里的 js-reverse_* 工具。

常用映射：

• list_scripts -> js-reverse_list_scripts
• get_script_source -> js-reverse_get_script_source
• save_script_source -> js-reverse_save_script_source，filePath 必填，且必须是 "D:\reverse_ENV\workspace\<项目名>\..." 下的绝对路径
• search_in_sources -> js-reverse_search_in_sources
• break_on_xhr -> js-reverse_break_on_xhr
• evaluate_script -> js-reverse_evaluate_script
• get_paused_info -> js-reverse_get_paused_info
• set_breakpoint_on_text -> js-reverse_set_breakpoint_on_text
• list_network_requests -> js-reverse_list_network_requests
• get_request_initiator -> js-reverse_get_request_initiator
• get_websocket_messages -> js-reverse_get_websocket_messages
• take_screenshot -> js-reverse_take_screenshot
• new_page -> js-reverse_new_page
• navigate_page -> js-reverse_navigate_page
• select_page -> js-reverse_select_page
• select_frame -> js-reverse_select_frame
• pause/resume -> js-reverse_pause_or_resume

如果未来工具名前缀变化，先更新本节，不要在执行时临时猜测。

核心原则

• Observe-first
• Hook-preferred
• Breakpoint-last
• Rebuild-oriented
• Evidence-first

先页面观察，再最小化采样，再做本地补环境，不要跳过取证直接猜环境。

渐进式披露阶段

本 skill 的五阶段工作流已按 reverse-coordinator 的四个深度等级对齐：

阶段	深度	对应本 skill 步骤	产出
分类	L0	1. Observe	目标请求、可疑脚本、initiator 线索
侦察	L1	1-2. Observe + Capture	参数样例、调用顺序、运行时证据
决策	—	Capture 后判定	判断：纯 JS / 有 WASM / 有 VM / 有反调试
深挖	L2	3-4. Rebuild + Patch	本地 Node 复现脚本
深挖+	L3	5. DeepDive	safe AST，或有 Trace + fixture 的 JSVMP / JS-WASM 边界恢复
阻滞	L4	fallbacks.md	VM/WASM 缺证据、反检测或语义不稳定 → triage

遵循 reverse-coordinator 约定：不得跳过 Observe 直接猜环境。WASM/VM marker 先交 web-deobfuscation gate 分级，只有缺 opcode/boundary Trace、fixture 或稳定语义时才标 L4 triage。

五阶段工作流

1. Observe

目标：先确认目标请求、相关脚本、候选函数，不猜环境。

默认动作：

• 用 js-reverse_new_page 或 js-reverse_navigate_page 打开目标页面
• 用 js-reverse_list_network_requests 找目标请求
• 先记录目标请求 requestId，再用 js-reverse_get_request_initiator({ "requestId": "<requestId>" }) 回溯调用来源
• 用 js-reverse_list_scripts、js-reverse_search_in_sources 缩小脚本范围

必须产出：

• 目标请求 URL 或特征
• requestId
• initiator 线索
• 可疑脚本 URL
• 初始任务记录

2. Capture

目标：对目标请求做最小侵入采样，拿到参数样例、调用顺序、运行时证据。

规则：

• 优先 js-reverse_break_on_xhr
• 优先 js-reverse_evaluate_script 做轻量运行时观察
• 命中后先看 js-reverse_get_paused_info
• 必要时再用 js-reverse_set_breakpoint_on_text

3. Rebuild

目标：把页面证据整理成本地可迭代的 Node 复现材料。

规则：

• 本地补环境必须以页面观测证据为依据
• 不允许空想式补 window/document/navigator/crypto/storage
• 每次只记录一个最小因果补丁决策

4. Patch

目标：按报错和 first divergence 驱动补环境，直到本地脚本稳定跑出目标参数。

规则：

• 先看缺什么，再补什么
• 一次只做一个最小补丁决策
• 每次补丁后立即复测
• 每次补丁都写入任务记录

5. DeepDive

目标：本地跑通后，再做去混淆、控制流还原、业务逻辑提纯。

规则：

• 如果当前任务只是出签名，这一阶段可以降级
• 如果要长期复用算法链路，这一阶段必须做
• 已确认 AST 混淆、JSVMP 或 WASM 边界是核心阻塞时，切 web-deobfuscation；本 skill 负责提供源码、paused/runtime 证据和请求 fixture，不自行宣称算法恢复

执行要求

• 所有重要步骤都要写入本地 task artifact
• 如果无法解释为什么调用某个工具，就不要调用
• 优先使用 js-reverse_* 工具直接取证，不要先写脚本重造能力
• 失败时按 references/fallbacks.md 回退
• 输出遵循 references/output-contract.md

交付衔接

当本 skill 的 Rebuild 阶段完成（签名函数已定位、环境已补全、能本地跑出目标参数），若用户需要"写采集器"或"纯协议交付"，切到 protocol-recovery skill 继续。那个 skill 负责把已验证的签名逻辑打包为脱离浏览器的 Python 采集器。

当 Rebuild 被 AST/JSVMP/WASM 阻塞时，先切 web-deobfuscation 完成分类和 evidence manifest 验收；仍缺浏览器 WebAPI 时再回到 web-env-patcher。

必读引用

• 自动化入口：references/automation-entry.md
• 参数默认值：references/tool-defaults.md
• 任务输入模板：references/task-input-template.md
• MCP 专用任务编排：references/mcp-task-template.md
• 任务产物：references/task-artifacts.md
• 本地复现：references/local-rebuild.md
• 补环境：references/env-patching.md
• Node 复现：references/node-env-rebuild.md
• 插桩：references/instrumentation.md
• AST / JSVMP / WASM 路由：references/ast-deobfuscation.md
• 回退：references/fallbacks.md
• 输出契约：references/output-contract.md