用途:本技能定位为购买华为云服务时的优惠方案咨询助手。当用户准备购买华为云服务、想了解有哪些代金券或折扣可用时,它通过已授权账号读取代金券数据,判断能否抵扣目标服务费用,并在余额不足时给出替代或组合付款建议。它不直接下单,也不查询账单或用量明细。
主要能力:包括代金券余额与明细查询(面额、有效期、状态);判断余额是否足够购买目标服务(充足/部分/不足);余额不足时推荐低规格服务或「代金券+现金」组合;查询代金券适用的云服务及抵扣规则;查询成长中心公开任务列表(匿名可用,含 LIMIT/DAILY/WEEKLY/MONTHLY 周期类型),并按积分收益推荐优先任务。
使用方式:主入口为 scripts/voucher_assistant.py,按 action 分发。查询类命令如 python scripts/voucher_assistant.py list_vouchers、list_tasks、recommend_tasks、list_voucher_applicable_services 为只读自动执行。分析类如 python scripts/voucher_assistant.py analyze_voucher_coverage --balance 100 --price 80 与 python scripts/voucher_assistant.py recommend_discount_plan --balance 50 --price 80 --alt "ecs:c7.large.2:40" 可离线运行。管理类 apply_voucher --order-ref <ref> --amount <amt> --confirm 需显式确认,未接数据源或缺 --confirm 时仅输出预览。
前置条件:Python 3.6+(纯标准库,零第三方依赖);需网络访问 bss.myhuaweicloud.com 与 devdata.huaweicloud.com;代金券查询需华为云 AK/SK(环境变量 HW_ACCESS_KEY/HW_SECRET_KEY 或 HUAWEICLOUD_SDK_AK/HUAWEICLOUD_SDK_SK),可选 HW_DOMAIN_ID;任务列表为匿名查询,零配置可用。
数据源与限制:代金券数据来自 BSS 开放 API(SDK-HMAC-SHA256 签名 + X-Domain-Id 头),适用服务列表由本地知识库 references/voucher-taxonomy.md 提供;代金券实际抵扣依赖 BSS 订单系统。未配置 AK/SK 时代金券查询返回配置提示,任务列表始终可用;匿名任务列表仅含公开字段,不含个人完成状态与积分余额。所有 hcloud 命令经 skill-quality-cli 包装上报遥测,可设置 SKILL_QUALITY_REPORT=0 关闭。