Troubleshooting DE

Fehlerbehebung

🌍 English · Polski · Français · Deutsch · 中文

Lösungen für häufige ECLI-Probleme.

Erste Schritte bei jedem Problem

1. editor.log prüfen im Konfigurationsverzeichnis.
2. Im sauberen Modus ausführen: ecli --no-config --no-plugins.
3. Version und Plattform notieren: ecli --version und uname -a.
4. Bestehende Issues durchsuchen vor dem Öffnen eines neuen.

---

Installationsprobleme

Befehl ecli nicht gefunden

ECLI installiert, aber nicht in PATH.

Linux / FreeBSD / macOS:

• Native Pakete → /usr/local/bin/
• PyPI User-Install → ~/.local/bin/ — zu PATH hinzufügen:

  export PATH="$HOME/.local/bin:$PATH"

Windows:

• Installer fügt zu PATH hinzu. Neue PowerShell-Sitzung öffnen.

macOS: "ecli is damaged and can't be opened"

xattr -d com.apple.quarantine /usr/local/bin/ecli

macOS: "ecli cannot be opened because the developer cannot be verified"

ECLI ist ad-hoc signiert. Lösungen:

• Systemeinstellungen → Datenschutz → "Open Anyway"
• Oder xattr -d com.apple.quarantine /usr/local/bin/ecli

Windows: "VCRUNTIME140.dll missing"

Microsoft Visual C++ Redistributable installieren.

Linux: libncursesw.so.6: cannot open shared object file

sudo apt install libncursesw6 libtinfo6   # Debian
sudo dnf install ncurses-libs              # Fedora

FreeBSD: pkg install schlägt mit Abhängigkeitsfehlern fehl

sudo pkg update -f
sudo pkg install ./ecli_0.1.3_freebsd_x86_64.pkg

---

Anzeigeprobleme

Falsche Farben

echo $TERM
echo $COLORTERM

Erwartet: TERM=xterm-256color, COLORTERM=truecolor.

Beheben:

export TERM=xterm-256color
export COLORTERM=truecolor

Für tmux:

set -g default-terminal "tmux-256color"
set -as terminal-features ",xterm-256color:RGB"

Falsche Box-Drawing-Zeichen

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

Statusleiste falsch ausgerichtet

Font-Problem. Fira Code, JetBrains Mono, Cascadia Code oder Iosevka verwenden.

Bildschirmflackern

Terminal-Emulator aktualisieren. Alacritty, WezTerm oder Kitty ausprobieren.

---

Editor-Probleme

Datei lässt sich nicht speichern: "Permission denied"

ls -la /pfad/datei

Verlorene Arbeit nach Absturz

[editor]
autosave = true
autosave_interval_seconds = 30

Falsches Encoding

ecli --encoding utf-8 file.txt

---

Probleme mit dem KI-Panel

"API key not configured"

Prüfen:

ecli --check-config

"Connection refused" (Ollama)

ollama serve

Verifizieren:

curl http://localhost:11434/api/tags

"Rate limit exceeded"

Warten oder Anbieter wechseln (Tab im Panel).

Sehr langsame Antworten

• Anthropic/OpenAI — Netzwerklatenz prüfen.
• Ollama — Größe des lokalen Modells.

Leere Antwort

• Inhaltsrichtlinien-Verletzung
• Kontextlänge überschritten — Eingabe reduzieren
• Timeout — timeout_seconds erhöhen

---

Probleme mit dem Git-Panel

"Not a Git repository"

ECLI von einem Git-Repository aus starten.

Authentifizierung beim Push schlägt fehl

ECLI ruft git auf. Außerhalb von ECLI testen:

git push origin main

Binärer Diff

.gitattributes konfigurieren:

*.pdf binary
*.png binary

---

LSP-Probleme

Keine Autovervollständigung

[lsp]
enabled = true

[lsp.python]
command = "pylsp"

Prüfen:

which pylsp

LSP-Server stürzt ab

editor.log für Details konsultieren.

---

Plugin-Probleme

Plugin geladen, aber nicht in Palette

Der String im @command("name")-Dekorator muss genau eingegeben werden.

Plugin lässt ECLI abstürzen

ecli --no-plugins

Wenn es funktioniert, das problematische Plugin deaktivieren.

---

Performance-Probleme

Hohe CPU-Last

[editor]
treesitter_threshold_kb = 1024

Oder:

ecli --no-syntax file.txt

Speicher wächst

ECLI neu starten. Issue mit editor.log melden.

---

Wie man ein gutes Issue öffnet

Einschließen:

1. ECLI-Version (ecli --version)
2. OS und Architektur (uname -a)
3. Python-Version bei PyPI (python3 --version)
4. Terminal-Emulator und Version
5. Reproduktionsschritte
6. Erwartetes vs. tatsächliches Verhalten
7. editor.log-Auszüge (Geheimnisse schwärzen)
8. Ihre config.toml (API-Schlüssel schwärzen)