# rc-balance-query

> 查询 Right.codes（right.codes / right codes / rc）账户余额与套餐用量。

- Author: nightwhite
- Repository: nightwhite/rc-balance-query
- Version: 20260124184423
- Stars: 5
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/nightwhite/rc-balance-query
- Web: https://mule.run/skillshub/@@nightwhite/rc-balance-query~rc-balance-query:20260124184423

---

---
name: rc-balance-query
description: 查询 Right.codes（right.codes / right codes / rc）账户余额与套餐用量。
---

# rc-balance-query

## 用法

- **Skill 负责“生成回复”**：执行脚本 → 拿到查询结果 → 结合规则总结给用户（中文摘要 + 判断 + 情绪价值）。
- **不要通过修改脚本来改文案**：脚本只负责取数；所有“提醒/夸夸/续费”等都在本 `SKILL.md` 里处理。

## 命令

不需要查看或修改脚本内容，只需运行脚本即可：

macOS / Linux（bash）：
```bash
./scripts/rc_balance_query.sh
```

Windows（PowerShell）：
```powershell
powershell -ExecutionPolicy Bypass -File "./scripts/rc_balance_query.ps1"
```

## 注意事项

- 不要打印或记录 API Key。
- 如果返回状态不是 200，按实际报错内容（HTTP 状态码 + 返回的 message）简要说明原因并给出下一步。
- 回复里“到期时间”一律换算为东八区（UTC+8，北京时间）。
- 查询结果里面的金额，单位都是“美元”（USD）。

## Skill 工作流（必须按这个来）

1) **执行脚本拿到原始 JSON**（脚本默认只输出 JSON）。  
2) 若脚本返回非 0：不要猜测；直接用简短中文说明失败原因（HTTP 状态码 + message / curl 错误），并给出下一步（检查网络 / 检查 Key / 稍后重试）。  
3) 解析 JSON，提取并展示这些字段（若缺失显示 `N/A`）：  
   - `balance`（余额，USD）  
   - `subscriptions[0].name`（套餐名）  
   - `subscription.used_quota / total_quota / remaining_quota`（用量）  
   - `subscriptions[0].expired_at`（到期时间，统一换算 `UTC+8`）  
   - `subscriptions[0].reset_today`（今日是否已重置）  
4) 生成回复：**先输出“标准信息”**，再按规则追加 **一行 `小贴士`**（可合并多条提醒/夸夸，但保持一行即可）。

## 输出规则（情绪价值 + 判断）

在正常信息（余额/套餐/用量/到期/今日重置）后，按需追加 `小贴士`（一行即可，可合并多条）：

- **防浪费提醒（每日）**：若 `reset_today == false` 且 `remaining_quota > 0`，提示“建议在 **24:00（UTC+8）前**用一用，别浪费今天的额度”。
- **快用完夸夸**：若 `remaining_quota / total_quota <= 10%`（或剩余很少），夸用户效率高、快收尾了。
- **已用完表扬**：若 `remaining_quota <= 0`，表扬“今日额度已用完 / 很自律 / 输出拉满”，并提示等重置后继续。
- **到期/续费提醒**：若套餐 `expired_at` 距现在（UTC+8）≤ 72 小时，提醒“快到期记得续费哦”；若已过期，提醒“已到期请续费”。

## 回复模板（Markdown “颜色”版）

> 纯 Markdown 没有通用的“文字颜色”语法；这里用 🟢/🔴 作为跨平台最稳定的“颜色”表现。

- Right.codes 余额：🟢 **`xx.xx`**
- 套餐：`套餐名`
- 用量：已用 `x` / 总 `y`（剩余 `z`）
- 到期：`YYYY-MM-DD HH:mm:ss UTC+8`
- 今日重置：🟢 **否**（未重置） / 🔴 **是**（已重置）
- 小贴士：（按“输出规则”自动生成，可为空）