# aliyun-all-in-skill

Adopt this skill: https://proskills.md/skills/other/thechenv-aliyun-all-in-skill

Page: https://proskills.md/skills/other/thechenv-aliyun-all-in-skill
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 14396
upstream: https://github.com/thechenv/aliyun-all-in-skill/blob/HEAD/SKILL.md

````text
---
name: aliyun-all-in-skill
description: 阿里云资源报价与统计工具。支持 ECS 报价查询和 OSS 资源统计、RDS 报价。触发场景：(1) ECS 报价、询价、云产品报价、阿里云报价、ECS 价格查询 (2) 发送 ecs_instance_list_*.csv 文件 (3) RDS 报价、发送 rds_instance_list_*.csv 文件 (4) OSS 统计、OSS 分析、Bucket 统计、对象存储统计 (5) 发送 buckets_*.csv 文件。生成 Excel 后由 AI 通过 openclaw message send 发送到当前对话。
---

# 阿里云资源报价与统计

## 功能概述

- **ECS 报价**：查询阿里云 ECS 实例价格，生成 Excel 报价单
- **RDS 报价**：查询阿里云 RDS 实例价格（MySQL、SQLServer、PostgreSQL、MariaDB），生成 Excel 报价单
- **OSS 统计**：分析 OSS 资源使用情况，生成统计报告

## RDS 报价场景判断

AI 需根据输入类型自动判断 RDS 报价场景：

| 输入 | 场景 | 说明 |
|------|------|------|
| `rds_instance_list_<地域>_YYYY 年 MM 月 DD 日 时_分_秒.csv` 文件 | 场景一 | 基于 CSV 文件自动报价 |
| 文字配置描述（如 "杭州，4核8G，MySQL 8.0，高可用系列，500GB"） | 场景二 | 基于文字描述自动报价 |

### RDS 场景一：标准 CSV 格式（直接报价）

文件名匹配 `rds_instance_list_**_YYYY-MM-DD.csv` 或 `rds_instance_list_**_YYYY 年 MM 月 DD 日.csv` 时，直接报价：

```bash
venv/bin/python3 scripts/rds_csv_quoter_auto.py /path/to/file.csv
```

**报价说明：**
- 支持 4 种数据库类型：MySQL、SQLServer、PostgreSQL、MariaDB
- 自动查询 1 年和 3 年价格
- 自动选择 1 年目录价最高的实例应用"新客首购 6 折优惠"（限 1 次，限 1 件）
- 输出 Excel 格式与 ECS 报价单一致

### RDS 场景二：文字配置报价

用户提供文字描述配置（非 CSV 格式），调用：

```bash
venv/bin/python3 scripts/rds_text_quoter.py '<配置文本>'
```

**⚠️ AI 执行指引（必读）**：AI 在调用脚本前，必须先将用户原文格式调整为脚本可正确解析的标准格式。**只做格式调整，不补全任何字段，不更改任何内容**（地域、系列、存储类型等默认值全部由脚本处理）。

#### 标准化步骤

1. **按序号分割** — 识别 `1、` `2.` `3)` 等序号，分割每台实例
2. **提取配置项** — 从原文中提取：引擎+版本、ClassCode（如 `mysql.n2.medium.1`）、CPU+内存（如 `2核4G`）、产品系列、存储类型、存储大小、地域
3. **调整格式** — 将每台实例重组为脚本可解析的标准格式（见下方）
4. **不补全** — 用户没提供的字段不要补，留空即可，脚本会自动处理默认值

#### 标准输入格式

```
1、<地域>，<ClassCode>，<引擎> <版本>，<系列>，<存储类型>，<存储大小>GB
```

**字段说明：**
- 地域：用户提供则保留，未提供则不写（脚本默认杭州）
- ClassCode：用户提供则保留（优先级最高），未提供则不写（脚本会按 CPU+内存匹配）
- 引擎+版本：用户提供则保留，未提供则不写（脚本默认 MySQL 8.0）
- 系列：用户提供则保留，未提供则不写（脚本默认高可用系列）
- 存储类型：用户提供则保留，未提供则不写（脚本根据 ClassCode 从 JSON 推导）
- 存储大小：用户提供则保留

**注意**：字段之间用中文逗号 `，` 分隔，按序号 `1、2、3、` 开头。

#### 标准化示例

