Résolvez les conflits sur place (les routines d'aide `src/host_aggregate.c` reflètent déjà la disposition utilisée sur `main`, donc les fusions sont généralement simples) et exécutez `make` pour confirmer que la construction réussit toujours avant de pousser le résultat.

## Hooks d'automatisation

- `host_snapshot_last_captcha` expose l'invite et la réponse du captcha généré le plus récemment ainsi qu'un horodatage afin que des clients externes puissent passer les défis pour le compte d'une automatisation non supervisée.

## Durcissement de la sécurité

- `scripts/safe_permission.sh` renforce la propriété et le mode des fichiers de données d'exécution (état du BBS, état des votes, instantanés de cooldown et état général des discussions). Exécutez-le après le déploiement pour confiner le répertoire de données à `ssh-chatter` et garantir que chaque fichier est défini sur `0600`. Remplacez les cibles en passant des chemins explicites ou en exportant les variables d'environnement `STATE_ROOT` ou les `CHATTER_*_FILE` correspondantes avant l'exécution.
- Un chien de garde BBS en arrière-plan alimente périodiquement les publications et commentaires via le pipeline de modération IA (Gemini principal avec repli sur Ollama). Les publications signalées sont supprimées automatiquement et un avis est diffusé dans la salle.
- Les messages de chat, l'art ASCII et les publications/commentaires BBS passent par un pipeline de modération IA. Activez-le avec `CHATTER_SECURITY_AI=on` (définissez `GEMINI_API_KEY` pour Gemini ; le daemon bascule automatiquement sur le point de terminaison local Ollama à `http://127.0.0.1:11434`). Désactivez tout avec `CHATTER_SECURITY_FILTER=off`. Si tous les fournisseurs échouent, le filtre se désactive automatiquement pour maintenir le flux des conversations au lieu de supprimer silencieusement le contenu.
- Le transport SSH est verrouillé sur des échanges de clés, des chiffrements et des MAC modernes, et chaque charge utile de pont est enveloppée dans un oignon triple AES-256-GCM, de sorte que les relais ne voient que du texte chiffré.
- Les soumissions suspectes qui déclenchent le filtre en couches sont désormais suivies par IP ; des coups répétés déclenchent un kick et un bannissement automatiques lorsqu'ils sont activés, tandis que le détecteur de reconnexion rapide permet des fenêtres de récupération plus longues afin que les sessions réseau instables puissent se reconnecter sans être pénalisées. Les entrées de bannissement automatique sont **désactivées par défaut** ; définissez `CHATTER_AUTO_BAN=on` (ou `true`/`1`) pour les activer, ou laissez la variable non définie pour conserver les avertissements et la limitation sans écrire d'entrées de bannissement automatique.
- Les opérateurs peuvent marquer les points d'entrée de confiance (sorties VPN, proxies inverses, localhost) avec `CHATTER_PROTECTED_IPS` (séparés par des virgules, par défaut `127.0.0.1,::1,192.168.0.1`) afin que les bannissements d'urgence ne verrouillent jamais le daemon en dehors de son propre plan de contrôle.

## Stockage de fichiers et transferts

- Tous les fichiers gérés par l'utilisateur résident désormais sous `/etc/ssh-chatter/user-files` (remplacez avec `CHATTER_FILESTORE_PATH`, repli hérité : `CHATTER_FILE_STORAGE_ROOT`). Le daemon crée le répertoire si nécessaire et maintient les téléchargements confinés à celui-ci.
- Les clients SSH utilisent `scp` standard sans wrapper personnalisé. Traitez `/name.ext` comme la racine de l'arborescence de stockage : `scp my.zip user@host:/demos/my.zip` écrit dans `/etc/ssh-chatter/user-files/demos/my.zip` tandis que `scp user@host:/readme.txt ./` télécharge `/etc/ssh-chatter/user-files/readme.txt`.
- Les clients TELNET utilisent les nouvelles commandes `/filestore`. `/filestore` liste les fichiers disponibles, `/filestore-upload` démarre une session `rz`, et `/filestore-download <name>` démarre une session `sz`. Installez `lrzsz` (ou tout package fournissant `rz`/`sz`) sur le serveur afin que le backend ZMODEM puisse lancer ces aides.
- `/filestore-upload` accepte une destination optionnelle (par exemple `/filestore-upload /kitten/meow.png`). SSH-Chatter crée automatiquement le répertoire `/kitten` et y place le fichier téléchargé, reflétant la façon dont SCP utilise des chemins comme `user@host:/kitten/meow.png`.
- Les deux transports peuvent être mélangés : SSH pour les transferts scriptés non supervisés, TELNET pour les clients BBS nostalgiques avec outils ZMODEM intégrés.

## Relais Morse
SSH-Chatter prend en charge le relais radioamateur.
Cela montre les signaux morse globaux.
`/morse on` pour voir, `/morse-reply` pour envoyer.

### Détails du protocole

L'implémentation suit la spécification du protocole Binkp :
- Structure de trame Binkp standard avec en-têtes de 2 octets
- Authentification par mot de passe de session (CMD\_PWD/CMD\_OK)
- Mécanisme de maintien en vie (CMD\_NUL) toutes les 60 secondes
- Commande CHAT personnalisée (CMD\_CHAT, extension) pour la synchronisation des messages

## Prérequis

La construction du projet nécessite un environnement POSIX avec :

- Un compilateur compatible C23 (par exemple `gcc` ou `clang`)
- `make`
- En-têtes de développement et bibliothèque `libssh` (`libssh-dev` sur Debian/Ubuntu)
- En-têtes de développement et bibliothèque `libcurl` (`libcurl4-openssl-dev` sur Debian/Ubuntu)
- En-têtes de développement et bibliothèque `uchardet` (`libuchardet-dev` sur Debian/Ubuntu)
- En-têtes de développement et bibliothèque `icu` (International Components for Unicode) (`libicu-dev` sur Debian/Ubuntu)
- Bibliothèque de compression `lz4` et en-têtes de développement (`liblz4-dev` sur Debian/Ubuntu)
- Threads POSIX (généralement fournis par le système `libpthread`)
- `python3-pygments` (fournit le surligneur `pygmentize` pour l'écran de camouflage Tetris)

Sur Debian/Ubuntu, les dépendances peuvent être installées avec :```bash
sudo apt-get update
sudo apt-get install build-essential libssh-dev libcurl4-openssl-dev libuchardet-dev libicu-dev liblz4-dev

Cela produit un binaire `ssh-chatter` à la racine du dépôt et un objet partagé `libssh_chatter_backend.so` qui expose les aides à la traduction pour être réutilisées dans d'autres applications.  Nettoyez les artefacts intermédiaires avec `make clean`.

### Utilisation du backend de traduction partagé

L'objet partagé réutilise le pipeline de traduction C du serveur (y compris la préservation des espaces réservés ANSI) afin que d'autres processus puissent obtenir des traductions sans lancer l'hôte SSH complet.  Liez avec `libssh_chatter_backend.so` et incluez `include/ssh_chatter/ssh_chatter_backend.h` :```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);
  }
}

