競合はその場で解決してください（`src/host_aggregate.c` ヘルパールーチンは既に `main` で使用されているレイアウトを反映しているため、マージは通常簡単です）。結果をプッシュする前に `make` を実行してビルドが成功することを確認してください。

## 自動化フック

- `host_snapshot_last_captcha` は、最新に生成されたキャプチャプロンプトと回答をタイムスタンプとともに公開し、外部クライアントが無人自動化に代わってチャレンジを通過できるようにします。

## セキュリティ強化

- `scripts/safe_permission.sh` は、ランタイムデータファイル（BBS状態、投票状態、クールダウンスナップショット、一般チャッター状態）の所有者とモードを厳格化します。デプロイ後に実行して、データディレクトリを `ssh-chatter` に限定し、各ファイルが `0600` に設定されていることを確認します。明示的なパスを渡すか、実行前に `STATE_ROOT` または対応する `CHATTER_*_FILE` 環境変数をエクスポートしてターゲットを上書きします。
- バックグラウンドのBBS watchdogは、定期的に投稿とコメントをAIモデレーションパイプライン（プライマリはGemini、フォールバックはOllama）に送信します。フラグが立てられた投稿は自動的に削除され、ルームに通知がブロードキャストされます。
- チャットメッセージ、ASCIIアート、BBSの投稿/コメントはAIモデレーションパイプラインを通過します。`CHATTER_SECURITY_AI=on` で有効にします（Geminiの場合は `GEMINI_API_KEY` を設定。デーモンは自動的にローカルのOllamaエンドポイント `http://127.0.0.1:11434` にフォールバックします）。`CHATTER_SECURITY_FILTER=off` ですべて無効にします。すべてのプロバイダが失敗した場合、フィルタは自動的に無効になり、コンテンツを静かにドロップする代わりに会話を継続させます。
- SSHトランスポートは最新の鍵交換、暗号、MACに固定されており、すべてのブリッジペイロードは三重のAES-256-GCMオニオンでラップされるため、リレーは暗号文のみを認識します。
- レイヤーフィルタに引っかかった不審な投稿はIPごとに追跡され、有効にすると繰り返しのヒットが自動キックと禁止をトリガーします。一方、高速再接続検出器はより長い回復ウィンドウを許可するため、不安定なネットワークセッションがペナルティを受けることなく再接続できます。自動禁止エントリはデフォルトで**オフ**です。`CHATTER_AUTO_BAN=on`（または `true`/`1`）を設定して有効にするか、変数を未設定のままにして、自動禁止エントリを書き込まずに警告とスロットリングを維持します。
- オペレーターは `CHATTER_PROTECTED_IPS`（カンマ区切り、デフォルトは `127.0.0.1,::1,192.168.0.1`）を使用して信頼できる入口ポイント（VPN出口、リバースプロキシ、localhost）をマークできるため、緊急禁止によってデーモンが自身のコントロールプレーンからロックアウトされることはありません。

## ファイルストレージと転送

- すべてのユーザー管理ファイルは `/etc/ssh-chatter/user-files` に配置されます（`CHATTER_FILESTORE_PATH` で上書き、レガシーフォールバック: `CHATTER_FILE_STORAGE_ROOT`）。デーモンは必要に応じてディレクトリを作成し、アップロードをそのディレクトリ内に限定します。
- SSHクライアントはカスタムラッパーなしで標準の `scp` を使用します。`/name.ext` をストレージツリーのルートとして扱います。`scp my.zip user@host:/demos/my.zip` は `/etc/ssh-chatter/user-files/demos/my.zip` に書き込み、`scp user@host:/readme.txt ./` は `/etc/ssh-chatter/user-files/readme.txt` をダウンロードします。
- TELNETクライアントは新しい `/filestore` コマンドを使用します。`/filestore` は利用可能なファイルを一覧表示し、`/filestore-upload` は `rz` セッションを開始し、`/filestore-download <name>` は `sz` セッションを開始します。サーバーに `lrzsz`（または `rz`/`sz` を提供する任意のパッケージ）をインストールして、ZMODEMバックエンドがこれらのヘルパーを起動できるようにします。
- `/filestore-upload` はオプションの保存先を受け付けます（例: `/filestore-upload /kitten/meow.png`）。SSH-Chatterは `/kitten` ディレクトリを自動的に作成し、アップロードされたファイルをそこに配置します。これはSCPが `user@host:/kitten/meow.png` のようなパスを使用する方法を反映しています。
- 両方のトランスポートは混在して使用できます。SSHは無人スクリプト転送に、TELNETは組み込みZMODEMツールを備えた懐かしいBBSクライアントに適しています。

## モールスリレー
SSH-Chatterはアマチュア無線リレーをサポートしています。これはグローバルモールス信号を表示します。表示するには `/morse on`、送信するには `/morse-reply` を使用します。

### プロトコル詳細

実装はBinkpプロトコル仕様に従います：
- 2バイトヘッダーを持つ標準のBinkpフレーム構造
- セッションパスワード認証 (CMD\_PWD/CMD\_OK)
- 60秒ごとのキープアライブメカニズム (CMD\_NUL)
- メッセージ同期のためのカスタムCHATコマンド (CMD\_CHAT, 拡張)

## 前提条件

プロジェクトのビルドにはPOSIX環境が必要です：

