Cloudflare DNS 更新器

该技能用于创建或更新 Cloudflare DNS 的 A 记录，将其指向指定的 IP 地址，并确保该记录已启用 Cloudflare 代理（Proxied）。它是自动化服务部署与 DNS 管理的基础性工具。

前置条件

该技能要求已设置环境变量 CLOUDFLARE_API_TOKEN，其值为一个具备 DNS 编辑权限的有效 Cloudflare API Token。

模型应在尝试调用该技能前验证此前提条件。若该环境变量未设置，应明确告知用户并中止执行。

核心操作：scripts/update-record.py

核心逻辑由 update-record.py 脚本实现。

输入（命令行参数）

• --zone：（必需）根域名。示例：example.com
• --record：（必需）记录名称（子域名）。若需配置根域名本身，请使用 @。示例：www
• --ip：（必需）目标 IPv4 地址，即该 DNS 记录将解析到的 IP。
• --proxied：（可选）布尔值（true 或 false），用于设置 Cloudflare 代理状态。默认值为 true。

输出

脚本会将执行进度输出至 stdout。

• 执行成功时，输出确认信息及所创建/更新记录的 JSON 对象。
• 执行失败时，在 stderr 输出描述性错误信息，并以非零退出码终止进程。

执行流程

使用该技能时，请按以下步骤操作：

1. 验证前置条件：检查环境变量 CLOUDFLARE_API_TOKEN 是否已设置；若未设置，通知用户并中止流程。
2. 收集输入参数：根据用户的请求，提取 zone、record 名称和目标 ip。
3. 构造执行命令：拼装完整的 shell 命令以调用该脚本。
4. 执行命令：通过 exec 工具运行该命令。
5. 反馈结果：
   • 若命令执行成功，向用户报告 DNS 记录已成功创建或更新；
   • 若命令执行失败，解析 stderr 中的错误信息，并以清晰、易懂的方式向用户说明具体问题。

使用示例

用户请求：“将 www.example.com 指向服务器的公网 IP。”

AI 的思考过程：

1. 用户希望在 Cloudflare 上更新一条 DNS 记录，cloudflare-dns-updater 技能完全适用。
2. 我将调用 update-record.py 脚本。
3. 我需要获取 zone、record 名称和 IP 地址：
   • zone：example.com
   • record：www
   • IP：需先查询服务器的公网 IP。可通过 curl -s https://ipv4.icanhazip.com/ 获取。
4. 我将先获取 IP，再构造最终命令。
5. 执行命令后，向用户反馈结果。

AI 的操作：

# 步骤 1：获取公网 IP
PUBLIC_IP=$(curl -s https://ipv4.icanhazip.com/)

# 步骤 2：运行技能脚本
python3 skills/cloudflare-dns-updater/scripts/update-record.py 
  --zone "example.com" 
  --record "www" 
  --ip "$PUBLIC_IP"

容错策略

• 若未设置 CLOUDFLARE_API_TOKEN：不得尝试运行脚本。应明确告知用户缺失必需的环境变量，并提示需由管理员完成配置。
• 若脚本执行失败并退出：读取 stderr 中的错误信息。常见错误包括 API Token 无效、zone 名称错误或权限不足等。须将具体错误信息清晰传达给用户。