skills/mercury-api.wepieoa.com/fetch-game-config-clean

fetch-game-config-clean

SKILL.md

查询后台配置数据(Clean 版本)

与 fetch-game-config 的区别:当 namespace=activity 时,自动去除 ui_all_act_pagesui_meta 字段,减少输出噪音。

Region 区服对照表

代号 区服 代号 区服
C 华语服 K 韩服
T 泰服 A 阿语服
M 马来服 Q 土语服
P 菲律宾服 O Jackaroo
V 越南服 G 德语服
U 美服 I 印度服
B 葡语服 N 巴基斯坦服
S 西语服 R 俄语服
HW 会玩 J 日服
Y 意大利服 F 法语服

Namespace 常用命名空间

namespace 说明
activity 活动配置(自动去除 ui_all_act_pages、ui_meta)
activity_config 活动特殊配置(含礼物返金)
blindbox_config 盲盒配置
gift_box 礼盒配置
gift_pkg 礼包配置
gift 礼物配置(key 为礼物ID)
prop 道具配置(key 为道具ID)

使用方式

用户提供三个参数:

参数 说明 示例
namespace 配置命名空间(见上表) activity, gift_box
region 区服代号(单字母,不区分大小写,见上表) C, T, M
key 配置键名 blind_box_9901

环境说明

环境 域名 参数
WePlay 线上(默认) config-admin-api.weplayapp.com --env prod
WePlay 测试服 config-admin-dev-api.weplayapp.com --env dev
会玩线上(region=HW config-admin-api-new.wepieoa.com --env prod
会玩测试服(region=HW config-admin-dev-api-new.wepieoa.com --env dev

AI 自动判断环境规则:

  • 用户提到「测试」「dev」「test」「测试服」「测试环境」→ 使用 --env dev
  • 用户提到「线上」「prod」「生产」「正式」→ 使用 --env prod
  • 用户未提及环境 → 默认使用 --env prod(线上)

执行步骤

  1. 确认用户提供了 namespace、region、key 三个参数,缺少时主动询问;region 必须是以下值之一(不区分大小写):C T M P V K J U B S Y R A Q O G I N HW
  2. 根据上方规则判断环境,运行脚本:
python <当前skill目录>/scripts/fetch_config.py \
  --namespace <namespace> \
  --region <region> \
  --key <key> \
  --env <prod|dev> \
  --pretty
  • <当前skill目录> 替换为本机实际安装的 fetch-game-config-clean skill 目录。
  • 不要写死 ~/.claude/skills/.../Users/... 等安装者本地路径。
  1. 将返回的 JSON 数据展示给用户,并根据场景做必要的解读

二次下钻限制(强制执行)

本 skill 的职责仅限于拉取并展示当前 namespace/region/key 对应的配置数据

拿到返回结果后:

  • 禁止自动读取配置中的 URL、文档链接、图片链接、活动页链接、跳转链接
  • 禁止根据返回 JSON 中的字段值继续调用其他 skill 或继续打开链接内容
  • 禁止把配置里的文档地址当成新的读取目标做二次分析
  • 允许做字段级解释、结构化摘要、配置值比对

只有在用户明确要求“继续读取这个链接 / 继续分析这个文档 / 打开这个 URL”时,才允许进入下一步。

默认行为必须是:

  • 拉配置
  • 展示配置
  • 解读当前 JSON
  • 到此为止,不做二次下钻

去除字段说明

namespace=activity 时,脚本会自动从返回的 JSON 中移除以下字段:

  • ui_all_act_pages — 前端页面配置,通常体积较大且与业务逻辑无关
  • ui_meta — UI 元数据,同样与业务逻辑无关

其他 namespace 的数据不受影响,原样返回。

首次使用前的配置

设置环境变量:

export ConfigSecret=<your_app_secret>
export HWConfigSecret=<your_hw_app_secret>
  • ConfigSecret:普通 WePlay 区服使用
  • HWConfigSecretregion=HW 时使用
  • app_id:普通 WePlay 区服固定为 1region=HW 时固定为 2

典型使用场景

  • 活动配置:查看活动时间、规则、数值设计(自动过滤 UI 噪音字段)
  • 盲盒配置:查看某个盲盒的奖池概率、保底规则
  • 礼包/礼盒配置:查看礼包内容、价格、限购规则
  • 活动特殊配置:查看各区服差异化配置
  • 礼物配置namespace=giftkey=<礼物ID>,查看礼物属性、价格等信息
  • 道具配置namespace=propkey=<道具ID>,查看道具属性、效果等信息

依赖

pip install requests
Installs
3
First Seen
Apr 16, 2026