Un percorso chiaro per
il tuo primo prompt.

Prima di iniziare

1. Un sistema e una shell supportati: macOS o Linux su amd64/x86_64 o arm64/aarch64 o FreeBSD su amd64. Usa Bash, zsh o Fish. I pacchetti Arch sono solo x86_64. Non esiste un programma di installazione nativo di Windows/PowerShell.
2. Accesso per il download: una connessione Internet funzionante e un accesso HTTPS affidabile a GitHub, al repository di pacchetti selezionato e al provider del modello. L'inferenza locale richiede ancora il download iniziale del modello.
3. Autorizzazioni: una directory home scrivibile per le risorse per utente. I pacchetti del sistema Linux e macOS .pkg necessitano dell'accesso come amministratore; esegui Homebrew e ash install come utente normale.
4. Un modello: un server di inferenza locale con un modello scaricato o un account cloud/chiave API. Scegli un modello che supporti la chiamata degli strumenti, non un modello solo immagine/audio. Le esigenze di RAM locale, disco e GPU dipendono dal modello.

I pacchetti ash predefiniti non richiedono gli strumenti di creazione Go, Rust, Node.js o Xcode. Un gestore di pacchetti può avere i propri prerequisiti; segui prima le istruzioni di configurazione ufficiali.

macOS

Consigliato: birra fatta in casa

Prerequisiti:Birra fatta in casa, il suo ambiente macOS supportato e un file funzionantebrewcomando. Il tocco seleziona automaticamente l'archivio Intel o Apple Silicon. Homebrew 6 non si fida implicitamente di questo tocco di terze parti. Se Homebrew rifiuta di caricare la formula come non attendibile, esamina l'editore e la formula, quindi attendi solo questa formula (non l'intero tocco):

brew trust --formula jonconradt/ash/ash
brew install Jonconradt/ash/ash
ash version

Homebrew ricorda questa decisione di fiducia locale. Il tocco non può abilitare la fiducia per tuo conto; fidandosi dell'intero rubinettobrew trust jonconradt/ashè più ampio e permette di caricare anche le sue altre formule. Per affidarti invece a Beta o Nightly, utilizza il nome della formula corrispondente,jonconradt/ash/ash-betaOjonconradt/ash/ash-nightly. Homebrew possiede i file binari, i plugin nativi in ​​bundle, le pagine man e gli avvisi di licenza nel suo prefisso (normalmente/opt/homebrewsu Apple Silicon o/usr/localsu Intel). Controlla l'archivio rispetto al checksum SHA-256 della formula. Non configura il tuo provider né modifica il file di avvio della shell: continua coninizializzazione per utente. Utilizzobrew upgrade ashper aggiornamenti ebrew uninstall ashrimuovere Rilascio; Vedereformule di canaleper Beta/Notturno.

Alternativa: .pkg nativo

Scarica ildarwin-arm64.pkgrisorsa per Apple Silicon odarwin-amd64.pkgper Intel da acomunicato pubblicato.Verificare il manifest del checksum firmatoprima di aprire il programma di installazione. È richiesto l'accesso come amministratore.

Il pacchetto scriveashEash-brokerA/usr/local/bin, plugin per/usr/local/lib/ash/plugins, pagine man a/usr/local/share/man, e avvisi a/usr/local/share/licenses/ash. La ricevuta èdev.ash.cli. Non esegue l'inizializzazione per utente né si iscrive agli aggiornamenti:inizializzaredopo l'installazione, sostituirlo con un file .pkg più recente verificato da aggiornare e utilizzare il file .pkgprocedura di rimozione manualeper disinstallare. Non installarlo su una copia di proprietà di Homebrew.

Linux

Usa il gestore pacchetti della tua distribuzione ove possibile. Questi pacchetti possiedono/usr/bin/ash,/usr/bin/ash-broker,/usr/lib/ash/plugins, pagine man sotto/usr/share/mane avvisi di licenza. Lasciano le impostazioni del provider e gli hook della shellinizializzazione per utente.

Debian e Ubuntu: APT

Prerequisiti: amd64 o arm64, accesso amministratore, APT,curl,gpge certificati CA. Installa gli strumenti di download/chiave mancanti utilizzando la tua distribuzione prima di aggiungere il repository. La versione è nominatastable:

sudo apt update
sudo apt install ca-certificates curl gnupg
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://www.versionx.ai/apt/gpg.key -o versionx-apt.asc
gpg --show-keys --with-fingerprint versionx-apt.asc
sudo gpg --dearmor --batch --yes -o /etc/apt/keyrings/versionx-keyring.gpg versionx-apt.asc
sudo chmod 0644 /etc/apt/keyrings/versionx-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/versionx-keyring.gpg] https://www.versionx.ai/apt stable main" |
  sudo tee /etc/apt/sources.list.d/versionx.list
