Lösen Sie alle Konflikte direkt (die Hilfsroutinen in `src/host_aggregate.c` spiegeln bereits das Layout von `main` wider, daher sind Merges in der Regel unkompliziert) und führen Sie `make` aus, um zu bestätigen, dass der Build noch erfolgreich ist, bevor Sie das Ergebnis pushen.

## Automation hooks

- `host_snapshot_last_captcha` gibt die zuletzt generierte Captcha-Aufforderung und -Antwort zusammen mit einem Zeitstempel aus, sodass externe Clients im Namen unbeaufsichtigter Automatisierung Herausforderungen bestehen können.

## Security hardening

- `scripts/safe_permission.sh` schränkt die Besitzer- und Moduseinstellungen für Laufzeitdaten-Dateien (BBS-Zustand, Abstimmungszustand, Cooldown-Snapshots und allgemeiner Chatter-Zustand) ein. Führen Sie es nach der Bereitstellung aus, um das Datenverzeichnis auf `ssh-chatter` zu beschränken und sicherzustellen, dass jede Datei auf `0600` gesetzt ist. Überschreiben Sie die Ziele, indem Sie explizite Pfade übergeben oder die Umgebungsvariablen `STATE_ROOT` oder die entsprechenden `CHATTER_*_FILE` vor der Ausführung exportieren.
- Ein Hintergrund-BBS-Watchdog speist regelmäßig Beiträge und Kommentare in die KI-Moderation-Pipeline (Gemini primär mit Ollama als Fallback). Markierte Beiträge werden automatisch entfernt und eine Benachrichtigung wird im Raum ausgestrahlt.
- Chat-Nachrichten, ASCII-Kunst und BBS-Beiträge/Kommentare durchlaufen eine KI-Moderation-Pipeline. Aktivieren Sie sie mit `CHATTER_SECURITY_AI=on` (setzen Sie `GEMINI_API_KEY` für Gemini; der Daemon fällt automatisch auf den lokalen Ollama-Endpunkt unter `http://127.0.0.1:11434` zurück). Deaktivieren Sie alles mit `CHATTER_SECURITY_FILTER=off`. Falls alle Anbieter ausfallen, deaktiviert sich der Filter automatisch, um den Gesprächsfluss aufrechtzuerhalten, anstatt Inhalte stillschweigend zu verwerfen.
- Der SSH-Transport ist auf moderne Schlüsselaustausche, Chiffren und MACs festgelegt, und jede Bridge-Nutzlast ist in eine dreifache AES-256-GCM-Zwiebel eingewickelt, sodass Relais nur Chiffretext sehen.
- Verdächtige Einsendungen, die den mehrschichtigen Filter auslösen, werden jetzt pro-IP verfolgt; wiederholte Treffer lösen bei Aktivierung einen automatischen Kick und Bann aus, während der Schnellwiedererkennungsdetektor längere Wiederherstellungsfenster erlaubt, sodass instabile Netzwerksitzungen ohne Bestrafung wieder beitreten können. Automatische Bann-Einträge sind **standardmäßig deaktiviert**; setzen Sie `CHATTER_AUTO_BAN=on` (oder `true`/`1`), um sie zu aktivieren, oder lassen Sie die Variable ungesetzt, um Warnungen und Drosselung zu behalten, ohne automatische Bann-Einträge zu schreiben.
- Betreiber können vertrauenswürdige Einstiegspunkte (VPN-Ausgänge, Reverse-Proxies, localhost) mit `CHATTER_PROTECTED_IPS` (kommagetrennt, Standardwerte `127.0.0.1,::1,192.168.0.1`) markieren, sodass Notfall-Banns den Daemon nie von seiner eigenen Steuerungsebene aussperren.

## File storage and transfers

- Alle vom Benutzer verwalteten Dateien befinden sich jetzt unter `/etc/ssh-chatter/user-files` (Überschreiben mit `CHATTER_FILESTORE_PATH`, Legacy-Fallback: `CHATTER_FILE_STORAGE_ROOT`). Der Daemon erstellt das Verzeichnis bei Bedarf und hält Uploads darauf beschränkt.
- SSH-Clients verwenden standardmäßiges `scp` ohne benutzerdefinierten Wrapper. Behandeln Sie `/name.ext` als Stamm des Speicherbaums: `scp my.zip user@host:/demos/my.zip` schreibt nach `/etc/ssh-chatter/user-files/demos/my.zip`, während `scp user@host:/readme.txt ./` `/etc/ssh-chatter/user-files/readme.txt` herunterlädt.
- TELNET-Clients verwenden die neuen `/filestore`-Befehle. `/filestore` listet verfügbare Dateien auf, `/filestore-upload` startet eine `rz`-Sitzung und `/filestore-download <name>` startet eine `sz`-Sitzung. Installieren Sie `lrzsz` (oder ein beliebiges Paket, das `rz`/`sz` bereitstellt) auf dem Server, damit das ZMODEM-Backend diese Helfer starten kann.
- `/filestore-upload` akzeptiert ein optionales Ziel (z.B. `/filestore-upload /kitten/meow.png`). SSH-Chatter erstellt das Verzeichnis `/kitten` automatisch und legt die hochgeladene Datei dort ab, ähnlich wie SCP Pfade wie `user@host:/kitten/meow.png` verwendet.
- Beide Transporte können gemischt werden: SSH für unbeaufsichtigte, scriptgesteuerte Übertragungen, TELNET für nostalgische BBS-Clients mit integrierter ZMODEM-Unterstützung.

