qwencloud-usage

QwenCloud 使用说明

使用此技能处理账户认证、用量、账单、调用日志、配额、订阅、订单、席位和 PAYG 支出上限。绝不捏造或模拟账户数据。

工作流

1. 运行任何操作之前，先阅读 references/cli.md。这是有关安装、认证流程、命令、参数、分页、输出模式和退出处理的唯一信息来源。
2. 仅阅读与请求相关的结果语义参考：
   • 用量摘要、免费层、PAYG、模型明细或请求日志：references/usage.md
   • 账单周期、费用明细或支出上限：references/billing.md
   • 订阅状态、订单或席位：references/subscriptions.md
   • 登录、登出、凭据过期或认证事件：references/authentication.md
3. 对于精确查询 requestId，直接查询，不要添加 --from、--to 或 --period，也不要向用户询问日期。仅在用户明确提出要求时才添加时间筛选条件；请参阅 references/cli.md。
4. 按照下方的输出约定解读并展示结果。

输出约定

格式和呈现

遵循 CLI 参考中的输出模式规则。仅呈现与用户问题相关的易读信息，并将可选分析放在结果之后。

不要在面向用户的输出中展示 Coding Plan。即使 CLI 返回了 coding_plan、codingPlanStatus 及其子字段，也要将其省略，包括“未订阅”占位内容。

结果规则

• 将结果归类为 success、partial、empty、confirmation_required 或 error。
• 如果 Top-N 限制省略了行、分页尚未完成，或 CLI 参考中的完整性检查失败，则使用 partial；绝不要暗示数据完整。
• 对于 Free Tier，如果用户要求查看所有配额，请展示所有返回的模型。如果答案只展示了其中一部分，请说明已展示／模型总数，将结果标记为 partial，并附上 references/cli.md 中用于查看所有免费层配额的完整命令。不能用“可以查看更多”来代替该命令。
• 如果两个受支持的命令对看似同一条记录返回了冲突值，请展示每个值的来源和范围，并将结果标记为 partial。绝不要默默择一、合并数据或编造调和结果。

账单和订阅数据

• 使用操作返回的货币，绝不进行货币换算。仅对于账单周期摘要，展示其 pretaxAmount、tax 和 aftertaxAmount 值。
• 对于费用明细，仅展示返回的 rows[].amount、适用的平面响应级或切片级 totalAmount，以及 currency。对于订阅状态或订单，仅展示实际存在的金额和货币字段。绝不补造缺失的税前、税额、税后或货币字段。
• 在费用明细中，从模型排名中省略 groupKey=__tax__，并将该行返回的金额单独作为税额展示。
• 仅根据 seatSummary.groups[] 计算可用 Team 席位：对每个组使用 max(seats - assigned, 0)，然后求和。不要根据历史席位实例列表推算当前容量。
• 不要重新计算返回的日期或金额。验证响应，并遵循上述呈现规则。
• 展示账单或订阅数据时，始终附加：“最终金额以控制台账单为准。”

产品语义

• Token Plan 配额和余额使用十进制 Credits。对于剩余和总 Credits，无论 JSON 将其编码为数字还是数字字符串，都应保留返回的完整精度；切勿对其进行四舍五入、截断或缩写。例如，将 63028.84805624 显示为 63028.84805624，而不是 63,029。这适用于用量摘要、订阅配额、套餐档位、席位和 Credit 包；没有按模型划分的 Credit 明细。
• 消耗比较应使用同一配额范围内的精确值。四舍五入后的用量百分比为零，并不能证明没有消耗 Credits；不要根据四舍五入后的显示推断未使用状态或退款资格。
• Coding Plan 使用 per_5h、weekly 和 monthly 时间窗口内的请求总数；没有按模型划分的明细。未订阅时，其分支为 { "subscribed": false }。
• PAYG 仅提供总用量，不区分输入和输出。
• 按模型划分的明细仅适用于 PAYG。明细为零或为空，并不能说明 Free Tier、Token Plan 或 Coding Plan 的消耗情况。
• 用量摘要包含 period: { from, to } 和以下产品分支：
  • free_tier[]：包含 model_id，以及以下两者之一：quota: null 或 quota: { remaining, total, unit, used_pct, status, resetDate }。只有 status=valid 时才可用，并可计入可用配额总量。即使 remaining 为正数，也应将 expire 视为已过期，将 exhaust 视为已耗尽；状态未知或 quota: null 时，可用性未知。
  • token_plan：已订阅时包含 subscribed、planName、status、totalCredits、remainingCredits、usedPct 和 resetDate；否则至少为 { "subscribed": false }。存在 resetDate 时，它表示下一次 Credit 刷新日期；若缺失，则报告刷新日期未知。若订阅自动续费已关闭，请注明套餐会在此日期后过期。
  • coding_plan：已订阅时包含 subscribed、plan，以及包含 per_5h、weekly 和 monthly 的 windows，每项均包含 remaining、total 和 used_pct；否则为 { "subscribed": false }。
  • pay_as_you_go：包含 model_id、usage、cost 和 currency 的 models[] 条目，以及 total: { cost, currency }。