Valitud konteksti diagnostika

Vajalik on Bee 1.0.0-beta.16 või uuem koos käsuga context doctor. Kontrolli käsu olemasolu käsuga bee context doctor --help.

Agent saab enne reeglite ja kontekstifailide sisu viibale lisamist uurida valitud failide suurust ja loetavust. Doctor loendab ka toetatud tööriista- ja hook-deklaratsioone neid käivitamata. Markdowni duplikaadikandidaatide leidmiseks kasuta eraldi käsku context audit. Kumbki käsk ei muuda reegleid ega otsusta, milliseid kohustusi võib eemaldada.

Proovi ajutist näidet

Käivita Bashis või zsh-s. Ettevalmistus loob sünteetilised failid väljaspool tööpuud ja privaatse tühja Bee profiili. pwd -P leiab füüsilise kataloogi: macOS-is võib tee läbi /tmp või /var sisaldada sümbollinki, mille lugeja tagasi lükkab. Faili mcp.json näidiskäsk on teadlikult väljamõeldud.

demo_dir="$(mktemp -d "${TMPDIR:-/tmp}/bee-doctor-demo.XXXXXX")"
demo_dir="$(cd "$demo_dir" && pwd -P)"
mkdir "$demo_dir/profile"
printf '# Review 🐝\nRead selected files, keep required checks, and ask for review before changing any shared rule.\n' > "$demo_dir/rules.md"
cp "$demo_dir/rules.md" "$demo_dir/comparison.md"
cat > "$demo_dir/mcp.json" <<'JSON'
{"mcpServers":{"example":{"command":"bee-docs-example-only","args":["DEMO"],"env":{"EXAMPLE_MODE":"demo"}}}}
JSON
cat > "$demo_dir/manifest.json" <<JSON
{
  "schemaVersion": 1,
  "snapshotId": "doctor-demo",
  "rootPath": "$demo_dir",
  "inputs": [
    {"id": "rules", "path": "rules.md", "dialect": "markdown-atx-v1"},
    {"id": "tools", "path": "mcp.json", "dialect": "mcp-servers-json-v1"}
  ]
}
JSON
chmod 444 "$demo_dir/rules.md" "$demo_dir/comparison.md" "$demo_dir/mcp.json" "$demo_dir/manifest.json"
printf '%s\n' "$demo_dir"

Ettevalmistus kirjutab ainult näidisfailid. Järgmised Bee käsud loevad neid; failide õigused lubavad ainult lugemist. Doctori manifest ei vali faili comparison.md.

BEE_HOME="$demo_dir/profile" bee context doctor --help
BEE_HOME="$demo_dir/profile" bee context doctor --manifest "$demo_dir/manifest.json" --json --budget 16384

Mõlemad käsud lõpetavad koodiga 0. Aruanne sisaldab rules kohta ühe jaotisega read rida ning tools kohta declared rida ühe MCP-serveri ja ühe keskkonnakirjega. Markdowni failis on 109 UTF-8 baiti, 107 UTF-16 koodiühikut ja hinnanguliselt 27 tokenit. Mesilase emotikon on üks nähtav märk, kuid kasutab nelja UTF-8 baiti ja kaht UTF-16 koodiühikut. Failide sisu, pealkirju, käsustringe ega keskkonnaväärtusi aruandes ei avaldata.

Vali allikas selgelt

--manifest võtab tavalise UTF-8 JSON-faili absoluutse tee. rootPath on absoluutne füüsiline kataloog; iga sisendi path on selle juure suhtes. Doctoril pole valikut --root. See ei avasta lisafaile, ei ava dependsOn kaudu uusi teid ega otsi privaatseid logisid. Välja jäetud fail jääb mõõtmata.

Manifest nõuab schemaVersion: 1, väärtust snapshotId ning 1–64 sisendit kordumatute ID-de ja teedega. Valikuline dependsOn viitab valitud ID-dele ega tohi moodustada tsüklit; see ei tõenda laadimisjärjekorda. Valikuline range skeemiga source kirjeldab kutsuja deklareeritud päritolu. sourceBinding: caller_declared_not_verified_against_files ei ole kontrollitud allikas ega edastuskinnitus; vajaliku deklaratsiooni puudumisel jäta source välja.

Dialekt	Vaatlus
`markdown-atx-v1`	`.md` faili suurused ja füüsiliste ATX-jaotiste arv; koodiplokis olev pealkiri ei ole jaotise piir
`mcp-servers-json-v1`	Ainult `mcpServers` sisaldav `.json` objekt; toetatud käsu/URL-i deklaratsioonid, keskkonna- ja päisekirjete arvud, sealhulgas keelatud deklaratsioonid
`claude-hooks-json-v1`	Ainult `hooks` sisaldav `.json` objekt; käsuhook’id sündmustele `SessionStart`, `UserPromptSubmit` ja `PreToolUse`

