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 příkaz k instalaci, jeden k inicializaci, nic dalšího, čemu věřit

Instalátor stáhne jeden archiv pro váš stroj, před rozbalením čehokoli ověří jeho otisk (digest) proti metadatům releasu a instaluje atomicky; bez gitu, bez Rustu, bez Node, bez roota.

status
stav funkce: stabilní
doména
Povrchy

Co dělá

majordomus init vytvoří vrstvu z kostry nástroje a odmítne přepsat existující; --extend doplní, co chybí, a nic nepřepíše. Repozitář zřízený dřív, než vrstva existovala, přesune migrate, náhled je s --dry-run, s ověřenou zálohou. Samotný nástroj potřebuje POSIX shell, git a program na kontrolní součty a při práci nikdy nesahá do sítě.

S --personal, na init nebo na instalátoru se vytvoří táž vrstva jako osobní vrstva jednoho člověka ve sdíleném repozitáři: je pokryta vlastním exclude souborem adresáře git, nic se nezapisuje do .gitignore a příkaz selže, pokud git status po něm nečte totéž jako před ním. update a capture install pokrývají to, co zapisují, stejně, doctor to při každém běhu znovu ověří a init --extend --shared předá vrstvu týmu, když své opodstatnění doložila.

Co nedělá

Neinstaluje do vašeho projektu nic kromě .ai/ a souborů, které politika jmenuje, a neinstaluje git hooky: doctor pojmenovává dva řádky, které ještě musíte přidat. Osobní vrstva necestuje: je jednoho checkoutu na jednom stroji, dokud není sdílena. Archiv pro Windows se nepublikuje, dokud shellová polovina nemá odpověď pro Windows, a model distribuce to říká, místo aby dodával program, který nic nemůže řídit.

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.

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.

Distribuce distribution ověřeno chováním

Jak je tento projekt balen, publikován a instalován: platformy, pro něž release staví, názvy artefaktů, které odvozuje jediná pojmenovávací funkce, kanonický příkaz instalátoru, publikované release a čím je samotný tento build. Každá odpověď pochází ze share/distribution.yaml a ze záznamů release; žádný zdejší povrch netvrdí vlastní fakt.

Release release implementováno

Co tento projekt dodal a co dodá příště, odvozené, ne udržované: changelog skládá záznamy release vrstvy, rozhodnutí datovaná v okně každého release a konvenční commity v jeho rozsahu; zpráva o verzi čte jediné místo, kde se verze píše, a projekci, kterou vypisuje shellový nástroj, a říká, čím se podle veřejného kontraktu musí stát — nebo že to nelze změřit, a tedy nic nerozhoduje — a vedle toho jako důkaz uvádí, co naznačují commity od posledního release.

Objekty, z nichž se skládá

Druhy objektů vrstvy. Každý je schéma, třída zdroje a soubor na disku; číslo vedle něj říká, kolik jich tento repozitář dnes obsahuje, spočítáno při sestavení.

  • distribution-model1
  • release-record33

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.
oblasti práce
ověřenídokumentace
názvy
Politika

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
distribution.artifact majordomus distribution artifact GET /api/v1/distribution/artifact majordomus_artifact
distribution.build majordomus distribution build GET /api/v1/distribution/build majordomus_build
distribution.model majordomus distribution show GET /api/v1/distribution majordomus_distribution
distribution.releases majordomus distribution releases GET /api/v1/distribution/releases majordomus_releases
distribution.status majordomus distribution status GET /api/v1/distribution/status majordomus_install_status
release.analysis —žádné GET /api/v1/release/analysis majordomus_release_analysis
release.changelog —žádné GET /api/v1/changelog majordomus_changelog
release.next —žádné GET /api/v1/release/next majordomus_release_next
release.version —žádné GET /api/v1/release/version majordomus_release_version

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í Distribuce má jeden kanonický modelproject.distribution-canonical
  • blokující Přenosný shellproject.portable-shell
  • blokující Žádná síť, žádná telemetrie, žádný eval, žádné tiché přepsání, žádné rekurzivní mazáníproject.no-network-no-eval
  • blokující Osobní vrstva nemění nic sdílenéhoproject.a-personal-layer-changes-nothing-shared

Rozhodnutí za ním

Použití

Příkazy, které to spouštějí

  • majordomus init nastavení

    Vytvoří vrstvu .ai/ v tomto repozitáři a odmítne přepsat existující.

  • majordomus migrate nastavení

    Přesune data projektu z doby před .ai z .majordomus/ do .ai/, výslovně a se zálohou.

  • majordomus version inspect · jen pro čtení

    Vytiskne verzi, bez potřeby repozitáře či instalace.

  • majordomus archive inspect

    Pořiďte snímek sledovaného stromu, který lze číst nebo ověřit jinde.

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/install.md
stejná odpověď
majordomus product show install
číst dál

Instalace Majordomus

Distribuce

Osobní režim: Majordomus jako nástroj jednoho člověka

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