**用户输入（简写/不规范格式）：**
```
1、postgresql 15.0，基础系列，高性能云盘，2核 4G（通用型）50GB
2、引擎:mysql 8.0，产品系列:基础系列，存储类型:ESSD PL1 云盘，实例规格:2核 4GB（单机基础版） mysql.n2.medium.1，存储空间:120GB
3、ESSD PL1 mysql.n2.large.2c 100GB
4、杭州 4核8G 250GB
```

**AI 标准化后传给脚本：**
```
1、postgresql 15.0，基础系列，高性能云盘，2核 4G 50GB
2、mysql 8.0，mysql.n2.medium.1，基础系列，ESSD PL1 云盘，120GB
3、mysql.n2.large.2c，ESSD PL1 云盘，100GB
4、杭州，4核 8GB，250GB
```

#### 关键规则

⚠️ **只做格式调整，不补全任何字段**：用户没写的不要帮用户补。例如用户没写地域，不要补"杭州"；没写系列，不要补"高可用系列"。所有默认值由脚本处理。

⚠️ **ClassCode 优先级最高**：用户提供了 ClassCode 必须保留（脚本会精确匹配 rds_series.json）。用户没提供 ClassCode 时保留 CPU+内存信息，由脚本的 CPU+内存匹配逻辑处理。

⚠️ **存储大小不要误取**：注意区分内存（如 `4GiB`）和存储（如 `50GB`）。存储大小是传给脚本的 `DBInstanceStorage` 参数。

⚠️ **多条匹配时脚本会要求人工确认**：无 ClassCode + CPU+内存匹配到多条规格时（如 PostgreSQL 2核4G 基础系列对应多个规格），脚本会在 Excel 备注中标红提示「匹配到的规格为：xxx、xxx，请人工确认」，这属于脚本的正常设计。

⚠️ **存储类型关键词**：脚本可识别 `高性能云盘` `general_essd` `ESSD PL1` `cloud_essd` `高性能本地盘` `local_ssd` 等关键词。用户写了就保留，没写就不写。

**输出格式**：Excel 报价单共 9 列（无实例 ID 列）

| A | B | C | D | E | F | G | H | I |
|---|---|---|---|---|---|---|---|---|
| 产品名称 | 产品描述 | 地域 | 数量 | 1年目录价 | 1年折扣价 | 3年目录价 | 3年折扣价 | 备注 |

**输入参数规则：**

| 参数 | 规则 | 默认值 |
|------|------|--------|
| CommodityCode | 固定为 rds | rds |
| RegionId | 用户提供地域则用用户的，否则默认杭州 | cn-hangzhou |
| Engine | 用户提供数据库类型则用用户的，否则默认 MySQL；不在 MySQL/SQLServer/PostgreSQL/MariaDB 中则不报价 | MySQL |
| EngineVersion | 用户提供则用用户的（支持模糊匹配），否则默认引擎最高版本 | MySQL 8.0 / SQLServer 2022 / PG 18.0 / MariaDB 10.6 |
| DBInstanceClass | 【优先级最高】提供则精确匹配 references/rds_series.json 中的 ClassCode | 无 |
| CPU+内存 | 未提供 ClassCode 时，在 rds_series.json 中按引擎+CPU+内存+系列匹配 | 无 |
| Category | 用户提供系列则用用户的，否则默认高可用系列 | HighAvailability |
| DBInstanceStorage | 用户提供则用用户的，否则默认 100GB | 100GB |
| DBInstanceStorageType | 用户提供则用用户的，ClassCode 路径下未提供时根据 JSON 的 storageType 推导（Local→local_ssd, Cloud→general_essd） | 动态推导 |

**规格匹配规则：**

1. **提供 ClassCode**：精确匹配 rds_series.json，校验 Engine、CPU/内存、category（系列）、storageType（存储类型）、ClassGroup（规格族）一致性。用户未提供 storageType 时根据 JSON 的 storageType 自动推导（Local→local_ssd, Cloud→general_essd）
2. **未提供 ClassCode 但提供 CPU+内存**：在 rds_series.json 中按引擎+CPU+内存+系列筛选：
   - 仅 1 条匹配 → 直接选用
   - 2 条匹配 → 优先选非 ARM 架构的；若非 ARM 有 2 条，且去掉字母 `e` 后 ClassCode 相同（如 `pg.n2.2c.1m` 和 `pg.n2e.2c.1m`），则选不带 `e` 的标准版（`pg.n2.2c.1m`）；否则要求人工确认
   - 3 条及以上 → 要求人工确认

**错误处理：**

| 场景 | 备注（红色字体） |
|------|------------------|
| 不支持的数据库类型 | 该数据库类型暂不支持 |
| ClassCode 不存在 | 提供的数据库规格不存在，请检查 |
| Engine 冲突 | 该数据库规格和提供的数据库类型冲突，请检查 |
| CPU/内存冲突 | 该数据库规格和提供的 CPU/内存配置冲突，请检查 |
| 系列冲突 | 该数据库规格和提供的产品系列冲突，请检查 |
| 存储类型冲突 | 该数据库规格和提供的存储类型冲突，请检查 |
| 规格族冲突 | 该数据库规格和提供的规格族冲突，请检查 |
| 集群系列 | 集群系列暂不自动报价，请人工确认 |
| 匹配不到规格 | 未找到匹配的规格，请检查配置 |
| 无 ClassCode 且无 CPU+内存 | 未提供实例规格或 CPU/内存配置 |
| MCP 询价失败 | MCP 询价失败，请检查配置或人工询价 |

**默认值规则：**
- 地域：杭州
- 数据库类型：MySQL
- 数据库版本：引擎对应的最高版本
- 存储：100GB
- 存储类型：CPU+内存路径默认高性能云盘；ClassCode 路径根据 JSON 的 storageType 推导（Local→高性能本地盘, Cloud→高性能云盘）
- 产品系列：高可用系列
- 集群系列不报价

**SQLServer 特殊处理：**
- rds_series.json 中 SQLServer 规格无 category 字段，通过 ClassCode 后缀判断系列
- `.e2` 后缀需结合 EngineVersion 判断：含"集群"/"cluster"为集群系列，否则为高可用系列
- 默认优先高可用系列

**MariaDB 特殊处理：**
- 仅支持高可用系列（HighAvailability），不提供其他系列
- 仅支持 ESSD PL1/PL2/PL3 云盘，默认 ESSD PL1（cloud_essd）
- 仅支持 10.3 和 10.6 两个版本，其他版本报错

**存储类型参考：**
- general_essd：高性能云盘
- local_ssd：高性能本地盘
- cloud_ssd：SSD 云盘
- cloud_essd：ESSD PL1 云盘
- cloud_essd2：ESSD PL2 云盘
- cloud_essd3：ESSD PL3 云盘

## OSS 统计场景判断

AI 需根据输入类型自动判断 OSS 统计场景：

| 输入 | 场景 | 说明 |
|------|------|------|
| AK + SK | 场景一 | 基于 AK 查询账号 OSS 资源，**含 ECS 快照** |
| `buckets_YYYYMMDD.csv` 文件 | 场景二 | 基于 CSV 文件统计，**不含 ECS 快照** |

### OSS 场景一：基于 AK 查询（含 ECS 快照）

```bash
venv/bin/python3 scripts/oss_quoter_auto.py <AK> <SK>
```

### OSS 场景二：基于 CSV 文件（不含 ECS 快照）

文件名匹配 `buckets_*.csv` 时，使用 CSV 场景：

```bash
venv/bin/python3 scripts/oss_csv_quoter_auto.py /path/to/buckets_YYYYMMDD.csv
```

两种场景共用同一个 Excel 模板（地域、存储类型、冗余类型、实际存储、计费存储），场景二不含 ECS 快照行。

## ECS 报价

### 场景一：标准 CSV 格式（直接报价）

文件名匹配 `ecs_instance_list_**_YYYY-MM-DD.csv` 时，直接报价：

```bash
venv/bin/python3 scripts/ecs_csv_quoter_auto.py /path/to/file.csv
```

**输出格式**：Excel 报价单共 10 列

| A | B | C | D | E | F | G | H | I | J |
|---|---|---|---|---|---|---|---|---|---|
| 产品名称 | **实例 ID** | 产品描述 | 地域 | 数量 | 1年目录价 | 1年折扣价 | 3年目录价 | 3年折扣价 | 备注 |

- B列"实例 ID"对应 CSV 文件中每行的 A 列（实例 ID）
- 从 B 列开始所有数据向右移动一列

## AI 执行指引（场景二必读）

当用户输入文字描述配置（而非 CSV 文件）时，AI 需要先**标准化**配置文本，再调用脚本。脚本的正则解析依赖标准格式，直接传入用户原文会导致数据丢失。

