Pi Agent Multiplattform-Bereitstellung

Pi Agent unterstützt die Ausführung auf Windows, macOS, Linux und Android (Termux).

Dieses Kapitel behandelt die wesentlichen Konfigurationspunkte für jede Plattform.

macOS-Konfiguration

macOS ist eine erstklassig unterstützte Plattform für Pi Agent, und die meisten Funktionen funktionieren ohne weitere Konfiguration.

Empfohlene Terminals

True-Color-Unterstützung überprüfen

$ echo $COLORTERM
truecolor

Shell-Aliase

Pi Agent führt bash standardmäßig im nicht-interaktiven Modus aus (d. h.bash -c); er erweitert Ihre Shell-Aliase nicht automatisch.

Kernmechanismus: Pi dazu bringen, Shell-Aliase zu erkennen. Um benutzerdefinierte Aliase in Pi zu verwenden, schreiben Sie die folgende Konfiguration in ~/.pi/agent/settings.json (oder ~/.atomic/agent/settings.json), damit er Ihre Shell-Konfigurationsdatei (wie ~/.zshrc oder ~/.bashrc) beim Start aktiv lädt:

{
  "shellCommandPrefix": "shopt -s expand_aliases\neval \"$(grep '^alias ' ~/.zshrc)\""
}

Hinweis:Bitte ändern Sie den Pfad ~/.zshrc in den tatsächlichen Pfad Ihrer Shell-Konfigurationsdatei.

Windows-Konfiguration

Unter Windows können Sie Pi Agent über ein natives Terminal oder WSL2 ausführen. Der Schlüssel liegt darin, das richtige Terminal auszuwählen und Tastenkürzelkonflikte zu beheben.

Empfohlene Installationsmethode

Unter Windows wird empfohlen,Windows Terminalmit WSL2 zu verwenden oder direkt Node.js zu nutzen.

Git für Windows installieren

Pi verwendet standardmäßig Git Bash, um Befehle unter Windows auszuführen.

Beim Start sucht es der Reihe nach, einschließlich des StandardpfadsC:\Program Files\Git\bin\bash.exe。

Wenn Git für Windows nicht installiert ist, wird bash beim Start nicht gefunden; installieren Sie einfach Git für Windows, um dies zu beheben.

Wenn Sie Git Bash nicht verwenden möchten, können Sie auchshellPathein anderes bash konfigurieren oder überdefaultToolszum PowerShell-Tool wechseln.

Node.js installieren

vonnodejs.orgLaden Sie den Installer herunter oder verwenden Sie winget:

# PowerShell
> winget install OpenJS.NodeJS.LTS

Pi Agent installieren

Führen Sie Folgendes in PowerShell oder CMD im Windows Terminal aus:

# PowerShell
> npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Windows-spezifische Tastenkürzel

Unter Windows sendet Ctrl+Q standardmäßig Follow-up-Nachrichten und Alt+Q ruft in der Warteschlange befindliche Nachrichten ab; eine Neubelegung ist nicht erforderlich.

Eine Konfiguration ist nur erforderlich, wenn Sie auf Alt+Enter umsteigen möchten.

In Windows Terminal ist Alt+Enter standardmäßig die Tastenkombination für den Vollbildmodus.

Wenn Pi Agent diese Tastenkombination empfangen soll, müssen Sie die Vollbild-Tastenkombination in den Windows Terminal-Einstellungen entfernen oder neu belegen.

Suchen Sie in den Einstellungen nach "toggleFullscreen" und ändern Sie dessen Tastenkombination auf eine andere Kombination.

Legen Sie dann die Bindung von pi'sapp.message.followUpauf alt+enter fest.

Suspend-Verhalten

Native Windows-Terminals unterstützen keine Unix-Jobsteuerung.

Unter nativem Windows ist Ctrl+Z an das Rückgängigmachen der Bearbeitung gebunden; Sie müssen eine eigene Tastenkombination für das Suspendieren binden.

Unter WSL verwenden Sie Alt+Z zum Suspendieren; Ctrl+Z kann weiterhin Prozesse suspendieren, und fg kann sie wieder in den Vordergrund holen.

Termux-Konfiguration (Android)

Pi Agent kann auf Android-Geräten über Termux ausgeführt werden.

Installationsschritte

Installieren Sie zunächst Termux selbst. Holen Sie das neueste Installationspaket von F-Droid und führen Sie dann die folgenden Befehle in Termux aus.

Zusätzlich zu Termux selbst müssen Sie auch die Termux:API-App auf Ihrem Telefon installieren.

Diese App kann auch von F-Droid bezogen werden; Geräteintegrationsfunktionen wie die Zwischenablage hängen davon ab.

Wenn Sie nur das termux-api-Kommandozeilenpaket installieren, ohne die Termux:API-App zu installieren, werden die zugehörigen Befehle nicht wirksam.

Hinweise

Die Termux-Umgebung unterscheidet sich von regulärem Linux; bitte beachten Sie die folgenden Punkte.

tmux-Integration

Pi Agent funktioniert normal in tmux-Sitzungen.

Vorteile

Pi Agent in tmux zu betreiben dient hauptsächlich der Persistenz und den Multi-Window-Funktionen.

Empfohlene Konfiguration

Fügen Sie Folgendes zu ~/.tmux.conf hinzu:

Von diesen sind die beiden extended-keys-Zeilen die entscheidende Konfiguration; sie stellen sicher, dass Tastenkombinationen wie Shift+Enter und Ctrl+Enter korrekt an pi übergeben werden.

extended-keys-format csi-u erfordert tmux 3.5 oder höher; du kannsttmux -Vverwenden, um die Version zu prüfen.

$ tmux -V
tmux 3.5a

Ohne diese beiden Zeilen wird Shift+Enter in tmux zu einem einfachen Enter herabgestuft, und mehrzeilige Eingabe sendet die Nachricht direkt.

Wenn die tmux-Version zwischen 3.2 und 3.4 liegt, lass die csi-u-Zeile weg; pi unterstützt weiterhin das Standard-xterm-Format von tmux.

Optimierung der Terminal-Einstellungen

Unabhängig davon, welches Terminal du verwendest, wirken sich die folgenden Einstellungen direkt auf die Anzeigequalität von Pi Agent aus.

Konfiguration des integrierten Terminals in VS Code

Fügen Sie die folgende Konfiguration zur settings.json von VS Code hinzu; der Dateipfad ist~/Library/Application Support/Code/User/settings.json(macOS):

Shell-Alias-Empfehlungen

Das Folgende ist ein vollständiges Set von Pi Agent-Aliasen, plattformübergreifend kompatibel. Du kannst sie zu ~/.zshrc, ~/.bashrc oder einer entsprechenden Shell-Konfigurationsdatei hinzufügen:

Wenn Sie die Fish-Shell verwenden, ändern Sie alias in abbr oder verwenden Sie die Alias-Syntax von Fish.

# fish shell 使用 abbr 定义缩写
abbr -a pic pi -c