Integracija umetne inteligence
Blockstudio vključuje dve kontekstni datoteki za pomočnike pri kodiranju. Prva je strnjen indeks dokumentacije. Druga vsebuje celotno besedilo vseh dokumentov in shem za orodja, ki želijo celoten korpus v enem zahtevku.
Agent prebere indeks, poišče potreben dokument in ga odpre. Druga možnost je, da agentu posredujete pol megabajta nerazvrščenega besedila, kjer ničesar ni mogoče neposredno nasloviti in se naloži vse, ne glede na ustreznost.
Indeks
blockstudio-llm.txt enkrat navede vsak objavljeni dokument, razvrščen po razdelku in podrazdelku ter v vrstnem redu navigacije. Vsak vnos vsebuje:
route: dokumentacijska URL.file: izvorna pot Markdown v repozitoriju Blockstudio.purpose: enovrstični opis namena dokumenta.settings: potiblockstudio.jsonv lasti tega dokumenta.hooks: imena filtrov in dejanj PHP ter JavaScript v njegovi lasti.php: funkcije, razredi in metode v njegovi lasti.cli: ukazi v njegovi lasti.
## Docs / Dev / Inspection Tools
### Canvas
route: /docs/dev/canvas
file: docs/docs/dev/canvas.md
purpose: A visual workspace and public inventory API for Blockstudio content.
settings: dev/canvas/enabled, ui
hooks: blockstudio/settings/dev/canvas/admin_bar, blockstudio/settings/dev/canvas/enabled
php: Blockstudio\Canvas, Canvas::documents(), Canvas::inventory()
Vrstica z identifikatorjem se zapiše le, če je dokument dejansko lastnik nečesa te vrste, zato zgornji vnos nima vrstice cli, medtem ko je stran za statično predhodno upodabljanje lastnica celotne družine ukazov za predhodno upodabljanje.
Vrstice z identifikatorji omogočajo iskanje po indeksu. Agent, ki išče kavljišče, sproženo pred upodabljanjem bloka, pregleda vrstice za kavljišča in najde PHP Hooks, ki vsebuje celoten nabor izrazov filtrov in dejanj. Agent, ki išče statično predhodno upodabljanje, poišče isto besedo in najde Static Prerendering ter Settings, ki vsebujeta števce oziroma konfiguracijo. Enako so navedene tudi javne sheme JSON, skupaj z njihovo potjo in datoteko.
Identifikatorji se berejo iz besedila, vgrajene kode in primerov kode. Bloki, označeni z text, vsebujejo dobesedni izhod in sezname imenikov, zato so izpuščeni: dokument, ki izpiše izhod ukaza, s tem še ni lastnik tega ukaza.
Celotno besedilo
blockstudio-llm-full.txt je datoteka z vso dokumentacijo in vsemi shemami. Še vedno se ustvarja, objavlja in je dosegljiva, vendar agentu ni več posredovana najprej, kar je navedeno tudi v njenem lastnem glavi.
Kako nastaneta
Obe datoteki se sestavita med gradnjo z npm run build:llm, ki zažene scripts/build-llm.ts. Skript:
- Prebere uvodne metapodatke vsakega objavljenega dokumenta v zbirkah
docs,guidesinregistry, da pridobi njegov naslov, pot in namen. - Iz telesa vsakega dokumenta izlušči identifikatorje, ki so v njegovi lasti: imena kavljišč iz klicev filtrov in dejanj, poti nastavitev, preverjene glede na shemo nastavitev, funkcije in razrede PHP ter ukaze CLI.
- Zapiše indeks v
includes/llm/blockstudio-llm.txt. - Pregleda drevo dokumentacije v vrstnem redu navigacije, odstrani navigacijske Markdown, pri tem pa ohrani naslove in primere kode, doda sheme JSON in zapiše celotno besedilo v
includes/llm/blockstudio-llm-full.txt.
npm run docs:check odpove, če objavljeni dokument manjka v indeksu ali če indeks kaže na datoteko, ki ne obstaja več.
Kako jih uporabljati
- Omogočite nastavitev
ai/enableContextGenerationv svojemblockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
-
Datoteki sta zdaj na voljo na naslovih
your-site.com/blockstudio-llm.txtinyour-site.com/blockstudio-llm-full.txt. -
Nastavite orodje umetne inteligence na indeks:
- Cursor: dodajte URL kot dokument v nastavitvah projekta.
- Claude Code: sklicujte se na URL ali prenesite datoteko in jo dodajte v kontekst projekta.
- GitHub Copilot: vključite datoteko v repozitorij ali se nanjo sklicujte v navodilih.
Delovalo bo vsako orodje, ki kot kontekst sprejema URL ali besedilno datoteko. Obe datoteki sta statični in ne vključujeta podatkov, specifičnih za spletno mesto, kot so vaši registrirani bloki ali trenutne nastavitve.
Lastna pogodba vašega projekta
Indeks opisuje Blockstudio. Ne opisuje pa vašega projekta, ki je druga polovica informacij, potrebnih agentu: kje so bloki in strani, katere funkcije so omogočene ter kaj bo analiza zavrnila. vendor/bin/blockstudio-agents to ustvari iz vašega blockstudio.json in vaših datotek. Oglejte si pogodbo projekta.