Edastatud väljund ja kasutus

Vajalik on Bee 1.0.0-beta.16 või uuem koos käsuga bee delivery. Kontrolli oma käivitatava faili tuge käsuga bee delivery --help.

Suurus	Mida see näitab?
Mõõdetud UTF-8 baidid	Bee lõpliku väljundi maht pärast edukat kirjutamist ja puhvri tühjendamist, koos edastusümbrise ja reavahetusega. See on kohaliku väljundi vaatlus.
Nimetatud tokenihinnangud	utf16-ceil-div4, versioon 1: lõpliku väljundi UTF-16 koodiühikute arv jagatakse neljaga ja ümardatakse üles. See pole teenusepakkuja tokeniseerija.
Väljast antud teenusepakkuja kasutus	Eraldi käsk bee budget --measured loeb loendureid selgesõnaliselt valitud kohalikust Codexi logist. Edastusaruanded neid loendureid ei kogu ega ühilda.
Sääst, kulu ja reeglite järgimine	Mõõtmata. Väljundibaidid ja hinnangud ei tõenda teenusepakkuja tarbimist, arveldust, säästu, mudeli reeglijärgimist ega kvaliteeti.

Loe olemasolevat vaatlust

Operaator või agent saab enne konteksti läbivaatamist uurida, mida Bee edukalt kirjutas. Lase olemasoleval Claude’i UserPromptSubmit haagil tavapäraselt töötada ja loe seejärel kohalikke metaandmeid. Aruande saamiseks pole teist haagikutset vaja: uus väljundi väljastamine võib luua uue sündmuse.

Vaikehoidla on ~/.bee/usage/delivery-v1. Muutujaga BEE_HOME on tee $BEE_HOME/.bee/usage/delivery-v1; BEE_HOME on .bee ülemkataloog. Report ja read nõuavad selgesõnalist --store väärtust ning töötavad enne seadistuse või uuenduste kontrolli. Lähtestamine, andmebaas, mudel ega võrguühendus pole vajalik.

delivery_store="${BEE_HOME:-$HOME}/.bee/usage/delivery-v1"
bee delivery --help
bee delivery report --store "$delivery_store" --limit 100

Alusta väljadest totalsStatus, issues, deliveredEvents ja deliveredUtf8Bytes. Baitide ja hinnangute summadesse lähevad ainult Delivered kirjed. eventKinds kirjeldab ka salvestatud kirjutusvigu; ebaõnnestunud või osalise kirjutuse kavandatud maht pole edastatud baitide arv. Hinnangumassiiv hoiab hindajate ID-d ja versioonid lahus.

totalsStatus: lower_bound tähendab, et vaatlusi leidub, mitte et ajavahemik on täielikult kaetud. observationWindowComplete on alati false; droppedObservationCount ja measuredProviderTokens on null. Puuduv tõendus jääb teadmata ka siis, kui arvulised loendurid on nullid.

Leia vajalik seanss ja väljundipind

Küsimus	Toetatud vaatlus ja piirang
Milline väljundipind?	Vaata groups kirjeid väärtusega dimension: surface: hook.prompt.plain või hook.prompt.context-json. Pinnapõhist filtrit pole. Mõlemad on sama viibahaagi väljundivormingud.
Milline seanss?	Kasuta koos --session-kind ja --session. Natiivkirjed kasutavad claude-native-session tüüpi ja natiivset UUID-d. Seansirühmades on identity seansi ID ja version selle identiteeditüüp. Sobivus peab olema täpne ja on tõstutundlik.
Milline allikas või retsept?	Natiivkirjetes on sourceRefHash: null ja recipeHash: null. Need on teadmata ja võrreldamatud. Koondüksus steering-block, versioon 1, ei tuvasta üksikut reeglit ega allikarevisjoni. Allikafiltrit pole.
Milline olek?	Vaata eventKinds; kui sündmuse UUID on juba teada, uuri käsuga read välja observation.observation.kind. Natiivsed Withheld-summad pole saadaval: nativeWithheldEvents: null, nativeWithheldStatus: unavailable_no_native_producer.
Milline ajavahemik?	Teadaoleva kirje observation.observation.observedAtUtc on kirjutuskatse UTC vaatlusaeg. Aruandel pole ajavahemikufiltrit, ajavahemiku summasid ega sündmusloendit; täielikku algus- ja lõpphetkega akent ei saa tõendada.

Järgmine UUID on sünteetiline. Asenda see oma vaatluse täpse natiivse seansi ID-ga:

bee delivery report --store "$delivery_store" \
  --session-kind claude-native-session \
  --session 11111111-1111-4111-8111-111111111111 --limit 100

groups esitab sama edastatud väljundi kolme vaadet: üksus, pind ja seanss. Ära liida nende summasid omavahel. --limit piirab rühmi kõigi kolme vaate peale, mitte sündmusi ega sisendbaite; summad arvutatakse enne seda piiri. Vaikimisi ja suurim väärtus on 100; 0 annab summad ilma rühmadeta. Kontrolli omittedGroups. Kui rühmi jäeti välja, suurenda väiksemat piiri või vali üks teadaolev seanss ja käivita uuesti. Jätkukursorit ega lehekülgede kaupa lugemist pole; üle 100 rühma ei saa ühe aruandega täielikult küsida. Ära liida kattuvaid aruandeid.

read vajab juba teadaolevat nullist erinevat sidekriipsudega sündmuse UUID-d. Aruanded ei loetle sündmuste UUID-sid ja natiivhaak ei väljasta lisamise kviitungit. Kasuta käsku ainult siis, kui usaldatud tootja või testikviitung on sündmuse ID eraldi andnud; see pole sündmuste avastamise käsk. Sünteetiline UUID näitab süntaksit ja annab puuduva kirje korral tulemuse unavailable:

bee delivery read --store "$delivery_store" \
  --event 22222222-2222-4222-8222-222222222222

Leitud vastuses on status: recorded_observation; selle observation sisaldab skeemiversiooni, seansisisest järjekorranumbrit ja pesastatud vaatluse metaandmeid. See olek üksi ei tähenda, et kirjutus oli Delivered.

Proovi kehtivat võrguühenduseta tühja aruannet

See POSIX-kesta näide kasutab uut tühja ajutist kodukataloogi ega vaja teenuseid. See ei loo arvestushoidlat ega kirjuta selle sisefaile. CLI-l pole avalikku lisamise, importimise ega sünteetilise kirje loomise käsku.

delivery_demo=$(mktemp -d)
BEE_HOME="$delivery_demo" bee delivery report \
  --store "$delivery_demo/.bee/usage/delivery-v1" --limit 0
rmdir "$delivery_demo"

Aruandekäsk lõpetab koodiga 5, nagu puuduva tõenduse korral oodata; viimane rmdir eemaldab tühja proovikataloogi. Valitud väljad tegelikust JSON-väljundist:

{
  "totalsStatus": "unknown",
  "observedEvents": 0,
  "deliveredEvents": 0,
  "deliveredUtf8Bytes": 0,
  "groups": [],
  "omittedGroups": 0,
  "issues": ["missing", "observation_window_open"],
  "observationWindowComplete": false,
  "measuredProviderTokens": null,
  "nativeWithheldEvents": null
}

See näitab teadmata vaatlusakent, mitte mõõdetud nulltarbimisega seanssi. Sünteetilise sündmuse lugemine puuduvast hoidlast annab samuti väljumiskoodi 5 koos status: unavailable ja observation: null väärtustega.

Valikud, väljumiskoodid ja piirid

Väljund on JSON lõpureavahetusega; ära lisa delivery käskudele --json. Toetatud on ainult delivery --help, delivery report ja delivery read. Baseline/check-, parandamise, lähtestamise ega hoidla kirjutamise käsuteid pole.

Liides	Leping
report	Kohustuslik --store PATH; valikuline paar --session-kind KIND --session ID; valikuline --limit 0..100.
read	Kohustuslik --store PATH --event UUID; aruandefiltreid ega limiiti pole.
Identiteedistringid	1–128 ASCII tähte/numbrit või - _ . : /. Natiivsed seansi-ID-d on nullist erinevad UUID-d; muid identiteeditüüpe ei käsitleta vaikimisi Claude’ina.
Vigane kasutus	Tundmatud, korduvad, puuduvad või tühjad valikud lükatakse tagasi. Kuni 16 argumenti ja kokku 16384 UTF-16 koodiühikut argumentides.
Väljundipiir	Kuni 262144 UTF-8 baiti JSON-i, lõpureavahetus välja arvatud. Ületamisel tagastatakse status: report_cap ja väljumiskood 5, mitte poolik JSON. Valikut --budget pole.
Väljumiskood 0	Abi, vähemalt ühe vaadeldud sündmusega aruanne või leitud sündmus. Kontrolli probleeme ja tüüpe: ka kinnitatud algusosa või ainult vigadega aruanne võib anda 0.
Väljumiskood 4	Vigane kasutus. Paranda valikud enne tulemuse tõlgendamist.
Väljumiskood 5	Sobivaid vaatlusi pole, sündmus pole saadaval või väljundipiir on ületatud. Vaata JSON-i; see ei tõenda null edastust.