Need on piiratud skeemid, mitte kõigi keskkondade seadistusfailide lugejad. Tundmatu dialekt annab unsupported_dialect, toetamata seadistuskuju unsupported_config. Vigane JSON, pärast dekodeerimist korduvad omadusenimed ja vigane Unicode lükatakse tagasi. Vali sobivad juhisefailid: levinud mandaadifailide nimed on keelatud, kuid doctor ei ole üldine saladuste tuvastaja. ID-d ja valitud teed jäävad väljundis nähtavaks.

Loe tulemusi enne tegutsemist

Kontrolli iga sisendi välju status ja errorCode. Puuduva või tagasilükatud sisendi mõõdud on teadmata: null, mitte nullarv. Saadaval read säilivad, kuid kui mõni valitud rida pole mõõdetav, on declaredDiskTotals väärtus null. Tühi valik on vigane. Osaline vaatlus ei ole täielik inventuur.

configuration.inclusion: declared_not_loaded loendab deklaratsioone; see ei tõenda käivitamist ega mudelile edastamist. Ka eraldi tõendatud edastamine ei tõenda mudeli kuulekust. utf16-ceil-div4 versioon 1 hindab iga faili valemiga ceil(UTF-16 ühikud / 4) ja liidab need hinnangud. See pole tegelik teenusepakkuja tarbimine, arveldus ega tõendatud sääst. Teenusepakkujale omistamata jääk on teadmata; see CLI ei lisa kasutuslogi.

Piira väljundit ja käsitle väljumiskoode

Väljund on üks JSON-dokument koos lõpureavahetusega ka ilma --json valikuta. --budget lubab 512–262144 UTF-8 baiti koos lõpureavahetusega, vaikeväärtus on 262144. Loenda kodeeritud baite, mitte nähtavaid märke või UTF-16 ühikuid. See on väljundi suuruse piir, mitte tokenite jäik ülempiir.

BEE_HOME="$demo_dir/profile" bee context doctor --manifest "$demo_dir/manifest.json" --budget 512

Näide annab koodi 5 ja errorCode: output_limit. Doctor asendab liiga suure aruande väikese tervikliku veadokumendiga; see ei jäta ridu vaikides välja ega lõika JSON-i katki ning valikut --limit pole. Suurenda eelarvet lubatud vahemikus või vali teadlikult vähem sisendeid. Väljundvoo kirjutusviga edastatakse teist JSON-i avaldamata.

Kood	Tähendus ja järgmine samm
`0`	Abi või täielikud vaatlused; kontrolli ühikuid ja piiranguid
`4`	Vigane kasutus; kontrolli manifesti, täpseid lippe, kordusi ja eelarve vahemikku
`5`	Vigased, puuduvad, toetamata või tagasilükatud andmed, tühistamine või väljundipiir; loe veakoode ja paranda valikut

Käsk peab algama täpselt sõnadega context doctor. Lippe ei korrata; --json ei võta väärtust. Alguses olevat lippu ega -- märki ei teisendata doctori käsuks.

Lugemispiirid on 64 sisendit, 262144 baiti faili kohta, kokku 1048576 valitud baiti, 64 jaotist Markdowni faili kohta ja JSON-i sügavus 16. Ülemkataloogi liikumine, sümbollingid/reparse point’id, hardlink’id ja mittetavalised failid lükatakse tagasi. Avatuna hoitud failipidemete ja korduskontrollidega tuvastatakse muutusi, kuid checked_unchanged_not_atomic ei taga atomaarset hetkeseisu.

10-sekundiline tähtaeg kasutab koostöist tühistamist: seda kontrollitakse lugemise, parsimise ja kontrollimise ajal. See ei saa jõuga katkestada blokeeritud sünkroonset failisüsteemikutset ega piira blokeeritud väljundvoogu. Protsessi väljumine kümne sekundiga pole garanteeritud.

Uuri järgmiseks duplikaadikandidaate

BEE_HOME="$demo_dir/profile" bee context audit --help --json
BEE_HOME="$demo_dir/profile" bee context audit --from "$demo_dir/rules.md" --against "$demo_dir/comparison.md" --root "$demo_dir" --json

Markdowni failid on identsed, seega annab audit täieliku kandidaatidega aruande ja koodi 1. Auditi kood 0 tähendab täielikku tulemust ilma kandidaatideta, 4 vigast kasutust ja 5 mittetäielikku tulemust. Enne täielikkuse eeldamist kontrolli välju omittedFindings ja sourceInventory.omittedSections. Duplikaadikandidaat on alus ülevaatuseks, mitte luba reegli kustutamiseks. Vt context audit ja piirangud.

Teenusepakkuja teatatud loendurite jaoks kasuta bee budget --measured koos selgelt valitud toetatud seansilogiga; doctori hinnangud neid ei asenda. Hoia response/history vood ja puuduv tõendus eraldi. See osa ei paku reeglite eelvaadet, importi, rakendamist ega taastamist. See ei muuda reegleid automaatselt ega käivita agente, hook’e või deklareeritud tööriistu.