Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

Jeden registr nad příkazovou řádkou, HTTP, OpenAPI, Swagger UI a MCP

Každý agent, skript i člověk čte tentýž repozitář přes rozhraní, kterým už mluví, a žádné z rozhraní se neudržuje ručně.

status
stav funkce: stabilní
doména
Povrchy

Co dělá

První majordomus mcp v repozitáři naváže jeden sdílený server na loopback rozhraní a zaloguje každý povrch, který servíruje: domovskou stránku, tuto dokumentaci, rustdoc cratu, Cockpit, Swagger UI, dokument OpenAPI, routy schopností a MCP přes HTTP. Každý další klient se k němu připojí místo spuštění dalšího a server skončí, když odejde jeho poslední klient. Konfigurace klientů v kořeni repozitáře — jedna pro každého providera, který nějakou čte, jak je vypisuje docs/generated/providers.md — jmenují jeden launcher, takže stačí repozitář v kterémkoli z nich otevřít.

To, co server odpovídá, je registr: nástroj, zdroj, trasa nebo příkaz existuje, protože existuje deklarace, a tatáž deklarace je to, co vykresluje reference i web. Povrch — připojení dokumentace, rustdoc crate, generovaná zpráva, Swagger UI — se zjišťuje z věci, která jej produkuje, nebo ze zdroje, který říká, že existuje, a rozliší se jednou do topologie, kterou čtou router, domovská stránka, publikace i validátor.

Co nedělá

Většina z toho, co se poskytuje, čte. Každá schopnost nese svůj efekt v registru: čtení, změnu vlastního stavu odpovídajícího runtime (nástěnka peerů, žurnál meshe, kniha důkazů), nebo změnu repozitáře. Ty, které zapisují do repozitáře, jsou continuity.publish, continuity.resume, continuity.sync, executions.start, intents.propose, plan.transition, reasoning.record a recover.orphans; instrukce initialize, které čte každý klient, je jmenují z registru, a případ 3363 odmítne tuto stránku, když se její seznam a seznam registru liší, protože věta slibující povrch jen pro čtení je přesně ta věta, podle které agent jedná. Ve výchozím stavu neexistuje autentizace ani vzdálené navázání; server je pro klienty na tomto stroji. Když je navázán mimo loopback, jeho čtení odpovídá každému, kdo se k němu dostane, a každá schopnost, která něco mění, je vzdálenému volajícímu odmítnuta, pokud vstup nepodepsal propojený uzel. Nespouští model a nesměruje na něj práci.

Proč existuje

Provozní okamžiky z katalogu Why, které pojmenovávají některý z mechanismů této funkce. Nic zde nebylo přiděleno: okamžik se objeví, protože pojmenovává pravidlo, příkaz, schopnost nebo tvrzení, které pojmenovává i tato funkce.

Každý okamžik, na který odpovídá (31)

Princip

Moduly schopností spustitelného souboru, které tato funkce pojmenovává, každý se schopnostmi, které skládá. Rozhraní, jichž každý dosahuje, jsou uvedena níže v části Rozhraní: jde o projekce jedné deklarace, ne o samostatné registrace.

Repozitář repository ověřeno chováním

Repozitář, který tento proces obsluhuje: jeho vrstva, stav gitu, stav indexu z něj postaveného a jeho rozsah: co z něj pracovník čte a co nikdy nečte.

Objekty objects ověřeno chováním

Deklarativní objekty vrstvy AI repozitáře: pravidla, prompty, profily, politika, dokumenty, milníky, úkoly, tvrzení a jakékoli druhy, které repozitář přidá; vypisují se, čtou podle URI a prohledávají.

Webové plochy web ověřeno chováním

Co tento repozitář vystavuje přes HTTP, určeno z producentů, kteří to vytvářejí, a ne z registru, který by někdo udržoval: trasy, na které odpovídá samotný spustitelný soubor, build dokumentace a každá vygenerovaná zpráva, která deklarovala vlastní mount. Stejné určení obsluhuje router, vykresluje domovskou stránku a skládá publikaci.

Prostředí repozitáře environment ověřeno chováním

Čím tento checkout právě teď je: projekt a jeho verze, repozitář a jeho vrstva, správa verzí, toolchainy, které deklaruje, co vrstva obsahuje, workflow, která člověk může spustit, projekce providerů a lokální služby — jeden typovaný snímek s položkou původu pro každou hodnotu v něm. Banner direnv, přehled Cockpitu i tato trasa jsou vykreslení téže hodnoty.

Provedení executions ověřeno chováním

Spuštění schopnosti tohoto registru jako práce, kterou lze sledovat: spuštěné, sledované událost po události přes živý kanál, zpětně přečtené a zastavitelné na požádání. Jedna rovina na checkout: `majordomus run` běží ve vlastním procesu a spuštění oznámí serveru, který checkout už obsluhuje, aby ho vedl vedle svých; bez serveru řekne, že běh nemůže nikdo jiný vidět. V paměti; spuštění nepřežije server, který ho drží.

Graf příkazů commands implementováno

Každý příkaz, který tento repozitář nabízí, z jakéhokoli programu, který jej nabízí: spustitelný soubor v Rustu, shellový nástroj nesoucí životní cyklus úlohy a workflow, která repozitář deklaruje, aby je člověk spouštěl. Složeno ze tří deklarací, které už existují — stromu clap, dodaného registru příkazů a vlastního výpisu runneru workflow — nikdy ze seznamu. Každý příkaz nese, co jeho spuštění mění, co potřebuje, odkud pocházejí hodnoty jeho argumentů a každý povrch, který jej nese, s důvodem, když nějaký nenese.

