Teslim edilen çıktı ve kullanım

bee delivery içeren Bee 1.0.0-beta.16 veya üzeri gerekir. Elinizdeki ikilinin desteğini bee delivery --help ile kontrol edin.

Nicelik	Neyi gösterir?
Ölçülen UTF-8 baytları	Bee’nin yazma ve flush işlemleri başarılı olduktan sonraki son çıktının boyutu; aktarım zarfı ve satır sonu dahildir. Bu, yerel çıktı gözlemidir.
Etiketli token tahminleri	utf16-ceil-div4, sürüm 1: son çıktının UTF-16 kod birimi sayısını dörde bölüp yukarı yuvarlar. Sağlayıcının tokenizer’ı değildir.
Dışarıdan sağlanan sağlayıcı kullanımı	Ayrı bee budget --measured komutu, açıkça seçilen yerel Codex günlüğündeki sayaçları okur. Teslimat raporu bu sayaçları toplamaz veya uzlaştırmaz.
Tasarruf, maliyet ve kurala uyum	Ölçülmez. Çıktı baytları ve tahminler sağlayıcı tüketimini, faturayı, tasarrufu, modelin kurala uyumunu veya kaliteyi kanıtlamaz.

Mevcut gözlemi okuyun

Operatör veya ajan, hangi bağlamı inceleyeceğine karar vermeden önce Bee’nin başarıyla yazdığı çıktıyı görebilir. Mevcut Claude UserPromptSubmit hook’u normal biçimde çalışsın; ardından yerel metaverisini okuyun. Rapor almak için ikinci bir hook çağrısı gerekmez: yeni bir çıktı üretimi yeni bir olay oluşturabilir.

Varsayılan depo ~/.bee/usage/delivery-v1 yoludur. BEE_HOME kullanılıyorsa yol $BEE_HOME/.bee/usage/delivery-v1 olur; BEE_HOME, .bee dizininin üst dizinidir. Report ve read açık bir --store ister, yapılandırma veya güncelleme kontrolünden önce çalışır. Başlatma, veritabanı, model veya ağ bağlantısı gerekmez.

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

Önce totalsStatus, issues, deliveredEvents ve deliveredUtf8Bytes alanlarına bakın. Bayt ve tahmin toplamlarına yalnızca Delivered kayıtları katılır. eventKinds, kaydedilmiş yazma hatalarını da gösterir; başarısız veya kısmi yazmada denenen boyut, teslim edilen bayt sayısı değildir. Tahmin dizisi, tahminci kimliklerini ve sürümlerini ayrı tutar.

totalsStatus: lower_bound, gözlem bulunduğu anlamına gelir; zaman aralığının eksiksiz olduğunu göstermez. observationWindowComplete her zaman false; droppedObservationCount ve measuredProviderTokens ise null olur. Sayısal sayaçlar sıfır olsa bile eksik kanıt bilinmeyendir.

İlgili oturumu ve çıktı yüzeyini bulun

Soru	Desteklenen inceleme ve sınırı
Hangi çıktı yüzeyi?	groups içindeki dimension: surface kayıtlarını inceleyin: hook.prompt.plain veya hook.prompt.context-json. Yüzey filtresi yoktur. İkisi aynı prompt hook’unun çıktı biçimleridir.
Hangi oturum?	--session-kind ve --session birlikte kullanılır. Yerel kayıtlar claude-native-session ve yerel UUID kullanır. Oturum gruplarında identity oturum kimliği, version kimlik türüdür. Eşleşme tamdır ve büyük/küçük harfe duyarlıdır.
Hangi kaynak veya tarif?	Yerel kayıtlarda sourceRefHash: null ve recipeHash: null bulunur. Bunlar bilinmez ve karşılaştırılamaz. Toplu öğe steering-block, sürüm 1, tek bir kuralı veya kaynak revizyonunu tanımlamaz. Kaynak filtresi yoktur.
Hangi durum?	eventKinds alanına bakın; olay UUID’si zaten biliniyorsa read ile observation.observation.kind alanını inceleyin. Yerel Withheld toplamları açıkça kullanılamaz: nativeWithheldEvents: null, nativeWithheldStatus: unavailable_no_native_producer.
Hangi zaman aralığı?	Bilinen kaydın observation.observation.observedAtUtc alanı, yazma girişiminin UTC gözlem zamanıdır. Raporlarda zaman aralığı filtresi, aralık toplamları veya olay listesi yoktur; eksiksiz başlangıç/bitiş penceresi kurulamaz.