### 标准化步骤

1. **识别每台实例** — 按序号分割（1. / 2. / 3. ...）
2. **提取每项配置** — 地域、规格、镜像、系统盘、数据盘、带宽
3. **补全缺失字段** — 用户未明确提供的字段按「默认值规则」补全
4. **统一格式** — 按以下标准格式重组后传给脚本

### 标准输入格式

```
1. <地域> 实例规格：<规格代码> (<vCPU> vCPU <内存> GiB) 镜像：<镜像名称> 系统盘：<类型> <大小>GiB 数据盘：<类型> <大小>GiB 公网带宽：<计费方式> <大小>Mbps
2. ...
```

**⚠️ 关键规则（必须遵守）：**

| 用户提供的信息 | AI 标准化格式 | 脚本走哪个场景 |
|--------------|-------------|-------------|
| 用户明确给了规格代码（如 `ecs.g6.xlarge`） | `实例规格：ecs.g6.xlarge (4 vCPU 8 GiB)` | 场景1（精确匹配） |
| 用户给了规格族+核数内存（如 `u1，8核32G`） | `规格族：u1 (8 vCPU 32 GiB)` | 场景2（族内匹配） |
| **用户只给了几核几G**（如 `8核32G`） | **`配置：8 vCPU 32 GiB`** | **场景3（优先级自动匹配）** |

**绝对禁止：用户只给了几核几G时，AI 自行编造规格代码填入 `实例规格：ecs.xxx`！** 这会导致脚本走场景1并校验一致性，AI 填错了就会报价失败。场景3 的自动匹配优先级是 `u1 > u2i > c9i > g9i > r9i`，由脚本根据 `ecs_series.json` 自动匹配。

### 标准化示例

**用户输入（简写）：**
```
1、8 核 16G，80G，5Mbps
2、香港，4C8G，数据盘100G，3M
```

**AI 标准化后传给脚本：**
```
1. 华东1（杭州） 配置：8 vCPU 16 GiB 镜像：公共免费镜像 系统盘：ESSD PL0 80GiB 公网带宽：按固定带宽 5Mbps
2. 中国香港 配置：4 vCPU 8 GiB 镜像：公共免费镜像 系统盘：ESSD PL0 40GiB 数据盘：ESSD PL0 100GiB 公网带宽：按固定带宽 3Mbps
```

### 关键注意事项

⚠️ **收费镜像**：Windows 在中国香港及海外地域收费，内地免费。Red Hat / SUSE / Alibaba Cloud Linux 3 Pro 全球收费。遇到收费镜像需告知用户「不报价，需人工确认」。

⚠️ **地域**：每台实例可独立指定地域。用户未指定时默认杭州（cn-hangzhou）。**不要把某台实例的地域当成全局地域**。

⚠️ **磁盘**：用户只写大小没写类型 → 默认 ESSD PL0。只写一个大小 → 系统盘。写多个大小 → 最小的为系统盘，其余为数据盘。

⚠️ **带宽**：用户写了大小但没写计费方式 → ≤20Mbps 默认按固定带宽，≥21Mbps 默认按流量计费。

---

### 场景二：文本配置（非 CSV 格式的 ECS 报价）

适用场景：用户提供文字描述配置（如几台实例，每台实例的规格、磁盘、带宽等），而非标准 CSV 文件。

AI 按上述「AI 执行指引」标准化配置后，调用：

```bash
venv/bin/python3 scripts/ecs_text_quoter.py '<标准化后的配置文本>'
```

**输出格式**：Excel 报价单共 9 列

| A | B | C | D | E | F | G | H | I |
|---|---|---|---|---|---|---|---|---|
| 产品名称 | 产品描述 | 地域 | 数量 | 1年目录价 | 1年折扣价 | 3年目录价 | 3年折扣价 | 备注 |

- 无"实例 ID"列（与场景一不同）

#### 默认值规则表

| 配置项 | 默认值 | 判断条件 |
|--------|-------
````

## File: README.md
upstream: https://github.com/thechenv/aliyun-all-in-skill/blob/HEAD/README.md

````text
# 阿里云持续运营 Skill

基于阿里云 OpenAPI MCP Server 实现的持续运营/运维工具集，为 OpenClaw Agent 提供阿里云资源报价、统计、分析等能力。

## 目录结构

