奶茶咖啡活动查询

品牌资源

品牌列表和搜索策略见 references/brands.md。

地域配置

运行 scripts/set_region.py 管理地域偏好，配置保存在 region.json：

python3 scripts/set_region.py               # 查看当前配置
python3 scripts/set_region.py --city 深圳   # 设置城市
python3 scripts/set_region.py --city 深圳 --district 南山区  # 精确到区
python3 scripts/set_region.py --reset       # 重置全国

执行任何活动查询前，先读取 region.json（若不存在则默认全国）。

执行流程

0. 首次使用检测（优先执行）

检查 region.json 是否存在且地域已配置（city 字段非空）：

• 文件不存在或 city 为空 → 视为未配置，在开始搜索前先询问用户：

> "你在哪个城市？告诉我可以帮你优先搜本地活动（直接说城市名就行，或者回复'全国'跳过）"

• 用户回复城市 → 调用 python3 scripts/set_region.py --city {城市} 保存，然后继续搜索
• 用户回复"全国"或不想设置 → 直接继续搜索
• 文件存在且 city 非空 → 静默读取配置，直接进入步骤 1

1. 确认查询范围

• 用户指定品牌 → 只查该品牌
• 用户未指定 / 用户说"全部" → 查 references/brands.md 中所有品牌

2. 搜索活动信息

读取 region.json 获取地域配置，构建搜索关键词：

• 有城市配置：{品牌名} {城市} 优惠活动 {年月} + {品牌名} 全国活动 {年月}
• 无城市配置：{品牌名} 全国 优惠活动 {年月}

地域限定活动需在表格"获取方式"列标注"⚠️仅限{城市}"。

使用 browser-operation skill 或 web_search / web_fetch 工具：

搜索方式（按优先级）：

1. 先用 web_search 搜索：{品牌名} 最新活动 优惠 {当前年月}
2. 若结果不够新，用 web_fetch 抓品牌官网活动页或公众号文章
3. 内网可用时优先用搜狗搜索 skill

每个品牌至少获取：

• 当前是否有优惠券（类型+金额）
• 是否有新品上市
• 是否有买赠/联名活动
• 活动有效期

3. 输出格式

读取 references/brands.md 中的表格格式，汇总输出：

## 🧋 今日奶茶咖啡活动汇总（{日期}）

| 品牌 | 活动类型 | 活动详情 | 有效期 | 获取方式 |
|------|---------|---------|--------|---------|

活动类型用 emoji 标注，严格区分以下类型，不可混淆：

• 🎫 优惠券/折扣（官方App/小程序发放的券、折扣码）
• 🎁 买赠活动（买一送一、第二杯半价/免费等）
• 🤝 联名合作（与IP/品牌联名推出的限定优惠）
• ⏰ 限时特惠（官方直接限时降价）

不属于优惠活动，不展示：

• 🆕 新品上市（纯产品发布，没有价格优惠的不算）
• 品牌财报、融资、开店等品牌动态

表格后附：今日推荐 —— 性价比最高的 1-2 个活动，一句话点评。

4. 注意事项

• 只展示品牌官方活动：仅收录品牌自己发起的优惠（官方App/小程序/公众号），美团/饿了么/抖音等第三方外卖平台的满减、补贴、半价活动一律不展示
• 活动信息时效性强，务必标注信息来源和抓取时间
• 搜索不到时如实说"暂未找到 XX 活动信息"，不要编造
• 过期活动一律不展示：截止日期早于今天的活动直接丢弃，不出现在表格中
• 活动截止日期不明确时，优先搜索确认，确认已过期同样丢弃
• 即将开始的活动单独列出：开始日期晚于今天但在 7 天内的活动，在表格后单独用"📅 即将开始"区块展示，注明开始时间，提醒用户提前关注
• 区分全国活动和地区限定活动，地区限定需标注