boba/obfuskator
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
obfuskator/docs
History
loki5512344 2b19ed6096
passes: add mba scheme to Constants (and+or+add identity) 
(a&b)+(a|b) = a+b, documented honestly: falls to the same symbolic
evaluator as xor/add/shift (every sub-expression is a foldable
LDC,LDC,BINOP triple), but defeats a pattern matcher hardcoded to one
opcode ("ldc,ldc,ixor = split constant"). Added to ConstantsConfig
default schemes.

Tests: mba_form_uses_and_or_add_not_a_single_binop, round-trip coverage
in int_forms_round_trip/long_forms_keep_shape.
2026-10-14 01:30:10 +02:00
..
learnings docs: drop stale learnings notes (lessons/priorities/reference) 2026-10-13 13:28:03 +02:00
architecture.md frames,jar,passes: verifier-driven hardening from real jars 2026-10-09 13:47:27 +02:00
README.md frames,jar,passes: verifier-driven hardening from real jars 2026-10-09 13:47:27 +02:00
stack.md frames,jar,passes: verifier-driven hardening from real jars 2026-10-09 13:47:27 +02:00
techniques.md passes: add mba scheme to Constants (and+or+add identity) 2026-10-14 01:30:10 +02:00

README.md

Документация noxis

Обфускатор JVM/Java-байткода на Rust. Этот файл - индекс.

Что где

файл что внутри
architecture.md слои, крейты, собственный IR, конвейер пассов, структурные правила
techniques.md как работает каждая техника + плюсы/минусы/цена
stack.md почему свой IR, какой backend, StackMapTable, PRNG, генерация рантайма
learnings/lessons.md уроки из разбора EvoVis: что защита сделала плохо и чего мы не делаем
learnings/reference.md разбор референсного обфускатора (Java/ASM) - что берём, что нет
learnings/priorities.md что улучшим: стратегия и приоритеты
learnings/ai-resistance.md новые техники обфускации и устойчивость к LLM-анализу

План выполнения - ../todo.md. Исходный материал разбора - ../info/.

Структурные правила проекта

Правила - только про Rust-код: crates/*/src, crates/*/tests, crates/*/benches. Документация (docs/**, корневые .md) и info/ вне гейта: писать подробно там, где это документация, а не ограничивать объём искусственно. Не учитываются также Cargo.lock, .gitignore, корень крейта (в нём всегда лежат Cargo.toml + build.rs).

  1. Не больше 250 строк кода в одном .rs файле. Пустые строки и полно-строчные комментарии (//, ///, //!) не считаются - измеряется объём кода, а не документации.
  2. Не больше 4 .rs-файлов в одной директории. Подпапки не ограничены: src/ может содержать lib.rs и три модуля-директории, каждая из которых в свою очередь содержит не больше четырёх файлов.

tests/ и benches/ не исключены намеренно - иначе правило «250 строк» обходится выносом кода в тесты.

Правило 2 - это не косметика: файл из тысячи строк означает, что в нём смешаны разные причины к изменению (нарушение KISS/DRY/SOLID), а команда из восьми файлов в одной папке - что модуль перестал быть модулем.

Как проверяется

Правила гоняются при компиляции. Каждый крейт имеет build.rs:

fn main() {
    noxis_structure_check::check();
}

noxis-structure-check обходит деревья src/, tests/ и benches/ этого крейта и падает со стопкой ошибок, если лимит нарушен. Поэтому cargo build не соберёт нарушение - специально запускать проверку не нужно. Деревья регистрируются через cargo:rerun-if-changed, чтобы гейт не срабатывал на правки вне проверяемых путей.

Остальное, что не привязано к компиляции, собирается одним скриптом:

./scripts/check.sh   # structure → fmt → clippy -D warnings → test

Что делать при нарушении

  • файл разрослся → разрезать по одной ответственности на файл: mod.rs = публичный контракт модуля, соседние файлы - внутренности;
  • папка переполнилась → завести подпапку и вынести подфункцию целиком, а не «чтобы влезло».

Каждый модуль получает mod.rs с //!-документацией - это точка входа, читающаяся вместо пяти файлов.