Täpsemad CLI töövood

Need käsud on dokumenteeritud Bee praeguse stabiilse väljalaske jaoks. Käivita need õiges checkout’is. bee --version näitab paigaldatud binaari versiooni; teise versiooni käitumine võib erineda. Ülejäänud käsud on käsuviites ja agendile mõeldud lugemised MCP tööriistades.

Artefakti säilitamine ja uurimine

artifact add kopeerib UTF-8 faili füüsilise checkout’i privaatsesse salve. Toetatud on JSON (vaikimisi, lisamisel valideeritakse) ja tekst. Ühe faili piir on 1 MiB, ühes checkout’is kuni 64 artefakti. Lugemine kontrollib manifesti ja täpseid säilitatud baite; algset faili uuesti ei loeta ega käsku uuesti käivitata. MCP tööriistadega jagamiseks kasuta valitud Bee instantsi artifacts kataloogi.

# Käivita Git checkout'is, kus on reports/results.json.
checkout="$(git rev-parse --show-toplevel)"
artifact_store="$HOME/.bee/artifacts" # vaikimisi instants; nimega instantsi korral kasuta selle juurt
bee artifact add --root "$checkout" --store "$artifact_store" --file reports/results.json --format json
# Pane tagastatud id (SHA-256) muutujasse artifact_id.
artifact_id='<returned-id>'
bee artifact search --root "$checkout" --store "$artifact_store" --text 'failed' --limit 20 --offset 0 --budget 65536
bee artifact get --root "$checkout" --store "$artifact_store" --id "$artifact_id" --out "$checkout/recovered-results.json"

add tagastab id, root, sourcePath, sourceSha256, sourceBytes, format ja toorsalvestuse metaandmed. search otsib täpset tekstijada ridadest kogu selle checkout’i arhiivis või ühe --id piires. Tulemuses on schemaVersion, arhiiviotsingul artifactsSearched, enne lehekülgedeks jagamist arvutatud matchedRecords, offset, nextOffset ja rows (artefakti ID, lähte räsi/tee, rida, tekst). Ühe ID otsing annab ka artifactId, sourceSha256, operation: "search", totalRows. get loob uue faili ega kirjuta olemasolevat üle; vastus sisaldab status: "recovered", id, sourceSha256, sourceBytes.

Säilitatud JSON-massiivi saab pärida ilma koodi või SQL-i käivitamata. Päringufail võib olla kuni 64 KiB. JSON Pointer valib massiivi ja rea väljad; tühi arrayPointer valib juurtaseme massiivi. eq/ne arvestavad tüüpi, contains otsib tekstist, exists kontrollib välja olemasolu. Puuduv väli erineb JSON null väärtusest ja ne sobib vaid olemasolevale väljale. countOnly ei tagasta ridu; groupBy nõuab skalaarset pointer’it. limit on 1–1000, vaikimisi 100.

{
  "arrayPointer": "/results",
  "filters": [{"pointer": "/outcome", "operation": "eq", "value": "failed"}],
  "select": ["/name", "/outcome"],
  "offset": 0,
  "limit": 20,
  "maximumOutputBytes": 65536
}

Salvesta objekt failina query.json ja käivita:

bee artifact query --root "$checkout" --store "$artifact_store" --id "$artifact_id" --query-file query.json

Vastus sisaldab schemaVersion, artifactId, sourceSha256, operation: "query", matchedRecords, totalRows, offset, nextOffset, rows. Kui täielik vastus eelarvesse ei mahu, annab otsing/päring vea ega kärbi tõendeid vaikselt. Lähtefail peab olema tavaline fail täpses Git checkout’is; sümbol- ja kõvalinke ei aktsepteerita. Salve õigused peavad olema privaatsed. Süntaksiviga annab väljumiskoodi 4; keeldumine, puuduva/rikutud salvestuse, eelarve või katkestuse viga annab 5 ning errorCode stderr’is.

JSON-esituse kodeerimine ja dekodeerimine

representation encode loob versioonitud JSON-väärtuste paketi. Veerupõhine kuju valitakse vaid siis, kui kogu ümbris on mõõdetult väiksem. JSON-väärtused ja arvude kirjakuju säilivad, algsed tühikud ja väljade järjekord mitte. Täpsete algbaitide jaoks kasuta artefakti taastamist.

bee representation encode --file reports/results.json --encoding cl100k_base > packet.json
bee representation decode --file packet.json > decoded.json

