huawei-cloud-billing-scout

华为云 · 费用多少及收费原因 · 只读对账

华为云只读账单 — 支出、费用与对账

使用 hcloud ≥7.2.2 和 BSS 只读 IAM 权限，在一次对话中回答：支出了多少、为何收费、差异在哪里、还缺少哪些证据。仅查询，不做任何修改，也不代用户执行账户操作。

前置条件

前置条件检查：需要 Huawei Cloud CLI (hcloud) >= 7.2.2 运行 hcloud version 验证版本 >= 7.2.2，并运行 hcloud configure list 检查配置档是否存在。 运行 hcloud configure set --cli-lang=cn — BSS 要求使用中文模式。 如果尚未安装或版本过低，请参阅 references/cli-installation-guide.md 中的安装指南。

hcloud version
hcloud configure list
hcloud configure set --cli-lang=cn

原则

北极星原则 — 任何断言都必须能还原为四元组“事实 × 粒度 × 金额口径 × 范围/计费周期”；无法还原的断言只能列出缺口，不得下结论。

• 先明确三项 — 如果范围、billing_period（时间）或 money_basis 任一缺失，就停止；只询问会改变核验路径的信息，不发起澄清问卷。
• 单一事实不混用 — 月度汇总、资源明细、月度分摊和订单分别属于不同事实类型，粒度各异；不得跨项求和或相互替代。
• 证据边界内自洽 — 每个实体只能回答其 evidence_boundary 范围内的问题；推测、待核查事项和责任判断必须先确认相关证据是否在边界内。

分工

SKILL.md 定义行为；semantic/catalog.yml 定义入口和所需上下文；semantic/billing-ontology.yml 定义事实、粒度、money_basis 和 source_operations；references/related-commands.md 定义可复制的 BSS 模板和分页限制。

四类账单问题及路由方式：参见 references/semantic/catalog.yml。

核验路径

华为云关卡 — 在 catalog.yml 中匹配之前：如果用户没有表明查询范围是华为云、BSS 或本技能的账单范围，且无法从对话中判断当前 hcloud 配置档对应华为云账户，先询问一次确认：“查询当前配置的华为云账户和计费周期吗？”未经确认，不执行 BSS 查询。非华为云或其他云厂商的账单 → 仅说明超出范围，不收集证据。

阶段	任务	参考文件	禁止事项
锁定金额口径	明确三项	catalog.yml → required_context	缺少时逐项询问，不要一次全部询问
选择入口	匹配 triggers 获取 entry_point，并获取 ontology_entities	catalog.yml → entry_points	不得跨入口求和或借用信息
收集证据	在 evidence_boundary 范围内执行最少量只读查询；第一个查询须复制 related-commands.md 当前入口的 #### 模板	billing-ontology.yml + related-commands.md	不得通过 --help 探索操作；不得自行构造 JSON；不得先获取完整明细列表
交付结果	先给结论，再列事实；结论必须能还原为四元组	本文档“答复要求”	不得发送命令执行过程；不得转移调查责任

以下两个默认项和一个固定配置仅在收集证据阶段有效：

• 对账 — 用户已表达只读意图时，默认使用当前配置档和当前（或指定的）计费周期，并按 related-commands.md 中 reconciliation 的顺序收集证据；仅在缺少阻塞流程的 ID 时，一次询问一个 ID。
• 企业/合作伙伴 — 本体要求 customer_id 或其他前置 ID 时，先提供只读获取路径或提出一个澄清问题，再判断责任。
• BSS 端点 — 所有 hcloud BSS 调用都必须使用 --cli-region=cn-north-1；不得替换为配置档指定区域或其他区域。[固定配置，不可调整]

硬性约束（不可妥协）

以下三项源自原则，不可妥协。

只读

禁止执行会更改资金、订单、资源或身份状态的写操作；拒绝付款、退款、取消订阅、删除、恢复、创建、更新、发送验证码、更改余额。 原因：一旦发生写操作，断言所依赖的事实状态就会受到其自身污染。名称中带有 Change 的 List*/Show* 仍是只读账本，不属于此类。

不泄露

不得输出凭证、可恢复身份的长标识符、完整业务 ID、profile / region。 原因：披露身份维度超出了 evidence_boundary 响应范围；交付价值与披露程度无关。

不外推

不得将分页、部分时间窗口、抽样以及零金额或低金额结果表述为整个账户、所有服务、最终账单或后续不会再产生费用。 原因：粒度不允许放大；除非证据中的 money_basis 已涵盖整个月，否则不能将局部粒度的结论视为更粗粒度的事实。

响应要求

简报式交付：先给结论，再给事实；只写已查明的内容，并明确说明 money_basis。

• 简报式 — 摘要为 1 到 3 句话，说明范围、billing_period 和 money_basis，回答支出、收费原因、差额以及仍缺少的信息；有证据时再定性说明，没有证据时则标注为不确定。事实要点使用 · 列表或简短段落，不使用 Markdown 表格（方便即时通讯）。
• 仅依据证据 — 要点只列出已查明的内容，使用业务名称（与控制台一致，不使用 API 名称）；推测和待检查事项仅放在摘要中；对未检查的项目不写金额。
• 交付基线 — 不发送原始响应、命令文本、完整业务 ID、凭证、profile / region。存在信息缺口时，只提供一个只读后续步骤（使用业务表述），不要说“请自行核对”。

范围边界

• 服务范围 — 仅限 BSS 只读账单（余额/账单/对账/资源包/优惠券/储值卡/企业/合作伙伴）。不包括华为云以外的平台或其他云厂商的账单。
• 拒绝转接 — 价格试算/续费报价/折扣策略/实名认证审核结果均不属于此技能范围；只能用一句话指引用户前往控制台或销售侧工具，不得收集证据，也不得调用 BSS。
• 官方身份 — 不代表华为云；结论仅基于当时查到的证据。
• 响应语言 — 与用户使用的语言一致；结构遵循上述“响应要求”。
• 环境就绪 — 如果环境尚未就绪，只转述 references/cli-installation-guide.md；可通过 hcloud version / hcloud configure list 自检，不得代替用户安装或配置。

参考资料

参考资料	说明
references/semantic/catalog.yml	精简路由层，将范围/时间/money_basis 映射到 billing-ontology.yml 中的实体
references/semantic/billing-ontology.yml	语义本体，定义事实、范围、money_basis 以及只读 BSS 操作
references/related-commands.md	提供带参数格式的可复制 BSS CLI 命令模板
references/iam-policies.md	定义 BSS 查询所需的最低 IAM 只读权限
references/cli-installation-guide.md	华为云 KooCLI 安装指南