data: script usage of 34 game releases and the usage-ranked roadmap

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Patryk Gensch
2026-10-28 20:37:10 +01:00
co-authored by Claude Opus 5.5
parent ebbeeea144
commit 60a2c65e1f
4 changed files with 20336 additions and 132 deletions
+12 -1
View File
@@ -38,7 +38,7 @@ Atlas odczytuje snapshoty z dysku przy każdym pobraniu katalogu. Command Center
- **Nieustalone w oryginale**: brak obserwacji, nigdy dowód nieobecności.
Licznik to pary typ/metoda. Nie jest liczbą unikalnych ciał Java ani procentem zgodności całego silnika. Metody bazowe `CMC_Runner` (SEND, CLONE, …) są w zakresie `*` raz; typy wskazują go polem `inherits`. Zakres `@` to instrukcje `@IF`/`@LOOP`/… (runner typu 0), porównywane z `CodeParser.dispatchSpecialCall`. Typy bez rozpoznanych metod pozostają widoczne.
Roadmapę braków emulatora per zakres generuje `python -m ams.roadmap tracker.json -o docs/roadmap.md` (metody z sygnaturą, stuby, eventy i pola bez literału, z rodzinami silnika, w których DLL dana pozycja występuje).
Roadmapę braków emulatora per zakres generuje `python -m ams.roadmap tracker.json -o docs/roadmap.md` (metody z sygnaturą, stuby, eventy i pola bez literału, z rodzinami silnika, w których DLL dana pozycja występuje). Z `--usage data/script-usage.json` każda luka ma liczbę gier i miejsc w ich skryptach, luki są w tej kolejności, a raport dodaje tabelę priorytetów i listę użyć spoza znanego API oryginału.
Typ → runner pochodzi z `runner_map` snapshotu (fabryka w 7.1+, konstruktory klas w 6.1); bez niego z nazwy klasy, oznaczone jako wnioskowane. Metoda wspólnego runnera, którą oryginał pomija dla danego typu warunkiem `obj.getType()`, nie jest temu typowi przypisana; pusta implementacja wirtualna jest oznaczona jako brak efektu. Sygnatury (typy argumentów i wyniku) są odczytane z ciała metody i mogą być sumą wariantów (`int/string`).
Eventy typu pochodzą z jego vtable (`type_events`) albo z listy najbliższej klasy w łańcuchu konstruktorów. Po stronie emulatora liczy się literał nazwy: w klasie typu (`emitted`), w `Variable.java` (`emitted_base`), w innym kodzie bez przypisania do typu (`engine_literal`); `not_found` znaczy tylko, że literału nie ma.
Pola typu pochodzą z jego łańcucha konstruktorów (`type_fields`) albo z pól jego klasy i jej baz. Po stronie emulatora: klucz `":NAME"` w gałęzi typu w `CNVParser.createVariable` lub odczyt atrybutu (`getAttribute`, `getAttributeInHierarchy`, `attributes().get`) w klasie typu (`read`), w `Variable.java` (`read_base`), gdzie indziej (`engine_literal`).
@@ -46,6 +46,17 @@ Alias `BOOL` jest łączony z `BOOLEAN`, `INT` z `INTEGER`; nazwy metod są norm
Adapter rozpoznaje bieżący wzorzec rejestracji Java; nie jest ogólnym parserem języka Java. Komentarze i literały nie tworzą fałszywych wpisów, nawiasy są dopasowywane leksykalnie. Własne dispatchery `GROUP` / `INSTANCE` są oznaczone do przeglądu. Celowe no-op nie są automatycznie stubami.
## Użycie w skryptach gier
```sh
.venv/bin/python -m ams.usage "/Users/genszu/Gry Aidem Media" -o data/script-usage.json # ~10 s dla 51 obrazów
.venv/bin/python -m ams.usage GRA.iso -o /tmp/usage.json --dump /tmp/skrypty # także zdekodowane skrypty (UTF-8)
```
Katalog z obrazami daje jedno wydanie na obraz, a tytułem jest folder obrazu, więc kilka wydań jednej gry liczy się jako jedna gra. Katalog bez obrazów jest jednym wydaniem z luźnych skryptów. Obrazy czyta 7-Zip: `bsdtar` nie widzi plików na części płyt (Aladyn, Pinokio, Piotruś Pan, Wojna Trojańska). CNV/DEF/CLASS są deszyfrowane jak w `ScriptDecypher` emulatora; SEQ opisuje sekwencje, nie obiekty skryptu, i jest pomijany. Rodzina silnika pochodzi z DLL silnika na płycie. Gry od 6.1 wzwyż mają skrypty wprost na płycie; w instalatorach (MSI/CAB/PMG) są tylko starsze silniki albo wydania w Unity.
`NAZWA^METODA(` liczy się dla typu z deklaracji `NAZWA:TYPE=`: najpierw z tego samego pliku, potem z całego wydania, jeśli wszystkie deklaracje się zgadzają. `NAZWA_N` to kopia `CLONE`, `NAZWA_CURSOR` to kursor bazy `NAZWA`, a RANDOM/MOUSE/KEYBOARD/SYSTEM to obiekty globalne (jak `BuiltinVariableProvider`). Obiekt z `KLASA^NEW("NAZWA")` jest instancją (`INSTANCE`): jego metody to zachowania ze skryptu klasy, nie API silnika. `*ZMIENNA^METODA(` liczy się jako `dynamic` dla typów obiektów, których nazwy wydanie przypisuje do ZMIENNA (`:VALUE=`, `^SET("…")`). Reszta (`$N`, THIS, nazwy niezadeklarowane lub niejednoznaczne) zostaje pod `unresolved` per nazwa metody. Roadmapa przypisuje ją zakresowi, który jako jedyny ma tę metodę (albo `*`). Do listy „spoza API” trafiają tylko użycia bezpośrednie. Liczby to miejsca w skryptach, nie wykonania.
## Dowody poprawności
`tracker-reviews.json` jest wersjonowanym rejestrem przeglądów; początkowo pustym. Ekstrakcja rejestracji silników, WORLD i KOLOROWANKA nie wypełnia go automatycznie.