成熟度:Preview
目标
在进入 Server 环境前,用最小链路验证应用能创建 Thread、发起 Run、消费完整事件流,并在失败时保留足够的诊断信息。
当前可用
- Desktop 会在本机启动 Gateway,并使用 SQLite、本机配置和 OS 沙箱。
@fellow.work/client可在 Node、浏览器和 React 中调用 Thread / Run,并消费 SSE。- Run 事件会持久化;单实例下可从已有序号回放,再接入实时流。
- 沙箱内的工具只应使用
/mnt/...虚拟路径。默认执行策略是workspace-write。
建议先记录 Thread ID、Run ID、最后收到的事件序号和 Gateway 返回的错误,再缩小问题范围。认证失败先检查凭证类型:浏览器只能持有短期 access token,不能持有 fkey_。
调试边界
- 本地模式不等于生产拓扑。默认 Cloud Docker 路径仍是单节点、SQLite、内存 Stream Bridge 和本地 sandbox mode。
- 仓库中的 PostgreSQL、Redis 与 Docker sandbox 配置结构不代表默认多副本拓扑已经可用。
- 当前没有对外承诺统一的事件检查器或本地模拟 Gateway;不要把内部日志格式当作公共 API。
- 模型不能请求关闭沙箱。需要 OS 原语的操作只能走已登记的窄 Host capability;任意 host shell 会被拒绝。
未来能力
Planned: 统一事件检查器、可分发的本地模拟 Gateway、协议版本诊断和跨组件关联视图。它们落地前不作为开发或发布前置条件。