# Ast Deobfuscation > 使用 Babel AST 对 JavaScript 做分层、可回退的定向反混淆。适用于 `_0x` 标识符、字符串表、自执行解码包装、dispatcher 对象、虚假常量分支、`while/for + switch` 控制流平坦化、`if (literal === opcode)` 分发链，以及需要按站点或混淆家族命中特征切换专用脚本的场景。用户明确提到 reese84、顶象、极验4、同花顺、网易易盾、小红书、OB 变种或类似站点适配时也使用本 skill。 - Skill: `lwjjike/ast-deobfuscation` (Agent Skill, multi-file: 37 files) - Install (CLI): `npx skillmds@latest add lwjjike/ast-deobfuscation` - Raw SKILL.md: https://api.skillmd.com/api/skills/lwjjike/ast-deobfuscation/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: lwjjike (https://skillmd.com/u/lwjjike) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/lwjjike/ast-deobfuscation --- # AST 反混淆 优先使用分层入口，而不是继续把站点特有逻辑堆进通用脚本。 ## 工作流 1. 先运行 `scripts/detect-patterns.js [hint]` 做模式检测。 2. 只读取命中的站点或混淆家族规则文档。 3. 运行 `scripts/run-pipeline.js [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`。 - 测试案例时，把中间产物、检测结果、对比结果和流水线耗时都保留在案例目录里，方便定位慢步骤和失败步骤。