Skip to content

Latest commit

 

History

History
159 lines (108 loc) · 5.08 KB

reverse-task-index.md

File metadata and controls

159 lines (108 loc) · 5.08 KB

Reverse Task Index

按逆向目标快速定位 MCP 工具,减少“该用哪个工具”的试错成本。

Step 0:开场必读(强制)

任何新会话、任何新 case、任何“继续上次逆向”的第一步,都先读:

  1. docs/reference/reverse-bootstrap.md
  2. docs/reference/case-safety-policy.md
  3. docs/reference/reverse-workflow.md
  4. 若任务已通过 env-pass,或目标明确是“补环境后提纯算法”,继续读 docs/reference/pure-extraction.md

开场第一条正式工作回复必须同时说明:

  • 已读取上述文档
  • 当前阶段(Observe / Capture / Rebuild / Patch / PureExtraction / Port)
  • 本次产出写入哪里:scripts/cases/* 抽象层,还是 artifacts/tasks/<task-id>/ 可执行层

仓库级安全边界:

  • scripts/cases/* 只允许抽象模板与方法索引
  • 可执行实现、完整签名链路、真实任务证据统一进入 artifacts/tasks/<task-id>/

如果第一条回复没有显式确认这些约束,视为尚未进入正确工作流。

默认工作流:

  1. 页面观察
  2. 运行时采样
  3. task artifact 记录
  4. local rebuild
  5. 本地补环境(代理日志优先)
  6. env-pass 后再进入纯算法提纯

读取优先级(强制):

  1. 先读 artifacts/tasks/<task-id>/(若存在)
  2. 再读 scripts/cases/* 抽象 case
  3. 最后按模板新建流程:
    • docs/reference/parameter-methodology-template.md
    • docs/reference/parameter-site-mapping-template.md

1) 快速摸清页面加载了什么脚本

  • list_scripts
  • get_script_source
  • search_in_scripts

常用场景:先看主站脚本、动态加载脚本、webpack chunk 的体量和命名。

2) 在压缩/混淆代码里定位关键逻辑

  • find_in_script
  • set_breakpoint_on_text
  • deobfuscate_code
  • skill code-analysis(understand_code 已下线)

常用关键词:sign、token、nonce、encrypt、hmac。

3) 追踪请求参数是怎么生成的

  • create_hook
  • inject_hook
  • get_hook_data
  • break_on_xhr
  • get_request_initiator

推荐先 Hook fetch/xhr/websocket,触发业务动作后再抓记录。

4) 一键分析目标站点(推荐入口)

原 analyze_target 工具已下线,改按 skill target-analysis 复现:collect_code 采代码 + create_hook/inject_hook 采样 + get_hook_data 关联,产出同款:

  • requestFingerprints
  • priorityTargets
  • signatureChain
  • actionPlan

适合第一次接触目标站,快速得到下一步可执行动作。

5) 导出本地补环境工程

  • export_rebuild_bundle
  • diff_env_requirements

适合在页面里确认请求链路后,导出 env/entry.js、env/env.js、env/polyfills.js、env/capture.json 做 local rebuild。

固定顺序:

  1. 先运行 env/entry.js
  2. 先读 task-local 代理 env log
  3. 记录当前 first divergence
  4. 再按“最小因果单元”决定补丁
  5. 必要时才用 diff_env_requirements 做辅助比对

补环境原则请同时参考:docs/reference/env-patching.md

6) 评估风险和加密实现

原 detect_crypto / risk_panel / understand_code 工具已下线,改按 skill code-analysis 用采集到的代码做加密识别、风险评分与结构理解。

用于识别弱算法、可疑签名实现、安全风险点。

7) 页面交互自动化(配合采样)

  • navigate_page
  • query_dom
  • click
  • fill
  • wait_for_element
  • take_screenshot

适合自动触发登录、下单、提交等关键动作后再采集数据。

8) 导出分析结果

  • collection_diff

用于对比两次采样差异,并把关键结论写入 task artifact。

9) 浏览器状态自检

  • check_browser_health

10) 典型最小链路

  1. new_page
  2. 先读 docs/reference/reverse-bootstrap.md,再按其要求继续读 docs/reference/case-safety-policy.md 与 docs/reference/reverse-workflow.md
  3. 按 skill target-analysis 做目标初筛(原 analyze_target)
  4. 设定目标边界:targetKeywords、targetUrlPatterns、targetFunctionNames、targetActionDescription
  5. search_in_scripts
  6. create_hook + inject_hook
  7. 触发页面动作
  8. get_hook_data
  9. export_rebuild_bundle
  10. 运行 env/entry.js 并读取代理 env log
  11. 记录 first divergence
  12. diff_env_requirements(仅辅助)
  13. 按 skill code-analysis 做风险评估(原 risk_panel)
  14. env-pass 后再推进纯算法提纯

11) 参数总表

完整参数与字段说明请查:docs/reference/tool-reference.md

12) 参数复现模板复用(推荐)

遇到“某个参数可复现”任务时,先走模板而不是临时写脚本:

  1. 先读 docs/reference/reverse-bootstrap.md
  2. 再填站点无关模板:docs/reference/parameter-methodology-template.md
  3. 再填站点映射模板:docs/reference/parameter-site-mapping-template.md
  4. 按模板执行 Observe / Capture / Rebuild / Patch / Verify,补环境阶段默认走“代理日志 + first divergence + 最小因果单元”
  5. 可执行代码与完整链路统一放 artifacts/tasks/<task-id>/

安全约束:docs/reference/case-safety-policy.md