## Morse Relay
SSH-Chatter unterstützt Amateurfunk-Relais.
Dies zeigt globale Morsecodes.
`/morse on` zum Ansehen, `/morse-reply` zum Senden.

### Protocol Details

Die Implementierung folgt der Binkp-Protokollspezifikation:
- Standard-Binkp-Frame-Struktur mit 2-Byte-Headern
- Sitzungspasswort-Authentifizierung (CMD\_PWD/CMD\_OK)
- Keepalive-Mechanismus (CMD\_NUL) alle 60 Sekunden
- Benutzerdefinierter CHAT-Befehl (CMD\_CHAT, Erweiterung) für die Nachrichtensynchronisation

## Prerequisites

Zum Bauen des Projekts wird eine POSIX-Umgebung benötigt mit:

- Ein C23-kompatibler Compiler (z.B. `gcc` oder `clang`)
- `make`
- `libssh` Entwicklungs-Header und Bibliothek (`libssh-dev` auf Debian/Ubuntu)
- `libcurl` Entwicklungs-Header und Bibliothek (`libcurl4-openssl-dev` auf Debian/Ubuntu)
- `uchardet` Entwicklungs-Header und Bibliothek (`libuchardet-dev` auf Debian/Ubuntu)
- `icu` (International Components for Unicode) Entwicklungs-Header und Bibliothek (`libicu-dev` auf Debian/Ubuntu)
- `lz4` Kompressionsbibliothek und Entwicklungs-Header (`liblz4-dev` auf Debian/Ubuntu)
- POSIX-Threads (normalerweise von der System-`libpthread` bereitgestellt)
- `python3-pygments` (stellt den `pygmentize` Highlighter für den Tetris-Tarnbildschirm bereit)

Auf Debian/Ubuntu können die Abhängigkeiten installiert werden mit:```bash
sudo apt-get update
sudo apt-get install build-essential libssh-dev libcurl4-openssl-dev libuchardet-dev libicu-dev liblz4-dev

Dies erzeugt eine `ssh-chatter`-Binärdatei im Repository-Stammverzeichnis und ein `libssh_chatter_backend.so`-Shared-Object, das die Übersetzungshilfen zur Wiederverwendung in anderen Anwendungen bereitstellt.  Bereinigen Sie Zwischenartefakte mit `make clean`.

### Verwendung des gemeinsamen Übersetzungs-Backends

Das Shared-Object verwendet die C-Übersetzungspipeline des Servers wieder (einschließlich der Erhaltung von ANSI-Platzhaltern), sodass andere Prozesse Übersetzungen erhalten können, ohne den vollständigen SSH-Host zu starten.  Binden Sie `libssh_chatter_backend.so` ein und fügen Sie `include/ssh_chatter/ssh_chatter_backend.h` hinzu:```c
#include "ssh_chatter/ssh_chatter_backend.h"

int main(void) {
  char translated[4096];
  char detected[64];

  if (ssh_chatter_backend_translate_line("Hello, world!", "ko", translated, sizeof(translated), detected, sizeof(detected))) {
    printf("Detected %s -> %s\n", detected, translated);
  }
}

Wenn angegeben, liest `-m` die Tagesnachricht aus dem angegebenen Dateipfad. Häufige Beispiele:```bash
# Start the chat server on port 2022, loading host keys from /etc/ssh
./ssh-chatter -p 2022 -k /etc/ssh

# Enable telnet access on 0.0.0.0:4242 alongside SSH
./ssh-chatter -T 0.0.0.0:4242

# Serve a custom MOTD from a file and bind to localhost
./ssh-chatter -a 127.0.0.1 -m /etc/ssh-chatter/motd

Der öffentliche Server ist verfügbar unter `bbs.chatter.pw` auf dem standard SSH-Port:```bash
ssh -p 2222 [email protected]

Übergeben Sie `-T off` (oder `-T disable`), um den Telnet-Listener vollständig auszuschalten.

### JSON line API

