功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

专业版为企业提供完整的CDN管理与优化平台,在免费版基础配置能力之上,新增多CDN智能调度、Edge Workers边缘计算、高级WAF与DDoS防护、实时性能监控与告警、缓存预热与批量刷新、SARIF合规报告等企业级功能。专业版完全兼容免费版配置方法,已有CDN配置可无缝升级,适合全球内容分发与高并发场景.

专业版核心优势

优势	说明
多CDN调度	智能选择最优CDN,故障自动切换
边缘计算	Edge Workers在边缘节点执行逻辑
高级WAF	自定义规则+机器学习威胁检测
DDoS防护	L3-L7全方位DDoS缓解
实时监控	全维度性能监控+智能告警
缓存预热	上线前主动预热缓存
批量刷新	批量URL/目录缓存刷新
全球加速	200+边缘节点覆盖

核心能力

1. 多CDN智能调度(专业版独有)

详细代码示例已移至 references/detail.md

处理: 解析多CDN智能调度(专业版独有)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回多CDN智能调度(专业版独有)的响应数据,包含状态码、结果和日志.

2. Edge Workers边缘计算(专业版独有)

输入格式

参数名	类型	必填	说明
input	string	是	CDN配置工具包专业版处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

// Cloudflare Worker: 边缘A/B测试
export default {
    async fetch(request, env) {
        const url = new URL(request.url);
// ...
        // A/B测试:50%用户看到新版页面
        const variant = Math.random() < 0.5 ? 'A' : 'B';
// ...
        // 添加变体标识到请求头
        const modifiedRequest = new Request(request, {
            headers: {
                ...Object.fromEntries(request.headers),
                'X-AB-Variant': variant
            }
        });
// ...
        // 获取源站响应
        const response = await fetch(modifiedRequest);
// ...
        // 在边缘修改响应
        const modifiedResponse = new Response(response.body, response);
        modifiedResponse.headers.set('X-AB-Variant', variant);
headers.set('X-Edge-Location', request.cf?.colo || 'unknown');
// ...
        return modifiedResponse;
    }
};
// ...
// Edge Worker: 边缘缓存API响应
export default {
    async fetch(request, env) {
        const cache = caches.default;
        const cacheKey = new Request(request.url, request);
// ...
        // 检查缓存
        let response = await cache.match(cacheKey);
        if (response) {
            // 添加缓存命中标识
            response = new Response(response.body, response);
            response.headers.set('X-Cache-Status', 'HIT');
            return response;
        }
// ...
        // 回源获取
        response = await fetch(request);
// ...
        // 仅缓存成功响应
        if (response.status === 200) {
headers.set('X-Cache-Status', 'MISS');
headers.set('Cache-Control', 'public, max-age=300');
// ...
            // 异步写入缓存
            const event = new Request(request.url, { method: 'GET' });
            await cache.put(event, response.clone());
        }
// ...
        return response;
    }
};

处理: 解析Edge Workers边缘计算(专业版独有)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回Edge Workers边缘计算(专业版独有)的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

3. 高级WAF与DDoS防护(专业版独有)

#!/bin/sh
API_TOKEN="你的API_TOKEN"
ZONE_ID="你的ZONE_ID"
# ...
curl -s -X POST "https://api.cloudflare.com/client/v4/zones/${ZONE_ID}/rulesets" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    -H "Content-Type: application/json" \
    -d '{
        "name": "输入验证防护",
        "kind": "zone",
        "phase": "http_request_firewall_custom",
        "rules": [{
            "expression": "(http.request.uri.query contains \"UNION\" and http.request.uri.query contains \"SELECT\") or (http.request.uri.query contains \"\\x27 OR\\x27\")",
            "action": "block",
            "description": "阻止输入验证攻击"
        }]
    }' | jq '.success'
# ...
cloudflare.com/client/v4/zones/${ZONE_ID}/rulesets" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    -H "Content-Type: application/json" \
    -d '{
        "name": "API速率限制",
        "kind": "zone",
        "phase": "http_ratelimit",
        "rules": [{
request.uri.path contains \"/api/\")",
            "action": "block",
            "ratelimit": {
                "characteristics": ["ip.src", "http.request.headers[\"x-api-key\"]"],
                "period": 60,
                "requests_per_period": 100,
                "mitigation_timeout": 300
            },
            "description": "API每分钟100次限制"
        }]
    }' | jq '.success'
# ...
curl -s -X PATCH "https://api.cloudflare.com/client/v4/zones/${ZONE_ID}/ddos_protection/l7" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    -H "Content-Type: application/json" \
    -d '{"sensitivity_level":"high"}' | jq '.success'
