Skip to content

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

docs(agents): preserve the Cloudflare fork deployment workflow

tianma-if1767b6667dae
diff --git a/AGENTS.md b/AGENTS.md
index 0551f952..adedc0f7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -61,6 +61,7 @@ Related Issue: #<issue-number>
- **AI 模型 API 优先客户端直连**:所有平台、所有功能的 AI 模型 API 请求优先由客户端直接调用模型服务;Web 端遇到浏览器网络或 CORS 限制时,允许通过 EdgeEver 后端兜底。桌面端及原生移动端保持直连;已有 HTTP 响应或开始接收流式结果后,不得因错误自动切换到后端重复调用。
- **Cloudflare 部署**:严格按 `docs/agent-deploy-cloudflare.md` 执行。
+- **Cloudflare 默认部署入口**:保留 Fork + Workers Builds 及现有上游同步机制;未经明确要求,不改用会改变 Fork 同步方式的 Deploy to Cloudflare 模板入口。
- **跨运行时架构**:项目未来将正式支持 Docker 自托管;实现新功能时必须保持业务逻辑与 Cloudflare 解耦,并为其他运行时预留扩展边界。Cloudflare 与 Docker 必须共用同一套业务代码,仅允许保留薄且稳定、不包含业务判断的运行入口和基础设施驱动适配器。
- **数据库 Migration**:数据库或种子变化时,在 `migrations/` 下新增递增编号 SQL,禁止修改已执行的旧 Migration。
- **数据库读取预算**:备份、分页、同步和轮询必须评估整次操作的累计读取量,禁止逐页或逐次轮询重复全量扫描、计数。使用本地代表性数据验证读取量随页数与数据量的增长,并补充回归测试;不得用生产库全量扫描或压测来验证。额度耗尽必须明确诊断,不得只提示稍后重试。