Projekce pro editory a agenty editors ověřeno chováním

Soubory, které z tohoto repozitáře čtou Zed a Google Antigravity, odvozené z dovedností a ze sledovaného justfile: co který produkt podporuje a na základě jakých důkazů, stav a obsahová adresa každého promítnutého souboru a co dělat s každým nálezem.

Entity entity implementováno

Každý objekt vrstvy jako adresovatelný, navzájem propojený uzel: jeho trasa, jeho odchozí reference, reference, které na něj vedou, povrchy, které za něj odpovídají, a to, co se dá o jeho vynucování říct bez spuštění čehokoli. Nic z toho nevyjmenovává druhy, entity ani trasy — objekt indexu má trasu, protože je objektem.

Projekce MCP mcp experimentální

MCP projekce tohoto registru popsaná jako jedna typovaná hodnota: kdo odpovídá na `initialize` a s jakými verzemi protokolu, transporty a kolik relací každý drží, co z protokolu se poskytuje a co ne, každý nástroj s efektem a nápovědami, z nichž se odvozují jeho anotace, nástroje, které zapisují do repozitáře, zdroje a stav konfigurace každého deklarovaného klienta v tomto repozitáři. Nic z toho není vlastní seznam: nástroje jsou z registru, efekt je klasifikace schopnosti, klienti jsou provideři distribuce.

Kde se nachází

doména
Povrchy — Jedna deklarace v repozitáři se stane příkazovou řádkou, HTTP API, MCP, UI, Cockpitem, dokumentací i tímto webem a projekce, která se s ní rozchází, shodí build.

Rozhraní

Každá schopnost za ní, na každém rozhraní, na které je promítnuta. Odkaz vede na referenci tohoto webu pro dané rozhraní; HTTP route a nástroj MCP odpovídá běžící majordomus serve, ne tento web.

Schopnosti za touto funkcí podle rozhraní
schopnostpříkazová řádkaHTTPnástroj MCP
repository.info —žádné GET /api/v1/repository majordomus_repository
repository.scope majordomus scope GET /api/v1/scope majordomus_scope
repository.scope_classify —žádné GET /api/v1/scope/classify majordomus_scope_classify
objects.get —žádné GET /api/v1/object majordomus_get
objects.list —žádné GET /api/v1/objects majordomus_list
objects.search —žádné GET /api/v1/search majordomus_search
objects.verify —žádné GET /api/v1/objects/verify majordomus_verify_objects
web.surfaces —žádné GET /api/v1/web/surfaces majordomus_web_surfaces
environment.explain —žádné GET /api/v1/environment/explain majordomus_environment_explain
environment.preflight —žádné GET /api/v1/environment/preflight majordomus_preflight
environment.status —žádné GET /api/v1/environment majordomus_environment
executions.cancel majordomus executions cancel POST /api/v1/executions/cancel majordomus_execution_cancel
executions.demonstrate —žádné GET /api/v1/executions/demonstrate majordomus_demonstrate_execution
executions.events majordomus executions events GET /api/v1/executions/events majordomus_execution_events
executions.get majordomus executions show GET /api/v1/executions/get majordomus_execution
executions.list majordomus executions list GET /api/v1/executions majordomus_executions
executions.protocol majordomus executions protocol GET /api/v1/executions/protocol majordomus_execution_protocol
executions.report —žádné POST /api/v1/executions/report —žádné
executions.start majordomus run POST /api/v1/executions/start majordomus_execution_start
commands.get —žádné GET /api/v1/command majordomus_command
commands.graph —žádné GET /api/v1/commands/graph majordomus_command_graph
commands.list —žádné GET /api/v1/commands majordomus_commands
editors.status —žádné GET /api/v1/editors majordomus_editors
entity.kinds majordomus entity kinds GET /api/v1/entity/kinds majordomus_kinds
entity.show majordomus entity show GET /api/v1/entity majordomus_entity
mcp.projection —žádné GET /api/v1/mcp majordomus_mcp
v Cockpitu, běžícího serveru
/cockpit/api API
poskytováno spustitelným souborem
/api/v1 Registr schopností přes HTTP
/openapi.json Dokument OpenAPI registru schopností
/swagger Swagger UI nad dokumentem OpenAPI
/mcp MCP přes HTTP pro připojené klienty
/docs Dokumentace, jak ji tento proces poskytuje
/rustdoc Dokumentace crate v Rustu, jak ji vykresluje rustdoc

Důkazy

Co je zaručeno

Každé tvrzení, které tato funkce pojmenovává, se stavem, který deklaruje jeho řádek, verdiktem, který podporují zaznamenané běhy, a testem, který o něm rozhoduje.

Spustitelné případy užití

Pravidla, která jej drží

  • blokující Webový povrch se deklaruje jednou a z něj se odvozují všechny webové projekceproject.web-surface-declared-once
  • blokující Webový povrch se objeví od svého producenta a nikdy se neregistruje dvakrátproject.web-surface-topology
  • blokující Nativní příkaz příkazové řádky existuje jen se svou dokumentací a spustitelnými příkladyproject.native-cli-documented
  • blokující Nic, co klient zanechá, nezamkne jiného klientaproject.shared-server-resilience

Rozhodnutí za ním

Použití

Z příkazové řádky spustitelného souboru

Synopse každého, jak ji vypisuje nápověda samotného spustitelného souboru.

Odkud tato stránka pochází

soubor
.ai/repo/features/interfaces.md
stejná odpověď
majordomus product show interfaces

Prohledává názvy a popisy všech stránek, které tento web publikuje.