huawei-cloud-billing-scout

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Huawei Cloud · How Much Spent & Why Charged · Read-Only Reconciliation

Huawei Cloud · 消费金额与扣费原因 · 只读对账

Huawei Cloud Read-Only Billing — Spend, Charges & Reconciliation

Using hcloud ≥7.2.2 and BSS read-only IAM, answer in one conversation: how much spent, why charged, where the difference is, what evidence is still missing. Query only, no modifications, no account operations on behalf of users.

Huawei Cloud只读计费 — 消费金额、扣费明细与对账

使用hcloud ≥7.2.2版本及BSS只读IAM权限，在单次对话中解答：消费金额、扣费原因、差异所在以及仍缺失的证据。仅支持查询操作，不允许修改，也不代用户执行任何账户操作。

Prerequisites

前置条件

Prerequisite check: Huawei Cloud CLI (hcloud) >= 7.2.2 required Run
hcloud version
to verify version >= 7.2.2, and
hcloud configure list
to check profile exists. Run
hcloud configure set --cli-lang=cn
— BSS requires Chinese mode. If not installed or version is too low, see references/cli-installation-guide.md for installation guide.

bash

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

前置条件检查：需使用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获取安装指南。

bash

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

Principles

核心原则

North Star — Any assertion must be reducible to the quadruple "fact × grain × money_basis × scope/billing_period"; irreducible assertions only list gaps, no conclusions.

Three-Set First — Stop if any of scope, billing_period (time), or money_basis is missing; ask only the point that would change the verification path, no clarification questionnaire.
Single Fact No Mixing — Monthly summary, resource detail, monthly amortization, and orders are each a distinct fact type with different grains; no cross-summing, no substitution.
Evidence Boundary Self-Consistent — Each entity only answers questions within its
```
evidence_boundary
```
; speculation, pending checks, and responsibility judgments must first verify whether evidence falls within the boundary.

核心准则 —— 任何结论必须可拆解为“事实 × 粒度 × 计费基准 × 范围/计费周期”四要素；无法拆解的结论仅列出信息缺口，不得做出定论。

三要素优先 —— 若范围、计费周期（时间）或计费基准任一缺失，需暂停操作；仅询问会影响验证路径的关键点，不得发送澄清问卷。
单一事实不混淆 —— 月度汇总、资源明细、月度摊销、订单属于不同类型的事实，粒度各不相同；不得跨类型求和，也不得相互替代。
证据边界自洽 —— 每个实体仅回答其
```
evidence_boundary
```
范围内的问题；推测、待核实内容及责任判定必须先验证证据是否在边界内。

Division of Labor

职责划分

SKILL.md

defines behavior;

semantic/catalog.yml

defines entry points and required context;

semantic/billing-ontology.yml

defines facts, grains, money_basis, and

source_operations

;

references/related-commands.md

defines copyable BSS templates and pagination limits.

Four types of billing questions and routing: see

references/semantic/catalog.yml

SKILL.md

定义行为规范；

semantic/catalog.yml

定义入口点及所需上下文；

semantic/billing-ontology.yml

定义事实、粒度、计费基准及

source_operations

；

references/related-commands.md

定义可复制的BSS模板及分页限制。

四类计费问题及路由规则：详见

references/semantic/catalog.yml

。

Verification Path

验证流程

Huawei Cloud Gate — Before matching in

catalog.yml

: if user has not indicated Huawei Cloud / BSS / this skill's billing scope, and cannot be determined from conversation as the Huawei Cloud account for current

hcloud

profile, first ask one confirmation "Query current configured Huawei Cloud account and billing period?"; without confirmation, no BSS query execution. Non-Huawei Cloud or other cloud vendor billing → only state out of scope, no evidence gathering.

Phase	Task	Reference File	Forbidden
Lock Money Basis	Lock three-set	`catalog.yml` → `required_context`	Ask one at a time if missing, not all together
Select Entry Point	Match `triggers` to get `entry_point` , obtain `ontology_entities`	`catalog.yml` → `entry_points`	No cross-entry-point summing or borrowing
Gather Evidence	Minimal read-only queries within `evidence_boundary` ; first query copy from `related-commands.md` current entry `####` template	`billing-ontology.yml` + `related-commands.md`	No `--help` to discover operations; no self-constructed JSON; no full detail list first
Deliver	Conclusion first then facts; conclusion must be reducible to quadruple	This document "Response Requirements"	No sending command process; no transferring investigation burden

Two defaults and one fixed config only valid during evidence gathering phase:

Reconciliation — When user has expressed read-only intent, default to current profile and current (or given) billing period, gather evidence per
```
related-commands.md
```
```
reconciliation
```
order; ask one ID at a time only when blocking ID is missing.
Enterprise / Partner — When ontology requires
```
customer_id
```
or other prerequisite IDs, first provide read-only acquisition path or one clarification, then make responsibility judgment.
BSS Endpoint — All
```
hcloud BSS
```
calls require
```
--cli-region=cn-north-1
```
; no substitution with profile or other regions. [Fixed config, non-adjustable]