Teine toetatud --encoding on o200k_base; vaikimisi cl100k_base. Paketis on formaat, kodeering, tokenite arvud ja sisu. Need arvud kirjeldavad kohalikku kodeeringut, mitte teenusepakkuja arvet. JSON-sisendi piir on 1 MiB. Vigane pakett või liiga suur lahtipakkimine ebaõnnestub ilma osalise JSON-ita. Käsud loevad kohalikke faile ja kirjutavad ainult stdout’i; shelli suunamine on sinu selgesõnaline failikirjutus.

Valikulise proosa tihendamine ja algteksti taastamine

Tihendamine on vaikimisi väljas ja kadudega. Lubatud on üksnes selgelt prose-ks liigitatud tekst. Ära anna koodi, prompte, juhiseid, segapakette, õiguslikke või täpseid testitõendeid. setup on ainus samm, mis võib kohaliku Pythoni käituskeskkonna ja mudeli paigaldada/alla laadida; see ei lülita tihendamist sisse.

bee compression settings show
bee compression setup --python python3
bee compression doctor
bee compression settings on
bee context compress --input notes.txt --content-kind prose --rate 0.5
# Võta originalSha256 tihendamise vastusest:
bee compression recover --sha256 '<originalSha256>'

--rate on 0.1–0.9. Vastuses on status, text, originalSha256, valikulised originalPath/compressedSha256, semanticRisk, kohalikud originalTokens/compressedTokens ja võimalusel käitusaja mõõtmised. Taastamine annab status: "recovered", täpse text-i ja kontrollitud sha256. Väljalülitatud tihendamine tagastab algteksti; ka edukas tihendamine märgib semanticRisk: true. Enne tähenduse usaldamist vaata taastatud algteksti. Adapter töötab kohapeal ega kasuta varjatud pilvefallback’i. Sisendi piir on 64 KiB/8192 kohalikku tokenit, järelduse aeg 120 sekundit. Seaded ja algtekstid salvestatakse valitud instantsi juure alla. Vigane kasutus annab 4, pooleli olev käituskeskkond/tihendus/taastamine 5. Muud kontekstivalikud on konteksti ja teenusepakkuja tööriistades.

C# sümbolimuudatuse eelvaade

symbol leiab ühe deklaratsiooni olemasolevast värskest C# graafist. Võta sümboli ID graph outline väljundist ja lähte SHA-256 graafi/lähte tõendist. Räsi kaitseb valimise ja muutmise vahel tehtud muudatuse eest. Pane UTF-8 C# asendustekst faili replacement.txt; uus .cs fail checkout’is muudaks graafi aegunuks. Vaata eelvaadet:

checkout="$(git rev-parse --show-toplevel)"
bee graph build --json
bee graph outline src/Example.cs --json
shasum -a 256 src/Example.cs # kopeeri esimene väli väärtuseks <source-sha256>
bee symbol preview --root "$checkout" --symbol '<symbol-id>' --expected-sha256 '<source-sha256>' \
  --operation replace --replacement-file replacement.txt --budget 65536 --json
# Pärast eelvaate ja räsi kontrolli:
bee symbol apply --root "$checkout" --symbol '<symbol-id>' --expected-sha256 '<source-sha256>' \
  --operation replace --replacement-file replacement.txt --budget 65536 --json
bee graph build --json

Valikud on replace, insert-before, insert-after; --replacement-file - loeb stdin’ist. preview ei kirjuta. apply muudab üksnes kontrollitud deklaratsiooni ridu ja säilitab UTF-8 BOM-i. Mõlemad tagastavad ok, applied, supportedLanguage: "csharp", valikulise errorCode ja edit andmed (path, symbolId, graafi/lähte/kandidaadi räsid, toiming, baitide vahemik, before, after). apply ei ehita graafi uuesti ega kompileeri/testi. Asenduse piir on 64 KiB, lähte/kandidaadi 256 KiB; väljundi eelarve 512–262144 baiti (vaikimisi 65536). Mitmetähenduslik sümbol, vana graaf või erinev räsi keelavad muudatuse. Vigane sisend annab 4, keeldutud muudatus 5.

Disainiekspordi kasutamine teostuses

design loeb HTML-i, kataloogi või ZIP-i võrguühenduseta ega käivita skripte. prepare kirjutab kohaliku ülekandepaketi, kuid ei laadi seda üles. import säilitab kogu algse maketi ja indeksi. list näitab ID-sid, slice annab ühe ID piiratud lähte- ja sõltuvuskonteksti, map salvestab seose teostusega ning verify kontrollib terviklust. Kasuta füüsilist lähte- ja väljundteed; macOS-is on /tmp sümlink, mistõttu näide teeb kataloogi kodukataloogi alla.

