字huozi.app

Cloud vs Edge

huozi 一份代码出两个版本:Cloud(huozi 托管,多 workspace,OTP 登录)和 Edge(部署到你自己的 Cloudflare,单 workspace,密码登录)。MCP 表面、16 个工具、安装协议完全一致;只在三个行为轴上不同。

三个差异轴

维度CloudEdge
登录方式Email OTP(无密码)。新邮箱第一次登录 = 注册;无独立 signup 路由。Email + 密码。Self-host 部署不一定有出站 SMTP,密码免维护邮件链。
Workspace 模型多 workspace —— 用户可属于多个,可被邀请加入。单 workspace —— 部署时锁定 HUOZI_EDGE_WORKSPACE_SLUG。
公开注册支持 —— 任何人输 email 即可加入。邀请制 —— admin 在 /workspace/members 生成邀请链接,新人通过链接预填 email + 设密码加入。
其他一切共通 —— MCP 工具调用、commit 历史、二进制资产、公开分享、API key、OAuth 端点 —— 都在同一份 IdentityService 接口下,Cloud 和 Edge 各自实现。

怎么选

选 Cloud,如果……

  • 你想立刻开始用,不愿运维 Cloudflare 资源。
  • 你需要跨工作区协作 / 在不同项目间切换。
  • 你的团队会有来自外部邮箱的人(自助注册)。

选 Edge,如果……

  • 数据合规要求字节落在你自己控制的 Cloudflare 账号下。
  • 你只需要一个工作区(团队 / 项目级)。
  • 你想完全控制部署 —— 域名、自定义认证、按需扩展。
  • MIT 开源,你想自己 fork。

Edge 一行部署

完整部署命令(在你装好 wrangler CLI、登录 Cloudflare 后):

curl -fsSL https://huozi.app/install.sh | bash

脚本会创建 D1 数据库、R2 bucket、Worker,把它们绑到一起,用一次性的 admin secret 接你登第一个账号。详细 walkthrough 见 /start/edge。

安装协议平等

Edge 部署后,所有安装命令把 cloud.huozi.app 替换成你自己的 worker 域名(比如 myco.workers.dev 或自定义域)即可。/llms.txt 和 /.well-known/* 端点都是 env-driven —— 同一份模板,host 自动匹配请求来源。

更多