# Kugou Mysterious Shop

> 神秘商店配置审核与Apollo配置生成工具。用于读取解析神秘商店的配置文档（如Excel、飞书文档等），审核抽奖概率配置（appid: 8001334），并生成Apollo配置输出。适用于：神秘商店活动配置审核、礼物ID规则校验、Apollo配置生成。

- Skill: `dvcrn/kugou-mysterious-shop` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/kugou-mysterious-shop`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/kugou-mysterious-shop/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/kugou-mysterious-shop

---


# 神秘商店配置审核与Apollo配置生成

## 技能触发

当用户提到以下内容时，应使用此技能：
- 神秘商店配置审核
- 读取神秘商店文档第X期内容
- 神秘商店第十二期/十一期/十期等
- 审核神秘商店配置并生成Apollo配置
- 神秘商店礼物配置

**触发示例：**
- "读取神秘商店文档礼物配置第十二期的内容"
- "审核神秘商店的配置并生成Apollo配置"
- "神秘商店第十二期配置审核"
- "读取神秘商店Excel并审核"
- "神秘商店活动配置"

## 功能概述

本技能提供以下功能：
1. **读取解析** - 解析神秘商店配置文档（Excel、飞书文档等）
2. **配置审核** - 查询appid=8001334的抽奖概率配置，校验礼物ID规则
3. **Apollo配置生成** - 生成可用于发布的Apollo配置JSON

## 使用方法

### 第一步：读取配置文档

支持以下输入方式：
- 发送Excel文件（.xlsx）
- 发送飞书文档链接
- 提供文档内容

**Excel列索引映射（礼物配置表）：**
| 列索引 | 字段名 |
|--------|--------|
| [1] | 新礼物id |
| [3] | 礼物名称 |
| [4] | 礼物价值（元） |
| [5] | 折扣率 |
| [8] | 折后星币 |
| [9] | 单日可售数量 |
| [11] | 单次可够数量 |
| [14] | 补给点顺序 |
| [15] | 红色文案 |
| [16] | 礼物描述文案 |
| [17] | 视频预览链接 |

**读取时使用 `data_only=True` 模式解析公式单元格**

示例用户输入：
- "读取神秘商店文档第十二期内容"
- "审核神秘商店配置"

### 第二步：配置审核

调用抽奖概率接口查询 appid=8001334 的配置：

```
appId: 8001334
```

**审核规则**：
- 检查每个礼物ID是否在抽奖配置中存在对应的规则条件
- 规则条件样式：`giftId=='${礼物ID}_${折后星币}'`
- 例如：`giftId=='10372_100000'`

**规则内容校验**：
规则条件内容必须包含：
- 奖品类型：配置的礼物
- 奖品ID：礼物id
- 奖品数量：1
- 奖品过期时间：3
- 奖品名称：配置的奖励名称
- 成功率：1
- 库存限制：不限制
- 库存数量：配置的库存数量

### 第三步：Apollo配置生成

根据文档配置生成Apollo配置JSON，字段映射：

| 配置字段 | Apollo字段 | 说明 |
|---------|-----------|------|
| 补给点顺序 | position | 礼物在地图上的位置 |
| 新礼物id | giftId | 礼物ID |
| 单日可售数量 | remainNum | 剩余数量/库存 |
| 单次可够数量 | singleMaxNum | 单次最大购买数量 |
| 折扣率 | tagType | 1=折扣礼物, 2=新礼物(折扣率=1) |
| 红色文案 | tagName | 标签名称（如：全新首发、七折返场） |
| 礼物描述文案 | tagDesc | 标签描述 |
| 视频预览链接 | giftPreviewMp4 | 礼物预览视频URL |

**固定字段**：
- status: 1
- useTag: 1
- cornerColor1: "#FF5361" (折扣礼物) / "#F0525F" (新礼物)
- cornerColor2: "linear-gradient(100deg, #E46E07 0%, #FC1D76 100%)" (折扣礼物) / "linear-gradient(100deg, #F3A350 0%, #F77058 100%)" (新礼物)

## 输出格式

### 输出原则

**重要：直接输出到对话，不要生成文件！**

1. 审核报告 → 使用Markdown表格直接在对话中输出
2. Apollo配置 → 使用JSON代码块直接在对话中输出
3. 仅当用户明确要求或内容过长时才生成文件

### 配置审核报告（Markdown输出）

在对话中直接输出以下格式：

```markdown
## 神秘商店第X期配置审核报告

