西财美食 Skill
> 西南财经大学（柳林校区）「吃什么」决策助手。
不是美食列表，是替你做决定的工具——它直接告诉你现在去哪吃。
一、它到底干嘛的
大众点评能告诉你附近有什么店，但不知道：
- 这个窗口现在开没开（食堂 19:00 后基本全关）
- 从哪个门出去最近、步行几分钟
- 食堂刷校园卡、拒收现金
- 这家排不排队（赶时间时很要命）
这些才是每天真正卡住你的问题。本 Skill 把它们全算进去，再给你结论。
一句话区别：别的 App 给你一长串店名让你自己筛，它给你「现在去哪吃、几点去、刷不刷卡」。
二、最快用法：直接说话就行
不用记任何命令，像问同学一样问它：
| 你想问的 | 直接这么说 |
|---|---|
| 中午一个人 20 块吃啥 | 「中午一个人 20 块有啥推荐」 |
| 深夜还有啥开的 | 「晚上十点东门还有啥吃的」 |
| 某食堂现在开哪些窗口 | 「三味堂二楼现在开着吗」 |
| 新生不懂食堂 | 「我是新生，学校食堂怎么吃」 |
| 一下午怎么安排 | 「帮我规划下午：吃饭+自习+逛街，预算 40」 |
| 吃过一家店想记下来 | 「打卡 重庆面庄」 |
| 看看我的打卡进度 | 「生成我的美食护照」 |
它会自己挑合适的模块跑，然后把结果讲给你听。
三、模块速查
想手动跑也行，在项目目录下执行：
python scripts/query.py --freshman # 新生餐饮生存指南
python scripts/query.py --now 12:30 --scene 一人食 --budget 20 # 午间一人食 20 元
python scripts/query.py --now 22:30 --scene 宵夜 --gate 东门 # 深夜东门柳浪湾
python scripts/query.py --now 18:00 --hall 三味堂 # 三味堂现在开哪些窗口
python scripts/query.py --now 14:00 --plan --budget 40 --activities 吃饭,自习 # 动线方案
python scripts/query.py --keyword 高师盖浇 # 找某家店
python scripts/query.py --checkin "重庆面庄" # 打卡
python scripts/query.py --passport # 生成美食护照
常用参数
| 参数 | 作用 | 可选值 |
|---|---|---|
--now |
按几点算（默认取当前时间） | 如 22:30 |
--scene |
场景，逗号分隔可多选 | 一人食 / 两人 / 聚餐 / 宵夜 / 早餐 / 赶时间 / 减脂 / 请客 / 甜品 / 省钱 |
--budget |
人均上限（元） | 如 20 |
--gate |
限定门或片区 | 东门 / 西门 / 北门 / 柳浪湾 / 旭辉 / 新尚 |
--hall |
限定食堂 | 三味堂 / 五谷堂 / 柳园食府 等 |
--export |
导出成 HTML 攻略图 | 可加文件名 |
--top |
结果条数 | 默认 3 |
> 想发给同学或发朋友圈，任意查询后面加 --export，会生成一张自包含 HTML 攻略，直接打开或转发都不会破图。
四、能做 / 不能做
能做
- 按当前时间硬过滤，只给现在真开着的店和窗口
- 按门区、片区、食堂、预算、场景收窄
- 提示校园卡结算、排队久、已关门/已转让的店
- 给出带来源和置信度的推荐理由，可追溯
- 规划一次出行的动线（吃饭+自习+逛街），估算总花费
- 打卡集章，生成可分享的美食护照
- 纯离线运行：不联网、不调用外部 API、不上传任何数据
不能做（提前说清，免得白跑）
- 只覆盖柳林校区及三个步行可达商圈，不含光华校区
- 不知道此刻排队多长、有没有座位——只能提示"这家通常排队久"
- 高德 POI 来的店只有基础信息（评分/人均/营业时间），没有口味评价，结果里会挂 ⚠️ 提示并降权，不冒充学生推荐
- 学生真实评价来自 19 条频道佐证帖，不是全量口碑，覆盖不到的店就没有
- 不能帮你下单、导航、看实时外卖
五、看懂结果里的三个标识
置信度（每条结果都带）
| 等级 | 含义 |
|---|---|
A |
近 6 个月官方信息（如食堂窗口、供餐时间） |
A- |
近 3 个月学生频道佐证 |
B |
近 12 个月，或高德 POI（营业属实，口味未验证） |
C |
未验证，默认不主动推荐 |
A- B C 会随时间衰减——2024 年的老帖不会和今年的新帖同权。
⚠️ 提示：出现即代表这条信息有局限（如"仅有基础信息，无口味评价"），看到了就自己多判断一步。
人均：未标注：该店源数据里没有价格，统一沉到列表最末尾，不与有价格的混排。
六、西财专属避坑（别的 App 不会告诉你）
- 一粟堂装修改造中，暂停供餐 —— 它的所有窗口一律不推荐，别白跑，去三味堂或五谷堂。（官方 2026-09-07 称其「马上将以全新面貌和大家见面，还会上新好多新品」，即重开在即但尚未恢复；重开后窗口名单可能整体变更）
- 食堂 19:00 后基本全关 —— 晚餐统一 17:00–19:00，夜宵选择有限：东门小吃街、柳园食府，以及 「西财苏小铁」校园餐车（宿舍区楼下，19:30–22:00 供应炒饭炒面、手撕鸡、现捞大锅菜、现煮泡面等，周末不营业）
- 食堂拒收现金，只刷校园卡 /支付宝
- 赶时间或有早课 —— 宿舍区楼下有「西财苏小铁」餐车早餐（7:30–9:30，三明治/饭团/面包/烧麦/豆浆），不必绕去食堂
- 住致知园 —— B 座楼下有便民餐点，早午晚三餐都有，不用跑到食堂
七、打卡护照怎么玩
精选了 30 家必打卡（校内 10 + 旭辉 Cmall 5 + 新尚天地 5 + 东门柳浪湾 10），筛选口径是：校外看高德评分 ≥4.5、同分按人均越低越优先；校内取学生常去的经典。
- 吃过就
--checkin "店名"（或对它说「打卡 XX」），支持模糊匹配 - 护照里打卡过的头像点亮，没打卡的置灰加锁
- 按进度解锁称号：美食小白 → 探店学徒 → 探店达人 → 美食探长 → 美食宗师 → 资深食神 → 西财食神（30 家满级）
--passport生成 HTML，可截图发小红书
> 装好后 data/checkins.json 是空的，从 0/30 开始；作品里附带的 demo/demo-passport.html 是演示效果（预置 5 家），真实使用不会自带打卡记录。
八、给新生的第一条命令
python scripts/query.py --freshman
一份「柳林校区餐饮生存指南」：食堂在哪、怎么付钱、几点有饭、一顿多少钱、各门区吃什么、校内必吃与避坑——刚报到那几天，看这一份就够。
