fetch-game-config-clean
SKILL.md
查询后台配置数据(Clean 版本)
与 fetch-game-config 的区别:当 namespace=activity 时,自动去除
ui_all_act_pages和ui_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(线上)
执行步骤
- 确认用户提供了 namespace、region、key 三个参数,缺少时主动询问;region 必须是以下值之一(不区分大小写):
C T M P V K J U B S Y R A Q O G I N HW - 根据上方规则判断环境,运行脚本:
python <当前skill目录>/scripts/fetch_config.py \
--namespace <namespace> \
--region <region> \
--key <key> \
--env <prod|dev> \
--pretty
- 将
<当前skill目录>替换为本机实际安装的fetch-game-config-cleanskill 目录。 - 不要写死
~/.claude/skills/...、/Users/...等安装者本地路径。
- 将返回的 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 区服使用HWConfigSecret:region=HW时使用app_id:普通 WePlay 区服固定为1,region=HW时固定为2
典型使用场景
- 活动配置:查看活动时间、规则、数值设计(自动过滤 UI 噪音字段)
- 盲盒配置:查看某个盲盒的奖池概率、保底规则
- 礼包/礼盒配置:查看礼包内容、价格、限购规则
- 活动特殊配置:查看各区服差异化配置
- 礼物配置:
namespace=gift,key=<礼物ID>,查看礼物属性、价格等信息 - 道具配置:
namespace=prop,key=<道具ID>,查看道具属性、效果等信息
依赖
pip install requests