AI

ZX Spectrum spēles ar AI aģentiem: zx-framework un MELTDOWN

Mūsu studijas dibinātājs ar atvērtā koda ietvaru zx-framework liek AI aģentiem rakstīt ZX Spectrum programmas C valodā. Tā top Tetris un tower defense spēle MELTDOWN.

FSM Studio · · 4 min lasīšanai

Ilustrācija: 8 bitu dators ar tastatūru un mazs robots blakus, terakota un zilās krāsās

Vai AI kodēšanas aģents spēj uzrakstīt programmu 8 bitu datoram, kuram ir 48 vai 128 kilobaiti atmiņas? Mūsu studijas dibinātājs to pārbauda trijos atvērtā koda projektos: ietvarā zx-framework, spēlē zx-tetris un spēlē MELTDOWN, kas vēl top. Tie nav FSM produkti, bet personīgi projekti; šeit pastāstām, kā tie darbojas un ko no tiem var aizņemties darbam ar aģentiem.

Ko satur zx-framework

zx-framework ir starta ietvars ZX Spectrum 48K un 128K programmām (spēlēm, utilītām, demo) C valodā ar z88dk kompilatoru. To vada no Claude Code. README uzsver, ka viss ir konteinerizēts: vajag tikai Docker.

Komplektā ir:

  • Instrumenti Docker vidē: z88dk (C uz Z80 un .tap failu), bezgalvas ZEsarUX emulators, z80dasm un Python integrācijas scenārijiem.
  • Piecu aģentu konveijers: katrs uzdevums no docs/tasks/ iet cauri plānotājam, kodētājam, testētājam, recenzentam un dokumentētājam ar komandu /task <id>.
  • Pētnieks: svešu .tap, .sna vai .rom failu ieliek mapē imports/, uzdod jautājumu, un aģents sagatavo ziņojumu, balstītu uz reālu dizasemblēšanu.
  • Aparatūras uzziņa zx-arch: atmiņas karte, ekrāna izkārtojums, atribūti, tastatūras matrica, bīperis, AY-3-8912, 50 Hz pārtraukums un 128K banku pārslēgšana ar saitēm uz oriģinālavotiem.
  • /quick-start: aptauja par projektu, docs/PROJECT.md melnraksts, pirmie uzdevumi un instrumentu pārbaude.

Kā aģents pārbauda savu darbu

Ar aģentu nepietiek, ja nevar pārbaudīt rezultātu. Tāpēc ietvars satur pārbaudes pakalpojumus. smoke ielādē .tap bezgalvas ZEsarUX un pārbauda, ka programmas skaitītājs nav 0x0000, un nofotografē ekrānu. integration palaiž JSON scenārijus pa ZRCP. Ir arī trace (cikliski precīzs z88dk-ticks izsekojums) un divi dizasembleri.

Katrs uzdevums satur pieņemšanas kritērijus un Test plan bloku: skip, smoke-only vai konkrētu scenāriju sarakstu. Recenzents salīdzina katru kritēriju ar izmaiņām un testētāja artefaktiem. Ja rezultāts ir FAIL vai REWORK, darbs atgriežas pie kodētāja. Ja ir INFRA_ERROR, konveijers apstājas.

zx-tetris: mazs projekts, kurā var redzēt tehniskos lēmumus

zx-tetris ir klasisks Tetris ZX Spectrum 128K, rakstīts C valodā, kompilēts uz .tap un palaists Fuse emulatorā. README to sauc par hobija projektu zema līmeņa 8 bitu programmēšanas apguvei. Spēle būvēta no nulles: viena šūna ir viens rakstzīmes lauciņš, ieraksti notiek tieši ekrāna atmiņā 0x4000 un atribūtos 0x5800, bez augsta līmeņa grafikas bibliotēkas.

