腾讯云自动报价（对内）

Overview

本 skill 实现从竞品（阿里云/华为云）配置清单自动对标生成腾讯云报价单的完整能力。覆盖 CVM 云服务器、CBS 云硬盘、CLB 负载均衡、EIP 弹性公网 IP、COS 对象存储、MySQL、Redis、安全产品、大数据产品等全品类，所有价格均基于腾讯云官方 API 验证或官方文档确认。

支持的竞品来源：
- 阿里云：自动检测 ECS sheet 中"实例规格族"以 ecs. 开头
- 华为云：自动检测 ECS sheet 中"实例规格族"以 s/c/m/r/e 等华为云系列前缀开头

工作流程

Step 1: 读取输入清单

用户提供竞品（阿里云或华为云）的应用清单 Excel 文件，通常包含以下信息：
- ECS 云服务器配置（CPU、内存、磁盘、操作系统、实例规格族、数量）
- 应用产品清单（OSS/OBS、RDS、Redis、SLB/ELB、EIP、安全产品、大数据产品等）

脚本会自动检测竞品来源并选择对应的机型映射逻辑。

使用 pandas 读取 Excel：

import pandas as pd
df_ecs = pd.read_excel(input_file, sheet_name='ECS')
df_app = pd.read_excel(input_file, sheet_name='应用')

Step 2: 对标产品映射与价格计算

2.1 CVM 云服务器

阿里云机型映射规则：

华为云机型映射规则：

> 华为云规格族命名： {系列前缀}{代次}.{规格大小}.{内存配比}，如 c6.2xlarge.4（计算增强型第6代 8核32G）。系列前缀决定映射目标。

> 华为云 fallback 机制： 当首选机型（如 SA9）在目标地域通过 API 查询不可用时，自动降级到 fallback 列表中的下一个机型（如 BF1）。此 fallback 仅对华为云来源生效，阿里云来源的机型映射逻辑保持固定不变。

定价模型（通过 InquiryPriceRunInstances API 验证）：

> 重要：以下单价必须从腾讯云官方 API（InquiryPriceRunInstances）或官方定价页面验证，严禁使用第三方网站价格。

> ⚠️ 地域差异警告：以下线性公式仅在上海/北京地域验证为0误差。广州、香港等其他地域的 CVM 定价与上海不同，必须通过 InquiryPriceRunInstances API 实时查询目标地域的实际价格。特别是 BF1 蜂驰型，地域价差可达 +36%（香港）或 -10%（广州）。

> 广州/香港等地域： 上述公式不适用，必须通过 API 查询。已知差异示例：广州 BF1.2XLARGE32 纯实例价 622.08（上海为 691.2，低 10%），香港 BF1.2XLARGE32 纯实例价 937.44（上海为 691.2，高 36%）。

MA9 优先使用 API 精确价格表：

实例规格命名规则：

MEDIUM=2核, LARGE=4核, 2XLARGE=8核, 4XLARGE=16核, 8XLARGE=32核
格式: {机型}.{CPU前缀}{内存GB}
示例: SA9.LARGE16 = SA9 4核16G

CVM 定价流程（API 优先）：

> 核心原则： 当环境变量中存在 TENCENTCLOUD_SECRET_ID / TENCENTCLOUD_SECRET_KEY 时，必须优先通过 InquiryPriceRunInstances API 查询每个 CVM 配置在目标地域的实际刊例价（含系统盘和数据盘）。仅当 API 不可用时，才退化使用以下线性公式估算，并在输出中标注"估算值，未经API验证"。对于非上海/北京地域，禁止使用线性公式，必须 API 查询。

兜底计算公式（仅限上海/北京地域 API 不可用时）：

def calc_cvm_price(cpu, mem, model):
    if model == 'SA9':
        return cpu * 34.2 + mem * 17.1
    elif model == 'BF1':
        return cpu * 28.8 + mem * 14.4
    elif model == 'MA9':
        # 优先使用API精确价格
        api_prices = {(2,16): 265.47, (4,32): 530.93, (8,64): 1061.87, (16,128): 2123.73}
        if (cpu, mem) in api_prices:
            return api_prices[(cpu, mem)]
        return cpu * 34.2 + mem * 12.317

2.2 CBS 云硬盘

磁盘类型对标规则：

> ⚠️ 地域差异警告：以下磁盘单价适用于中国内地地域（上海、广州、北京等）。境外地域（香港、新加坡等）单价不同，必须通过 InquiryPriceRunInstances（含磁盘参数）或 InquiryPriceCreateDisks API 查询。已知香港地域差异：CLOUD_BSSD=0.75、CLOUD_SSD=1.1、CLOUD_HSSD=1.5（均为元/GiB/月）。

官方文档参考： cloud.tencent.com/document/product/362/2413

2.3 公网带宽（EIP）

阶梯计费模型（包月，上海地域）：

def calc_bandwidth_monthly(mbps):
    if mbps <= 0: return 0
    if mbps <= 2: return mbps * 20
    elif mbps <= 5: return 2 * 20 + (mbps - 2) * 25
    else: return 2 * 20 + 3 * 25 + (mbps - 5) * 90

计算示例：
- 10Mbps = 2×20 + 3×25 + 5×90 = 40+75+450 = 565元/月
- 30Mbps = 2×20 + 3×25 + 25×90 = 40+75+2250 = 2,365元/月

2.4 CLB 负载均衡

2.5 PaaS/安全/大数据产品

