Konteksti suurus

Valitud konteksti ja teenusepakkujate juhend käsitleb lähtepakette, täpse toorväljundi taastamist, selgesõnalisi mudeliprofiile ja valikulisi kandidaat-worker-toiminguid. Käsud on avaldatud CLI-s; kontrolli paigaldatud versiooni ja käsu abi.

token estimate

Enne ülesannet hinda failide või selgesõnalise standardsisendi kaudu valitud teadaolevat teksti käsuga bee token estimate. Tokenite eelkontrolli juhend näitab kontekstivalikute võrdlemist, sama sisendi kordamist lipuga --calls, väljundieelarve eraldamist ja kogusummade säilitamist lipuga --limit 0. Vajalik on Bee 1.0.0-beta.16 või uuem.

Vali kontekst, hinda seda, kontrolli piisavust ja täida ülesanne eraldi. Väiksem valik üksi ei tõesta kvaliteeti ega säästu. Seejärel kasuta allolevat mõõdetud kasutuse töövoogu selgelt valitud toetatud logiga; eelkontrolli arvud ei näita tegelikku väljundit, arutlust, vahemälukasutust ega teenusepakkuja tarbimist.

budget –by-item

bee budget "catalog validation" --path src/Catalog/Product.cs --by-item --json

Vaata eelvaadet kontekstist, mille Bee näidispäringu jaoks koostaks. --by-item näitab iga reegli, mälu ja muu elemendi tegelikku UTF-16 märkide panust. Jaotiste pealkirju ja ümbritsevaid markereid arvestatakse eraldi. Sisu ei prindita uuesti. Käsk vajab Bee algseadistust ja seadistatud MongoDB-d.

Tokenihinnang kasutab valemit ceil(UTF-16 märgid / 4). See ei ole mudeli kasutus- ega arveldusandmed. Eraldi ümardatud hinnangute summa võib koguhinnangust erineda. Eelarve eelvaade ei loo edastuskviitungit.

context audit

bee context audit --from AGENTS.md --against docs --root . --json

Võrdle valitud Markdown-allikat faili või kataloogiga. Audit näitab failiräsisid, suurusi, allika jaotiste asukohti ning normaliseeritud duplikaadikandidaate. See töötab võrguühenduseta enne konfiguratsiooni ja MongoDB kasutamist ega muuda allikafaile.

Allika loend näitab kuni 200 jaotist, suurima sisuga esimesena, ka duplikaatide puudumisel. Sisu maht põhineb normaliseeritud tekstil; pealkirju ja piirimärke arvestatakse algse faili suurusest eraldi.

Duplikaadikandidaadid on vähemalt 64 normaliseeritud märgiga identsed plokid. BOM ja realõpud normaliseeritakse; lõigupiirid ja ATX-pealkirjad jäetakse võrdlusest välja. Muud tühikud, kood, tähesuurus ja kirjavahemärgid säilivad. Vaste ei tõenda, et kohustuse võib ohutult kustutada.

Lugemine ja väljund on piiratud. Teed peavad jääma valitud juurkataloogi; sümbollingid ja ebaregulaarsed failid lükatakse tagasi. Loetamatu, muutunud või piiri ületav sisend annab mittetäieliku raporti. macOS-is kasuta /tmp sümbollingi asemel füüsilist teed, näiteks /private/tmp.

Väljumiskoodid: 0 täielik, kandidaate pole; 1 täielik, kandidaadid leitud; 4 vigased argumendid; 5 mittetäielik. Enne raporti ammendavaks pidamist kontrolli väljajäetud tulemuste arvu.

test summarize

bee test summarize TestResults/results.trx --json

Loe olemasolevat TRX-testiraportit ilma kogu XML-i agendi konteksti lisamata. Bee näitab koguarve, üksikuid ebaõnnestumisi, piiratud diagnostikat ja raporti räsi. Käsk ei käivita teste, ei loe manuseid ega võta ühendust teenusega; algseadistus ja MongoDB pole vajalikud. Esimene lugeja toetab UTF-8 TRX-i lameda tulemuste loendiga; pesastatud InnerResults märgitakse toetamata kujuks ja raport on mittetäielik.

