ast-deobfuscation

name	ast-deobfuscation
description	使用 Babel AST 对 JavaScript 做分层、可回退的定向反混淆。适用于 `_0x` 标识符、字符串表、自执行解码包装、dispatcher 对象、虚假常量分支、`while/for + switch` 控制流平坦化、`if (literal === opcode)` 分发链，以及需要按站点或混淆家族命中特征切换专用脚本的场景。用户明确提到 reese84、顶象、极验4、同花顺、网易易盾、小红书、OB 变种或类似站点适配时也使用本 skill。

AST 反混淆

优先使用分层入口，而不是继续把站点特有逻辑堆进通用脚本。

工作流

1. 先运行 scripts/detect-patterns.js <input.js> [hint] 做模式检测。
2. 只读取命中的站点或混淆家族规则文档。
3. 运行 scripts/run-pipeline.js <input.js> <output-dir> [hint] 执行选中的流水线。
4. 对照参考产物或原始混淆症状，判断是否还需要新增专用适配脚本。

设计规则

• 通用脚本只保留低风险、可复用的改写，例如结构标准化、虚假分支清理、dispatcher 内联、控制流拍平和 if -> switch。
• 一旦某个模式明显是站点特有的，就同时补齐四部分：规则文档、检测器命中项、专用适配脚本、流水线配置项。
• 对于高开销步骤，优先按家族跳过或重排，不要强行要求所有样本走同一套顺序。像 reese84 这种大样本，如果太晚执行 inline-literals，很容易卡住。
• 专用适配脚本应当保持窄而准。如果某条规则没有在多个无关样本中复用，不要急着回灌到通用脚本。
• 结构性改写后要重新 parse，并保证每一阶段都可以独立运行和排查。

入口脚本

• scripts/detect-patterns.js 根据文件路径、可选 hint 和源码症状判断最可能命中的站点或混淆家族。
• scripts/run-pipeline.js 把样本复制到测试目录，执行选中的步骤，记录耗时并输出流水线报告。
• scripts/collect-residue-metrics.js 统计仍未解开的症状，例如 split('|')、直接 loop/switch 平坦化、opcode if 链、dispatcher wrapper 和 _0x 标识符。
• scripts/compare-with-reference.js 将最新流水线输出与 decode.js 对比，汇总剩余差距。

参考文档

• 新增或调整适配器时，先读 references/pattern-layering.md。
• 任何逻辑想放进通用脚本前，先读 references/safe-rewrite-rules.md。
• 处理字符串表、解码 stub、最小运行时求值时，读 references/string-array-and-minimal-eval.md。
• 处理控制流平坦化、opcode 分发器和 VM 类 handler 时，读 references/control-flow-and-opcode-patterns.md。
• 处理逗号表达式、IIFE、语句提升时，读 references/sequence-normalization.md。
• 检测器命中后，只读取对应的一份站点规则文档：
  • references/patterns/reese84.md
  • references/patterns/dingxiang.md
  • references/patterns/geetest4.md
  • references/patterns/tonghuashun.md
  • references/patterns/yidun.md
  • references/patterns/xiaohongshu.md
  • references/patterns/cn-bidding-ob.md
  • references/patterns/mps-ob.md

校验

• 每个新增或改过的 JavaScript 辅助脚本，在接入流水线前都要至少过一次 node --check 或等价的加载校验。
• 修改 skill 后，运行 C:\Users\25198\.codex\skills\.system\skill-creator\scripts\quick_validate.py C:\Users\25198\.codex\skills\ast-deobfuscation。
• 测试案例时，把中间产物、检测结果、对比结果和流水线耗时都保留在案例目录里，方便定位慢步骤和失败步骤。