核心用法
该 Skill 用于查询华为云租户下的虚拟私有云（VPC）列表，是一款纯只读的网络资产盘点工具。用户可通过自然语言触发查询，如“列出我的 VPC”“查询 VPC 列表”等。Skill 优先调用华为云官方 KooCLI 的 hcloud VPC ListVpcs/v3 命令，失败时自动回退至 huaweicloudsdkvpc Python SDK。
支持的核心功能包括：
- 基础查询：列出当前项目下所有 VPC 及其元数据（ID、名称、CIDR、状态、描述、企业项目）
- 多维度过滤：按 VPC 名称、ID、CIDR 网段、企业项目 ID 精准筛选
- 跨项目查询：支持
all_granted_eps参数遍历所有授权企业项目 - 分页控制：通过
limit和marker参数处理大规模 VPC 列表 - 版本兼容：v3 为主推荐版本，v2 为兼容性备选
典型使用场景
1. 网络资产盘点：运维人员定期审计租户 VPC 分布与配置
2. 网段规划辅助：创建新 VPC/子网前，验证现有 CIDR 占用情况
3. 故障定位：通过名称或 ID 快速定位特定 VPC 并检查状态
4. 企业项目合规审计：按企业项目维度统计资源归属
显著优点
| 优势维度 | 具体说明 |
|---------|---------|
| **官方工具链** | 基于华为云官方 KooCLI 和 Python SDK，API 调用合规、稳定可靠 |
| **零风险只读** | 严格限定为查询操作，无创建、修改、删除权限，从根本上避免误操作 |
| **多版本容错** | CLI 与 SDK 双通道回退机制，单点故障时自动降级保障可用性 |
| **灵活过滤** | 支持数组式过滤参数（`--name.1` `--cidr.1`），满足复杂查询需求 |
| **企业级特性** | 原生支持华为云企业项目（Enterprise Project）隔离模型 |
| **中文友好** | 内置中文触发词（"查询VPC列表""租户VPC列表"等），贴合国内用户习惯 |
潜在缺点与局限性
1. 能力边界严格受限：仅支持 VPC 列表查询，无法获取子网、安全组、路由表、NAT 网关等关联资源信息。用户若需完整网络拓扑，需配合其他 Skill 或控制台操作。
2. 依赖预置认证：必须提前完成 KooCLI 配置（hcloud configure）或 SDK 的 AK/SK 设置，无法自主完成身份认证流程。
3. 权限粒度较粗：需要 vpc:vpc:list IAM 权限，若用户仅有只读权限但缺少该特定权限，查询将失败。
4. 区域隔离限制：单次查询仅能针对一个 Region（通过 --cli-region 指定），跨 Region 资产盘点需循环调用。
5. 输出格式固定：虽支持 --cli-output=json，但字段解析与可视化需用户自行处理，无内置表格美化或导出功能。
适合的目标群体
- 云运维工程师：日常网络资产巡检、合规审计
- 云架构师：VPC 规划前的现状调研与网段冲突排查
- DevOps 团队：基础设施即代码（IaC）实施前的存量资源摸底
- 安全合规人员：企业项目维度的资源归属核查
- 华为云租户管理员：多项目环境下的网络资源统筹管理
使用风险与注意事项
| 风险类型 | 说明与建议 |
|---------|-----------|
| **性能风险** | 单租户 VPC 数量过多（数千级）时，全量查询可能超时。建议配合 `limit`/`marker` 分页，或添加过滤条件缩小范围 |
| **认证失效风险** | AK/SK 过期或 IAM 权限变更会导致查询中断。建议定期检查 `hcloud configure list` 状态 |
| **数据时效性** | 查询结果为调用时刻的快照，非实时流式数据。高频场景下需注意缓存与一致性 |
| **SDK 依赖风险** | Python SDK 回退路径依赖 `huaweicloudsdkvpc` 包，环境缺失时将完全不可用。建议在关键生产环境预装依赖 |
| **误过滤风险** | 数组过滤参数（`--name.1`）语法错误会导致过滤失效或 API 报错，需严格遵循 `--key.N=value` 格式 |
> 重要提示：本 Skill 明确声明不包含子网、安全组、路由表等资源的查询能力。若用户询问此类需求，应主动澄清边界并引导至 appropriate 工具或控制台。