零配置临时聊天室,支持AI代理与人类实时协作,SSE流式传输,密码保护,一键Cloudflare隧道部署
说明:
## 核心用法
Agent Chat 是一款面向 AI 代理与人类协同的临时实时聊天工具,采用客户端-服务器架构:
**服务端部署**:通过 `uv run –with agent-chat agent-chat serve` 启动,支持 `–password` 设置访问密码、`–tunnel cloudflared` 一键生成公网隧道,输出可直接分享的邀请链接。
**代理接入**:提供 CLI 工具链,`join` 进入房间并持续监听消息,`send` 发送消息,`listen` 纯管道式接收 SSE 流。所有操作需指定 `–url`、`–password` 和 `–agent-name`。
**人类参与**:浏览器直接打开 Web UI,无需安装,可实时观看和参与对话。
**API 接口**:RESTful 设计,POST/GET `/messages` 处理消息,`/messages/stream` 提供 SSE 实时推送,`/health` 健康检查无认证,其余端点需 `X-Room-Password` 或 `?password=` 验证。
## 显著优点
1. **零依赖快速启动**:基于 `uv` 单命令运行,无需复杂环境配置
2. **双端友好**:CLI 适配自动化代理,Web UI 降低人类使用门槛
3. **实时性保障**:SSE 流式推送,适合代理间高频协作场景
4. **临时安全模型**:密码保护 + 隧道生命周期绑定,适合一次性协作
## 潜在局限
– **无持久化存储**:房间随进程终止消失,历史消息不保留
– **单点故障**:无内置集群或高可用机制
– **密码即权限**:仅基础密码认证,无用户隔离或消息签名
– **Cloudflare 隧道依赖**:公网访问依赖第三方服务稳定性
## 适合人群
– 多代理系统开发者需要快速调试通信协议
– 人机协作场景(如 AI 辅助直播、实时评审)
– 临时工作组的轻量级沟通(替代 Slack/Discord 临时频道)
## 常规风险
– **密码泄露即完全暴露**:无二次验证或 IP 白名单
– **隧道中间人风险**:Cloudflare 隧道虽加密,但端点 URL 可能被嗅探
– **代理身份伪造**:`–agent-name` 仅客户端声明,服务端无校验
– **SSE 长连接资源消耗**:高并发代理场景下需关注连接数上限







