or
- -### Deploy with an AI Agent (Optional / Experimental) - -If you use an AI coding assistant (such as Claude Code, Codex, OpenClaw, Antigravity, Cursor, or Trae) in your daily workflow, you can copy this prompt into it. The assistant will guide you through executing the standard manual deployment commands above and configuring automatic updates: +Copy this prompt into your AI coding assistant, such as Claude Code, Codex, OpenClaw, Antigravity, Cursor, or Trae. It covers the first installation and the automatic-update setup: **Recommendation:** Before deployment, configure GitHub and Cloudflare MCP servers, plugins, or other supported integrations for your AI Agent. This allows it to fork the repository, create the required Cloudflare resources, deploy the application, and connect the instance to Cloudflare Workers Builds. @@ -78,6 +70,14 @@ After the first deployment, see [Cloudflare Workers Builds](docs/cloudflare-work > Common pitfall: Cloudflare R2, D1, and Workers may still require a Visa card during activation or usage, even when you stay within the free quotas. +or
+ +### Manual Deployment + +Please refer to the [Cloudflare Manual Deployment Guide](docs/manual-deploy.md) for first-time manual installation, Cloudflare resource setup, and emergency recovery. After the first deployment, connect Workers Builds; future updates arrive through GitHub **Sync fork** or pushes to `main`. + +The automated helper commands are recommended. The template uses `admin` / `admin123` for the initial login, and the password can be changed later in Personal Settings. If you create the Cloudflare resources manually, finish configuring `.env.local`—including the D1 ID, R2 bucket, and the 400-day session limit—before running `bun run deploy`. + ## Multi-Account Login diff --git a/README.zh-CN.md b/README.zh-CN.md index 43a646d3..34ba298c 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -49,17 +49,9 @@ EdgeEver 是一个开源、自托管、Cloudflare-native 的现代笔记工作 ## 部署 -### 手动部署 (推荐) - -关于首次手动安装、Cloudflare 资源配置与紧急修复，请参考 [Cloudflare 手动部署指南](docs/manual-deploy.zh-CN.md)。首次部署后，请配置 Cloudflare Workers Builds；之后通过 GitHub **Sync fork** 或推送 `main` 自动更新。 - -推荐优先使用自动化辅助命令。配置模板使用 `admin` / `admin123` 作为初始登录账号密码，之后可在个人设置中修改密码。如果选择完全手动创建 Cloudflare 资源，必须先在 `.env.local` 中完成 D1 ID、R2 bucket 和 400 天会话期限等配置，再执行 `bun run deploy`。 - -或
- -### 通过 AI Agent 一句话部署 (可选) - -如果你习惯在日常开发中使用 AI 编程助手（如 Claude Code、Codex、OpenClaw、Antigravity、Cursor、Trae 等），也可以将下方提示词复制给它。AI 助手会帮你自动执行上述标准的手动安装命令，并配置后续自动更新： +### 通过AI Agent 一句话部署 + +将下方提示词复制给你的 AI 助手（Claude Code、Codex、OpenClaw、Antigravity、Cursor、Trae 等），它会完成首次安装并配置后续自动更新。 **建议：** 开始部署前，请先为 AI Agent 配置 GitHub 和 Cloudflare 的 MCP、插件或其他可用集成，以便 Agent 完成仓库 Fork、Cloudflare 资源创建、应用部署和 Workers Builds 自动部署连接。 @@ -75,6 +67,14 @@ Agent 应优先按 [AI Agent Cloudflare Deployment](docs/agent-deploy-cloudflare > 常见踩坑：Cloudflare 的 R2、D1 和 Worker 即使使用免费额度，在开通或使用过程中也可能要求绑定一张 Visa 卡。国内用户可以考虑办理招商银行多币种卡，拿到 Visa 卡后绑定到 Cloudflare 账号即可。 +或
+ +### 手动部署 + +关于首次手动安装、Cloudflare 资源配置与紧急修复，请参考 [Cloudflare 手动部署指南](docs/manual-deploy.zh-CN.md)。首次部署后，请配置 Cloudflare Workers Builds；之后通过 GitHub **Sync fork** 或推送 `main` 自动更新。 + +推荐优先使用自动化辅助命令。配置模板使用 `admin` / `admin123` 作为初始登录账号密码，之后可在个人设置中修改密码。如果选择完全手动创建 Cloudflare 资源，必须先在 `.env.local` 中完成 D1 ID、R2 bucket 和 400 天会话期限等配置，再执行 `bun run deploy`。 + ## 多账号登录