openclaw
81939825d1
- core/module: 命令模板、门控（feature flag/confirm/dry-run）、ecode 错误标签、ResultFormatter - runbook executor: http.get/http.post/assert.json(expect_success 严格断言)、目标主机管理、任务落库、最终 stdout 直接回传 - cf 模块: /cf dns list 支持域名自动解析 zone_id；dns list/zones/workers list 格式化回传；API success:false 判真失败 - 全部 CF/CPA runbook 接入严格断言，杜绝假阳性 success - 新增 cpa/cfdav/mail/sub 模块与 runbooks；QQ 订阅到期提醒调度 - Web 后台: 模块设置(CF/CPA/cfdav/AI)、OPS 任务、渠道管理、审计页
2.3 KiB
2.3 KiB
CF 命令设计（ops-assistant v1）
目标
为 ops-assistant 提供 Cloudflare DNS 管理能力，保证幂等、安全、可审计。
1. 命令清单
-
/cf zones- 列出可用 Zone（name/id）
-
/cf dnslist <zone> [name] [type]- 示例：
/cf dnslist example.com - 示例：
/cf dnslist example.com www A
- 示例：
-
/cf dnsadd <fqdn> <ip> [--type A/AAAA/CNAME] [--ttl 120] [--proxied on/off]- 示例：
/cf dnsadd test.fnos.xx.kg 1.2.3.4
- 示例：
-
/cf dnsset <fqdn> <ip> [--type A/AAAA/CNAME] [--ttl 120] [--proxied on/off]- 存在则更新，不存在则创建
-
/cf dnsdel <fqdn> --type <A/AAAA/CNAME>- 必须带
--type - 需二次确认
YES
- 必须带
-
/cf dnsproxy <fqdn> on|off- 仅更新 proxied
-
/cf health- Token/权限可用性检查
2. 权限与安全
read角色：仅允许zones / dnslist / healthadmin角色：允许所有命令dnsdel必须二次确认YES
3. 参数校验
fqdn必须属于某个 Zone（<sub>.<zone>）ip校验：A→ IPv4AAAA→ IPv6
type默认Attl默认120proxied默认保持原值（仅 dnsproxy/dnsset 明确修改）
4. 幂等与更新规则
/cf dnsadd
- 查询同名同类型记录
- 存在 → 返回“已存在”
- 不存在 → 创建
/cf dnsset
- 若任一字段不同则更新：
contentttlproxied
- content 相同但 ttl/proxied 不同 → 仍执行更新
/cf dnsdel
- 必须带
--type - 仅删除指定 type 记录
5. 输出规范
成功
✅ DNS操作成功
- name: <fqdn>
- type: <type>
- content: <ip>
- ttl: <ttl>
- proxied: <true/false>
- id: <record_id>
已存在
ℹ️ DNS记录已存在（未变更）
- name: <fqdn>
- type: <type>
- content: <ip>
- id: <record_id>
失败
❌ DNS操作失败
- reason: <鉴权/参数/CF错误>
- detail: <error_message>
6. 审计日志（必写）
字段：
ts / actor / cmd / zone / fqdn / action / record_id / result / detail
示例：
{
"ts": "2026-03-14T15:02:10+08:00",
"actor": "kory",
"cmd": "/cf dnsadd test.fnos.xx.kg 1.2.3.4",
"zone": "fnos.xx.kg",
"record_id": "xxxxx",
"action": "create",
"result": "ok",
"detail": {"type":"A","ttl":120,"proxied":false}
}