```
aliyun-all-in-skill/
├── SKILL.md                           # Skill 定义文件（OpenClaw 识别入口）
├── README.md                          # 本文档
├── .gitignore                         # Git 忽略配置
├── config/
│   └── config.json.example            # 配置文件模板（需复制为 config.json）
├── references/
│   ├── ecs_series.json                # ECS 规格数据（326 规格族，1902 规格）
│   └── rds_series.json                # RDS 规格数据
└── scripts/
    ├── setup.sh                       # 交互式初始化脚本
    ├── mcp_verify.sh                  # MCP 连通性校验脚本
    ├── ecs_csv_quoter_auto.py         # ECS 场景一：CSV 自动报价入口
    ├── ecs_csv_quoter.py              # ECS CSV 解析核心逻辑
    ├── ecs_text_quoter.py             # ECS 场景二：文本报价入口
    ├── ecs_spec_validator.py          # ECS 规格验证器
    ├── ecs_excel_generator.py         # ECS Excel 报价单生成器
    ├── ecs_constants.py               # ECS 公共常量定义
    ├── ecs_quoter.py                  # ECS 报价统一入口
    ├── rds_csv_quoter_auto.py         # RDS 场景一：CSV 自动报价入口
    ├── rds_csv_quoter.py              # RDS 报价核心逻辑（含 6 折优惠策略）
    ├── rds_text_quoter.py             # RDS 场景二：文本报价入口
    ├── rds_text_parser.py             # RDS 文本配置解析器
    ├── rds_spec_validator.py          # RDS 规格匹配验证器（含 e 字母自动选择规则）
    ├── rds_excel_generator.py         # RDS Excel 报价单生成器
    ├── rds_constants.py               # RDS 常量定义
    ├── mcp_client.py                  # MCP JSON-RPC 客户端
    ├── oss_stat.py                    # OSS 资源统计核心
    ├── oss_excel.py                   # OSS Excel 报告生成器（两种场景共用）
    ├── oss_quoter_auto.py             # OSS 场景一：AK 查询入口（含 ECS 快照）
    ├── oss_csv_quoter_auto.py         # OSS 场景二：CSV 统计入口（不含 ECS 快照）
    └── requirements.txt               # Python 依赖列表
```

## 文件说明

| 文件 | 功能 |
|------|------|
| `SKILL.md` | OpenClaw Skill 定义，包含触发条件、使用方式、参数说明 |
| `config/config.json` | MCP Endpoint、AK 凭证存储（需手动创建） |
| `references/ecs_series.json` | ECS 规格族数据，用于规格验证和推断 |
| `references/rds_series.json` | RDS 规格族数据，用于规格验证和推断 |
| `scripts/setup.sh` | 交互式引导用户完成环境初始化 |
| `scripts/mcp_verify.sh` | 校验 MCP 连通性，诊断配置问题 |
| `scripts/mcp_client.py` | MCP JSON-RPC 2.0 客户端封装 |
| `scripts/rds_text_quoter.py` | RDS 场景二：文本报价入口 |
| `scripts/rds_text_parser.py` | RDS 文本配置解析器（12 字段提取） |
| `scripts/rds_spec_validator.py` | RDS 规格验证器（含 e 字母自动选择） |

## 快速安装

### 1. 克隆仓库

```bash
cd ~/.openclaw/skills
git clone https://github.com/TheChenV/aliyun-all-in-skill.git
cd aliyun-all-in-skill
```

### 2. 运行初始化脚本

```bash
./scripts/setup.sh
```

脚本会交互式引导你完成：
- Python 虚拟环境安装
- 参数配置（MCP Endpoint、AK AccessKey ID/Secret）
- 生成配置文件

### 3. 参数获取方式

#### Streamable HTTP Endpoint

1. 登录阿里云控制台（管理员账号）
2. 访问 https://api.aliyun.com/mcp
3. 点击「获取 Endpoint」或复制显示的 Streamable HTTP Endpoint

格式示例：
```
https://openapi-mcp.<region>.aliyuncs.com/id/<your-id>/mcp
```

#### AccessKey (AK) 静态凭证

1. 请管理员账号前往 https://ram.console.aliyun.com/users
2. 找到对应的 RAM 用户，进入详情
3. 在「认证管理」标签页中点击「创建 AccessKey」
4. 保存 AccessKey ID 和 AccessKey Secret
5. 为该 RAM 用户授予 `AliyunOpenAPIMCPServerStaticCredentialAccess` 权限策略