sudo apt update
sudo apt install ash
rm versionx-apt.asc

Prima di importare qualsiasi chiave del repository, verifica la sua impronta digitale rispetto a una fonte di editore attendibile. L'impronta digitale della chiave VersionX è32C6 C11D 2F86 BFE4 6EB7 7FFC 5257 FEA6 1368 919F. APT controlla i metadati del repository firmato e il pacchetto digest che contiene; l'ambito della chiave è compresosigned-by. Aggiorna consudo apt update && sudo apt upgrade ash; rimuovere consudo apt remove ash.

Sistemi compatibili con Fedora e RHEL: DNF

Prerequisiti: x86_64 o aarch64, accesso amministratore, DNF/RPM,curl,gpge certificati CA. Installa gli strumenti mancanti dalla tua distribuzione. Ispeziona la chiave e confronta l'impronta digitale sopra prima di importarla:

curl -fsSL https://www.versionx.ai/rpm/gpg.key -o versionx-rpm.asc
gpg --show-keys --with-fingerprint versionx-rpm.asc
sudo rpm --import versionx-rpm.asc
sudo tee /etc/yum.repos.d/versionx.repo >/dev/null <<'EOF'
[versionx]
name=VersionX ash repository
baseurl=https://www.versionx.ai/rpm/
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://www.versionx.ai/rpm/gpg.key
EOF
sudo dnf install ash
rm versionx-rpm.asc

I file RPM non sono firmati individualmente.repo_gpgcheck=1verifica i metadati del repository che coprono i loro checksum;gpgcheck=0riflette le firme per pacchetto assenti, non la verifica del repository disabilitata. Se la tua policy richiede payload RPM firmati, questo repository non li soddisfa. Aggiorna consudo dnf upgrade ash; rimuovere consudo dnf remove ash.

ArchLinux: Pacman

Prerequisiti: x86_64, accesso amministratore, Pacman con il suo portachiavi inizializzato,curl, Egpg. Verificare che l'impronta digitale della chiave visualizzata corrisponda a quella sopra prima di fidarsi. Aggiungi il repository una volta, non a ogni aggiornamento:

curl -fsSL https://www.versionx.ai/pacman/gpg.key -o versionx-pacman.asc
gpg --show-keys --with-fingerprint versionx-pacman.asc
sudo pacman-key --add versionx-pacman.asc
sudo pacman-key --lsign-key 32C6C11D2F86BFE46EB77FFC5257FEA61368919F
sudo tee -a /etc/pacman.conf >/dev/null <<'EOF'
[versionx]
Server = https://www.versionx.ai/pacman/$arch
SigLevel = Required DatabaseRequired
EOF
sudo pacman -Syu ash
rm versionx-pacman.asc

Pacman verifica sia le firme dei pacchetti che quelle del database. Mantieni Arch sincronizzato consudo pacman -Syu, non un aggiornamento parziale; rimuovereashconsudo pacman -R ash.

Altri metodi di installazione di Linux

Già in usoHomebrew su Linux? ILstesse istruzioni per il toccosupporta amd64 e arm64; Brew possiede questi file, non APT/DNF. Altrimenti, usa un verificatoinstallazione di script/archivio un abbinamentoScaricare i file .deb/.rpm. Installa un .deb verificato consudo apt install ./PACKAGE.deb, o un .rpm consudo dnf install ./PACKAGE.rpm(sostituisci i nomi dei file). Un pacchetto diretto rimane di proprietà del gestore del pacchetto, ma non aggiunge un repository né si iscrive automaticamente alle versioni future. Il payload RPM corrente non è firmato; segui la politica della tua distribuzione invece di disabilitare i controlli della firma.

FreeBSD

Prerequisiti: amd64, Bash (anche quando la tua shell interattiva è zsh o Fish), strumenti di download/verifica e una directory di installazione scrivibile. Installa Bash utilizzando il gestore nativo di FreeBSD:

sudo pkg install bash

