충돌을 제자리에서 해결하고 (`src/host_aggregate.c` 헬퍼 루틴은 이미 `main`의 레이아웃을 반영하므로 일반적으로 병합은 간단합니다) `make`를 실행하여 푸시하기 전에 빌드가 여전히 성공하는지 확인하세요.

## 자동화 훅

- `host_snapshot_last_captcha`는 가장 최근에 생성된 캡챠 프롬프트와 답변을 타임스탬프와 함께 노출하여 외부 클라이언트가 무인 자동화를 대신하여 챌린지를 전달할 수 있도록 합니다.

## 보안 강화

- `scripts/safe_permission.sh`는 런타임 데이터 파일(BBS 상태, 투표 상태, 쿨다운 스냅샷, 일반 채터 상태)의 소유권과 모드를 강화합니다. 배포 후 실행하여 데이터 디렉토리를 `ssh-chatter`로 제한하고 각 파일이 `0600`으로 설정되도록 합니다. 명시적 경로를 전달하거나 실행 전에 `STATE_ROOT` 또는 해당 `CHATTER_*_FILE` 환경 변수를 내보내 대상을 재정의합니다.
- 백그라운드 BBS 와치독은 주기적으로 게시물과 댓글을 AI 중재 파이프라인(기본 Gemini, Ollama 대체)에 전달합니다. 플래그된 게시물은 자동으로 제거되고 방에 공지가 전송됩니다.
- 채팅 메시지, ASCII 아트, BBS 게시물/댓글은 AI 중재 파이프라인을 통해 흐릅니다. `CHATTER_SECURITY_AI=on`으로 활성화합니다 (Gemini의 경우 `GEMINI_API_KEY` 설정; 데몬은 자동으로 `http://127.0.0.1:11434`의 로컬 Ollama 엔드포인트로 대체합니다). `CHATTER_SECURITY_FILTER=off`로 모든 것을 비활성화합니다. 모든 공급자가 실패하면 필터는 자동으로 비활성화되어 콘텐츠를 자동으로 삭제하는 대신 대화가 계속 흐르도록 합니다.
- SSH 전송은 최신 키 교환, 암호화, MAC으로 고정되며 모든 브리지 페이로드는 삼중 AES-256-GCM 양파로 감싸져 중계기는 암호문만 볼 수 있습니다.
- 계층형 필터를 작동시키는 의심스러운 제출은 이제 IP별로 추적됩니다. 반복된 적중 시 활성화되면 자동 킥 및 밴이 트리거되는 반면, 빠른 재연결 감지기는 더 긴 복구 기간을 허용하여 불안정한 네트워크 세션이 불이익 없이 다시 참여할 수 있습니다. 자동 밴 항목은 **기본적으로 꺼져 있습니다**. 활성화하려면 `CHATTER_AUTO_BAN=on` (또는 `true`/`1`)을 설정하거나 변수를 설정하지 않은 상태로 두어 자동 밴 항목을 기록하지 않고 경고 및 제한을 유지합니다.
- 운영자는 `CHATTER_PROTECTED_IPS`로 신뢰할 수 있는 진입점(VPN 출구, 리버스 프록시, localhost)을 표시할 수 있습니다 (쉼표로 구분, 기본값 `127.0.0.1,::1,192.168.0.1`). 이로 인해 긴급 밴이 데몬을 자체 제어 평면에서 잠그지 않습니다.

## 파일 저장 및 전송

- 모든 사용자 관리 파일은 이제 `/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, 내장 ZMODEM 도구가 있는 복고풍 BBS 클라이언트에는 TELNET.

## 모스 릴레이
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` (Tetris 위장 화면을 위한 `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

This produces an `ssh-chatter` binary in the repository root and a `libssh_chatter_backend.so` shared object that exposes the
translation helpers for reuse in other applications.  Clean intermediate artifacts with `make clean`.

### 공유 번역 백엔드 사용하기

The shared object reuses the server's C translation pipeline (including ANSI placeholder preservation) so other processes can
obtain translations without spawning the full SSH host.  Link against `libssh_chatter_backend.so` and include
`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]

`-T off` (또는 `-T disable`)를 전달하여 telnet 리스너를 완전히 끌 수 있습니다.

### JSON line API

서버는 또한 자동화 및 외부 통합을 위해 TCP를 통해 JSON line protocol을 노출합니다. 기본적으로 포트 `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

**요청 예시 (클라이언트 → 서버)**```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. `/var/lib/ssh-chatter/ssh_host_rsa_key`가 없을 때 기본 RSA 호스트 키를 생성합니다.
6. `/etc/ssh-chatter/motd`에 기본 MOTD를 생성하고 환경 기반 조정을 위한 오버라이드 파일 `/etc/ssh-chatter/chatter.env`를 생성합니다.
7. `/etc/systemd/system/chatter.service`를 작성하고, `systemd`를 다시 로드하며, 서비스를 활성화하고 즉시 시작합니다.

결과 `chatter.service` 유닛은 적절한 기본값으로 서버를 시작하며, `CAP_NET_BIND_SERVICE` 권한을 부여하여 루트가 아닌 서비스 계정이 필요한 경우 권한 있는 포트에 바인딩할 수 있도록 합니다.

### 서비스 사용자 정의

`/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