Der Server stellt außerdem ein JSON-Line-Protokoll über TCP für Automatisierung und externe Integrationen bereit. Es hört standardmäßig auf Port `34567` und kann mit `-J` deaktiviert oder neu konfiguriert werden:```bash
# Disable the JSON API
./ssh-chatter -J off

# Bind JSON API on a custom port
./ssh-chatter -J 0.0.0.0:45678

**Beispielanfragen (client → server)**```json
{"type":"chat","id":1,"username":"alice","message":"안녕하세요"}
{"type":"image","id":2,"username":"alice","url":"https://example.com/cat.png","caption":"cat"}
{"type":"asciiart","id":3,"username":"alice","message":" /\\_/\\\\n( o.o )\\\\n > ^ <"}
{"type":"poll","id":4,"username":"op","is_operator":true,"question":"Favorite color?","options":["red","blue","green"]}
{"type":"poll","id":5,"username":"bob","action":"vote","choice":2}
{"type":"vote","id":6,"username":"op","label":"weekend","question":"Plan?","options":["hike","rest"],"allow_multiple":true}
{"type":"vote","id":7,"username":"bob","label":"weekend","action":"vote","choice":1}

Für ein ausführbares Beispiel siehe `scripts/json_api_example.py`:```bash
python3 scripts/json_api_example.py --url tcp://127.0.0.1:34567 --save /tmp/json_api_output.txt

Was das Skript tut:

1. Kompiliert das Projekt (`make`).
2. Installiert die resultierende Binärdatei unter `/usr/local/bin/ssh-chatter`.
3. Erstellt einen dedizierten Systembenutzer und eine Gruppe `ssh-chatter` (falls sie nicht bereits existieren).
4. Erstellt `/var/lib/ssh-chatter` für den Laufzeitzustand (einschließlich des SSH-Hostschlüssels) und `/etc/ssh-chatter` für Konfigurationsdateien.
5. Generiert einen standardmäßigen RSA-Hostschlüssel unter `/var/lib/ssh-chatter/ssh_host_rsa_key`, falls dieser fehlt.
6. Erstellt eine standardmäßige MOTD unter `/etc/ssh-chatter/motd` und eine Überschreibungsdatei `/etc/ssh-chatter/chatter.env` für umgebungsbasierte Anpassungen.
7. Schreibt `/etc/systemd/system/chatter.service`, lädt `systemd` neu, aktiviert den Dienst und startet ihn sofort.

Die resultierende `chatter.service`-Unit startet den Server mit sinnvollen Standardeinstellungen und gewährt die Fähigkeit `CAP_NET_BIND_SERVICE`, sodass das nicht-Root-Dienstkonto ggf. privilegierte Ports binden kann.

### Anpassen des Dienstes

Sie können die Standardwerte anpassen, indem Sie `/etc/ssh-chatter/chatter.env` bearbeiten und den Dienst neu starten:```bash
sudo systemctl edit chatter.service   # or edit the environment file directly
sudo systemctl restart chatter.service

Sie können jede kopierte Datei bearbeiten, um anzupassen, was erscheint, wenn der Tarnbildschirm aktiv ist.

Die Übersetzungsunterstützung basiert jetzt auf der Google Gemini API.  Setzen Sie Folgendes in `chatter.env` (oder der Umgebung), um sie zu aktivieren:

- `GEMINI_API_KEY` – Geheimer API-Schlüssel, der zur Authentifizierung von Übersetzungsanfragen verwendet wird.
- `GEMINI_API_BASE` – Optionaler Überschreibungswert für die API-Basis-URL (Standard: `https://generativelanguage.googleapis.com/v1beta`).
- `GEMINI_MODEL` – Optionaler Überschreibungswert für den Gemini-Modellnamen (Standard: `gemini-2.5-flash`).

Wenn die Übersetzung aktiv ist, liefert der Chat jede Nachricht sofort in ihrer Originalsprache und fügt eine eingerückte
Beschriftung hinzu, die den übersetzten Text enthält, sobald die Gemini-Antwort eintrifft.  Reaktionszusammenfassungen verwenden denselben Beschriftungsstil, sodass
Aktualisierungen direkt unter der Nachricht erscheinen, auf die sie sich beziehen.

Wenn die eingefügten Inline-Beschriftungen störend wirken, können Sie im Voraus einen kleinen Puffer von Leerzeilen mit `/chat-spacing <0-5>` reservieren.
Die Einstellung betrifft nur Live-Chat-Threads – Bulletin-Board-Inhalte werden weiterhin ohne Reservierung übersetzt –, sodass Sie den
Abstand für Ihre eigene Sitzung anpassen können, ohne langformatige Beiträge zu beeinträchtigen.

Ihre Übersetzungsumschaltung und Sprachwahl werden in `chatter_state.dat` gespeichert, sodass zukünftige Sitzungen automatisch dieselbe
Konfiguration wiederherstellen, sobald Sie sich erneut verbinden.

Wenn Sie das Programm installieren möchten, ohne den Dienst sofort zu starten, führen Sie das Skript mit `SKIP_START=1` aus.

Befehle zur Dienstverwaltung:```bash
sudo systemctl status chatter.service
sudo systemctl restart chatter.service
sudo systemctl disable --now chatter.service