bee design doctor
demo_dir="$(mktemp -d "$HOME/bee-doc-demo.XXXXXX")"
bee design prepare mock.zip --output "$demo_dir/transfer"
bee design import mock.zip --output "$demo_dir/bundle"
bee design list "$demo_dir/bundle"
bee design slice "$demo_dir/bundle" --id '<id-from-list>' --budget 65536
bee design map "$demo_dir/bundle" --mapping mapping.json
bee design verify "$demo_dir/bundle" --json

mapping.json sisaldab id, absoluutseid target ja fixture teid, reuseStrategy väärtust (direct-extract, constrained-transform, existing-component, rebuild-region) ning valikulisi route, expectedRevision, reason; rebuild-region nõuab põhjust. prepare võib saada kasutaja määratud --provider-file-limit-bytes ja --provider-total-limit-bytes; Bee ei avasta teenusepakkuja tegelikke piire. slice vajab --id ja eelarve võib olla 512–65536 baiti. Vastustel on schemaVersion/status; tulemustoimingutes on andmed result väljal, import annab bundle, revision, failide/elementide/piirangute arvud ja visualAcceptance: false. Slice sisaldab complete, segments, dependencies, limitations ning väljajätmiste arvu. Väljumiskood 0 tähendab täielikku, 4 vigast kasutust, 5 puudulikku/keeldutud tulemust. verify kontrollib räsi ja sõltuvusi, mitte pildi vastavust ega disaini heakskiitu. Ekspordi loomiseks vaata disainioskust.

Visuaaltõendite jäädvustamine ja võrdlemine

Visuaalkontroll vajab eraldi Node runner’it. doctor annab vaid olemasoluinfo; pakette ei paigaldata ega brauseri valmisolekut tõendata. Jätka samas shellis, et demo_dir viitaks imporditud paketile. Ekspordi runner uude kataloogi, paigalda lukustatud sõltuvused, loo imporditud disainist spetsifikatsiooni mustand ja täienda seda:

bee visual doctor
bee visual export-runner --output "$demo_dir/visual-runner"
cd "$demo_dir/visual-runner" && npm ci
bee visual init --bundle "$demo_dir/bundle" --output "$demo_dir/visual-draft.json"
# Täida selector'id, käitusprofiil, fixture'id, retseptid ja piirkonnakontrollid.
bee visual reference --request /absolute/path/reference-request.json --runner-dir "$demo_dir/visual-runner"
bee visual capture --request /absolute/path/capture-request.json --runner-dir "$demo_dir/visual-runner"
bee visual compare --request /absolute/path/compare-request.json --runner-dir "$demo_dir/visual-runner"
bee visual report --request /absolute/path/report-request.json --runner-dir "$demo_dir/visual-runner"

Toiming	Loodud tõend
select	Valib stsenaariumid specPath, policyPath ja suhteliste changedPaths järgi; raporteerib katvuse, ei tee visuaalkontrolle.
cache-clean	Vaikimisi eelvaatab võrdluspiltide vahemälu puhastust; ainult remove: true kustutab kontrollitud Bee kirjed.
reference	Jäädvustab deklareeritud disainiallika võrdluseks, mitte rakenduse ekraanipilti golden’ina.
capture	Jäädvustab rakenduse koos selgete web.files räside ja source ehituse/artefakti identiteediga; rakenduse jäädvustus on alati uus.
compare	Kontrollib valitud piirkondi, olekut, fixture’it, profiili, lähte- ja artefaktiidentiteeti ning kirjutab piiratud leidudega comparison.json.
report	Kontrollib olemasolevaid võrdlusartefakte ja kirjutab skriptivaba HTML-aruande; üleslaadimist ei toimu.

Reference/capture päring vajab absoluutseid specPath ja outputDir teid, võib sisaldada scenarioIds ning web allikat. Capture vajab lisaks web.files: [{path, sha256}] ja source: {sourceId, buildId, artifactSha256}. Eksporditud runner sisaldab täpseid JSON-skeeme ja avalikku demo-generaatorit täielike päringunäidetega.