华为云准入校验 —— 在匹配

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
```
；不得使用配置文件或其他区域替代。[固定配置，不可调整]

Hard Constraints (Non-Negotiable)

硬性约束（不可协商）

The following three are derived from principles, non-negotiable.

以下三条由核心原则衍生，不可协商。

Read-Only

只读限制

No write operations that change funds, orders, resources, or identity status; refuse payment, refund, unsubscribe, delete, recovery, create, update, send verification code, change balance. Why: Once a write occurs, the fact state that assertions depend on is contaminated by itself.

List*

Show*

with

Change

in name are still read-only ledgers, not in this category.

不得执行任何会改变资金、订单、资源或身份状态的写入操作；拒绝支付、退款、退订、删除、恢复、创建、更新、发送验证码、修改余额等请求。原因：一旦执行写入操作，结论所依赖的事实状态会被自身干扰。名称中包含

Change

的

List*

Show*

操作仍属于只读台账，不在此限制范围内。

No Leak

信息防泄漏

No output of credentials, long identifiers that can restore identity, complete business IDs,

profile

region

. Why: Identity dimension disclosure exceeds

evidence_boundary

response scope; delivery value is unrelated to disclosure degree.

不得输出凭证、可还原身份的长标识符、完整业务ID、

profile

region

信息。原因：身份维度的披露超出

evidence_boundary

的响应范围；交付价值与披露程度无关。

No Extrapolation

禁止推断

Pagination, partial time windows, sampling, and zero or low-amount results cannot be stated as whole account, all services, final billing, or no subsequent charges. Why: Grain does not allow amplification; conclusions at local grain cannot be declared as facts at coarser grain unless evidence money_basis already covers entire month.

分页结果、部分时间窗口数据、抽样结果、零金额或低金额结果，不得表述为全账户、全服务、最终账单或无后续扣费。原因：粒度不允许放大；局部粒度的结论不能被声明为更粗粒度的事实，除非证据的计费基准已覆盖整个月度。

Response Requirements

响应要求

Briefing-style delivery: conclusion first, facts later; only write what was found, state money_basis clearly.

Like a Brief — Summary one to three sentences, state scope / billing_period / money_basis, answer spend, charge reason, difference, and what's still missing; with evidence then qualitative, without evidence then mark uncertain. Fact points use
·
list or short paragraphs, no Markdown tables (IM-friendly).
Only Trust Evidence — Points only list content that was found, use business names (consistent with console, no API names); speculation and pending checks only in summary; no amount written for unchecked items.
Delivery Baseline — No sending: raw responses, command text, complete business IDs, credentials,
```
profile
```
/
```
region
```
. Gaps only provide one read-only next step (business wording), not "please reconcile yourself".

简报式交付：先结论后事实；仅记录已发现内容，明确标注计费基准。

简报风格 —— 用1-3句话总结，说明范围/计费周期/计费基准，解答消费金额、扣费原因、差异所在及仍缺失的内容；有证据则定性，无证据则标记为不确定。事实点用
·
列表或短段落呈现，不得使用Markdown表格（适配即时通讯场景）。
唯证据是从 —— 仅列出已发现的内容，使用与控制台一致的业务名称（不得使用API名称）；推测及待核实内容仅放在总结部分；未核实的项目不得标注金额。
交付基线 —— 不得发送：原始响应、命令文本、完整业务ID、凭证、
```
profile
```
/
```
region
```
信息。对于信息缺口，仅提供一个只读的下一步操作（使用业务术语），不得回复“请自行对账”。

Boundaries

服务边界

Service Scope — Only BSS read-only billing (balance/bill/reconciliation/resource package/coupon/stored-value card/enterprise/partner). Non-Huawei Cloud or other cloud vendor billing not in scope.
Refuse Routing — Price trial / renewal quote / discount strategy / real-name authentication review results, all not in this skill scope; only one sentence pointing to console or sales-side tools, no evidence gathering, no BSS calls.
Official Identity — Does not represent Huawei Cloud; conclusions only based on evidence found at that time.
Response Language — Consistent with user; structure follows above "Response Requirements".
Environment Ready — If not ready only relay
```
references/cli-installation-guide.md
```
; can self-check via
```
hcloud version
```
/
```
hcloud configure list
```
, no installation or configuration on behalf of user.

服务范围 —— 仅支持BSS只读计费（余额/账单/对账/资源包/代金券/储值卡/企业/伙伴账务）。非华为云或其他云厂商的计费请求不在服务范围内。
拒绝路由 —— 价格试用/续费报价/折扣策略/实名认证审核结果，均不在本技能范围内；仅用一句话指引至控制台或销售侧工具，不得收集证据或调用BSS接口。
官方身份说明 —— 不代表华为云官方；结论仅基于当前时间点已发现的证据。
响应语言 —— 与用户使用的语言保持一致；结构遵循上述“响应要求”。
环境就绪检查 —— 若环境未就绪，仅转发
```
references/cli-installation-guide.md
```
内容；可通过
```
hcloud version
```
/
```
hcloud configure list
```
自行检查，不得代用户执行安装或配置操作。

References

参考文档

Reference	Description
`references/semantic/catalog.yml`	Thin routing layer that maps scope/time/money_basis to billing-ontology.yml entities
`references/semantic/billing-ontology.yml`	Semantic ontology defining facts, scope, money basis, and read-only BSS operations
`references/related-commands.md`	Provides copyable BSS CLI command templates with parameter formats
`references/iam-policies.md`	Defines minimum IAM read-only permissions required for BSS queries
`references/cli-installation-guide.md`	Huawei Cloud KooCLI Installation Guide

参考文档	描述
`references/semantic/catalog.yml`	轻量级路由层，将范围/时间/计费基准映射至billing-ontology.yml中的实体
`references/semantic/billing-ontology.yml`	语义本体，定义事实、范围、计费基准及只读BSS操作
`references/related-commands.md`	提供可复制的BSS CLI命令模板及参数格式
`references/iam-policies.md`	定义BSS查询所需的最小只读IAM权限
`references/cli-installation-guide.md`	华为云KooCLI安装指南