- C23互換コンパイラ（例: `gcc` または `clang`）
- `make`
- `libssh` 開発用ヘッダーとライブラリ（Debian/Ubuntuでは `libssh-dev`）
- `libcurl` 開発用ヘッダーとライブラリ（Debian/Ubuntuでは `libcurl4-openssl-dev`）
- `uchardet` 開発用ヘッダーとライブラリ（Debian/Ubuntuでは `libuchardet-dev`）
- `icu`（International Components for Unicode）開発用ヘッダーとライブラリ（Debian/Ubuntuでは `libicu-dev`）
- `lz4` 圧縮ライブラリと開発用ヘッダー（Debian/Ubuntuでは `liblz4-dev`）
- POSIXスレッド（通常はシステムの `libpthread` によって提供）
- `python3-pygments`（テトリスカモフラージュ画面用の `pygmentize` ハイライターを提供）

Debian/Ubuntuでは、依存関係は以下のようにインストールできます：

``````bash
sudo apt-get update
sudo apt-get install build-essential libssh-dev libcurl4-openssl-dev libuchardet-dev libicu-dev liblz4-dev

これにより、リポジトリルートに `ssh-chatter` バイナリと、他のアプリケーションで再利用するための翻訳ヘルパーを公開する共有オブジェクト `libssh_chatter_backend.so` が生成されます。中間生成物は `make clean` でクリーンアップします。

### 共有翻訳バックエンドの使用

この共有オブジェクトは、サーバーのC言語翻訳パイプライン（ANSIプレースホルダーの保存を含む）を再利用するため、他のプロセスは完全なSSHホストを起動せずに翻訳を取得できます。`libssh_chatter_backend.so` にリンクし、`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);
  }
}

指定された場合、`-m`は指定されたファイルパスから今日のメッセージを読み取ります。

一般的な例:```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

公開サーバーは `bbs.chatter.pw` のデフォルトSSHポートで利用可能です:```bash
ssh -p 2222 [email protected]

Pass `-T off`（または `-T disable`）を渡すと、telnetリスナーを完全にオフにできます。

### JSONラインAPI

サーバーはまた、自動化や外部統合のためにTCP経由でJSONラインプロトコルを公開しています。デフォルトではポート`34567`でリッスンし、`-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

**リクエスト例 (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}

実行可能な例については、 `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

スクリプトの機能:

1. プロジェクトをコンパイルします（`make`）。
2. 生成されたバイナリを `/usr/local/bin/ssh-chatter` にインストールします。
3. 専用の `ssh-chatter` システムユーザーとグループを作成します（まだ存在しない場合）。
4. 実行時状態（SSHホストキーを含む）用の `/var/lib/ssh-chatter` と、設定ファイル用の `/etc/ssh-chatter` を作成します。
5. デフォルトのRSAホストキーが存在しない場合、`/var/lib/ssh-chatter/ssh_host_rsa_key` に生成します。
6. `/etc/ssh-chatter/motd` にデフォルトのMOTDを作成し、環境変数によるチューニング用のオーバーライドファイル `/etc/ssh-chatter/chatter.env` を作成します。
7. `/etc/systemd/system/chatter.service` を書き込み、`systemd` をリロードし、サービスを有効にして即座に起動します。

結果として生成される `chatter.service` ユニットは、適切なデフォルト設定でサーバーを起動し、`CAP_NET_BIND_SERVICE` ケーパビリティを付与するため、非rootのサービスアカウントでも必要に応じて特権ポートにバインドできます。

### サービスのカスタマイズ

`/etc/ssh-chatter/chatter.env` を編集してデフォルトを調整し、サービスを再起動してください:```bash
sudo systemctl edit chatter.service   # or edit the environment file directly
sudo systemctl restart chatter.service

カモフラージュ画面がアクティブなときに表示される内容をカスタマイズするには、コピーした任意のファイルを編集できます。

翻訳機能は現在、Google Gemini API を利用しています。これを有効にするには、`chatter.env`（または環境変数）に以下を設定します。

- `GEMINI_API_KEY` – 翻訳リクエストの認証に使用するシークレット API キー。
- `GEMINI_API_BASE` – API ベース URL のオプション上書き（デフォルトは `https://generativelanguage.googleapis.com/v1beta`）。
- `GEMINI_MODEL` – Gemini モデル名のオプション上書き（デフォルトは `gemini-2.5-flash`）。

翻訳が有効な場合、チャットは各メッセージを元の言語で即座に配信し、Gemini の応答が到着すると、インデントされたキャプションに翻訳テキストを含めてフォローアップします。リアクションのサマリーも同じキャプションスタイルを使用するため、更新は参照元のメッセージの真下に表示されます。

インラインキャプションの挿入が気になる場合は、`/chat-spacing <0-5>` であらかじめ小さな空白行バッファを確保できます。この設定はライブチャットスレッドにのみ影響し、掲示板のコンテンツは予約なしで翻訳され続けるため、長文の投稿に影響を与えることなく、自分のセッションのスペーシングを調整できます。

翻訳の切り替えと言語の選択は `chatter_state.dat` に保存されるため、再接続すると将来のセッションで自動的に同じ設定が復元されます。

サービスをすぐに開始せずにインストールする場合は、`SKIP_START=1` を指定してスクリプトを実行してください。

サービス管理コマンド:```bash
sudo systemctl status chatter.service
sudo systemctl restart chatter.service
sudo systemctl disable --now chatter.service