KITAQ SERIES • REFERENZAUSGABE
KUROSAKI
NES- und FDS-Ausführung und -Analyse
Von der ersten Codezeile zur Ausführung, Beobachtung und erneuten Prüfung.
Quellenstand: 14. September 2026 · Englische Referenzausgabe: 14. September 2026
Quellenstand: 14. September 2026 · Englische Referenzausgabe: 14. September 2026
Referenz der Befehlssyntax
Die folgende Hilfe wurde für diese Quellenausgabe aufgezeichnet. Sie erläutert optionale Argumente, Standardwerte und zulässige Werte. Ersetzen Sie die beispielhaften Eingabedateinamen durch Ihre eigenen Ausgaben. Aufgezeichnete Werkzeugantworten behalten ihren ursprünglichen Wortlaut.
kurosaki
help
KITAQFC-aware clean-room NES observation emulator CLI
Usage: kurosaki.exe <COMMAND>
Commands:
battery-export Export raw battery RAM from a matching snapshot (not a snapshot file)
battery-run Cold boot with an explicit battery file; no implicit save-file writes
inspect-rom
audit-board
run
trace
audio-export
profile
diagnose
replay-record
replay-run
snapshot-save
snapshot-load
snapshot-rebase Rebind a reviewed v2 snapshot to an explicitly allowlisted compatible ROM
snapshot-resume
diff
decompile Recover bounded function CFGs and readable pseudocode from a mapper context
disasm
mapper-test
fds-inspect
export-assets
report
mapper-list
mapper-info
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print versionkurosaki battery-export — Rohe batteriegepufferte RAM-Daten aus einem gespeicherten Zustand exportieren
powershell
kurosaki battery-export out/game.nes out/state.kss.json --out out/save.savhelp
Export raw battery RAM from a matching snapshot (not a snapshot file)
Usage: kurosaki.exe battery-export --out <OUT> <ROM> <SNAPSHOT>
Arguments:
<ROM>
<SNAPSHOT>
Options:
--out <OUT>
-h, --help Print helpkurosaki battery-run — Mit gespeichertem RAM starten
powershell
kurosaki battery-run out/game.nes --sav out/save.sav --frames 120 --png out/loaded.png --save-out out/next.savhelp
Cold boot with an explicit battery file; no implicit save-file writes
Usage: kurosaki.exe battery-run [OPTIONS] --sav <SAV> <ROM>
Arguments:
<ROM>
Options:
--sav <SAV>
--frames <FRAMES> [default: 600]
--replay <REPLAY>
--json <JSON>
--snapshot <SNAPSHOT>
--png <PNG>
--save-out <SAVE_OUT>
-h, --help Print helpkurosaki inspect-rom — Den ROM-Header untersuchen
powershell
kurosaki inspect-rom out/game.nes --json out/rom.jsonhelp
Usage: kurosaki.exe inspect-rom [OPTIONS] <ROM>
Arguments:
<ROM>
Options:
--json <JSON>
--md <MD>
-h, --help Print helpkurosaki audit-board — Anforderungen der Platine prüfen
powershell
kurosaki audit-board out/game.nes --expected-board surom512 --json out/board.jsonhelp
Usage: kurosaki.exe audit-board [OPTIONS] <ROM>
Arguments:
<ROM>
Options:
--expected-board <EXPECTED_BOARD> [default: surom512]
--metadata <METADATA>
--json <JSON>
-h, --help Print helpkurosaki run — Eine feste Anzahl von Bildern ausführen
powershell
kurosaki run out/game.nes --frames 120 --png out/game.png --json out/run.jsonhelp
Usage: kurosaki.exe run [OPTIONS] <ROM>
Arguments:
<ROM>
Options:
--frames <FRAMES> [default: 1]
--max-instructions <MAX_INSTRUCTIONS>
--headless
--state-hash <STATE_HASH>
--json <JSON>
--md <MD>
--png <PNG>
--snapshot <SNAPSHOT>
--observe-json <OBSERVE_JSON>
--trace-jsonl <TRACE_JSONL>
--emit-diagnostics <EMIT_DIAGNOSTICS>
--repro-bundle <REPRO_BUNDLE>
--break-on-diagnostic <BREAK_ON_DIAGNOSTIC>
--png-on-diagnostic <PNG_ON_DIAGNOSTIC>
--snapshot-on-diagnostic <SNAPSHOT_ON_DIAGNOSTIC>
--kitaqfc-debug <KITAQFC_DEBUG>
--allow-unimplemented
--pad1 <PAD1> [default: 0]
--pad2 <PAD2> [default: 0]
-h, --help Print helpkurosaki trace — Einen zeitlich geordneten Ereignisverlauf aufzeichnen
powershell
kurosaki trace out/game.nes --frames 2 --cpu --ppu --out out/trace.jsonlhelp
Usage: kurosaki.exe trace [OPTIONS] --out <OUT> <ROM>
Arguments:
<ROM>
Options:
--frames <FRAMES> [default: 1]
--out <OUT>
--cpu
--mem-read
--mem-write
--ppu
--apu
--mapper
--nmi
--dma
--full
--kitaqfc-debug <KITAQFC_DEBUG>
--allow-unimplemented
--pad1 <PAD1> [default: 0]
--pad2 <PAD2> [default: 0]
-h, --help Print helpkurosaki audio-export — PCM-Audio als WAV speichern
powershell
kurosaki audio-export out/game.nes --frames 120 --wav out/audio.wavhelp
Usage: kurosaki.exe audio-export [OPTIONS] --wav <WAV> <ROM>
Arguments:
<ROM>
Options:
--frames <FRAMES> [default: 60]
--wav <WAV>
--json <JSON>
--allow-unimplemented
--trace-audio
--pad1 <PAD1> [default: 0]
--pad2 <PAD2> [default: 0]
-h, --help Print helpkurosaki profile — Häufig ausgeführte Codebereiche ermitteln
powershell
kurosaki profile out/game.nes --frames 120 --out out/profile.jsonhelp
Usage: kurosaki.exe profile [OPTIONS] <ROM>
Arguments:
<ROM>
Options:
--frames <FRAMES> [default: 60]
--out <OUT>
--md <MD>
--kitaqfc-debug <KITAQFC_DEBUG>
--allow-unimplemented
-h, --help Print helpkurosaki diagnose — Statische und Laufzeitdiagnosen erstellen
powershell
kurosaki diagnose out/game.nes --frames 120 --out out/diagnostics.jsonhelp
Usage: kurosaki.exe diagnose [OPTIONS] <ROM>
Arguments:
<ROM>
Options:
--frames <FRAMES>
[default: 0]
--out <OUT>
--md <MD>
--emit-diagnostics <EMIT_DIAGNOSTICS>
--check <CHECK>
[possible values: ppu, nmi, mapper, apu, abi, input, fds, asset]
--kitaqfc-debug <KITAQFC_DEBUG>
--allow-unimplemented
--pad1 <PAD1>
[default: 0]
--pad2 <PAD2>
[default: 0]
-h, --help
Print helpkurosaki replay-record — Eine Referenzwiedergabe aufzeichnen
powershell
kurosaki replay-record out/game.nes --frames 120 --out out/replay.jsonhelp
Usage: kurosaki.exe replay-record [OPTIONS] --out <OUT> <ROM>
Arguments:
<ROM>
Options:
--frames <FRAMES> [default: 60]
--out <OUT>
--allow-unimplemented
-h, --help Print helpkurosaki replay-run — Eine aufgezeichnete Eingabefolge ausführen
powershell
kurosaki replay-run out/game.nes out/replay.json --json out/replay-result.jsonhelp
Usage: kurosaki.exe replay-run [OPTIONS] <ROM> <REPLAY>
Arguments:
<ROM>
<REPLAY>
Options:
--load-snapshot <LOAD_SNAPSHOT>
Restore this version-2 snapshot before applying the replay timeline. With this option, --frames and trace bounds are absolute emulator frames
--frames <FRAMES>
--verify
--json <JSON>
--png <PNG>
--snapshot <SNAPSHOT>
--observe-json <OBSERVE_JSON>
--wav <WAV>
--trace-jsonl <TRACE_JSONL>
--trace-start-frame <TRACE_START_FRAME>
--trace-end-frame-exclusive <TRACE_END_FRAME_EXCLUSIVE>
--cpu
--mem-read
--mem-write
--ppu
--apu
--mapper
--nmi
--dma
--full
--allow-unimplemented
-h, --help
Print helpkurosaki snapshot-save — Den Maschinenzustand speichern
powershell
kurosaki snapshot-save out/game.nes --frames 120 --out out/state.kss.jsonhelp
Usage: kurosaki.exe snapshot-save [OPTIONS] --out <OUT> <ROM>
Arguments:
<ROM>
Options:
--frames <FRAMES> [default: 1]
--out <OUT>
--allow-unimplemented
--pad1 <PAD1> [default: 0]
--pad2 <PAD2> [default: 0]
-h, --help Print helpkurosaki snapshot-load — Eine Zustandsdatei untersuchen
powershell
kurosaki snapshot-load out/state.kss.json --json out/state-summary.jsonhelp
Usage: kurosaki.exe snapshot-load [OPTIONS] <SNAPSHOT>
Arguments:
<SNAPSHOT>
Options:
--json <JSON>
-h, --help Print helpkurosaki snapshot-rebase — Einen Zustand auf eine durch eine Kompatibilitätsvereinbarung zugelassene ROM übertragen
powershell
kurosaki snapshot-rebase out/before.nes out/after.nes out/state.kss.json --contract out/compatibility.json --out out/rebased.kss.jsonhelp
Rebind a reviewed v2 snapshot to an explicitly allowlisted compatible ROM
Usage: kurosaki.exe snapshot-rebase [OPTIONS] --contract <CONTRACT> --out <OUT> <SOURCE_ROM> <TARGET_ROM> <SNAPSHOT>
Arguments:
<SOURCE_ROM>
<TARGET_ROM>
<SNAPSHOT>
Options:
--contract <CONTRACT>
--prg-ram-patch <ADDRESS=FILE>
--cpu-ram-patch <ADDRESS=HEXBYTES>
--out <OUT>
--json <JSON>
-h, --help Print helpkurosaki snapshot-resume — Mit einem gespeicherten Zustand fortfahren
powershell
kurosaki snapshot-resume out/game.nes out/state.kss.json --frames 60 --json out/resumed.jsonhelp
Usage: kurosaki.exe snapshot-resume [OPTIONS] <ROM> <SNAPSHOT>
Arguments:
<ROM>
<SNAPSHOT>
Options:
--reset-at-start Reset the CPU after restoring the snapshot while retaining mapper RAM
--frames <FRAMES> [default: 1]
--out <OUT>
--json <JSON>
--png <PNG>
--observe-json <OBSERVE_JSON>
--trace-jsonl <TRACE_JSONL>
--cpu
--mem-read
--mem-write
--ppu
--apu
--mapper
--nmi
--dma
--full
--allow-unimplemented
--pad1 <PAD1> [default: 0]
--pad2 <PAD2> [default: 0]
-h, --help Print helpkurosaki diff — Gespeicherte Ergebnisse vergleichen
powershell
kurosaki diff --before out/before.kss.json --after out/after.kss.json --json out/diff.jsonhelp
Usage: kurosaki.exe diff [OPTIONS] --before <BEFORE> --after <AFTER>
Options:
--before <BEFORE>
--after <AFTER>
--json <JSON>
--md <MD>
-h, --help Print helpkurosaki decompile — Funktionen, Kontrollflussgraphen und Pseudocode rekonstruieren
powershell
kurosaki decompile out/game.nes --format markdown --out out/decompile.mdhelp
Recover bounded function CFGs and readable pseudocode from a mapper context
Usage: kurosaki.exe decompile [OPTIONS] <ROM>
Arguments:
<ROM>
Options:
--out <OUT>
Write the rendered report here; stdout is used when omitted
--format <FORMAT>
[default: json] [possible values: json, markdown, text]
--function <FUNCTIONS>
Function name or Bnnn:$AAAA physical PRG-bank selector. Repeatable
--all
Also start a bounded candidate analysis at $8000 in every physical 8 KiB PRG bank
--annotations <ANNOTATIONS>
JSON annotation sidecar. ROM.decompile.json is loaded automatically when present
--snapshot <SNAPSHOT>
Restore a version-2 snapshot before capturing the PRG-bank windows
--trace-jsonl <TRACE_JSONL>
KUROSAKI trace JSONL to overlay exact physical-bank/PC hit counts
--max-instructions <MAX_INSTRUCTIONS>
Per-function static-analysis cap, preventing data from causing unbounded output [default: 2048]
-h, --help
Print helpkurosaki disasm — CPU-Befehle anzeigen
powershell
kurosaki disasm out/game.nes --bytes 256 --text out/disasm.txthelp
Usage: kurosaki.exe disasm [OPTIONS] <ROM>
Arguments:
<ROM>
Options:
--bytes <BYTES> [default: 256]
--start <START> CPU address in decimal or with a 0x/$ hexadecimal prefix
--snapshot <SNAPSHOT> Restore a version 2 snapshot before reading mapped CPU bytes
--prg-bank-8k <PRG_BANK_8K> Read one exact physical 8 KiB PRG-ROM bank, independent of mapper state
--json <JSON>
--text <TEXT>
-h, --help Print helpkurosaki mapper-test — Das Mapper-Verhalten beobachten
powershell
kurosaki mapper-test out/game.nes --json out/mapper-test.jsonhelp
Usage: kurosaki.exe mapper-test [OPTIONS] <ROM>
Arguments:
<ROM>
Options:
--json <JSON>
-h, --help Print helpkurosaki fds-inspect — Die Diskettenstruktur untersuchen
powershell
kurosaki fds-inspect out/game.fdshelp
Usage: kurosaki.exe fds-inspect [OPTIONS] <DISK>
Arguments:
<DISK>
Options:
--json <JSON>
-h, --help Print helpkurosaki export-assets — Ressourcen aus einer ROM exportieren
powershell
kurosaki export-assets out/game.nes --out out/assetshelp
Usage: kurosaki.exe export-assets --out <OUT> <ROM>
Arguments:
<ROM>
Options:
--out <OUT>
-h, --help Print helpkurosaki report — Aus gespeicherten Beobachtungen einen Bericht erstellen
powershell
kurosaki report out/run.json --md out/report.mdhelp
Usage: kurosaki.exe report --md <MD> <INPUT>
Arguments:
<INPUT>
Options:
--md <MD>
-h, --help Print helpkurosaki mapper-list — Registrierte Mapper auflisten
powershell
kurosaki mapper-listhelp
Usage: kurosaki.exe mapper-list [OPTIONS]
Options:
--all
--json <JSON>
--md <MD>
-h, --help Print helpkurosaki mapper-info — Einen Mapper beschreiben
powershell
kurosaki mapper-info 4help
Usage: kurosaki.exe mapper-info [OPTIONS] <MAPPER>
Arguments:
<MAPPER>
Options:
--json <JSON>
-h, --help Print help