保定学院拉屎了吗

校园场景里的真实问题

在保定学院，找厕所是一件靠运气的事。走进一栋教学楼，你不知道这层男厕有没有纸、要不要排队、味道能不能忍。学生群里流传的情报往往是几小时前的，等真的冲过去，发现情况已经变了。

这个技能要解决的正是这个信息差。它把实时状态和历史口碑拆成两层：前者告诉你「现在能不能上」，后者告诉你「这厕所长期行不行」。

它如何工作

1. 结构化楼栋知识库。 references/restroom_data.json 已录入 36 栋真实楼栋（行政楼、综合楼、外语楼、数计楼、理科楼、实验楼、美术楼、音乐楼、现代信息中心、现代实训中心、图书馆、宿舍 1–15 号楼、校医院 16 号楼）的每层男女厕所，约 410 间，并附带楼栋情报：常年有纸、高峰拥挤、隐蔽程度。

2. 打卡上报与时间戳保鲜。 学生提交的每条打卡带时间戳，free、paper 这类易变维度超过 live_ttl_min（默认 30 分钟）自动过期，避免两小时前的情报误导当前决策。

3. 五维加权评分。 干净度（0.30）、有纸率（0.25）、空闲度（0.20）、气味（0.15）、设施（0.10），按多人打卡均值加权得出综合分。达到阈值分档为红榜 / 黑榜 / 普通，样本量低于 min_reports 的标注「待校准」，不替少数人背书。

4. 脚本化操作。 scripts/rank.py 提供 report、status、board、today、list 五个入口；scripts/tencent_docs_sync.py 支持腾讯文档 CSV 合并上报（按 building+rid 追加，ts+user 去重）。改楼栋结构、权重阈值只需编辑 JSON，并在 meta.changelog 追加记录。

5. 网页端。 assets/index.html 是单文件自包含的卡通交互页，找厕所 + 打卡两块功能，数据内联、离线可用；改数据后需重跑 tools/gen_data_v3.py 与 build_inline.py 重新内联。

适用边界与注意点

• 楼栋情报来自校园排查 Excel，是常年规律，不等于实时状态；实时判断始终以最近 30 分钟内的打卡为准。
• 口碑依赖学生持续上报。样本不足的厕所一律标「待校准」，不会硬给结论。
• 评分权重与分档阈值写在 JSON 的 scoring 字段，可自行调整，但改动会直接影响分档结果，建议同步更新 changelog。
• 腾讯文档多人实时模式需要自行搭建在线表并配置 meta.data_source，属于可选能力，不配置时仅用本地 JSON 也能完整工作。