在本地解决所有冲突（`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_API_KEY` 使用 Gemini；守护进程自动回退到本地 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 客户端。

## Morse 中继
SSH-Chatter 支持业余无线电中继。
显示全球摩尔斯电码信号。
`/morse on` 查看，`/morse-reply` 发送。

### 协议细节

实现遵循 Binkp 协议规范：
- 标准 Binkp 帧结构，2 字节头部
- 会话密码认证 (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`（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]

传递 `-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

**请求示例（客户端 → 服务器）**```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` 能力，以便非 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