Aşağıdaki UUID sentetiktir. Kendi gözleminizin tam yerel oturum kimliğiyle değiştirin:

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

groups, aynı teslim edilmiş çıktıyı öğe, yüzey ve oturum olarak üç açıdan gösterir. Bu grupların toplamlarını birbirine eklemeyin. --limit, üç görünümdeki grup sayısını sınırlar; olayları veya girdi baytlarını değil. Toplamlar bu sınırdan önce hesaplanır. Varsayılan ve en yüksek değer 100; 0 yalnızca toplamları getirir. omittedGroups alanını kontrol edin. Grup atlanmışsa küçük limiti artırın veya bilinen tek bir oturuma daraltıp yeniden çalıştırın. Devam imleci ve sayfalama yoktur; 100’den fazla grubun tamamı tek raporda istenemez. Örtüşen raporları toplamayın.

read, önceden bilinen, sıfır olmayan, tireli bir olay UUID’si ister. Raporlar olay UUID’lerini listelemez; yerel hook da ekleme makbuzunu yazdırmaz. Bunu yalnızca güvenilir bir üretici veya test makbuzu ayrı olarak olay kimliği sağladığında kullanın; olay keşif komutu değildir. Bu sentetik UUID sözdizimini gösterir; kayıt yoksa kullanılamaz sonucu döner:

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

Bulunan yanıtın durumu status: recorded_observation olur; observation içinde şema sürümü, oturum içi sıra ve iç içe gözlem metaverisi bulunur. Bu durum, yazmanın Delivered olduğu anlamına tek başına gelmez.

Geçerli çevrimdışı boş raporu deneyin

Bu POSIX kabuk örneği yeni, boş bir geçici ev dizini kullanır; servis gerektirmez. Defter oluşturmaz veya dahili depo dosyalarına yazmaz. CLI’da herkese açık ekleme, içe aktarma veya sentetik kayıt komutu yoktur.

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

Rapor komutu, kullanılamayan kanıt için beklendiği gibi 5 ile çıkar; sondaki rmdir boş deneme dizinini temizler. Gerçek JSON çıktısından seçilen alanlar:

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

Bu, bilinmeyen bir gözlem penceresini gösterir; tüketimi sıfır ölçülmüş bir oturumu değil. Olmayan depoda sentetik olayı okumak da status: unavailable ve observation: null ile çıkış 5 verir.

Seçenekler, çıkışlar ve sınırlar

Çıktı, sonunda satır sonu bulunan JSON’dur; delivery komutlarına --json eklemeyin. Yalnızca delivery --help, delivery report ve delivery read desteklenir. Baseline/check, onarım, sıfırlama veya deftere yazma yolları yoktur.

Arayüz	Sözleşme
report	Zorunlu --store PATH; isteğe bağlı birlikte --session-kind KIND --session ID; isteğe bağlı --limit 0..100.
read	Zorunlu --store PATH --event UUID; rapor filtresi veya limit yoktur.
Kimlik dizeleri	1–128 ASCII harf/rakam veya - _ . : /. Yerel oturum kimlikleri sıfır olmayan UUID’lerdir; diğer kimlik türleri sessizce Claude sayılmaz.
Geçersiz kullanım	Bilinmeyen, yinelenen, eksik veya boş seçenekler reddedilir. En fazla 16 argüman ve argümanlar genelinde 16384 UTF-16 kod birimi.
Çıktı sınırı	Son satır sonu hariç en fazla 262144 UTF-8 bayt JSON. Taşma, kısmi JSON yerine status: report_cap ve çıkış 5 döndürür. --budget seçeneği yoktur.
Çıkış 0	Yardım, en az bir gözlenen olay içeren rapor veya bulunan olay. Sorunları ve türleri inceleyin: doğrulanmış önek veya yalnızca başarısızlık içeren rapor da 0 dönebilir.
Çıkış 4	Geçersiz kullanım. Sonucu yorumlamadan önce seçenekleri düzeltin.
Çıkış 5	Eşleşen gözlem yok, olay kullanılamıyor veya çıktı sınırı aşıldı. JSON’u inceleyin; bu, sıfır teslimat kanıtı değildir.

