| name | maas |
| description | 七牛云 MaaS 平台管理助手，提供 API Key 管理、用量日志查询等平台运营能力， 并给出标准的需求处理流程（SOP）。 |
| type | tool |
| best_for | ["查询请求日志：按时间/模型/API Key/状态码过滤，获取总量或明细列表","用量统计：按天/小时粒度查询 Token 消耗，按模型分组","API Key 管理：创建、改名、启用/禁用、设限额、删除","生成面板或报表：可用性概览、Token 消耗趋势、Key 配额使用率","生成集成脚本：告警轮询、用量巡检"] |
total（汇总）或取 items（明细）day / hour 等粒度查询 Token 消耗，可按模型分组使用任何接口前，必须先明确凭证类型并严格隔离使用。
MaaS 平台涉及两类相互独立的凭证，混用会导致严重的权限泄露风险：
| 凭证类型 | 形态 | 用途 | 鉴权头格式 | 泄露影响 |
|---|---|---|---|---|
| 平台管理凭证（AK/SK） | AK + SK 两段字符串 | 调用平台管理接口：日志查询、用量统计、Key 管理 | Authorization: Qiniu AK:sig | 可创建/删除所有 Key、读取全量日志用量，极高风险 |
| 模型调用 API Key（sk-xxx） | sk- 开头的单段字符串 | 业务代码调用 AI 模型（OpenAI 兼容接口） | Authorization: Bearer sk-xxx | 仅消耗配额，可通过限额控制，风险可控 |
强制隔离原则：
AK/SK 签名算法详见 references/aksk-token.md，接口完整定义见 references/openapi.json。
以下步骤适用于所有用户需求，必须按顺序执行，不得跳步。
将用户需求对应到上方"提供的能力"中的一项或多项：
若意图不明确，直接询问用户目标，不要猜测并随意调用接口。
缺什么问什么，不要假设后直接执行（时间范围等有明确默认值的除外）：
查询类
管理类（写操作）
429：限流 → 检查该 Key 的配额设置或并发数5xx：服务端错误 → 记录 request_id 上报支持4xx：客户端参数错误 → 查看 errors 字段描述Resolve intent into Qiniu Miku Live management API action keys, validate parameter placement against the API catalog, and execute signed requests safely.
Fetch and extract concrete web page URLs through Qiniu xfetch. Prefer Qiniu's path-style fetch API for markdown, JSON, or raw HTML extraction before other page-fetch methods.
帮助开发者创建、配置和发布七牛 AppMarket 云应用。当用户需要创建应用、发布版本、制作自定义镜像（含 VM 管理）、生成 DeployMeta、编写或测试 Terraform 模块时使用。
Operate Qiniu Cloud KODO object storage via qshell CLI. Covers file CRUD, batch operations, CDN refresh/prefetch, data processing, file sharing, M3U8 operations, and sandbox management.