SuperAPI AI 工具集

kuroco-api-performance-review

部署与运维

查看项目

更新于 10-15 21:10

技能介绍

用途:调查 Kuroco 站点的 API 性能与成本,找出费用集中在哪些费目、哪些接口慢或未被缓存,并围绕缓存设定给出按性价比排序的改善报告。调查以缓存为核心:Kuroco 按量计费中请求数占主导,缓存 HIT 与否单价可差一个数量级,因此对策基本只有“减少请求”和“提高缓存比率”两类。本技能只做调查与提案,设定变更需用户批准,原则上引导在管理后台操作。

主要能力与工具:usage-get 取月/日成本与用量;api_analytics-list 取接口维度聚合(次数、平均耗时、平均响应大小,单次最多35天);api_log-list 取原始日志(仅最近12小时,每5秒每成员限一次);api-list 取 API 定义;api_uri-list 取接口定义与最近8天用量及缓存设置(需 api_id);front/img/edge_log-list 用于拆分流量。

必要用法:先连接 Admin MCP(只读可用 x/all/readonly 或 mcp:tools.read,需 site、logs、rcms_api 模块),调用前用 tools/list 确认工具与参数。标准流程为:usage-get 掌握成本结构(注意区分 cost_site 与 cost_all_sites),由金额与用量逆算单价;api_analytics-list 做接口聚合并与同期比较找异常;api_uri-list 对照缓存设定(maxage、cache_by_group)与最近实绩,区分“未设 TTL”与“设了但未命中”;必要时用 api_log-list 抽样验证;最后按症状定位原因并汇总对策。

限制:日志仅回溯12小时且有限流;api_analytics-list 单次最多35天;usage-get 不能指定 site_id;返回值为格式化字符串,过滤排序需用原始数值。缓存期(maxage)无法经 MCP 修改,需在管理后台操作;CORS 与安全方式变更、CDN 缓存清除等需批准,调查阶段不应执行。单价应基于 usage-get 实绩逆算,并注明非官方价目表抄录。未提供的具体价格、套餐与效果数据暂未说明。