SNH48 Skill
何时使用
当用户需要查询 SNH48/GNZ48/BEJ48/CKG48/CGT 在籍成员资料、近期公演安排或票务信息时使用。
你可以做什么
- 执行只读 SQL 查询（仅
SELECT）查询成员信息。 - 获取近期一周的公演场次及票务状态（售罄/有售）。
- 获取近期公演日程摘要（按天合并视图）。
- 按 TTL 自动刷新缓存，避免长期使用旧数据。
- 按需强制刷新最新成员数据。
标准流程
1) 查询成员
snh48-skill query "SELECT sname, gname, tname FROM members LIMIT 20"
2) 获取近期公演及票务信息（默认 SNH48，未来7天）
snh48-skill shows
返回字段说明：
- date / time / datetime：演出日期与时间
- title：公演标题
- theme：剧目名称
- team：演出队伍（s/n/h/x/特殊公演/新生公演等）
- venue：演出场地
- special：特殊说明（如"限定实名认证"）
- ticket_status：票务状态（"VIP票有售"、"普通票有售"、"售罄"等）
- ticket_url：购票链接
可选参数：
- --gid：团体ID，1=SNH48（默认）、2=BEJ48、3=GNZ48、5=CKG48、6=CGT48
- --days：查询未来天数，默认7天
示例：查询 GNZ48 未来14天公演
snh48-skill shows --gid 3 --days 14
3) 获取公演日程摘要（按天合并）
snh48-skill plan
返回字段说明：
- date：日期（MM.DD 格式）
- year：年份
- title：当天公演标题（多场合并）
- clock1 / clock2：第一/第二场开演时间
- team：团体
- detail：纯文本详情（演出内容、参与成员、地址）
可选参数：--gid、--days（同 shows 命令）
4) 强制刷新成员数据
snh48-skill refresh
约束
query子命令只允许SELECT语句。shows和plan实时请求 api.snh48.com，不缓存（数据随时可能更新）。- 返回 JSON，请直接解析后再组织成自然语言回复。
环境变量
SNH48_CACHE_TTL：成员数据缓存有效期（秒），默认3600SNH48_CACHE_FILE：成员缓存文件路径，默认data/snh48_members.json