### 4. 验证配置

```bash
./scripts/mcp_verify.sh
```

成功输出：
```
✅ MCP 连接成功！可用工具数量：XXX
```

失败会输出具体原因，按提示修复。

## 已完成功能

### ECS 报价

基于阿里云 ECS OpenAPI，支持多场景价格查询和 Excel 报价单生成。

**场景一：标准 CSV 格式自动报价**

文件名匹配 `ecs_instance_list_**_YYYY-MM-DD.csv` 时，直接报价，无需确认。

```bash
venv/bin/python3 scripts/ecs_csv_quoter_auto.py /path/to/file.csv
```

**场景二：文本配置报价**

用户提供的文本描述、非标准文件等，AI 先将用户描述转为标准格式，再传入脚本报价。

```bash
venv/bin/python3 scripts/ecs_text_quoter.py '配置内容' --region cn-hangzhou
```

**规格验证（3 种场景）**

| 场景 | 输入示例 | 验证方式 |
|------|---------|---------|
| 场景 1 | `ecs.g6.xlarge` | JSON 字典精确匹配 |
| 场景 2 | `c7 8 核 16G` | 规格族+CPU/内存匹配 |
| 场景 3 | `16 核 32G` | 默认优先级推断匹配 |

**场景 3 默认优先级**：`u1 > u2i > c9i > g9i > r9i`

**Excel 报价单标准格式输出**

**表格结构（9 列）**

| 列 | 标头 | 内容说明 |
|----|------|----------|
| A | 产品名称 | 固定为「ECS 云服务器」 |
| B | 产品描述 | 多行文本，含实例规格、镜像、系统盘、数据盘、公网带宽 |
| C | 地域 | 地域名称（如「杭州（cn-hangzhou）」） |
| D | 数量 | 固定为 1 |
| E | 官网目录价（元/1 年） | 1 年官网标准价 |
| F | 官网折扣价（元/1 年） | 1 年实际折扣价 |
| G | 官网目录价（元/3 年） | 3 年官网标准价 |
| H | 官网折扣价（元/3 年） | 3 年实际折扣价 |
| I | 备注 | 折扣规则说明 |

**产品描述格式示例**

```
实例规格：计算型 c7 / ecs.c7.2xlarge (8 vCPU 16 GiB)
镜像：CentOS 7.9 64 bit
系统盘：ESSD 云盘 PL0 500GiB
数据盘：ESSD 云盘 PL1 500GiB
公网带宽：按固定带宽 2Mbps
```

**表格附加行**

- 第一行：客户名称 + 报价日期
- 合计行：各价格列自动汇总
- 备注行：「产品价格可能有波动，以官网实际价格为准」（红色字体）

### RDS 报价

基于阿里云 RDS OpenAPI，支持 MySQL、PostgreSQL、SQLServer、MariaDB 四种数据库类型的价格查询。

**场景一：标准 CSV 格式自动报价**

文件名匹配 `rds_instance_list_**_YYYY-MM-DD.csv` 或 `rds_instance_list_**_YYYY 年 MM 月 DD 日.csv` 时，直接报价。

```bash
venv/bin/python3 scripts/rds_csv_quoter_auto.py /path/to/file.csv
```

**报价说明：**
- 支持 4 种数据库类型：MySQL、SQLServer、PostgreSQL、MariaDB
- 自动查询 1 年和 3 年价格
- 自动选择 1 年目录价最高的实例应用"新客首购 6 折优惠"（限 1 次，限 1 件）
- 输出 Excel 格式与 ECS 报价单一致

**价格字段映射：**

| 价格类型 | 数据路径 |
|---------|---------|
| 官网目录价（1 年/3 年） | `PriceInfo.OriginalPrice` |
| 官网折扣价（1 年/3 年） | `OrderLines[0].depreciateInfo.finalActivity.finalFee` |
| 优惠说明 | `OrderLines[0].depreciateInfo.finalActivity.activityName` |

**6 折优惠策略：**
- 筛选命中"新客首购云数据库 RDS 1 年享 6 折优惠"的实例
- 选择 1 年目录价最高的一台应用 6 折
- 其他命中 6 折但未被选中的实例使用 `standPrice` 并备注"1 年默认折扣价"

**Excel 报价单格式：**
- 产品名称：固定为"RDS"
- 产品描述：引擎、产品系列、存储类型、实例规格、存储空间
- 备注：1 年优惠说明 | 3 年优惠说明