Lorsqu'il est fourni, `-m` lit le message du jour à partir du chemin de fichier spécifié. Exemples courants :```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

Le serveur public est disponible à l'adresse `bbs.chatter.pw` sur le port SSH par défaut :```bash
ssh -p 2222 [email protected]

Passer `-T off` (ou `-T disable`) pour désactiver complètement l'écouteur telnet.

### API ligne JSON

Le serveur expose également un protocole ligne JSON via TCP pour l'automatisation et les intégrations externes. Il écoute sur le port `34567` par défaut et peut être désactivé ou reconfiguré avec `-J` :```bash
# Disable the JSON API
./ssh-chatter -J off

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

**Exemples de requêtes (client → serveur)**```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}

Pour un exemple exécutable, voir `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

Ce que fait le script :

1. Compile le projet (`make`).
2. Installe le binaire résultant dans `/usr/local/bin/ssh-chatter`.
3. Crée un utilisateur et un groupe système dédié `ssh-chatter` (s'ils n'existent pas déjà).
4. Crée `/var/lib/ssh-chatter` pour l'état d'exécution (incluant la clé d'hôte SSH) et `/etc/ssh-chatter` pour les fichiers de configuration.
5. Génère une clé d'hôte RSA par défaut dans `/var/lib/ssh-chatter/ssh_host_rsa_key` si elle est absente.
6. Crée un MOTD par défaut dans `/etc/ssh-chatter/motd` et un fichier de remplacement `/etc/ssh-chatter/chatter.env` pour le réglage basé sur l'environnement.
7. Écrit `/etc/systemd/system/chatter.service`, recharge `systemd`, active le service, et le démarre immédiatement.

L'unité `chatter.service` résultante démarre le serveur avec des valeurs par défaut raisonnables et accorde la capacité `CAP_NET_BIND_SERVICE` afin que le compte de service non root puisse se lier aux ports privilégiés si nécessaire.

### Personnalisation du service

Vous pouvez ajuster les valeurs par défaut en modifiant `/etc/ssh-chatter/chatter.env` et en redémarrant le service :```bash
sudo systemctl edit chatter.service   # or edit the environment file directly
sudo systemctl restart chatter.service

Vous pouvez modifier tout fichier copié pour personnaliser ce qui apparaît lorsque l'écran de camouflage est actif.

La prise en charge de la traduction repose désormais sur l'API Google Gemini.  Définissez les éléments suivants dans `chatter.env` (ou dans l'environnement) pour l'activer :

- `GEMINI_API_KEY` – Clé API secrète utilisée pour authentifier les requêtes de traduction.
- `GEMINI_API_BASE` – Remplacement facultatif pour l'URL de base de l'API (par défaut `https://generativelanguage.googleapis.com/v1beta`).
- `GEMINI_MODEL` – Remplacement facultatif pour le nom du modèle Gemini (par défaut `gemini-2.5-flash`).

Lorsque la traduction est active, le chat délivre chaque message immédiatement dans sa langue d'origine et le complète avec une légende indentée contenant le texte traduit une fois la réponse Gemini arrivée.  Les résumés de réactions utilisent le même style de légende afin que les mises à jour apparaissent directement sous le message auquel elles se réfèrent.

Si les insertions de légendes en ligne semblent gênantes, vous pouvez réserver un petit tampon de lignes vierges à l'avance avec `/chat-spacing <0-5>`.  Ce paramètre n'affecte que les fils de discussion en direct — le contenu du tableau d'affichage continue d'être traduit sans réservation — vous pouvez donc ajuster l'espacement pour votre propre session sans impacter les messages longs.

Votre bascule de traduction et vos choix de langue sont sauvegardés dans `chatter_state.dat`, de sorte que les sessions futures restaurent automatiquement la même configuration une fois que vous vous reconnectez.

Si vous préférez installer sans démarrer immédiatement le service, exécutez le script avec `SKIP_START=1`.

Commandes de gestion du service :```bash
sudo systemctl status chatter.service
sudo systemctl restart chatter.service
sudo systemctl disable --now chatter.service