从 AI 开始
EdgeOne Pages 内置的 AI 工具如部署 MCP、AI IDE 插件、以及不断迭代的边缘 AI,配合灵活的 AI 上下文文件,共同构建了一个智能化的开发生态,助您以更快的速度、更高的质量交付卓越的 Web 应用。
使用 Pages MCP
MCP(Model Context Protocol,模型上下文协议)是一种开放协议,让 AI 模型能够安全地与本地和远程资源进行交互。
EdgeOne Pages Deploy MCP 是一项专用服务,能够将 Web 应用快速部署到 EdgeOne Pages 并生成公开访问链接。这使您能够立即预览和分享 AI 生成的网页内容。更多详情可参考文档 Pages MCP。
AI 上下文文件
在 Pages 中,AI 上下文文件是您与 AI IDE(如 CodeBuddy、Cursor、Windsurf)沟通的桥梁。这些文件以 Markdown 格式编写,允许您定义项目特定的规则、最佳实践、代码规范、API 接口定义,甚至是业务逻辑描述。通过上下文文件,您可以为 AI 提供精确的上下文信息,确保其生成的代码、建议和自动化操作更符合您的项目需求和平台特性。
在 AI IDE 中使用 .mdc 文件
对于大多数 AI 开发工具,只需要将 pages-llms.mdc 文件放置于项目根目录下作为项目级规则,或者在开发工具中设置为全局规则。
在 CodeBuddy 中使用:在 IDE 中进入设置界面,定位至规则 tab,可在项目规则下将 .mdc 文件添加进去。更多信息可查看文档 使用 CodeBuddy IDE。
在 Cursor 中使用:在项目根目录创建 .cursor/rules/ 文件夹,将您的 .mdc 文件放置其中。或添加到用户主目录(如 ~/.cursor/rules/)。更多信息可查看 Cursor 官方文档中的示例 https://docs.cursor.com/zh/context/rules
在 Windsurf 中使用:在项目根目录创建 .windsurf/rules/ 文件夹,将你的 .mdc 文件放置其中。或通过 Windsurf UI 手动添加此文件。更多信息可查看 Windsurf 官方文档中的示例 https://windsurf.com/editor/directory
使用 llms.txt
您也可以在 AI 对话中,使用 http://docs.edgeone.site/llms.txt 来分享 Pages 文档的上下文。通常情况下,只要 AI 对话工具支持此格式,llms.txt 将会作为网络资源上下文被引用。
AI 辅助开发与部署实践
以下最佳实践将指导您如何有效与 AI 协作,更快、更好地进行项目开发。
优化提示词
清晰、结构化的提示词是与 AI 有效沟通的关键。遵循以下原则,让 AI 更准确地理解您的意图:
使用总分结构:先阐明总体目标,再逐步细化具体要求,如“创建一个响应式博客首页,包含导航、文章列表和页脚”。
使用精确术语:在关键指令中使用精确描述,例如“使用 Tailwind CSS 实现蓝色系扁平化设计”。
提供现有示例:通过提供现有代码或设计模式示例,引导 AI 生成符合您风格的内容。
持续调整迭代:尝试不同的表达来组织提示词,以发现 AI 带来的最佳结果。
EdgeOne Pages 提示词关键短语
为了帮助 AI 更好地理解您的意图,并生成可顺利部署到 Pages 的项目代码。在与 AI 对话时,提及这些词汇将显著提高 AI 输出的准确性和相关性。
EdgeOne Pages: 明确指定目标部署平台。
示例: “请为 EdgeOne Pages 创建一个 Next.js 博客应用。”
Node Functions: 指明需要使用 Node.js 运行时环境的后端逻辑。
示例: “我需要一个 Node Functions 来处理用户认证。”
Edge Functions: 指明需要使用边缘计算能力的轻量级逻辑。
示例: “请编写一个 Edge Functions 实现地理位置重定向。”
全栈应用: 强调项目包含前端和后端。
示例: “开发一个实时获取当地天气的全栈应用,前端使用 React,后端使用 Node Functions。”
AI Rule 文件: 指明使用特定的 AI 规则文件来指导 AI。
示例: “请参考 mdc 文件中的规则,生成符合 EdgeOne Pages 规范的代码。”
完善项目信息
合理提供 AI 上下文,能让 AI 深入理解您的项目。
充分利用上下文文件:在 pages-llms.mdc 中适当补充项目结构、API 接口或业务逻辑。AI IDE 将自动加载这些规则,确保 AI 生成的代码符合项目要求。
编写高质量的 readme:这是 AI 理解项目的关键入口。一个清晰、详细的 README.md 应包含项目简介、技术栈、运行/部署指南及关键模块描述,帮助 AI 快速掌握项目全貌并提供精准建议。