> 以下价格均需从腾讯云官方文档或 API 获取，不得使用第三方价格。

Step 3: 生成报价单 Excel

运行 scripts/generate_quote.py 脚本生成格式化的 Excel 报价单。

使用方式：

python3 {{SKILL_PATH}}/scripts/generate_quote.py <竞品清单路径> <输出路径> [地域]

参数说明：
- <竞品清单路径>：竞品（阿里云或华为云）应用清单 Excel 文件（需包含 ECS 和应用 sheet）
- <输出路径>：输出报价单 xlsx 文件路径
- [地域]：可选，默认为 "上海"。如果需求中指定了地域则使用指定地域，没有指定则默认上海

Logo：
输出报价单的标题行固定显示腾讯云官方 logo（自动从 COS 下载：https://test-wanxiang-1253451316.cos.ap-shanghai.myqcloud.com/logo_gem_1.jpg），无需手动指定。logo 缩放至高度 60px 放在标题行左侧，标题文字居中。

竞品来源自动检测：
- 阿里云：ECS sheet 中"实例规格族"列值以 ecs. 开头
- 华为云：ECS sheet 中"实例规格族"列值以 s/c/m/r/e 等华为云系列前缀开头

输出报价单包含列：
序号、{竞品}产品、{竞品}规格、腾讯云产品、腾讯云机型、腾讯云规格、配置详情、地域、数量、实例刊例价(元/月)、磁盘刊例价(元/月)、单台合计(元/月)、小计(元/月)、备注、价格计算说明

> 注意： 输出报价单中的"地域"列为必填字段。如果输入清单中有"地域"列则使用清单指定的地域，否则使用命令行参数指定的地域（默认上海）。每一行数据都必须包含地域信息。

Step 4: 价格验证

生成报价单后，必须通过以下方式验证关键价格的准确性：

1. CVM 价格验证：通过 InquiryPriceRunInstances API 验证所有 CVM 配置（含系统盘+数据盘），而非抽验
2. 非上海/北京地域：CVM 和 CBS 价格必须全部通过 API 查询，禁止使用公式估算
3. CBS 磁盘价格验证：通过 InquiryPriceCreateDisks API 或差分法验证磁盘单价，境外地域单价可能不同
4. MySQL 价格验证：通过 DescribeDBPrice API 验证
5. 官方文档交叉验证：COS、Redis、CLB 等产品需与官方文档定价页面核对

> 价格验证原则：所有价格必须可追溯到腾讯云官方 API 返回值或官方文档页面。CVM 价格应通过 InquiryPriceRunInstances API 在目标地域含系统盘+数据盘一起查询，确保总价口径一致。发现价格变动时，应更新 references/pricing-model.md 中的定价模型。

价格查询优先级

> 核心原则：获取价格时，必须严格遵守以下优先级顺序。严禁使用第三方网站价格。

优先级 1：腾讯云官方价格查询 API

对于有官方询价 API 的产品，必须优先通过 API 获取价格。API 返回的刊例价为最权威来源。

> ⚠️ 重要：InquiryPrice 接口同时返回"刊例价"和"官网折扣价"，必须两个都用
>
> 报价场景常被要求"官网折扣价"。严禁自行套用通用折扣口径（如"1年8.3折、3年5折"），因为腾讯云不同产品/不同周期的实际折扣差异极大（实测 CVM 包 3 年约 4.2 折，而非 5 折）。正确做法是直接读接口返回字段：
>
> | 产品 | 接口 | 刊例价字段 | 官网折扣价字段 | 单位 |
> |:---|:---|:---|:---|:---|
> | CVM | InquiryPriceRunInstances | Price.InstancePrice.OriginalPrice | Price.InstancePrice.DiscountPrice | 元（直接是元） |
> | CDB/MySQL | DescribeDBPrice | OriginalPrice | Price | 分（÷100 转元） |
> | Redis | InquiryPriceCreateInstance | （无原价字段，需按月单价×期数推算） | Price | 分（÷100 转元） |
> | CLB | InquiryPriceCreateLoadBalancer | Price.InstancePrice.OriginalPrice + Price.BandwidthPrice.OriginalPrice | 对应的 DiscountPrice | 元 |
>
> 调用包年时传 Period=12，包 3 年传 Period=36。CLB 包 3 年部分场景接口未返折扣（OriginalPrice == DiscountPrice），此时需在备注中标明、商务再议。
>
> 对于无询价接口的产品（COS/EIP/CDN/TSE/ES 等），才退回到按月单价×周期 + 公开折扣口径（1年8.3折/3年5折）估算，并在报价单中明确标注"[估算]"以区分。

优先级 2：腾讯云官方文档（产品定价/计费概述页面）

对于没有询价 API 的产品，从官方文档的定价或计费概述页面获取价格。

优先级 3：腾讯云官方购买页面

对于文档中也无法获取的价格，可通过购买页面的价格计算器确认。

API 调用需要腾讯云 SecretId/SecretKey，从环境变量获取：

import os
secret_id = os.environ.get("TENCENTCLOUD_SECRET_ID")
secret_key = os.environ.get("TENCENTCLOUD_SECRET_KEY")

Resources

scripts/

• generate_quote.py — 完整的报价单生成脚本，读取阿里云清单并输出腾讯云报价 Excel

references/

• pricing-model.md — 详细的定价模型文档，包含所有产品的定价公式、API 验证记录、官方文档链接