Parsimise täielikkus ja testide tulemus on eraldi. Vigane, lõpetamata või toetamata raport ei tõenda edu. Ka testideta raport pole edukas testijooks. Testiprotsessi algne väljumiskood pole teada: käsk kirjeldab valitud faili, mitte praeguse checkout’i sõltumatult kontrollitud testijooksu.

Vaikimisi näidatakse ainult mitteläbitud tulemuste üksikasju. Läbitud testide kaasamiseks kasuta --include-passed. --limit piirab nähtavate kirjete arvu, --budget väljundi märke; limiidi tõttu väljajäetud ja tahtlikult välistatud läbitud tulemused loendatakse eraldi.

Sama nimega tulemuste eraldi käivituse identiteedid säilivad. Pikad kärbitud diagnostikatekstid ja väljajäetud tulemused on selgelt märgitud. Nende põhjal otsusta, kas lugeda algset raportit; kokkuvõte ei korda kogu XML-i ega kogutud standardväljundit. Piirangute ja väljumiskoodide kohta vaata bee test summarize --help.

Vali väiksem vastus

Kasuta neid tööriistu, kui agent vajab tõendeid kõiki lähtefaile, logisid või aruandeid lugemata. Allolevad võrguühenduseta näited kasutavad sünteetilisi andmeid. budget --by-item vajab seadistatud andmehoidlat; see on prognoos, mitte teenuse mõõdetud kasutus.

Väljund	Piir ja ühik	Mida kontrollida
graph outline --compact --budget N	Vaikimisi 12 000; 2048–65 536 UTF-16 koodiühikut, lõpureavahetus välja arvatud	Veeruread säilitavad deklaratsiooniväljad; counts, omittedMetadata, värskus ja katvus
Graafiseoste --output-budget-chars N	Vähemalt 256 UTF-16 koodiühikut koos lõpureavahetusega; nõuab --json	output.omittedItems, omittedByPath, legacyComplete ja päringu kärpimine
test summarize --budget N	Vaikimisi 16 000; 2048–65 536 UTF-16 koodiühikut, lõpureavahetus välja arvatud	Tagastatud/väljajäetud kirjed, välja jäetud edukad tulemused ja lühendatud diagnostika
code runs list/show --budget N	Vaikimisi 16 000; 2048–65 536 UTF-16 koodiühikut koos lõpureavahetusega	Terviklus, algne analüüsitulemus ja väljajäetud kirjed

UTF-16 ühikud pole UTF-8 baidid ega teenuse tokenid: A kasutab ühte ühikut, paljud emojid kahte. Varasem graafipäringu --budget arvestab kolm märki nominaalse tokeni kohta ja piirab päringu tulemust, mitte tervet JSON-i. Ära aja seda segi outline’i märgieelarvega. Kui kohustuslik metaandmestik ei mahu terve väljundi eelarvesse, on kood 4; suurenda eelarvet.

Kompaktne outline jagab välju result.columns ja result.idPrefix; täis-ID = prefiks + rea sufiks. See eemaldab korduva struktuuri deklaratsioonivälju säilitades. Seosepäringu --compact eemaldab seevastu kirjeldavad loendiväljad. Kumbki ei taga väiksemat arvet ega kiiremat päringut. Vaata kodeerimisnäitest, kuidas outline’i järgi ridu valida.

Taaskasuta värskust eeldamata

Graaf salvestatakse kohalikult; seosepäringud võivad seda ehitada/uuendada, kui --no-refresh puudub. Outline ei uuenda kunagi. Kompilaatorianalüüsi salvestamine on teadlik valik:

bee code analyze --engine roslyn --save-run --json
bee code runs list --json --limit 10 --budget 4096
bee code runs show <run-id> --json --limit 20 --budget 8192

Kasuta tagastatud runId väärtust. show kood 0 tähendab faili edukat lugemist ka siis, kui analysisExitCode on 1 või 5. integrity: verified kontrollib salvestatud baite, mitte tänase lähtekoodi, tööriistade või seadete vastavust. Asjakohaste muudatuste järel analüüsi uuesti; vt analüüsiajalugu. Salvestatud aruande lugemine väldib uut analüüsi, kuid ei tõesta teenuse prompt-vahemälu kasutust.