抽奖配置AppID：8001334

| 序号 | 礼物ID | 礼物名称 | 配置星币价值 | 规则条件 | 状态 |
|------|--------|----------|--------------|----------|------|
| 1 | 11372 | 冰霜飞龙 | 100000 | giftId=='10372_100000' | ✅ 存在 |
| 2 | 10373 | 百花孔雀 | 7000 | giftId=='10373_7000' | ✅ 存在 |

### 审核问题汇总
（如有）

### 审核结果
✅ 审核通过 / ❌ X个问题需要修正
```

### Apollo配置输出（JSON输出）

在对话中直接输出JSON代码块：

```json
[
  {
    "position": 16,
    "giftId": 11372,
    "status": 1,
    "singleMaxNum": 10,
    "remainNum": 300,
    "useTag": 1,
    "tagType": 2,
    "tagName": "全新首发",
    "tagDesc": "飞龙降世，天地冰冻！",
    "cornerColor1": "#F0525F",
    "cornerColor2": "linear-gradient(100deg, #F3A350 0%, #F77058 100%)",
    "giftPreviewMp4": "https://..."
  }
]
```

### 输出示例（完整流程）

用户输入：
```
读取神秘商店文档礼物配置第十二期的内容，审核神秘商店的配置并生成Apollo配置
```

正确输出：

```
## 神秘商店第十二期配置审核报告

抽奖配置AppID：8001334

| 序号 | 礼物ID | 礼物名称 | 配置星币价值 | 规则条件 | 状态 |
|------|--------|----------|--------------|----------|------|
| 1 | 11372 | 冰霜飞龙 | 100000 | giftId=='10372_100000' | ✅ 存在 |
| 2 | 10373 | 百花孔雀 | 7000 | giftId=='10373_7000' | ✅ 存在 |
| 3 | 10374 | 星空飞火 | 3500 | giftId=='10374_3500' | ✅ 存在 |
| 4 | 10375 | 极光游艇 | 78840 | giftId=='10375_78840' | ✅ 存在 |
| 5 | 5097 | 万物生长 | 30000 | giftId=='5097_30000' | ✅ 存在 |
| 6 | 7852 | 欢乐摆摆船 | 12000 | giftId=='7852_12000' | ✅ 存在 |
| 7 | 8914 | 樱花列车 | 50000 | giftId=='8914_50000' | ✅ 存在 |
| 8 | 5439 | 帆船酒店 | 10000 | giftId=='5439_10000' | ✅ 存在 |

### 审核结果
✅ 8个礼物全部匹配，审核通过

以下是Apollo配置：

```json
[
  {"position": 16, "giftId": 11372, ...},
  {"position": 12, "giftId": 10373, ...},
  ...
]
```

**仅在以下情况生成文件：**
- 用户明确要求保存为文件
- 内容过长（如超过50个礼物）
- 用户说"保存到文件"

## 示例

用户输入：
```
读取神秘商店文档礼物配置第十二期的内容，审核神秘商店的配置并生成Apollo配置
```

处理流程：
1. 解析Excel/文档内容，提取第X期礼物配置
2. 调用kugou-award-rule查询appid=8001334的抽奖配置
3. 比对每个礼物ID是否有对应规则
4. 生成审核报告和Apollo配置

**其他触发示例：**
- "读取神秘商店文档第十二期内容"
- "审核神秘商店配置"
- "神秘商店第十二期配置审核并生成Apollo"
- "读取神秘商店Excel审核并生成配置"