# ...
cloudflare.com/client/v4/zones/${ZONE_ID}/bot_management" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    -H "Content-Type: application/json" \
    -d '{
        "enable_js": true,
        "fight_mode": true
    }' | jq '.success'

处理: 解析高级WAF与DDoS防护(专业版独有)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回高级WAF与DDoS防护(专业版独有)的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

4. 实时监控与告警(专业版独有)

处理: 解析实时监控与告警(专业版独有)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回实时监控与告警(专业版独有)的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：企业级、CDN、管理平台、支持多、智能调度、边缘计算、WAF、实时监控与、DDoS、适合企业级内容分、发需求、配置工具包专业版、为企业提供全方位、内容分发网络管理、核心能力、Edge、Workers、实时性能监控、缓存预热与刷新、SARIF、适用场景、全球内容分发、高并发活动保障、企业级安全防护、边缘计算应用、差异化、专业版兼容免费版、配置方法、新增企业级多、管理与边缘计算能、满足规模化分发需、适用关键词、multi、computing等.

使用场景

场景一:全球内容分发部署

#!/bin/sh
echo "=== 全球CDN部署 ==="
# ...
echo "配置中国区CDN(阿里云)..."
aliyun cdn AddCdnDomain --DomainName cn.example.com \
    --CdnType web --Sources '[{"content":"origin.example.com","type":"domain","priority":"20"}]'
# ...
echo "配置全球区CDN(Cloudflare)..."
cloudflare.com/client/v4/zones" \
    -H "Authorization: Bearer ${CF_TOKEN}" \
    -d '{"name":"example.com","account":{"id":"ACCOUNT_ID"}}'
# ...
echo "配置智能DNS路由..."
echo "  cn.example.com -> 阿里云CDN(中国大陆用户)"
echo "  global.example.com -> Cloudflare(全球用户)"
# ...
echo "执行缓存预热..."
for path in / /index.html /assets/app.js /assets/style.css; do
    curl -s -o /dev/null "https://cn.example.com${path}"
    curl -s -o /dev/null "https://global.example.com${path}"
done
# ...
echo "全球CDN部署完成"

场景二:高并发活动保障

#!/usr/bin/env python3
"""高并发活动CDN保障方案"""
# ...
class EventCDNGuard:
    """活动期间CDN保障"""
# ...
    def __init__(self):
        self.config = {
            "cache_ttl_static": 86400,      # 静态资源缓存1天
            "cache_ttl_dynamic": 60,         # 动态内容缓存1分钟
            "rate_limit": 1000,              # 每IP每秒1000请求
            "ddos_sensitivity": "high",      # DDoS高灵敏度
            "waf_mode": "blocking",          # WAF阻断模式
            "origin_shield": True,           # 源站防护
            "compression": "brotli",         # Brotli压缩
            "http_version": "http3",         # HTTP/3
        }
# ...
    def pre_event_setup(self):
        """活动前配置"""
        print("=== 活动前CDN配置 ===")
        print(f"  缓存TTL(静态): {self.config['cache_ttl_static']}秒")
        print(f"  缓存TTL(动态): {self.config['cache_ttl_dynamic']}秒")
        print(f"  速率限制: {self.config['rate_limit']} req/s per IP")
        print(f"  DDoS灵敏度: {self.config['ddos_sensitivity']}")
        print(f"  WAF模式: {self.config['waf_mode']}")
        print(f"  源站防护: {'启用' if self.config['origin_shield'] else '关闭'}")
        print(f"  压缩: {self.config['compression']}")
        print(f"  HTTP版本: {self.config['http_version']}")
# ...
    def warmup_cache(self, urls):
        """缓存预热"""
        print(f"\n=== 缓存预热: {len(urls)}个URL ===")
        for url in urls:
            print(f"  预热: {url}")
        print("预热完成")
# ...
    def generate_report(self):
        """生成保障报告"""
        return {
            "config": self.config,
            "status": "ready",
            "recommendations": [
                "活动前1小时执行缓存预热",
                "活动期间密切监控缓存命中率",
                "准备源站扩容方案",
                "配置故障切换备用CDN"
            ]
        }
# ...
if __name__ == "__main__":
    guard = EventCDNGuard()
    guard.pre_event_setup()
    guard.warmup_cache([
        "https://example.com/",
    ])
    import json
    print(json.dumps(guard.generate_report(), indent=2, ensure_ascii=False))

场景三:缓存批量管理

#!/bin/sh
ZONE_ID="你的ZONE_ID"
API_TOKEN="你的API_TOKEN"
# ...
echo "=== 批量URL刷新 ==="
cloudflare.com/client/v4/zones/${ZONE_ID}/purge_cache" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    -H "Content-Type: application/json" \
    -d '{
        "files": [
        ]
    }' | jq '.success'
