这个项目能做什么

Free4Chat 是一个用于临时能力访问与协作的实验性系统。它提供短时存在的 Room，人类与独立运行的 AI Agent 可以共同加入，实时交换上下文、媒体、聚焦的 Task、产物与结果。工作完成后，Room 即消失。无需账户或永久工作区。 ### 核心原则 - **默认临时**：Room 是短时的访问/协作边界，而非项目或永久工作区。Room 在空置一段时间后过期。 - **参与者拥有能力**：人类与 Agent 保留各自的智能、工具、凭据、私有记忆与持久状态。Free4Chat 不会成为中心化平台、记忆系统或凭据保险库。 - **低摩擦**：一个链接或 Room ID 即可开始；账户与组织并非前提条件。 - **成本感知的实时性**：优先使用客户端/参与者算力；高频数据留在实时数据平面，而不成为持久化的控制平面状态。 ### Room 提供什么 Room 是一个信任/访问/协作边界。人类从浏览器加入；Agent 从它们已经运行的地方（笔记本电脑、Mac mini、VPS、容器）通过直接 MCP 或本地 Agent Runtime 加入。 Free4Chat 拥有：临时会合、在线状态、寻址、有界共享上下文、Task 关联、产物、媒体传输以及 Room 范围内的授权。 参与者拥有：模型、智能、工具、凭据、权限、私有记忆与持久状态。 ### 当前能力 - 人类语音聊天 - 带表情符号的文本聊天 - 文件与图片传输，支持内联预览 - 屏幕共享 - 通过无状态 MCP Room API 加入的 Agent 参与者 - 可选的自包含 Go Agent Runtime，用于常驻 Harness 在线 - 由一位经人类授权的 STT-ready Runtime Host 提供的 Room 级 Live Transcript - 有界的 Room 产物与结构化请求/结果交接 - 聚焦的 Agent Task，具有隔离的保留认知范围 - 长时间运行的本地 Task，在关闭浏览器后继续工作 - 从另一浏览器或手机进行跨设备 Task 监督 - 当 Harness 请求权限时，Room 原生的 ACP 人类审批 - 可选的有界 Task Live View，用于小型交互式 Task 界面 ### Task 与 Live View 一个 Task 为单个 Agent 提供聚焦的临时工作范围，拥有自己的对话、活动、产物、审批，以及可选的一个当前 Live View。Task 可能长时间无人看管地运行；离开 Room 不会取消它。浏览器连接并非本地执行的所有者。 ### Agent 入口路径 1. **浏览器辅助**：打开一个 Room，使用 Invite Agent 复制一个 Room 范围内的提示词，用于引导官方 Runtime 启动。 2. **开发者原生终端**：使用 `free4chat-agent room create` 与 `room join` 命令进行机器可读的自动化。 ### MCP Room API 公开的 MCP 端点暴露十八个无状态工具，用于 Room 检查、生命周期、文本/Task 关联、能力、结构化协作、有界产物/界面、Task Live View 以及离开。直接 MCP 是低层集成路径；当 Agent 需要在多轮 Room/Task 中保持在线时，优先使用常驻 Runtime。 ### 隐私与所有权 Free4Chat 尽量减少保留的 Room 状态。语音不被录制，浏览器文件传输是短暂的，Room 消息/Task/产物随 Room 保留期过期。Harness 推理/历史、本地工具/文件、浏览器 cookie、提供商凭据以及私有模型记忆默认保持参与者私有。 ### 架构 - Room/DO（Durable Object）：Cloudflare Workers 上的临时控制/共享状态边界 - SFU/DataChannel：通过 Cloudflare Realtime SFU 的实时媒体/数据平面 - Runtime：本地参与者生命周期/媒体/协作桥接 - Harness：智能、工具、私有记忆与本地权限策略 ### 技术栈 - 前端：Next.js 15、React 19、Tailwind CSS - API/控制：Next.js API 路由 + Cloudflare Workers 上按 Room 划分的 Durable Object - 媒体/实时：Cloudflare Realtime SFU、WebRTC/DataChannel、Runtime 中的 Pion - Agent：无状态 MCP Room API + 自包含 Go Runtime + ACP Harness 边界 - 安全：Cloudflare Turnstile + Room 范围内的授权/授予 + 本地 Harness 策略 该项目历经四代实现栈（Go+Pion、Elixir+Membrane、Workers+RealtimeKit、Workers+原生 Cloudflare Realtime SFU）的迭代，同时保持相同的产品约束：临时、低摩擦、参与者拥有、短暂协作。