Kayıt, gizlilik ve hata sınırları

Yerel üretici yalnızca mevcut Claude UserPromptSubmit yolunu, düz metin ve context JSON biçimlerinde kapsar. Geçerli CLAUDE_CODE_SESSION_ID ve uygun JSON prompt zarfı gerekir; zarftaki geçerli oturum kimliği önceliklidir. Ham veya yalnızca argümanla verilen girdi, belirsiz/iç içe harness kimliği, bozuk veya 65536 UTF-16 kod birimini aşan zarf ve UTF-8 dışı çıktı gözlenmez. Session-start, pre-tool, Codex ve Hermes yolları yerel teslimat üreticisi değildir. Kullanım ölçmek için hook çağrılarını iç içe çalıştırmayın veya elle yinelemeyin.

Defter olay/oturum kimliklerini, yüzey ve öğe kimliğini, durumu, UTC zamanını, oturum içi sırayı, bayt sayısını ve adlandırılmış tahmini tutar. Prompt/çıktı gövdelerini, gövde hash’lerini, istisna metnini veya kimlik bilgilerini saklamaz. Metaveri yine de oturum kimliğini, zamanı ve hacmi açığa çıkarır: yerelde tutun, paylaşmadan önce inceleyin. Sağlama toplamları metaveri tutarlılığını kontrol eder; özgünlüğünü kanıtlamaz.

Bee, teslimatı yalnızca son çıktıyı yazıp flush yaptıktan sonra gözler. Bu bir taşıma ACK’i veya modelin çıktıyı tükettiğinin kanıtı değildir. Muhasebe hataları ana hook çıktısını, tanısını ve çıkış davranışını korur. Gözlemci ekleme için en fazla 100 ms bekler; gözlemci başına en fazla bir bekleyen ekleme vardır. Yavaş ekleme sonradan tamamlanabilir. Bu, dosya sistemi için kesin süre sınırı koymaz. Meşgul depo, çökme, kapasite ve yazma hataları gözlem kaybettirebilir; kayıp işaretleri her kaybı saymaz.

Varsayılan depo en fazla 2048 olay tutar (128’er olaylık 16 parça). Eski kayıtları atmak yerine kimlikleri korur ve kapasitede eklemeyi durdurur. Aynı olay kimliği ve metaverinin tam tekrarı idempotenttir; çelişkili tekrar ilk kaydı korur. Ayrı çağrılar yeni kimlik alır. Bu özellik ve oturum içi sıralama, eksiksiz veya tam bir kez gözlem garantisi vermez.

Okumalar sınırlı normal dosyalar kullanır, desteklenmeyen bağlantıları/dosya biçimlerini reddeder ve bozulmada doğrulanmış öneki korur. Çerçeve metaverisi satır sonuna ek olarak 4096 baytla, başlık da 4096 baytla sınırlıdır. Eksik, meşgul, bozuk, kapasite veya G/Ç kanıtı için issues alanına bakın. Önek yararlı olabilir ama eksiktir. Herkese açık büyütme, kurtarma veya döndürme komutu yoktur; gözlem üretmek için dahili dosyaları düzenlemeyin, silmeyi devam mekanizması saymayın.

Üç soruyu ayrı tutun

bee context doctor, kullanımdan önce açıkça seçilen yerel bağlam bildirimlerini inceler; normal bee budget bağlam boyutunu tahmin eder. Teslimat muhasebesi, gerçek Bee çıktı yazımlarının küçük bir bölümünü gözler. Aşağıdaki ayrı komut, dışarıdan sağlanan Codex kullanım sayaçlarının çevrimdışı okuyucusunu açıklar:

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

Bu okuyucu --harness codex, tam yerel --session UUID’si ve açık bir --log dosyası ister. Response ve history akışlarını ayrı tutar; sağlayıcı kullanımını teslim edilmiş bir kurala atfetmez veya fatura oluşturmaz. Sayaçlarını teslimat tahminlerine eklemeyin; ikisinden de tasarruf çıkarmayın.

Komut referansı, hook kurulumu, bağlam araçları ve sürüm notlarına bakın.