**场景二：文本配置报价**

用户提供的文字描述配置（非 CSV 格式），AI 先将用户原文格式调整为脚本可解析的中文逗号分隔格式，再传入脚本报价。AI 只做格式调整，不补全任何字段。

```bash
venv/bin/python3 scripts/rds_text_quoter.py '<配置文本>'
```

**规格匹配（2 种流程）**

| 流程 | 输入 | 匹配方式 |
|------|------|----------|
| 流程 1 | 用户提供 ClassCode（如 mysql.n2.large.2c）| rds_series.json 精确匹配，校验 Engine/CPU/内存/系列/存储类型一致性 |
| 流程 2 | 用户提供 CPU+内存（如 4核8G）| 按引擎+CPU+内存+系列+storageType 筛选 → ClassGroup 优先级过滤 → 多候选自动决策 |

**流程 2 多候选决策规则：**
- 1 条 → 直接使用
- 2 条 → 优先选非 ARM 架构的；若非 ARM 有 2 条且去掉字母 "e" 后 ClassCode 相同（如 pg.n2.2c.1m vs pg.n2e.2c.1m），则选不带 "e" 的标准版；否则要求人工确认
- 3 条及以上 → 要求人工确认

**默认值规则：**

| 字段 | 默认值 |
|------|--------|
| 地域 | 杭州（cn-hangzhou） |
| 引擎 | MySQL |
| 引擎版本 | MySQL 8.0 / SQLServer 2022 / PostgreSQL 18.0 / MariaDB 10.6 |
| 产品系列 | 高可用系列 |
| 存储大小 | 100GB |
| storageType | Cloud（高性能云盘） |

### OSS 资源统计

分析 OSS Bucket 使用情况，生成统计报告。支持两种场景：

**场景一：基于 AK 查询（含 ECS 快照）**

通过 AccessKey 查询阿里云账号的 OSS 资源使用情况，额外包含 ECS 快照统计。

```bash
venv/bin/python3 scripts/oss_quoter_auto.py <AccessKey_ID> <AccessKey_Secret>
```

**场景二：基于 CSV 文件统计（不含 ECS 快照）**

文件名匹配 `buckets_*.csv` 时，基于阿里云控制台导出的标准 OSS 资源清单进行统计。

```bash
venv/bin/python3 scripts/oss_csv_quoter_auto.py /path/to/buckets_YYYYMMDD.csv
```

**两种场景共用同一个 Excel 模板**（地域、存储类型、冗余类型、实际存储大小、计费存储大小），区别是场景二不含 ECS 快照行。

**统计维度**

| 维度 | 内容 |
|------|------|
| 地域 | 按地域聚合（华东 1 杭州、华北 2 北京等） |
| 存储类型 | 标准/低频/归档/冷归档/深度冷归档 |
| 冗余类型 | 本地冗余 (LRS)/同城冗余 (ZRS) |
| 存储量 | 实际存储 + 计费存储 |

### 文件发送机制

脚本只负责生成 Excel 文件并输出路径（`FILE_PATH:xxx.xlsx`），文件发送由 AI（OpenClaw Agent）通过 `openclaw message send` 完成：

```bash
openclaw message send --channel <当前对话 channel> --target <当前对话 target> --media <文件路径>
```

这种设计确保 Skill 天然支持所有 channel（飞书、Telegram、WhatsApp、Discord 等），无需硬编码任何 channel 或账号信息。

## 依赖说明

### Python 依赖

| 包 | 版本 | 用途 |
|----|------|------|
| `openpyxl` | >=3.1.2 | Excel 文件生成 |
| `oss2` | >=2.19.0 | OSS SDK（可选，仅 OSS 场景一需要） |

### 系统要求

- Python 3.10+
- 操作系统：Linux / macOS / Windows
- 网络访问：阿里云 OpenAPI MCP Server

## 参考文档

- [阿里云 OpenAPI MCP Server 官方文档](https://help.aliyun.com/zh/openapi/integrating-openapi-mcp-server-into-agent)
- [ECS 实例规格族](https://help.aliyun.com/document_detail/25378.html)
- [OSS 产品文档](https://help.aliyun.com/document_detail/31817.html)
- [RDS 产品文档](https://help.aliyun.com/product/29597.html)

## 许可证

Apache-2.0 License

## 贡献

欢迎提交 Issue 和 Pull Request。
````
