源 huozi Edge
同样的 Agent 云盘，跑在你自己的基础设施上。
无邮箱登录。一个部署者、一个工作空间、一个属于你的域名。
Edge 跑在 Cloudflare Workers + Durable Objects + D1 + R2 上 —— 这些资源由部署脚本一次性自动开通。
同一套云盘，由你来跑
Edge 提供与 Cloud 完全一致的 MCP 接口、Claude Code 兼容性、实时同步、提交历史和公开分享 URL —— 只是没有托管账号系统。你拿着 HUOZI_ADMIN_SECRET，把它部署到自己的 Cloudflare 账号；把 API key 粘贴给谁，谁就能接 Agent。
因为两个版本是同一份代码、靠 HUOZI_EDITION 切换 —— 每个 bug 修复和新功能都同时落到两边。
Cloud vs Edge
| Cloud | Edge | |
|---|---|---|
| 谁运营 | huozi.app | 你自己 |
| 鉴权 | 邮箱 OTP | 管理员密钥 + 粘贴 key |
| 每实例用户数 | 多人 | 单部署者 |
| 每用户 workspace 数 | 一个（可扩展） | 一个固定 workspace |
| 成本 | 付给 huozi.app | 付给 Cloudflare（多数情况 $0） |
| 授权 | 专有服务 | MIT |
底层栈
你部署的就是这一套。每个组件都跑在你自己的 Cloudflare 账号下，付的是你自己的额度。
- Cloudflare Workers 作为 serverless MCP 端点（HTTP 上的 JSON-RPC 2.0）。
- R2 存储 blob，按 Git 兼容的 SHA-1 寻址（与真 Git 的 blob <size>\0<content> 同算法）。
- D1 存放 files_current 索引、commit 链、按路径的审计行、API keys。
- Durable Objects 串行化写侧关键区（每个 workspace 一个 DO），并跨请求保留每会话的 ReadFileState（每个 {workspace, principal} 一个 DO）。
- Bearer 鉴权：token hash 到 api_keys 一行；那一行把这次调用绑定到 workspace、principal、可选的 scope 前缀。
你需要准备什么
全部加起来 5 分钟。完全不需要邮箱服务、SMTP、Resend、外置数据库或 Docker —— Edge 是粘贴 key、不发邮件的设计。
需要
- · 一个 Cloudflare 账号（免费档够用） 去 dash.cloudflare.com 注册 →
- · 本机：Node.js 22+、git、jq（macOS：brew install jq）
不需要
- · 邮箱登录服务（Resend / SendGrid / SES）—— Edge 不发邮件
- · 外置数据库 —— D1 + R2 + Durable Objects 全部由部署脚本自动开通
- · Docker —— 全部跑在 Cloudflare 边缘，不用本地容器
一行命令部署
完整安装路径在 /start/edge —— 一条 curl 命令，约 5 分钟。下面的架构细节解释会建出哪些资源以及为什么。
环境变量一览
脚本跑完会写一份 .huozi-edge.env，下面是里面的字段。日常使用基本不用动；进阶用户可以覆盖。
| 变量 | 谁来填 | 用途 |
|---|---|---|
HUOZI_EDITION | 脚本自动 | 切换 Cloud / Edge 行为分支 |
HUOZI_CLOUD_URL | 脚本自动 | Next.js 调 Worker 用 |
HUOZI_ADMIN_SECRET | 脚本自动 | 签发 / 撤销 api_key 的管理员凭据 |
HUOZI_AUTH_SECRET | 脚本自动 | 签 cookie 用的随机 secret |
HUOZI_EDGE_WORKSPACE_SLUG | 你（可选） | 唯一固定 workspace 的 slug（默认 default） |
HUOZI_EDGE_WORKSPACE_NAME | 你（可选） | workspace 显示名（默认 huozi-edge） |
一键升级
huozi 主线发了新版本？拉一下代码，再跑一次同一个脚本即可。Worker 会被重新部署、Schema 会被重新应用，D1 / R2 / DO 数据完整保留。
git pull
bash scripts/edge-deploy.sh让 AI Agent 替你部署
把下面这段粘贴给你的 Cursor 或 Claude Code，它会按脚本一步步替你跑完。除了 wrangler login 那一步要你点一下浏览器之外，全程不需要你的输入。
提示词（任意 Coding Agent 通用）
帮我把 huozi Edge 部署到我自己的 Cloudflare 账号上：
1. git clone https://github.com/Dachein/huozi 到本地，然后 cd 进去
2. 跑 npx wrangler login，等我授权完成
3. 跑 bash scripts/edge-deploy.sh —— 全程不要打断我；脚本会自动开通 D1 / R2 / Durable Objects、部署 Worker、签发第一把 admin api_key
4. 把生成的 hz_… admin api_key 单独打印一遍，告诉我去 /workspace/connect 粘贴
整个过程除了第 2 步的 wrangler login 不需要我的任何输入，请放手做。