Päring peab kasutama skeemiversiooni 1 ja tee-väljadel absoluutseid teid; brauseripildiks peab brauser olema paigaldatud või päringus peab olema browserExecutable. --node valib absoluutse Node tee; --timeout 1–300 sekundit (vaikimisi 60). init kirjutab mustandi requiresCompletion: true, acceptance: false; täida kohatäited. Runner’i vastuses on schemaVersion, operation, status, exitCode, trusted: false, acceptance: false. Väljumiskood 0 on runner’i läbimine, 3 visuaalne erinevus, 4 puudulik tõend, muud nullist erinevad väärtused on vead. Kasutaja koostatud tõend jääb usaldamata; aruanne on diagnostiline ja vajab inimese ülevaatust.

Mitme Bee instantsi eraldamine ühel masinal

Senine vaikimisi instants jääb ~/.bee alla. Nimega instantsil on oma bootstrap, andmebaas, koostööruum, persona, workeri seadistus ja kohalik olek. Seo checkout’i tee ja vajadusel remote’i muster; enne töö salvestamist kontrolli tegelikku valitud ulatust:

bee instance list --json
bee instance add demo --path /absolute/path/to/checkout --json
bee instance which /absolute/path/to/checkout --json
cd /absolute/path/to/checkout
bee instance show --verify --json
bee instance doctor --json
bee instance env demo --shell zsh

add lubab korduvaid --path/--remote väärtusi. map ja unmap muudavad üht seost (--path või --remote). policy --unmatched legacy|hooks-silent|deny määrab sobimatute teede käitumise. exec <name> [--cwd DIR] -- <cmd> käivitab lapse valitud ulatuses ja säilitab tema väljumiskoodi; kutsuva sessiooni seos jääb kehtima. stamp kontrollib/talletab andmebaasi omaniku, worker-agent loob seadistuse mustandi ja kirjutab ainult --write korral. doctor --scan DIR laiendab kontrolli, --fix-permissions kirjutab õigusi. remove eemaldab suunamise, mitte instantsi andmed. sessions prune --older-than DAYS --yes blokeerib vanad native sessiooni ID-d jäädavalt ega tuvasta, kas harness veel töötab.

which on pin’ist sõltumatu tee-suunamise eelvaade; JSON annab name, reason, matchedPath, matchedRemote ja root. show --verify näitab aktiivset instantsi koos bootstrap ja stamp diagnostikaga. Ainult checkout’i tee ei määra aktiivset ulatust: remote’i seos, --instance/BEE_INSTANCE ja native sessiooni pin võivad seda muuta. Konflikt peatub koodiga 8, selle asemel et andmeid segada. Organisatsioonide tõeliseks eraldamiseks kasuta iga instantsi jaoks eraldi andmebaasi- ja brokerikontot. Vaata seadistust ja tõrkeotsingut.

Selgesõnaliselt lubatud workeri käivitamine

collaborate launch edastab ülesande olemasoleva autenditud koostöösessiooni kaudu sõlmele, kus kohalik workeri käivitamine on sisse lülitatud. Vastuvõtja määrab programmi, argumendid, keskkonna, workspace’i lubatud loendi ja mahu. Uuri kohalikku poliitikat enne saatmist; kontroll ega järjekorda võetud taotlus ei tõenda protsessi käivitumist.

bee worker profiles --json
bee worker inspect '<profile>' --space '<space>' --workspace '<workspace-key>' --json
BEE_COLLABORATE_SESSION_ID='<joined-session-id>' bee collaborate launch \
  --request '<stable-uuid>' --node '<exact-node-id>' --profile '<profile>' \
  --workspace '<workspace-key>' --prompt-file task.txt --ttl-seconds 300 --json
BEE_COLLABORATE_SESSION_ID='<joined-session-id>' bee collaborate launch-status --request '<stable-uuid>' --json

--prompt-file - loeb stdin’ist; ülesanne võib olla kuni 128 KiB. --ttl-seconds on 5–3600 (vaikimisi 300). Oleku uurimiseks või launch-cancel --request ... tühistamiseks kasuta sama püsivat UUID-d; uus UUID võib luua teise kavatsuse. Vastuses on requestId, scope, nodeId, profile, workspace, state, version, loomise/aegumise/uuendamise ajad, cancelRequested ja process metaandmed. nativeBinding: "not_verified", agentOutcome: "not_assessed", qa: "not_assessed" ütlevad, et käivitusreceipt ei ole töö heakskiit. Kontrolli tegelikku harness-sessiooni, faile ja teste. Ebaselge tulemus blokeerib samas sõlmes ja ruumis uued käivitused; ära mine sellest teise päringuga mööda. Vaata koostööd ja plaane.