Mõõdetud kasutus ühest valitud logist

Kasuta seda toetatud kohaliku Codexi logi ja täpse thread UUID korral. Seadistust ega teenust pole vaja. Kahe reaga sünteetiline rollout.jsonl näitab toetatud loendurikuju:

{"timestamp":"2026-09-22T12:00:00Z","type":"session_meta","payload":{"id":"11111111-1111-4111-8111-111111111111","cli_version":"0.155.0","originator":"codex_exec"}}
{"timestamp":"2026-09-22T12:00:01Z","type":"event_msg","payload":{"type":"token_count","info":{"total_token_usage":{"input_tokens":100,"cached_input_tokens":60,"output_tokens":20,"reasoning_output_tokens":5,"total_tokens":120},"last_token_usage":{"input_tokens":100,"cached_input_tokens":60,"output_tokens":20,"reasoning_output_tokens":5,"total_tokens":120},"model_context_window":258400}}}

bee budget --measured --harness codex --session 11111111-1111-4111-8111-111111111111 --log rollout.jsonl --json

Näide tagastab koodi 0 ja skeemi 2: history.latest.cumulative sisaldab input 100, cached input 60, uncached input 40, output 20 ja total 120. Reasoning 5 on väljundi alamhulk; cached input sisaldub juba sisendis. Response-voog on tühi. cost, requestCount, usage ja lastRequestUsage on null. Need näitearvud ei mõõda säästu.

Hoia response ja history eraldi; ära liida vooge, hetktõmmiseid ega segmente. context_estimate, context_window_synthesis ja history_with_estimated_baseline märgivad hinnangulisi ajalooaluseid. Arvuline kooskõla ei tõesta arveldust, kõigi päringute salvestamist, mudeli tähelepanu ega Bee tekitatud säästu. complete kirjeldab antud hetktõmmist; seansi lõplikkus on teadmata ja alamharusid ei kaasata automaatselt.

Kõik kolm valikut on kohustuslikud. Toetatud on ainult kindlad Codexi logikujud; teised keskkonnad annavad koodi 5. Vale thread, muutuv/rikutud sisend ja toetamata kirjed on puudulikud (5), valed lipud vigased (4). Kasuta füüsilist tavafaili teed: ka ülemkaustade sümbollingid lükatakse tagasi. Piirid on 32 MiB/fail, 4 MiB/rida, 100 000 rida ja 10 000 kasutusvaatlust. Katkine lõpp võib säilitada varasemad vaatlused, kuid annab siiski koodi 5.

Loe rikkega testiaruannet

Salvesta see sünteetiline UTF-8 aruanne failina failure.trx. See kirjeldab riket ega pärine käivitatud testikomplektist:

<TestRun id="33333333-3333-4333-8333-333333333333" xmlns="http://microsoft.com/schemas/VisualStudio/TeamTest/2010">
  <Results><UnitTestResult testId="11111111-1111-4111-8111-111111111111" executionId="22222222-2222-4222-8222-222222222222" testName="PriceTests.Total" outcome="Failed"><Output><ErrorInfo><Message>Expected 42; got 41.</Message></ErrorInfo></Output></UnitTestResult></Results>
  <ResultSummary outcome="Failed"><Counters total="1" executed="1" passed="0" failed="1" error="0" timeout="0" aborted="0" inconclusive="0" passedButRunAborted="0" notRunnable="0" notExecuted="0" disconnected="0" warning="0" completed="0" inProgress="0" pending="0"/></ResultSummary>
</TestRun>

bee test summarize failure.trx --limit 5 --budget 8000 --json

Tulemus sisaldab parserStatus: complete, testVerdict: failed, ühte kirjet ja koodi 1. Diagnostika on “Expected 42; got 41.” producerExitCode jääb nulliks. Käivituse ID eemaldamine annab toetamata kuju ja incomplete/5. Kokkuvõtte räsi tuvastab antud baidid, mitte nende päritolu või ajakohasuse.

