SuperAPI AI 工具集

setup-cloudflare

部署与运维

查看项目

更新于 10-21 19:58

技能介绍

用途

该技能用于将用户的 Cloudflare 账户连接到 cf CLI,使智能体能够处理域名、DNS 和部署,而无需用户打开 Cloudflare 控制面板。技能要求智能体自行完成每一步,仅在必须由人工操作时(创建账户、批准登录、购买域名)才向用户请求。

主要能力

  • 在 macOS、Linux 或 Windows 上安装官方 Cloudflare CLI(cf)。
  • 通过浏览器让用户登录并选择账户。
  • 管理域名、DNS 和部署。
  • 检查 Node 是否可用(node --version,要求 v20 或更高),若不可用则先运行 setup-node 技能。
  • 若用户没有 Cloudflare 账户,引导其前往 https://dash.cloudflare.com/sign-up 并等待“done”,免费计划即可。
  • 安装命令:npm install -g cf,随后检查 cf --version。
  • 若 cf auth whoami 已显示 "authenticated": true,则跳过登录步骤;否则后台运行 cf auth login 并将输出写入文件。该命令会打开浏览器,提示用户登录并批准所有权限(包括敏感权限,因为部署和 DNS 需要它们),然后说“done”。若没有浏览器打开,从输出文件中读取链接并提供给用户。持续检查 cf auth whoami 直到显示已认证。
  • 运行 cf accounts list。若有多个账户,询问使用哪一个,并将 export CLOUDFLARE_ACCOUNT_ID=<id> 添加到用户的 shell 配置(~/.zshrc 或 ~/.bashrc,Windows 上为用户环境变量),以便每个会话都使用它。
  • 运行 cf zones list 查看用户的域名。若没有域名,告知他们可以在 Cloudflare 购买(Domain Registration,按成本价),或保留其他注册商的域名并稍后将名称服务器迁移到 Cloudflare;create-* 技能在需要域名时会处理。技能明确要求绝不替用户购买域名。
  • 验证:cf auth whoami 在正确账户上已认证,cf zones list 有响应(列出其域名或暂无),新会话也能找到 cf($SHELL -lic 'cf --version')。
  • 以简短检查清单收尾,每行用对勾或叉号标记:Node 可用、cf 已安装、已登录、已选择账户、已找到域名(列出或说暂无)。然后用一行告知用户智能体现在可以管理其域名并在 Cloudflare 上部署站点。

使用方式

该技能通过智能体执行,用户只需在需要人工操作时响应。若从链接而非本地文件夹获取此技能,不要从仓库安装其他内容:仅在某个步骤需要时用 curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/setup-cloudflare/<path> -o <scratch>/<file> 获取文件,并且仅当到达该步骤时才读取它提到的另一个技能,地址为 https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/<skill-name>/SKILL.md。

适用场景

适用于需要让智能体管理 Cloudflare 域名、DNS 和部署的场景,尤其是用户希望避免手动操作控制面板时。

限制

  • 禁止使用 Wrangler。
  • 禁止索要 API 令牌。
  • 与用户交流时使用其语言、简短消息、避免术语(不说“CLI”“OAuth”或“zone”)。
  • 绝不替用户购买域名。
  • 若用户没有 Cloudflare 账户,必须由用户自行创建。
  • 登录和权限批准必须由用户完成。
  • 关于收费、价格、平台、效果或使用步骤等未在资料中提供的信息,暂未提供。