Apifox Query

查询活动服务端 API 文档（7000+ 接口），根据用户意图找到准确的API路径和参数。

模式A：关键词搜索（默认首选，~30ms）

curl -s -X POST https://activity-ai.weplayapp.com/api/apifox/recommend \
  -H 'Content-Type: application/json' \
  -d '{"user_intent": "送礼", "tag": "版本相关接口"}'

参数	必填	说明
user_intent	是	简短意图关键词（如"抽奖"、"送礼"、"签到"）
tag	否	最高层级 tag，只支持：20xx活动（如2026活动）、公共接口、常驻活动、模板活动、版本相关接口、组件接口
top_n	否	返回数量，默认10

响应中每个候选包含 path、method、parameters（含正确参数名）、score。

以下意图建议加 "tag": "版本相关接口"，避免被活动/组件接口干扰：

意图关键词	对应业务
送礼、批量送礼	送礼
道具、秒杀	道具
充值、订单、购买	订单/充值
商城、折扣	商城
礼包	礼包
会员	会员
家族、扭蛋、宝箱	家族
好友	好友
动态、点赞、玩友圈	玩友圈
排行榜	排行榜
广场、贴文	广场
群聊、聊天	群聊/聊天

-- 每个操作单独查询，不要合并 -- 查询意图要简洁：用"抽奖"而不是"我想测试抽奖活动的接口" -- 从candidates中选择最合适的：根据path、summary、parameters判断哪个才是要用的接口 -- 结果不满意时：加 tag 缩小范围、换关键词、增加 top_n -- 选定接口后，从 parameters / request_body 中获取正确的参数名，不要猜测

模式B：目录浏览（兜底方案，意图模糊或模式A结果不准时使用）

服务将接口按 Apifox 文件夹层级生成本地目录树，Claude Code 可直接 Glob/Read 导航。

顶层目录（与 tag 白名单一致）：

/tmp/apifox-index/
├── 20xx活动/     （2023活动/ 2024活动/ 2025活动/ 2026活动/ ...）
├── 公共接口/
├── 常驻活动/
├── 模板活动/
├── 版本相关接口/
└── 组件接口/

# 第一步：确认索引就绪
curl -s https://activity-ai.weplayapp.com/api/apifox/index-dir

# 第二步：浏览顶层
ls /tmp/apifox-index/

# 第三步：逐层导航
Glob("/tmp/apifox-index/版本相关接口/**/*.md")
Read("/tmp/apifox-index/版本相关接口/送礼/送礼.md")

每个 .md 文件包含：METHOD path、接口名称、参数列表、请求体示例。

-- 不确定在哪个子目录时，先 Glob 看当前层，再逐层深入