FreeBSDpkggestisce i prerequisiti, noash: attualmente non c'èashRepository .pkg e nessun archivio di rilascio arm64. Usa ilsceneggiatura verificata, Overificare un tarball amd64 di FreeBSD, estrailo in una directory temporanea e installa la sua versioneashbinario come~/.local/bin/ashaccantoash-broker. Copia i suoi plugin nativi in$XDG_DATA_HOME/ash/plugins(predefinito~/.local/share/ash/plugins), Poiinizializzare. Possiedi questi file;pkg deletenon li rimuoverà. UtilizzoRilascia gli aggiornamenti automaticinella posizione predefinita o sostituire manualmente gli artefatti verificati.

Inizializza e verifica

Dopo aver installato i file binari, esegui il setup in modo interattivo come utente normale. Se non desideri l'integrazione della shell, puoi installare solo Ash. Probabilmente non è quello che vuoi. Il vero valore di ash è l'integrazione della shell di seguito. La configurazione delle sole risorse lascia invariati i file di avvio:

ash install

L'installazione che probabilmente desideri utilizzare prevede l'integrazione della shell. Questo cambierà il tuo .bashrc (o l'equivalente per la tua shell) per includere Ash. Per abilitare l'integrazione dei comandi non trovati, scegli esattamente un comando per la shell che utilizzi:

Bash

ash install --shell bash --shell-integration

zsh

ash install --shell zsh --shell-integration

Pesce

ash install --shell fish --shell-integration

Bash utilizza~/.bashrc, usa zsh~/.zshrce usi del pesce$XDG_CONFIG_HOME/fish/config.fish(predefinito~/.config/fish/config.fish). Successivamente apri una nuova shell; le shell esistenti mantengono il loro broker in esecuzione. L'integrazione è anteposta~/.local/binal PERCORSO: rimuove una vecchia copia locale dell'utente prima di aspettarsi che venga selezionato un pacchetto di sistema.

Se mancano le impostazioni del provider, la configurazione rileva le chiavi del provider esistenti o un server locale in esecuzione; altrimenti offre un menu del provider e richiede le credenziali. Scegli un modello compatibile con strumenti disponibile. Le impostazioni valide esistenti vengono conservate, quindi la riesecuzione della configurazione non è un comando di cambio provider.

Le impostazioni sono memorizzate in$XDG_CONFIG_HOME/ash/.ash_env(predefinito~/.config/ash/.ash_env, autorizzazioni per file privati). L'integrazione gestita li carica. Senza integrazione, gli utenti Bash/zsh possono procurarsi quel file nella normale configurazione di avvio; Gli utenti Fish dovrebbero impostare il corrispondenteASH_AI_*variabili che utilizzano la sintassi Fish, non originano il file in formato Bash. Proteggi qualsiasi file contenente token e non eseguirne mai il commit.

Per un'installazione locale dell'utente senza integrazione, aggiungere la directory effettiva a PATH. Bash/zsh:export PATH="$HOME/.local/bin:$PATH". Pescare:fish_add_path "$HOME/.local/bin". Mantienilo utilizzando la configurazione di avvio della tua shell; sostituire la directory di installazione personalizzata quando applicabile.

command -v ash
command -v ash-broker
ash version
ash "Say hello in one sentence"

I primi comandi dovrebbero risolvere l'installazione che hai scelto. La richiesta richiede un server in esecuzione o credenziali cloud valide; l'installazione di ash non installa un modello.

Ollama locale: nessun account cloud richiesto

Non è necessario disporre di un'IA locale da utilizzareash. Tuttavia, se desideri eseguire i modelli localmente senza fare affidamento su un provider cloud, puoi configurare un server Ollama locale.

Ollama offre anche un servizio cloud per l'esecuzione dei modelli in remoto, ma questo non è necessario per l'utilizzo localeash. Il server cloud include un livello gratuito e il modello cloud Gemma 4 31b di Google (gemma4-31b:nuvola) funziona molto bene conash. Questo è il modello utilizzato dal progetto per generare note di rilascio ed eseguire attività devops.

Installa Ollama usando il suoistruzioni ufficiali del sistema operativo. Avvia l'app/servizio Ollama oppure eseguiloollama servein un terminale separato se un server non è già in esecuzione. Su FreeBSD,ashIl supporto di non implica un programma di installazione nativo di Ollama: utilizza un server raggiungibile su un altro host supportato, se necessario.

Scarica un modello compatibile con gli strumenti adatto al tuo hardware;llama3.1:8bè un esempio, non un requisito minimo. Controlla ilcatalogo strumenti attualeper le alternative:

ollama pull llama3.1:8b
ollama list
curl -fsS http://localhost:11434/api/tags
ash install

Se non sono già impostate chiavi cloud, la configurazione può rilevare il server locale e offrire il modello scaricato. Se è già configurato un altro provider, modificare manualmente l'endpoint/modello. Esempio Bash/zsh:

export ASH_AI_ENDPOINT="http://localhost:11434"
export ASH_AI_MODEL="llama3.1:8b"
unset ASH_AI_AUTH_TOKEN
ash "Say hello in one sentence"

Equivalente pesce:

set -gx ASH_AI_ENDPOINT http://localhost:11434
set -gx ASH_AI_MODEL llama3.1:8b
set -e ASH_AI_AUTH_TOKEN
ash "Say hello in one sentence"

Queste modifiche influenzano solo la shell corrente. Perseverali nella tua protezioneashfile di ambiente o configurazione della shell appropriata, sostituendo eventuali override del vecchio provider. L'Ollama locale non ha bisogno di un gettone. Mantieni il server in loopback a meno che tu non protegga deliberatamente l'accesso; un server remoto riceve le richieste e l'output dello strumento.

Facoltativo: impostareOLLAMA_KEEP_ALIVE=30mnelIl server di Ollamaambiente e riavviare il server per mantenere i modelli al caldo.-1li mantiene caricati indefinitamente ma consuma memoria tra le richieste. Impostandolo solo inashil terminale client non riconfigura un server già in esecuzione.

L'inferenza locale non ha alcuna fattura API del provider, ma utilizza il tuo hardware/storage/elettricità.Nuvola di Olamaè un servizio separato con autenticazione e limiti di piano; non è la stessa configurazione locale.

Livelli cloud gratuiti

Crea una chiave provider utilizzando i collegamenti seguenti, quindi esegui ash install in modo interattivo e scegli il provider. La configurazione richiede il token ed elenca i modelli ove supportati. Scegli un modello di testo di livello gratuito attualmente disponibile con chiamata agli strumenti; elencare un modello non garantisce che sia gratuito per il tuo account.

Stai già esportando la chiave di un fornitore riconosciuto? L'installazione lo rileva; se esistono più chiavi, ti chiede di scegliere. Non incollare chiavi reali nella cronologia dei comandi, nelle registrazioni o nel codice sorgente. Il file di configurazione contiene un segreto, non un deposito crittografato.

Configurazione manuale o cambio di fornitore

Sostituisci l'endpoint seguente con il valore della tabella eMODEL_IDcon un modello verificato nel tuo account fornitore. Se la tua chiave è già esportata comeGROQ_API_KEY, questo esempio Bash/zsh lo riutilizza senza digitare il segreto:

export ASH_AI_ENDPOINT="https://api.groq.com/openai/v1"
export ASH_AI_MODEL="MODEL_ID"
export ASH_AI_AUTH_TOKEN="$GROQ_API_KEY"

Equivalente pesce:

set -gx ASH_AI_ENDPOINT https://api.groq.com/openai/v1
set -gx ASH_AI_MODEL MODEL_ID
set -gx ASH_AI_AUTH_TOKEN "$GROQ_API_KEY"

Per Gemini o OpenRouter, utilizza invece l'endpoint e la variabile chiave riconosciuta. Salva le impostazioni scelte in modo sicuro per le shell future. Gli endpoint cloud richiedono HTTPS e un token; L'HTTP locale non è una scorciatoia per un servizio cloud. Vedereil riferimento ambientaleEaltri fornitori supportatiper servizi a pagamento e override avanzati.

Installazione di script: un'alternativa, non la prima scelta

Preferisci Homebrew, APT, DNF o Pacman: tengono traccia dei file di proprietà, verificano i download utilizzando la loro configurazione di attendibilità e forniscono aggiornamenti/rimozioni familiari. Richiedono comunque la fiducia degli editori e le azioni di installazione dei pacchetti.

Prerequisiti: un sistema operativo/architettura supportato,$SHELLidentificare Bash/zsh/Fish,Firma Sigstore,tar,uname,install, utilità della shell standard, un comando SHA-256 (sha256sum,shasum, Osha256) e un downloader (curl,wgeto Python). L'esempio utilizza curl. Anche FreeBSD ha bisogno di Bash. La tua directory home/installazione deve essere scrivibile.

Scaricalo in un file locale, esaminalo con un editor ed eseguilo solo se ti fidi della sua origine e del suo comportamento. L'ispezione non è una garanzia di sicurezza; non eseguire questi passaggi alla cieca:

curl -fsSL https://jonconradt.github.io/ash/install.sh -o ash-install.sh
less ash-install.sh

Dopo l'ispezione, esegui la copia salvata come utente normale:

sh ./ash-install.sh
rm ./ash-install.sh

install.shscarica la versione più recente, verifica il manifest del checksum firmato Sigstore e il digest dell'archivio, quindi installaash/ash-brokerIn~/.local/bin. I plugin nativi vanno in rovina$XDG_DATA_HOME/ash/plugins. Esegue la configurazione per utente e chiede prima di abilitare l'integrazione della shell. Senza un terminale interattivo, le richieste del provider/integrazione potrebbero essere saltate: eseguiash installin modo interattivo in seguito.

Puoi impostareASH_INSTALL_DIRprima di eseguire lo script per scegliere un'altra destinazione. Aggiungi tu stesso quella destinazione a PATH.L'aggiornamento automatico è supportato solo in~/.local/bin; le destinazioni personalizzate richiedono la sostituzione manuale. Lo script non ha un selettore Beta/Notturno.

Verificare un pacchetto o un archivio diretto

Prerequisiti: cosign e un'utilità SHA-256. Dalla stessa versione pubblicata, scarica il tuo pacchetto/archivio,SHA256SUMS, ESHA256SUMS.sigstore.json. Lavora in una nuova directory. SostituirevX.Y.Zcon il tag esatto, incluso un suffisso prerelease, se applicabile:

cosign verify-blob SHA256SUMS \
  --bundle SHA256SUMS.sigstore.json \
  --certificate-identity "https://github.com/Jonconradt/ash/.github/workflows/release.yml@refs/tags/vX.Y.Z" \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com"

Solo dopo che ciò ha esito positivo, calcola il digest del tuo file conshasum -a 256 PACKAGEsu macOS,sha256sum PACKAGEsu Linux, osha256 -q PACKAGEsu FreeBSD. SostituirePACKAGEcon il nome file scaricato e confrontalo esattamente con la voce di quel nome file nel manifest verificato. Interrompi su una voce mancante o su qualsiasi mancata corrispondenza. Un checksum non firmato scaricato accanto a un file non equivale ai metadati dell'editore verificati.

Aggiornamenti e i tre canali

• Rilascio (consigliato):versioni pubblicate stabili comevX.Y.Z; la configurazione del repository lo chiamastable.
• Beta:test pre-release, taggatovX.Y.Z-beta.N; aspettarsi cambiamenti e regressioni.
• Notturno:recenti modifiche al ramo predefinito, contrassegnate con tagvX.Y.Z-nightly.YYYYMMDD.N; il più alto rischio di regressione. Le build sono pianificate ma potrebbero essere saltate se non cambia nulla o la pubblicazione non riesce.

Una versione pubblicata aggiorna la corrispondente formula Homebrew o il repository Linux firmato. Lo ricevi quando esegui il comando di aggiornamento del gestore proprietario (o lo fa la tua politica di aggiornamento del sistema operativo). La pubblicazione, gli aggiornamenti del repository e la distribuzione del sito Web possono ritardare a vicenda; verificare la disponibilità prima di cambiare canale. ash non installa silenziosamente gli aggiornamenti binari in background.

Homebrew: installa o cambia formula

Per una nuova installazione Beta/Notturna, utilizza il nome completo della formula corrispondente sopra in brew install. Quando si passa, disinstallare prima la formula attualmente installata: tutti e tre forniscono gli stessi file binari. Esempio, versione beta:

brew uninstall ash
brew install Jonconradt/ash/ash-beta
brew update
brew upgrade ash-beta

Utilizzoash-nightlyper notturno oashper Release nei comandi di installazione/aggiornamento. Disinstallare la formula effettiva del vecchio canale, non sempreash. Le impostazioni dell'utente vengono mantenute; aprire una nuova shell dopo il passaggio.

Linux: seleziona un canale del repository

APPARTAMENTO:utilizzare ilConfigurazione dell'APTcon esattamente una distribuzione dalla tabella. Per cambiare un'installazione esistente, modifica/etc/apt/sources.list.d/versionx.list, sostituendostableconbetaOnightly(o torna astable), Poi:

sudo apt update
sudo apt install --allow-downgrades ash

DNF:utilizzare ilConfigurazione DNFcon l'URL base selezionato. Per un'installazione esistente, sostituirebaseurlIn/etc/yum.repos.d/versionx.repo, mantenendo le impostazioni della firma, quindi:

sudo dnf --refresh distro-sync ash

Pacman:utilizzare ilConfigurazione di Pacmancon l'URL del server selezionato. Mantieni il nome della sezione[versionx]: ogni canale pubblica un database denominatoversionx.db. Cambia il server in quella sezione anziché aggiungere un database con un nome diverso. Per passare, incluso un downgrade:

sudo pacman -Syuu ash

Rivedi la transazione proposta: il ritorno alla Release potrebbe eseguire il downgrade di ash e il doppio u di Pacman può anche eseguire il downgrade di altri pacchetti. Eseguire il backup della configurazione prima di cambiare. Successivamente utilizzare i normali comandi di aggiornamento APT/DNF/Pacman dalle sezioni del sistema operativo; non lasciare abilitate diverse origini canale ash.

Aggiornamenti di rilascio locali dell'utente

ash update

Questo verifica e installa una versione stabile solo quando è attivaashl'eseguibile è sotto~/.local/bin. Aggiorna anche risorse/plug-in in bundle, con scelte per file personalizzati.ash update --version vX.Y.Zseleziona un tag stabile, non un canale; non è un comando di downgrade. Non c'è--channelopzione. Le installazioni del gestore pacchetti, le installazioni macOS .pkg e le destinazioni degli script personalizzati devono invece utilizzare il proprio gestore/programma di installazione. FreeBSD Beta/Nightly utilizza archivi verificati manualmente, non un abbonamento ad aggiornamento automatico. Apri una nuova shell dopo l'aggiornamento.

Disinstalla senza rimuovere file non correlati

1. Disabilita prima l'integrazione della shell

Prima di rimuovere i file binari, esegui il comando per ciascuna shell in cui hai abilitato l'integrazione:

Bash

ash install --shell bash --disable-shell-integration

zsh

ash install --shell zsh --disable-shell-integration

Pesce

ash install --shell fish --disable-shell-integration

Seashè già mancante, modifica il file di avvio pertinente dainizializzazionee rimuovere solo il blocco in mezzo# >>> ash install >>>E# <<< ash install <<<. Rimuovi qualsiasiash-linee PERCORSO/ambiente specifiche aggiunte manualmente, configurazione della shell non correlata. Vicinoash-shell abilitate in seguito in modo che i loro broker di proprietà della shell escano.

2. Consentire al gestore pacchetti proprietario di rimuovere i propri file

Homebrew (versione)

brew uninstall ash

APT

sudo apt remove ash

DNF

sudo dnf remove ash

Pacman

sudo pacman -R ash

Scegli solo il metodo di installazione; per uso Homebrew Beta/notturnoash-beta/ash-nightly. APT/DNF/Pacman rimuovono i file binari, i plugin e le pagine man di proprietà del pacchetto, non la configurazione/cronologia della directory home. Non eliminare manualmente i file di proprietà del pacchetto.

Pulizia opzionale del repository: rimuovere il fileashfile sorgente/etc/apt/sources.list.d/versionx.listed è dedicato/etc/apt/keyrings/versionx-keyring.gpg, o ilashfile di deposito/etc/yum.repos.d/versionx.repo, o ilash [versionx]sezione da/etc/pacman.conf. Per prima cosa controlla che nessun altro pacchetto li utilizzi. Rimuovere una chiave di attendibilità RPM/Pacman importata solo dopo aver confermato la sua impronta digitale e che nient'altro faccia affidamento su di essa; non eliminare mai il portachiavi condiviso di una distribuzione.

3a. Rimozione manuale di macOS .pkg

Il programma di installazione di macOS registra una ricevuta ma non haashprogramma di disinstallazione. Conferma che si tratta di un'installazione .pkg, non di Homebrew, e controlla il suo esatto payload:

pkgutil --pkg-info dev.ash.cli
pkgutil --files dev.ash.cli

Utilizzando quella ricevuta come inventario, rimuovi solo la suaashfile di proprietà:/usr/local/bin/ash,/usr/local/bin/ash-broker, i file in/usr/local/lib/ash/plugins,/usr/local/share/man/man1/ash.1, l'elenco localizzatoash.1pagine e avvisi in/usr/local/share/licenses/ash. Sono necessari i privilegi di amministratore. Verificare la proprietà se un altro programma di installazione ha successivamente sostituito questi file; non rimuovere la sua copia. Rimuovi vuotoash-solo directory, non condivise/usr/local,bino directory man.

Dopo aver rimosso il carico utile, facoltativamente rimuovere la ricevuta:

sudo pkgutil --forget dev.ash.cli

Dimenticare una ricevuta non rimuove alcun file installato.Conservalo finché non hai finito di controllare il carico utile.

3b. Rimozione manuale dell'archivio locale dell'utente/Linux/FreeBSD

Individua la copia attiva concommand -v ashEcommand -v ash-broker. Per l'installazione dello script predefinito, dopo aver disabilitato gli hook, rimuovere questi due file specifici:

rm "$HOME/.local/bin/ash" "$HOME/.local/bin/ash-broker"

PerASH_INSTALL_DIRo un archivio estratto manualmente, rimuovere solo il file effettivamente installatoash/percorsi del broker. Rimuovere i plugin/pagine man/avvisi di archivio installati utilizzando l'inventario dei file originali; i plugin di script sono nel fileashdirectory dei dati utente. Se i file sono in/usr/bin, controlla prima la proprietà condpkg -S /usr/bin/ash,rpm -qf /usr/bin/ash, Opacman -Qo /usr/bin/ashcome appropriato. Una copia di proprietà del pacchetto deve essere rimossa tramite tale gestore, anche se installata da un download autonomo.

4. Facoltativo: cancella le impostazioni locali, gli strumenti e la cronologia

• Configurazione:$XDG_CONFIG_HOME/ash, predefinito~/.config/ash.
• Dati, plugin e ambiente Python:$XDG_DATA_HOME/ash, predefinito~/.local/share/ash.
• Storia e stato:$XDG_STATE_HOME/ash, predefinito~/.local/state/ash.
• Cache:$XDG_CACHE_HOME/ash, predefinito~/.cache/ash.
• Durata del broker:$XDG_RUNTIME_DIR/ash, O$XDG_STATE_HOME/ash/runtimequando non è disponibile alcuna root di runtime.

Controlla le tue effettive sostituzioni XDG assolute prima di eliminare solo queste sottodirectory ash; non eliminare mai una root XDG o la tua home directory. Dopo che tutte le shell abilitate per ash sono state chiuse, rimuovere i file di runtime ash rimanenti, se necessario. Le credenziali OAuth MCP possono anche rimanere nel gestore credenziali del sistema operativo: rimuovere qui le voci specifiche di ash e revocare l'accesso al provider MCP. Revocare le chiavi AI non utilizzate negli account del fornitore; l'eliminazione di un file locale non revoca una chiave. Non disinstallare Ollama/models, Python o le dipendenze condivise come parte della rimozione di ash.

Risoluzione rapida dei problemi

Comando non trovato o versione errata

Controlla PERCORSO ecommand -v ash/command -v ash-broker. Un vecchio~/.local/binla copia può eseguire l'ombreggiatura di un pacchetto. Utilizza un proprietario/canale alla volta e apri una nuova shell.

Il menu del fornitore non è stato visualizzato

Correreash installda un terminale interattivo. Le impostazioni valide esistenti vengono conservate; utilizzoconfigurazione manualeper cambiare fornitore. Senza integrazione, assicurati che le impostazioni vengano esportate nell'ambiente della CLI.

Nessun modello o connessione rifiutata

Per Ollama, conferma che il suo server è in esecuzione eollama listinclude il modello scelto. Per i servizi cloud, controlla l'endpoint, l'idoneità del modello, HTTPS, il token e la quota dell'account; non condividere mai log contenenti token.

Repository o canale non disponibile

Controllare l'architettura e la versione/repository pubblicato. La pubblicazione può subire ritardi; non disabilitare la verifica della firma per aggirare un repository non disponibile.

La configurazione dello strumento Python non è riuscita

Installa Python con venv/ensurepip e consenti i download delle dipendenze, quindi esegui nuovamenteash install. Di baseashrimane utilizzabile senza questi strumenti.

Hai bisogno di maggiori dettagli? Vedereil riferimento al comando,Domande frequenti, Osegnalare un problemasenza credenziali.