Ülaltoodud context audit näide annab täieliku kontrolli korduskandidaatide korral koodi 1; vaata totalFindings, returnedFindings ja omittedFindings. Enne eemaldamist hinda, kas juhist vajatakse mõlemas kohas. Ebaolulise juhiste edastamise vähendamiseks jätka käitumise töövooga.

Uuri katvusaruannet (beta.14)

Kasuta seda siis, kui testikäivitus on juba loonud katvusaruande ja soovid valida järgmisena uuritavad lähtekoodiread. Vaja on Bee versiooni 1.0.0-beta.14 või uuemat ning üht olemasolevat Cobertura, OpenCoveri või LCOV aruannet. See töötab võrguühenduseta, lähtestamise, andmebaasi ja mudeliteenuseta. Väikese näitena salvesta see sünteetiline aruanne faili coverage.lcov; src/Calculator.cs on aruandes olev nimi ning faili olemasolu pole parsimiseks vajalik.

SF:src/Calculator.cs
DA:10,3
DA:11,0
LF:2
LH:1
BRDA:10,0,0,3
BRDA:10,0,1,0
BRF:2
BRH:1
end_of_record

bee code coverage import coverage.lcov --format lcov --json

Tulemuses on status: complete, exitCode: 0 ja tühi issues loend. Kirjes files on faili src/Calculator.cs mõõdikutel lines ja branches väärtused state: known, total: 2, covered: 1 ning percent: 50. Need on eraldi mõõtmised: lineData näitab real 10 kolme tabamust ja real 11 nulli; branchData näitab real 10 üht läbitud ja üht läbimata haru. Selle ülevaate jaoks ei avatud lähtekoodi ega käivitatud teste.

Enne vaatluste kasutamist loe status ja issues. Puuduv mõõtmine on unknown ning protsent null; selgesõnaline nullnimetaja on not-applicable, samuti nullprotsendiga. Kumbki ei tähenda 100%. Kood 0 kinnitab parsimist toetatud alamhulgas, mitte katvuslävendi läbimist või usaldusväärset QA-heakskiitu. Kood 4 tähendab vigast kasutust; kood 5 puudulikku, ebaturvalist, toetamata, vastuolulist või liiga suurt sisendit. Vigane või ebaturvaline sisend võib anda ainult veaobjekti. Puudulikus aruandes säilinud vaatlusi ei tohi lugeda täielikuks katvuseks.

Sisend peab olema tavaline UTF-8 fail suurusega kuni 8 MiB, ilma sümboolsete linkideta kogu failitees. Vali sobiv --format ning tõrke korral loe error või issues. Kasuta toetatud alamhulgas eksporditud aruannet; ära kustuta vastuolulisi kirjeid lihtsalt koodi 0 saamiseks. Näiteks DTD-ga XML pole toetatud. Bee kirjutab tulemuse stdout-i; import ei salvesta ajalugu, liida käivitusi, loe lähtekoodi ega käivita teste. Kehtivad lugemise, parsimise ja väljundi piirangud.

Hoia rawSha256 koos algse aruandega selle baitide tuvastamiseks. Valikud nagu --source-revision ja --source-snapshot on kontrollimata deklaratsioonid: sourceBinding jääb väärtusele not-established, checkedSource väärtusele not-read ja qaAcceptance väärtusele not-assessed. Need ei kinnita praeguse lähtekoodi värskust ega uue koodi katvust.

Agendi järgmise sammu jaoks selgita esmalt välja, millisest lähtekoodi revisjonist aruanne pärineb. Seejärel uuri aruandes nimetatud faili rida 11 kui läbimata rida ning rida 10 selle harude käitumise jaoks. Vali asjakohased deklaratsioonid ja kutsujad kodeerimise töövoo abil; katvus ei tähenda piisavaid kontrollväiteid ega kõiki hoidla faile. Hoia testitulemused ja käivitaja algne väljumiskood eraldi koos testikokkuvõtetega. beta.14 märkmetes on kõigi kolme vormingu käsud ja kõik deklaratsioonivalikud.