Spēlē ir septiņas figūras, NES līmeņu un gravitācijas tabula, NES punktu skaitīšana, mīkstā un cietā nolaišana, HUD un bīpera skaņas efekti. Interesantākā ir README sadaļa par ne tik acīmredzamiem lēmumiem:

  • Nav printf. Noklusējuma konsoles draiveris neinterpretē pozicionēšanas baitus, tāpēc teksts tiek zīmēts, kopējot 8 baitu glifus no ROM fonta.
  • Pirms katra intrinsic_halt() jāizsauc intrinsic_ei(), citādi pirmais HALT uz visiem laikiem aizķeras.
  • Kompilators sccz80 ir stingrs C89: nav inline, mainīgie jādeklarē bloka sākumā.
  • Funkcijā zx_cxy2saddr(x, y) pirmais arguments ir kolonna, otrais ir rinda; sajaucot iznāk transponēts attēls.

Tādas niansītes ir labs iemesls turēt uzdevumu aprakstos un pabeigšanas piezīmēs to, kas atšķīrās no plāna: nākamais aģents tās neatklās no jauna.

MELTDOWN: tower defense uz zx-framework

MELTDOWN ir zinātniskās fantastikas tower defense spēle ZX Spectrum 128K. Projekts ir izstrādē, un šeit mēs balstāmies uz tā sākotnējo vīziju (docs/PROJECT.md), nevis uz gatavu spēli.

Spēlētājs vada kosmosa reaktora automātiskās aizsardzības sistēmas. Starp viļņiem ir būvēšanas fāze, tad ar ENTER izlaiž nākamo vilni. Katrs ienaidnieks, kas izlauzies līdz kodolam, palielina reaktora nestabilitāti; ja stabilitāte nokrītas līdz nullei, reaktors izkūst (MELTDOWN) un spēle ir zaudēta. Pirmajai versijai (MVP) plānota viena karte un 6-8 viļņi, trīs torņi (LASER, MISSILE, TESLA) un trīs ienaidnieku veidi (DRONE, RUNNER, BRUTE).

Dokuments pamato arī izvēli: tīrs tower defense ZX klasiskajā laikmetā neesot bijis, bet tā mehānika labi der platformai. Šūnu režģis, veselu skaitļu aritmētika, maz objektu ekrānā un loģika 50 Hz kadru ciklā. Šaušana MVP ir momentāna un parādās kā īss mirgojums, lai izvairītos no atribūtu konflikta.

Grafikai plānots izmantot Google Gemini attēlu modeli: tas ģenerē PNG, bet projekta skripts pārvērš tos ZX formātos. README gaida tikai ielādes ekrānu un titulattēlu kā tiešu ieguvumu; spēles glifus roku darbs noslīpēs.

Ierobežojumi

  • Licence. Visu trīs repozitoriju README norāda MIT, taču LICENSE faila repozitorijos nav. zx-tetris README paskaidro: mācību projekts, nav pārdošanai.
  • MELTDOWN nav gatavs. Tas ir izstrādē; mēs nesolām datumus vai spēles gatavību.
  • Kvalitāti nenodrošina aģents viens pats. Konveijers un testi ir tas, kas ļauj rezultātu pārbaudīt; README to uzsver ar recenzijas un testa soļiem.
  • Šī ir niša. ZX Spectrum projekti nav FSM pakalpojums, bet piemērs tam, kā strukturēt darbu ar aģentiem.

Ko no tā izmantot savos projektos

Ja plānojat uzticēt AI aģentam reālu kodu, ņemiet no zx-framework principus, nevis platformu: uzdevums ar pieņemšanas kritērijiem, atsevišķi lomu soļi, automātiska pārbaude un pabeigšanas piezīme. Ja vēlaties ieviest šādu procesu uzņēmumā, skatiet AI automatizāciju, izlasiet kas ir AI kodēšanas rīki vai kā aģents ziņo par paveikto ar balsi. Visi projekti ir atvērtā koda sadaļā.

Ja jums ir process, kuru vēlaties nodot aģentiem, apspriediet projektu ar mums.

Avoti