AI integrācija
Blockstudio nodrošina divus konteksta failus kodēšanas asistentiem. Pirmais ir kompakts dokumentācijas rādītājs. Otrajā ir visu dokumentu un shēmu pilns teksts, paredzēts rīkiem, kuri vēlas saņemt visu korpusu vienā pieprasījumā.
Aģents nolasa rādītāju, atrod vajadzīgo dokumentu un atver to. Alternatīva ir nodot aģentam pusmegabaitu nediferencēta teksta, kurā neko nevar adresēt un viss tiek ielādēts neatkarīgi no tā, vai tas ir būtisks.
Rādītājs
blockstudio-llm.txt vienreiz uzskaita visus publicētos dokumentus, sagrupētus pēc sadaļas un apakšsadaļas, kurai tie pieder, navigācijas secībā. Katrā ierakstā ir:
route: dokumentācijas URL.file: Blockstudio repozitorijā esošais Markdown avota ceļš.purpose: viena rinda, kas apraksta dokumenta nolūku.settings: dokumenta pārvaldītieblockstudio.jsonceļi.hooks: dokumenta pārvaldītie PHP un JavaScript filtru un darbību nosaukumi.php: dokumenta pārvaldītās funkcijas, klases un metodes.cli: dokumenta pārvaldītās komandas.
## 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()
Identifikatora rinda tiek rakstīta tikai tad, ja dokumentam patiešām pieder kaut kas attiecīgajā kategorijā. Tāpēc iepriekš minētajam ierakstam nav cli rindas, bet statiskās iepriekšējās renderēšanas lapa pārvalda visu iepriekšējās renderēšanas komandu saimi.
Identifikatoru rindas ļauj rādītājam atbildēt uz vaicājumiem. Aģents, kas meklē āķi, kurš tiek izsaukts pirms bloka renderēšanas, pārskata āķu rindas un nonāk pie PHP Āķi, kas pārvalda visu filtru un darbību nosaukumu kopu. Aģents, kas meklē statisko iepriekšējo renderēšanu, meklē to pašu vārdu un nonāk pie Statiskā iepriekšējā renderēšana un Iestatījumi, kas attiecīgi pārvalda skaitītājus un konfigurāciju. Piecas publiskās JSON shēmas ir uzskaitītas tāpat, norādot to maršrutu un failu.
Identifikatori tiek nolasīti no teksta, iekļautā koda un koda piemēriem. Bloki, kas marķēti ar text, satur burtisku izvadi un direktoriju sarakstus, tāpēc tie tiek izlaisti: dokuments, kas parāda komandas izvadi, tādēļ nekļūst par šīs komandas īpašnieku.
Pilnais teksts
blockstudio-llm-full.txt ir pilna dokumentācija un visas shēmas vienā failā. Tas joprojām tiek ģenerēts, publicēts un ir adresējams, taču aģentam tas vairs netiek pasniegts pirmais, un pašā failā tas ir norādīts galvenē.
Kā tie tiek izveidoti
Abus failus būvēšanas laikā izveido npm run build:llm, kas palaiž scripts/build-llm.ts. Skripts:
- Nolasa katra publicētā dokumenta priekšpuses metadatus
docs,guidesunregistrykolekcijās, lai iegūtu nosaukumu, maršrutu un nolūku. - Izvelk katra dokumenta saturā pārvaldītos identifikatorus: āķu nosaukumus no filtru un darbību izsaukumiem, iestatījumu ceļus, kas validēti pēc iestatījumu shēmas, PHP funkcijas un klases, kā arī CLI komandas.
- Ieraksta rādītāju failā
includes/llm/blockstudio-llm.txt. - Navigācijas secībā iziet cauri dokumentācijas kokam, izņem tikai navigācijai paredzēto Markdown, saglabājot virsrakstus un koda piemērus, pievieno JSON shēmas un ieraksta pilno tekstu failā
includes/llm/blockstudio-llm-full.txt.
npm run docs:check neizdodas, ja rādītājā trūkst publicēta dokumenta vai ja rādītājs norāda uz failu, kas vairs nepastāv.
Kā tos izmantot
- Iespējojiet iestatījumu
ai/enableContextGenerationsavāblockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
-
Faili tagad ir pieejami adresēs
your-site.com/blockstudio-llm.txtunyour-site.com/blockstudio-llm-full.txt. -
Norādiet AI rīkam rādītāju:
- Cursor: pievienojiet URL kā dokumentu sava projekta iestatījumos.
- Claude Code: norādiet URL vai lejupielādējiet failu un pievienojiet to projekta kontekstam.
- GitHub Copilot: iekļaujiet failu repozitorijā vai norādiet uz to savās instrukcijās.
Der jebkurš rīks, kas pieņem URL vai teksta failu kā kontekstu. Abi faili ir statiski un nesatur vietnei specifiskus datus, piemēram, reģistrētos blokus vai pašreizējos iestatījumus.
Jūsu projekta līgums
Rādītājā aprakstīts Blockstudio. Tajā nav aprakstīts jūsu projekts — otra puse no informācijas, kas aģentam vajadzīga: kur atrodas bloki un lapas, kuras funkcijas ir iespējotas un ko analīze noraidīs. vendor/bin/blockstudio-agents to ģenerē no jūsu blockstudio.json un jūsu failiem. Skatiet projekta līgumu.