Pi Agent Installation
Dieses Kapitel erklärt, wie Sie Pi Agent auf verschiedenen Plattformen installieren und die grundlegende Umgebungskonfiguration abschließen.
Umgebungsanforderungen
Bevor Sie Pi Agent installieren, stellen Sie bitte sicher, dass Ihr System die folgenden Anforderungen erfüllt:
| Abhängigkeit | Mindestversion | Beschreibung |
|---|---|---|
| Node.js | 18 LTS oder höher empfohlen | Pi Agent läuft auf Node.js und erfordert eine Laufzeitumgebung, die moderne JavaScript-Funktionen unterstützt |
| npm | Mit Node.js mitgeliefert | Wird verwendet, um Pi Agent und Erweiterungspakete zu installieren |
| Terminal | Unterstützt True Color | Empfohlen: iTerm2 (macOS), Windows Terminal, Kitty, WezTerm |
Prüfen Sie, ob Node.js installiert ist:
node --version
Ausgabe ähnelt:
v20.11.0
Prüfen Sie, ob npm zusammen damit installiert wurde (es wird mit Node.js mitgeliefert):
npm --version
Ausgabe ähnelt:
10.2.4
Wenn Ihre Node.js-Version niedriger als 18 ist, führen Sie bitte zuerst ein Upgrade durch. Sie können nvm (Node Version Manager) verwenden, um mehrere Node.js-Versionen zu verwalten.
Installation
Methode 1: Globale Installation über npm
Dies ist die gebräuchlichste und einfachste Installationsmethode, geeignet für macOS, Linux und Windows:
# 全局安装 Pi Agent # --ignore-scripts 禁用依赖包的生命周期脚本,提高安装安全性 npm install -g --ignore-scripts @earendil-works/pi-coding-agent
Überprüfen Sie die Version nach der Installation:
pi --version
Nach der Installation kannpider Befehl direkt im Terminal verwendet werden.
Methode 2: Ein-Klick-Skript über curl
Unter Linux oder macOS können Sie auch das offizielle Installationsskript verwenden:
# 使用 curl 下载并执行安装脚本 curl -fsSL https://pi.dev/install.sh | sh
Dieses Skript erkennt Ihr System automatisch und schließt die Installation ab. Im Wesentlichen installiert es ebenfalls global über npm.
Methode 3: Andere Paketmanager
Wenn Sie pnpm, Yarn oder Bun verwenden, können Sie auch mit dem entsprechenden Befehl installieren:
# 使用 pnpm 安装 pnpm add -g @earendil-works/pi-coding-agent # 使用 Yarn 安装 yarn global add @earendil-works/pi-coding-agent # 使用 Bun 安装 bun install -g @earendil-works/pi-coding-agent
Deinstallationsmethoden
Wenn Sie Pi Agent deinstallieren, verwenden Sie denselben Paketmanager, den Sie für die Installation verwendet haben:
# npm 或 curl 安装的用 npm 卸载 npm uninstall -g @earendil-works/pi-coding-agent # pnpm 安装的 pnpm remove -g @earendil-works/pi-coding-agent # Yarn 安装的 yarn global remove @earendil-works/pi-coding-agent # Bun 安装的 bun uninstall -g @earendil-works/pi-coding-agent
Durch die Deinstallation von Pi Agent werden Ihre Konfiguration, Anmeldeinformationen oder Sitzungsaufzeichnungen nicht gelöscht. Diese Daten werden im Verzeichnis~/.pi/agent/gespeichert. Um sie vollständig zu entfernen, können Sie dieses Verzeichnis manuell löschen.
Terminal-Empfehlungen
Pi Agent verwendet 24-Bit-RGB-Farben, um die Terminal-Oberfläche darzustellen. Für die beste Erfahrung werden die folgenden Terminals empfohlen:
| Plattform | Empfohlenes Terminal | Beschreibung |
|---|---|---|
| macOS | iTerm2、Kitty、Warp | Native True-Color-Unterstützung mit guter Anzeige eingebetteter Bilder |
| Windows | Windows Terminal、WezTerm | Windows Terminal ist das offiziell empfohlene moderne Terminal |
| Linux | Kitty、WezTerm、Alacritty | Beide unterstützen True Color und GPU-Beschleunigung |
Weitere Terminal-Tools finden Sie unter:https://www.example.com/w3cnote/terminal-tools.html
Prüfen Sie, ob Ihr Terminal True Color unterstützt:
$ echo $COLORTERM truecolor
Wenn die Ausgabetruecoloroder24bitist, unterstützt Ihr Terminal die vollständige Farbdarstellung.
Erster Start
Wechseln Sie nach der Installation in ein Projektverzeichnis und starten Sie Pi Agent:
$ cd /path/to/your-project $ pi
Beim ersten Start sehen Sie den Willkommensbildschirm von Pi Agent.
Zu diesem Zeitpunkt wurde noch kein KI-Anbieter konfiguriert. Sie müssen zuerst die Authentifizierung abschließen—dies wird im nächsten Kapitel ausführlich erläutert.
Wenn Pi Agent startet, verwendet es das aktuelle Arbeitsverzeichnis (cwd) als Projektstamm. Es verfügt über Lese- und Schreibberechtigungen für Dateien in diesem Verzeichnis. Es wird empfohlen, es unter Git-Versionskontrolle zu verwenden, damit Änderungen leicht rückgängig gemacht werden können.
Pi Agent aktualisieren
Halten Sie Pi Agent auf dem neuesten Stand:
# 仅更新 Pi Agent 本身 pi update --self # 更新 Pi Agent 和所有已安装的扩展包 pi update --all # 更新模型目录(获取最新的可用模型列表) pi update --models
Die Verwendung von--self --forceerzwingt eine Neuinstallation von Pi Agent, selbst wenn bereits die neueste Version installiert ist:
$ pi update --self --force
Beachten Sie, dass von Installationsskripten wie install.sh verwaltete Installationen--force nicht unterstützen。
Wenn eine solche verwaltete Installation repariert werden muss, führen Sie einfach das Installationsskript erneut aus.
Andere Erweiterungen