Skip to content

AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.

docs: recommend AI Agent deployment

tianma-if51b1707c8a3f
diff --git a/README.md b/README.md
index 38bd8e73..fc89b2e0 100644
--- a/README.md
+++ b/README.md
@@ -54,13 +54,9 @@ The public demo resets every Monday at 1:00 AM (China Standard Time) and restore
## Deployment
-### Option A: Deploy online from a Fork (Recommended)
+### Option A: Deploy with an AI Agent (Recommended)
-[Fork EdgeEver on GitHub](https://github.com/tianma-if/edgeever/fork), then follow the [online deployment guide](docs/deploy-cloudflare-button.md).
-
-### Option B: Deploy with an AI Agent
-
-Copy this prompt into an AI Agent with GitHub and Cloudflare access:
+Copy this prompt into an AI Agent configured with GitHub and Cloudflare MCP servers, plugins, or other integrations:
```text
Deploy EdgeEver online:
@@ -73,6 +69,10 @@ Deploy EdgeEver online:
Detailed requirements: [AI Agent Cloudflare Deployment](docs/agent-deploy-cloudflare.md).
+### Option B: Deploy online from a Fork
+
+[Fork EdgeEver on GitHub](https://github.com/tianma-if/edgeever/fork), then follow the [online deployment guide](docs/deploy-cloudflare-button.md).
+
## Multi-Account Login
Once deployed, a single instance supports multi-account login.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 405f74e7..ef3fd58b 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -52,12 +52,9 @@ EdgeEver 是一个开源、自托管、Cloudflare-native 的现代笔记工作
## 部署
-### 方案一:Fork 后在线部署(推荐)
+### 方案一:AI Agent 部署(推荐)
-[在 GitHub Fork EdgeEver](https://github.com/tianma-if/edgeever/fork),然后查看[在线部署文档](docs/deploy-cloudflare-button.zh-CN.md)。
-
-### 方案二:AI Agent 部署
-将下方提示词复制给已接入 GitHub 和 Cloudflare 的 AI Agent:
+将下方提示词复制给已配置 GitHub、Cloudflare MCP、插件或其他可用集成的 AI Agent:
```text
请在线完成 EdgeEver 部署:
@@ -70,6 +67,10 @@ EdgeEver 是一个开源、自托管、Cloudflare-native 的现代笔记工作
详细要求见:[AI Agent 在线部署约定](docs/agent-deploy-cloudflare.zh-CN.md)。
+### 方案二:Fork 后在线部署
+
+[在 GitHub Fork EdgeEver](https://github.com/tianma-if/edgeever/fork),然后查看[在线部署文档](docs/deploy-cloudflare-button.zh-CN.md)。
+
## 多账号登录
部署完成后,单个实例支持多账号登录。
diff --git a/apps/site/src/components/agent-install-tabs.astro b/apps/site/src/components/agent-install-tabs.astro
index 0b6d5c08..5cd1e22c 100644
--- a/apps/site/src/components/agent-install-tabs.astro
+++ b/apps/site/src/components/agent-install-tabs.astro
@@ -7,17 +7,17 @@ const isEnglish = locale === "en-US";
const copy = isEnglish
? {
chooseOne: "Choose either option to complete deployment.",
- oneClick: "Option A: Deploy from a Fork",
- agent: "Option B: AI Agent deployment",
+ oneClick: "Option B: Deploy from a Fork",
+ agent: "Option A: AI Agent deployment",
recommended: "Recommended",
oneClickIntro:
- "Fork EdgeEver on GitHub, import the Fork into Cloudflare Workers & Pages, and configure the deployment online.",
+ "Complete deployment in 4 steps: Fork EdgeEver, import it into Cloudflare Workers & Pages, configure the required resources, then run and verify the first build. See the online deployment guide for details.",
forkButton: "Fork EdgeEver on GitHub",
oneClickGuide: "Open the online deployment guide",
oneClickGuideHref:
"https://github.com/tianma-if/edgeever/blob/main/docs/deploy-cloudflare-button.md",
agentIntro:
- "Copy the prompt below to your AI assistant (Claude Code, Codex, Cursor, and similar tools).",
+ "Copy the prompt below to an AI Agent configured with GitHub and Cloudflare MCP servers, plugins, or other integrations.",
promptLabel: "Prompt",
copyPrompt: "Copy prompt",
copying: "Copying...",
@@ -30,15 +30,15 @@ const copy = isEnglish
}
: {
chooseOne: "以下两种方案任选其一即可完成部署。",
- oneClick: "方案一:Fork 后在线部署",
- agent: "方案二:AI Agent 一句话部署",
+ oneClick: "方案二:Fork 后在线部署",
+ agent: "方案一:AI Agent 一句话部署",
recommended: "推荐",
- oneClickIntro: "先在 GitHub Fork EdgeEver,再将 Fork 导入 Cloudflare Workers & Pages,在线完成部署配置。",
+ oneClickIntro: "共 4 步完成部署:Fork EdgeEver、导入 Cloudflare Workers & Pages、配置所需资源、启动并验证首次构建。详细操作请查看在线部署文档。",
forkButton: "在 GitHub Fork EdgeEver",
oneClickGuide: "查看在线部署文档",
oneClickGuideHref:
"https://github.com/tianma-if/edgeever/blob/main/docs/deploy-cloudflare-button.zh-CN.md",
- agentIntro: "将下方提示词复制给你的 AI 助手(Claude Code、Codex、Cursor 等)。",
+ agentIntro: "将下方提示词复制给已配置 GitHub、Cloudflare MCP、插件或其他可用集成的 AI Agent。",
promptLabel: "提示词",
copyPrompt: "复制提示词",
copying: "复制中...",
@@ -58,22 +58,22 @@ const copy = isEnglish
<button
class="agent-install-tab active relative px-3 py-4 text-brand transition hover:text-brand-text"
type="button"
- data-tab-target="one-click"
+ data-tab-target="agent"
aria-selected="true">
- <span>{copy.oneClick}</span>
+ <span>{copy.agent}</span>
<span class="ml-1 rounded-full bg-brand/10 px-2 py-0.5 text-xs text-brand">{copy.recommended}</span>
</button>
<button
class="agent-install-tab relative px-3 py-4 text-slate-500 transition hover:text-brand-text"
type="button"
- data-tab-target="agent"
+ data-tab-target="one-click"
aria-selected="false">
- {copy.agent}
+ {copy.oneClick}
</button>
</div>
<div class="mt-8 overflow-hidden rounded-[28px] bg-slate-100 px-6 py-8 sm:px-10 md:px-14">
- <div class="agent-install-panel" data-tab-panel="one-click">
+ <div class="agent-install-panel hidden" data-tab-panel="one-click">
<p class="mx-auto max-w-3xl text-center text-lg leading-9 text-slate-600">{copy.oneClickIntro}</p>
<div class="mt-8 flex flex-col items-center justify-center gap-4 sm:flex-row">
<a
@@ -94,7 +94,7 @@ const copy = isEnglish
</div>
</div>
- <div class="agent-install-panel hidden" data-tab-panel="agent">
+ <div class="agent-install-panel" data-tab-panel="agent">
<p class="mx-auto mb-8 max-w-3xl text-center text-lg leading-9 text-slate-600">
{copy.agentIntro}
</p>
diff --git a/apps/site/src/content/blog/ai-agent-deploy-cloudflare.md b/apps/site/src/content/blog/ai-agent-deploy-cloudflare.md
index 9bce8a52..cb871aad 100644
--- a/apps/site/src/content/blog/ai-agent-deploy-cloudflare.md
+++ b/apps/site/src/content/blog/ai-agent-deploy-cloudflare.md
@@ -1,7 +1,7 @@
---
draft: false
title: "EdgeEver Cloudflare 部署指南:两种方案任选其一"
-snippet: "选择 Fork 后在线部署或 AI Agent 部署,在自己的 Cloudflare 账号中运行 EdgeEver。"
+snippet: "推荐使用 AI Agent 在线部署,也可从 GitHub Fork 后手动完成 Cloudflare 配置。"
image: {
src: "/images/agent-deploy.jpg",
alt: "EdgeEver 的两种 Cloudflare 部署方案"
diff --git a/apps/site/src/content/blog_en/ai-agent-deploy-cloudflare.md b/apps/site/src/content/blog_en/ai-agent-deploy-cloudflare.md
index 27dfca5d..f6a34298 100644
--- a/apps/site/src/content/blog_en/ai-agent-deploy-cloudflare.md
+++ b/apps/site/src/content/blog_en/ai-agent-deploy-cloudflare.md
@@ -1,7 +1,7 @@
---
draft: false
title: "Deploy EdgeEver to Cloudflare: choose one of two options"
-snippet: "Choose online deployment from a GitHub Fork or an AI Agent deployment in your own Cloudflare account."
+snippet: "Deploy online with an AI Agent, or configure EdgeEver manually from a GitHub Fork in your own Cloudflare account."
image: {
src: "/images/agent-deploy.jpg",
alt: "Two ways to deploy EdgeEver to Cloudflare"
diff --git a/apps/site/src/i18n.ts b/apps/site/src/i18n.ts
index d2401097..d4972658 100644
--- a/apps/site/src/i18n.ts
+++ b/apps/site/src/i18n.ts
@@ -129,7 +129,7 @@ export const siteCopy = {
items: [
{
title: "两种方式部署 EdgeEver",
- summary: "Fork 后在线部署,或让 AI Agent 代为完成同一套线上配置流程。",
+ summary: "让 AI Agent 代为完成线上部署,或手动 Fork 后在线配置同一套流程。",
href: "/blog/ai-agent-deploy-cloudflare",
cta: "查看部署指南",
},
@@ -252,7 +252,7 @@ export const siteCopy = {
items: [
{
title: "Two ways to deploy EdgeEver",
- summary: "Deploy online from a GitHub Fork, or let an AI Agent complete the same online configuration flow.",
+ summary: "Let an AI Agent complete the online deployment, or configure the same flow online from a GitHub Fork.",
href: "/blog/ai-agent-deploy-cloudflare",
cta: "Read deployment guide",
},
diff --git a/docs/promotion/promotion_article_juejin.md b/docs/promotion/promotion_article_juejin.md
index 718248f8..df8a5fba 100644
--- a/docs/promotion/promotion_article_juejin.md
+++ b/docs/promotion/promotion_article_juejin.md
@@ -85,23 +85,23 @@ EdgeEver 内置了 **REST API**、**OpenAPI 协议** 以及 **Remote MCP (Model
EdgeEver 的部署简单到了极致,甚至你都不需要打开终端。
-### 方式 A:Fork 后在线部署(推荐)
+### 方式 A:AI Agent 一句话部署(推荐)
-先 Fork EdgeEver 上游仓库,然后在 Cloudflare Workers & Pages 中导入自己的 Fork,在线配置 D1、R2、Worker Secret 和构建命令。部署完成后,启用仓库中的上游更新工作流,后续版本会自动同步、验证并部署。
-
-[Fork EdgeEver](https://github.com/tianma-if/edgeever/fork) 后,参考[在线部署文档](../deploy-cloudflare-button.zh-CN.md)完成配置。
-
-### 方式 B:AI Agent 一句话部署
-
-将下面这段话复制给你的 AI 助手(如 Claude Code、Cursor、Antigravity 等):
+将下面这段提示词复制给已配置 GitHub、Cloudflare MCP、插件或其他可用集成的 AI Agent:
```text
-请先 Fork https://github.com/tianma-if/edgeever,然后克隆这个 Fork。
-严格按照 docs/agent-deploy-cloudflare.md 创建 Cloudflare 资源、完成首次部署,并配置 Workers Builds 和 Update deployed EdgeEver 工作流。
-验证健康检查、首次构建和上游自动更新都成功后,再向我报告部署完成。
+请在线完成 EdgeEver 部署:
+1. Fork https://github.com/tianma-if/edgeever。
+2. 将这个 Fork 导入 Cloudflare Workers & Pages。
+3. 严格按照 docs/agent-deploy-cloudflare.zh-CN.md 配置 D1、R2、EDGE_EVER_AUTH_PASSWORD Worker Secret 和 Workers Builds。
+4. 启动首次构建,验证健康检查和登录,然后手动运行一次 Update deployed EdgeEver。
```
-AI 助手会代为在 Cloudflare 上创建 D1、R2,配置 Worker Secret,完成部署,并接通持续更新链路。
+### 方式 B:Fork 后在线部署
+
+先 Fork EdgeEver 上游仓库,然后在 Cloudflare Workers & Pages 中导入自己的 Fork,在线配置 D1、R2、Worker Secret 和构建命令。部署完成后,启用仓库中的上游更新工作流,后续版本会自动同步、验证并部署。
+
+[Fork EdgeEver](https://github.com/tianma-if/edgeever/fork) 后,参考[在线部署文档](../deploy-cloudflare-button.zh-CN.md)完成配置。
高级恢复时才需要手动运行部署命令: