Liigu sisu juurde

Tehisintellekti integratsioon

Blockstudio sisaldab kodeerimisabiliste jaoks kahte kontekstifaili. Esimene on dokumentatsiooni kompaktne indeks. Teine sisaldab iga dokumendi ja skeemi täisteksti tööriistade jaoks, mis vajavad kogu andmekogumit ühes päringus.

Agent loeb indeksit, leiab vajaliku dokumendi ja avab selle. Teine võimalus oleks anda agendile pool megabaiti eristamata proosat, milles miski pole adresseeritav ja kogu sisu laaditakse olenemata selle asjakohasusest.

Indeks

blockstudio-llm.txt loetleb iga avaldatud dokumendi ühe korra ning rühmitab need jaotise ja alajaotise järgi navigeerimisjärjekorras. Iga kirje sisaldab järgmist:

  • route: dokumentatsiooni URL.
  • file: Blockstudio hoidla Markdown lähtefaili tee.
  • purpose: üks rida dokumendi eesmärgi kohta.
  • settings: dokumendile kuuluvad blockstudio.json teed.
  • hooks: dokumendile kuuluvad PHP ja JavaScript filtrite ning toimingute nimed.
  • php: dokumendile kuuluvad funktsioonid, klassid ja meetodid.
  • cli: dokumendile kuuluvad käsud.
Text
## 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()

Identifikaatoririda lisatakse ainult siis, kui dokument sisaldab vastavat tüüpi üksust. Seetõttu pole ülaltoodud kirjel cli rida, samas kui staatilise eelrenderdamise leht sisaldab kogu eelrenderdamise käskude perekonda.

Identifikaatoriridade abil saab indeksilt vastuseid leida. Ploki renderdamisele eelnevalt käivituva konksu otsiv agent sirvib konksuridu ja jõuab lehele PHP Hooks, mis sisaldab kõiki filtri- ja toimingunimesid. Staatilise eelrenderdamise kohta otsides leiab agent sama sõna järgi lehed Static Prerendering ja Settings, mis kirjeldavad vastavalt loendureid ja konfiguratsiooni. Samamoodi on loetletud viis avalikku JSON skeemi koos nende marsruudi ja failiga.

Identifikaatorid loetakse proosast, reasisest koodist ja koodinäidetest. Märgisega text plokid sisaldavad sõnasõnalist väljundit ja kataloogiloendeid, mistõttu jäetakse need vahele: käsu väljundit kuvav dokument ei saa selle käsu omanikuks.

Täistekst

blockstudio-llm-full.txt on ühes failis olev täielik dokumentatsioon ja kõik skeemid. See luuakse endiselt automaatselt, avaldatakse ja sellele saab endiselt viidata, kuid see pole enam esimene sisu, mis agendile antakse, ning faili päises on see selgelt öeldud.

Kuidas need luuakse

Mõlemad failid pannakse ehitamise ajal kokku käsuga npm run build:llm, mis käivitab scripts/build-llm.ts. Skript teeb järgmist:

  1. Loeb pealkirja, marsruudi ja otstarbe jaoks kõigi avaldatud dokumentide esimese metaandmeploki kogudest docs, guides ja registry.
  2. Võtab iga dokumendi sisust selle identifikaatorid: konksude nimed filtri- ja toiminguväljakutsetest, seadete skeemiga valideeritud seadistusteed, funktsioonid ja klassid PHP ning käsud CLI.
  3. Kirjutab indeksi faili includes/llm/blockstudio-llm.txt.
  4. Läbib dokumentatsioonipuu navigeerimisjärjekorras, eemaldab ainult navigeerimiseks mõeldud Markdown, säilitades pealkirjad ja koodinäited, lisab JSON skeemid ning kirjutab täisteksti faili includes/llm/blockstudio-llm-full.txt.

npm run docs:check annab vea, kui avaldatud dokument puudub indeksist või kui indeks viitab failile, mida enam pole.

Kuidas neid kasutada

  1. Lubage oma blockstudio.json-is säte ai/enableContextGeneration:
JSON
{
  "ai": {
    "enableContextGeneration": true
  }
}
  1. Failid on nüüd saadaval asukohtades your-site.com/blockstudio-llm.txt ja your-site.com/blockstudio-llm-full.txt.

  2. Suunake oma tehisintellekti tööriist indeksi juurde:

    • Cursor: lisage URL dokumendina oma projekti sätetesse.
    • Claude Code: viidake üksusele URL või laadige fail alla ja lisage see projekti konteksti.
    • GitHub Copilot: lisage fail hoidlasse või viidake sellele juhistes.

Kontekstina sobib iga tööriist, mis aktsepteerib URL või tekstifaili. Mõlemad failid on staatilised ega sisalda saidipõhiseid andmeid, näiteks teie registreeritud plokke või praeguseid sätteid.

Teie projekti enda leping

Indeks kirjeldab Blockstudio. See ei kirjelda teie projekti, mis on teine pool sellest, mida agent vajab: plokkide ja lehtede asukohad, lubatud funktsioonid ning analüüsi käigus tagasilükatav sisu. vendor/bin/blockstudio-agents loob selle teie blockstudio.json ja failide põhjal. Vaadake projekti lepingut.