# ...
# curl -s -X POST "https://api.cloudflare.com/client/v4/zones/${ZONE_ID}/purge_cache" \
echo "=== 按前缀刷新 ==="
cloudflare.com/client/v4/zones/${ZONE_ID}/purge_cache" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    -H "Content-Type: application/json" \
    -d '{
        "prefixes": ["example.com/assets/", "example.com/images/"]
    }' | jq '.success'
# ...
echo "=== 缓存预热 ==="
URLS=(
)
for url in "${URLS[@]}"; do
    STATUS=$(curl -s -o /dev/null -w "%{http_code}" "$url")
    echo "  ${url}: ${STATUS}"
done

不适用场景

以下场景CDN配置工具包专业版不适合处理：

• 安全评估未授权目标
• 物理安全防护
• 社会工程学攻击

触发条件

需要安全检测、合规审计、质量检查、加密防护时使用。不适用于非本工具能力范围的需求.

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

从免费版升级

# 本技能的核心实现逻辑
# 请参考上方使用说明进行配置和调用
echo "implementation_ready"

首次多CDN配置

python3 multi_cdn_router.py --region cn --provider alicdn
py --region global --provider cloudflare

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

专业版功能矩阵

功能	免费版	专业版	说明
基础缓存	支持	支持	缓存策略配置
多CDN调度	不支持	支持	智能路由
Edge Workers	不支持	支持	边缘计算
高级WAF	基础规则	自定义+ML	安全防护
DDoS防护	基础	L3-L7	攻击缓解
实时监控	基础	全维度	性能监控
缓存预热	不支持	支持	主动预热
批量刷新	单URL	批量+前缀	缓存管理
告警推送	不支持	支持	实时告警

优选实践

1. 多CDN冗余:部署至少两个CDN,故障自动切换.
2. 边缘计算:将逻辑下沉到边缘,减少回源.
3. 缓存预热:上线前主动预热关键页面缓存.
4. 分层防护:WAF+DDoS+速率限制多层安全.
5. 持续监控:实时监控缓存命中率、响应时间、错误率.
6. 定期演练:定期模拟故障切换,验证容灾能力.

已知限制

• 本skill的能力范围受限于核心能力章节中定义的功能,不支持超出范围的操作
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响

常见问题

Q1: 专业版与免费版配置是否兼容?

完全兼容。专业版使用相同的CDN服务商API,新增高级功能通过额外配置启用.

Q2: Edge Workers支持哪些功能?

支持请求/响应修改、边缘缓存、A/B测试、认证鉴权、重定向等,在边缘节点执行,延迟低于50ms.

Q3: 多CDN调度如何工作?

通过智能DNS根据用户地理位置、CDN健康状态和性能指标动态选择最优CDN,故障时自动切换.

Q4: DDoS防护覆盖哪些层级?

覆盖L3/L4网络层和L7应用层,自动检测并缓解SYN Flood、UDP Flood、HTTP Flood等攻击.

Q5: 缓存预热有什么好处?

上线前预热缓存,避免上线瞬间大量回源请求导致源站压力过大.

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• Python: 3.8+(使用监控与调度引擎时需要)
• 网络: 需可访问CDN管理API

依赖详情

依赖项	类型	是否必需	获取方式
curl	命令行工具	必需	系统自带
jq	JSON处理工具	必需	apt install jq
python3	运行时环境	推荐	python.org 下载
requests	Python库	推荐	pip install requests
dig	DNS工具	推荐	apt install dnsutils
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

• 各CDN服务商需配置对应的API Token
• Cloudflare API Token在仪表盘生成,需Zone编辑权限
• AWS需配置Access Key和Secret Key
• 阿里云需配置AccessKey ID和Secret

可用性分类

• 分类: MD+execute(纯Markdown指令,核心功能需要exec命令行执行能力)
• 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行企业级CDN管理与优化任务
• API Key通过环境变量配置: export API_KEY=your_key

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

输出格式

{
  "success": true,
  "data": {
    "result": "CDN配置工具包专业版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "cdnkit pro"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}

安全注意事项

风险类型	防范措施
API密钥泄露	通过环境变量配置，禁止硬编码到代码或配置文件中
命令执行风险	仅执行白名单命令，避免拼接用户输入到命令行参数中
网络通信安全	使用HTTPS协议，验证SSL证书有效性
敏感数据暴露	输出结果中不包含密钥、令牌等敏感信息

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

核心功能

• 自动化执行: 企业级CDN管理平台,支持多CDN智能调度、边缘计算、高级WAF防护、实时监控与DDoS防护,适合企业级内容分发需求.
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据