Developer Docs

文档首页

开发文档 · 测试与发布

本地开发与调试

在本机验证 Fellow 应用的 Thread、Run、SSE 与沙箱边界。

成熟度: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、协议版本诊断和跨组件关联视图。它们落地前不作为开发或发布前置条件。

相关文档