jsreverser-mcp-playbook

MCP 前端 JS 逆向作业规范

定位说明：

• skills/jsreverser-mcp-playbook/references/* 是 AI 快速执行版，用于任务中按需快速读取。
• docs/reference/* 是 正式权威版，适合源码或已打包安装场景与仓库外部查阅。
• 如果两者表述出现差异，以 docs/reference/* 为准。

核心原则

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

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

目标场景

默认主场景是：

1. 定位接口签名、加密参数、关键请求字段
2. 在页面里确认哪个请求、哪个脚本、哪个函数参与参数生成
3. 导出本地复现材料
4. 在 Node 里按“代理 env log + first divergence + 最小因果单元”补环境跑通
5. 跑通后再做 AST 去混淆、VMP 插桩或逻辑提纯

五阶段工作流

1. Observe

目标：

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

默认入口：

• docs/reference/reverse-bootstrap.md
• references/automation-entry.md
• references/mcp-task-template.md

必须产出：

• 目标请求
• initiator 线索
• 可疑脚本 URL / scriptId
• 初始 task artifact

2. Capture

目标：

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

规则：

• 优先 fetch/xhr hook
• 如果目标发生在首屏初始化、首个请求前参数装配、页面首次执行阶段，先用 inject_preload_script 挂早期采样或补环境脚本
• 命中后先看 summary，再按需看 raw
• Hook 不足时再考虑断点

3. Rebuild

目标：

• 把页面证据导出为本地可迭代的 Node 复现工程。

参考：

• references/local-rebuild.md
• references/task-artifacts.md
• 正式规范：docs/reference/reverse-workflow.md

规则：

• 本地补环境必须以页面观测证据为依据
• 不允许空想式补 window/document/navigator/crypto/storage

4. Patch

目标：

• 按代理日志和 first divergence 驱动补环境，直到本地脚本能稳定跑出目标参数。

规则：

• 先读代理 env log，再记录当前 first divergence
• 一次只做一个补丁决策，不是机械地一次只改一个属性
• 一个补丁决策对应一个最小因果单元：值 / 函数壳 / 返回对象 / 最小对象契约
• diff_env_requirements 仅作辅助，不替代代理日志
• 每次补丁后立即复测，并记录 first divergence 是否前移
• 每次补丁都写入 task artifact
• 快速执行版看 references/env-patching.md，正式规范以 docs/reference/env-patching.md 为准

5. DeepDive

目标：

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

规则：

• 如果当前任务只是出签名，这一阶段可以降级
• 如果要长期复用算法链路，这一阶段必须做
• 进入纯算法提纯阶段时，优先读取 docs/reference/pure-extraction.md

场景路由

Task-driven 工具路由

当 MCP 已暴露 reverse task 工作流工具时，默认优先按下面顺序选工具，而不是先读参数 workflow 文档：

1. 新建任务
   • start_reverse_task
2. 查状态 / 摘要 / timeline / compare / tag / update
   • manage_reverse_task
3. 自动决定下一步并连续推进
   • orchestrate_reverse_task
4. 一键跑“定位函数 -> 最小切片 -> pure 草稿 / port-ready 草稿”
   • run_reverse_agent
5. 导出最少交付文件
   • export_portable_bundle
6. 只查看参数蓝图 / 案例 workflow
   • get_parameter_workflow
   • list_parameter_workflows
   • recommend_parameter_workflow