Salvestamine, privaatsus ja tõrgete piirid

Natiivne tootja katab ainult olemasoleva Claude’i UserPromptSubmit tee lihtteksti ja context JSON-i kujul. Vaja on kehtivat CLAUDE_CODE_SESSION_ID väärtust ja sobivat JSON-viibaümbrist; ümbrise kehtiv seansi-ID on eelistatud. Toores või ainult argumendina antud sisend, ebaselge/pesastatud käituskeskkonna identiteet, vigased või üle 65536 UTF-16 koodiühikuga ümbrised ning mitte-UTF-8 väljund jäävad vaatlemata. Session-start, pre-tool, Codex ja Hermes pole natiivsed edastustootjad. Ära pesasta ega korda haagikutseid käsitsi kasutuse mõõtmiseks.

Hoidla säilitab sündmuse/seansi ID-d, pinna ja üksuse identiteedi, oleku, UTC ajatemplid, seansisisese järjekorra, baitide arvu ning nimetatud hinnangu. Viiba/väljundi sisu, sisu räsi, erinditeksti ega pääsuandmeid ei salvestata. Metaandmed paljastavad siiski seansi identiteedi, ajastuse ja mahu: hoia neid kohalikult ning vaata enne jagamist üle. Kontrollsummad kontrollivad metaandmete kooskõla, mitte autentsust.

Bee vaatleb edastust alles pärast lõpliku väljundi kirjutamist ja puhvri tühjendamist. See pole transpordi ACK ega tõend mudeli tarbimise kohta. Arvestustõrked säilitavad peamise haagiväljundi, diagnostika ja väljumiskäitumise. Vaatleja ootab lisamist kuni 100 ms ja lubab enda kohta kuni ühe poolelioleva lisamise; aeglane lisamine võib hiljem lõppeda. See ei sea failisüsteemile jäika tähtaega. Hõivatud hoidla, krahhid, mahupiir ja kirjutusvead võivad vaatlusi kaotada; kaomarkerid ei loenda kõiki kadusid.

Vaikehoidla säilitab kuni 2048 sündmust (16 segmenti, igas 128). See säilitab ID-d ja lõpetab täitumisel lisamise, mitte ei eemalda vanu kirjeid. Sama sündmuse ID ja metaandmete täpne kordus on idempotentne; vastuoluline kordus jätab alles esimese kirje. Eraldi kutsed saavad uued ID-d. See ega seansisisene järjestus ei taga täielikku või täpselt ühekordset vaatlust.

Lugemine kasutab piiratud tavalisi faile, keeldub toetamata linkidest/failikujudest ning säilitab rikkumise leidmisel kontrollitud algusosa. Raami metaandmete piir on 4096 baiti pluss reavahetus; päise piir on 4096 baiti. Vaata välja issues, et leida puudumise, hõivatuse, rikke, mahu või I/O tõendust. Algusosa võib olla kasulik, kuid on mittetäielik. Avalikku suuruse muutmise, taastamise ega roteerimise käsku pole; ära muuda sisefaile vaatluste tekitamiseks ega käsitle kustutamist jätkamismehhanismina.

Hoia kolm küsimust lahus

bee context doctor uurib enne kasutamist selgesõnaliselt valitud kohalikke kontekstideklaratsioone; tavaline bee budget prognoosib konteksti mahtu. Edastuse arvestus vaatleb väikest osa Bee tegelikest väljundikirjutustest. Allolev eraldi käsk kirjeldab väljast antud Codexi kasutusloendurite võrguühenduseta lugejat:

bee context doctor --help
bee budget --measured --help --json

See lugeja nõuab --harness codex, täpset natiivset --session UUID-d ja selgesõnalist --log faili. Vastuse- ja ajalooandmevood jäävad eraldi; lugeja ei omista teenusepakkuja kasutust edastatud reeglile ega tõenda arvet. Ära liida selle loendureid edastushinnangutele ega tuleta kummastki säästu.

Vaata käskude viidet, haakide seadistamist, kontekstitööriistu ja väljalaskemärkmeid.