gmncode-usage

# GMNCODE Usage 使用本技能自带脚本，通过可用的 dashboard HTTP 接口查询 GMNCODE 用量数据。 ## 快速开始 1. 先确保凭据已经通过环境变量或 `~/.openclaw/.env` 提供。 2. 优先运行 `scripts/gmncode_usage.py`，不要每次都重新手写登录、token 缓存和重试逻辑。 3. 常用命令： - `python3 scripts/gmncode_usage.py brief` 查询你最常要的那组指标：**账户每日额度 + 今日模型用量** - `python3 scripts/gmncode_usage.py quota` 只看账户每日额度 - `python3 scripts/gmncode_usage.py report --date today` - `python3 scripts/gmncode_usage.py report --date 2026-03-25` - `python3 scripts/gmncode_usage.py report --start 2026-03-01 --end 2026-03-26` - `python3 scripts/gmncode_usage.py models --date 2026-03-25 --json` - `python3 scripts/gmncode_usage.py trend --start 2026-03-01 --end 2026-03-26 --json` ## 工作流 ### 1. 安全加载凭据 不要把邮箱和密码硬编码进临时脚本、回复内容或日志里。 优先使用： - `GMNCODE_EMAIL` - `GMNCODE_PASSWORD` `GMNCODE_BASE_URL` 已固定写死为 `https://gmncode.cn`，因为这不是敏感信息，不需要放进环境变量。 如果缺少凭据，就停止执行，并提示用户补充到 `~/.openclaw/.env`。 ### 2. 复用内置客户端 脚本已经处理好了： - 通过 `/api/v1/auth/login` 登录 - access token 本地缓存 - 遇到 `401` / `INVALID_TOKEN` 时自动重新登录并重试一次 - dashboard 所需的 referer / headers 除非 HTTP 接口失效，否则不要退回浏览器自动化方案。 ### 3. 使用正确接口 使用以下接口： - `/api/v1/subscriptions?status=active` - `/api/v1/usage/dashboard/stats` - `/api/v1/usage/dashboard/trend` - `/api/v1/usage/dashboard/models` 请求参数统一传： - `start_date=YYYY-MM-DD` - `end_date=YYYY-MM-DD` - `timezone=Asia/Shanghai` 不要用 `/api/v1/admin/dashboard/*`，普通用户 token 会返回 `403 FORBIDDEN`。 ### 4. 按指标口径取值 如果用户要的是这组固定指标，按下面口径取： #### A. 账户每日使用额度 从 `/api/v1/subscriptions?status=active` 读取所有活跃订阅： - **每日使用额度** = `sum(group.daily_limit_usd)` - **今日已用** = `sum(daily_usage_usd)` - **今日剩余** = 每日使用额度 - 今日已用 #### B. 今日模型用量 从 `/api/v1/usage/dashboard/models` 读取指定日期： - 模型名：`model` - token 用量：`total_tokens` - 实际金额：`actual_cost` 默认把 token 格式化成 `x.x M` / `x.xx B` 这种紧凑写法。 ## 输出建议 如果用户只想看固定口径，优先给两块： 1. **账户额度**：每日使用额度 / 今日已用 / 今日剩余 2. **今日模型使用**：模型名 / token 用量 / 实际金额 如果用户要更完整的汇报，再补： - `stats` 的汇总数据 - `trend` 的每日趋势 - 当查询区间为单日时，补 `models` 的按模型拆分 默认使用紧凑表格或短列表，避免冗长描述。 ## 资源 ### scripts/ - `scripts/gmncode_usage.py`：安全的 HTTP 客户端与 CLI，负责登录、stats、trend、models 查询。 ### references/ - `references/api.md`：接口说明、安全约定、凭据存储方式与字段解释。