阿拉丁会议室管家工坊

会议室台账的隐性损耗

行政团队维护会议室数据时，最头疼的是散落在各处的记录。Excel 导出表、前台手工登记簿、空间管理系统的 JSON 文件，这三种数据源的表头往往是不同的，编码可能是 GB18030，时间写法更是五花八门——9点30、09:00-次日、23:00 混杂在一起。更致命的是，这些数据里藏着系统性问题：大会议室一周只用 8 小时，小会议室却被订到爆；同一时段同一房间被两个人同时预订，系统却毫无反应；离职半个月的员工，名下依然挂着未结束的预订。传统的人工核对方式无法覆盖所有规则，也很难量化会议室健康度。

离线稽核流水线

aladin-room-forge 不试图去接管预订系统，它只做一件事：把上述零散记录清洗、归一、稽核，输出可追溯的结论。

核心工作流分为三步：

• 清洗归一（Ingest）：脚本首先会读取 CSV、TSV 或 JSON 文件（支持多文件合并）。它能自动识别中文表头别名，将四种日期格式和复杂的合并时段写法统一标准化，并剔除完全重复的行。如果表头无法识别或数据全空，脚本会直接以 exit=2 报错退出，绝不静默跳过。
• 规则稽核（Audit）：这是核心大脑。它会执行 R1-R12 共 12 条规则，涵盖撞期冲突（R1）、离职人员占用（R2）、未审批占用（R3）、空占（R4）、超容（R5）、幽灵账号（R6）等。每条发现按 P0/P1/P2/INFO 分级。系统采用 100 分制门禁：P0 扣 25 分，P1 扣 8 分，P2 扣 3 分。根据最终得分和 P0 数量，判定整体状态为 HEALTHY、WATCH 或 ALERT。
• 生成报告（Report）：一次性输出三件套：room_dashboard.html（含 SVG 评分环和 KPI 看板）、room_report.md（带 checkbox 的整改清单）、room_ledger.csv（utf-8-sig 编码，Excel 直接打开）。

适用边界与注意事项

• 只读离线分析：该技能全程使用 Python 标准库运行，不联网、不调用 API、不上传数据。它无法直接操作日历或预订系统，也不能实时拉取日程。
• 不做排程：它回答的是过去发生了什么，而非未来该怎么排。
• 数据准备：使用前需确保输入文件包含必需字段（如日期、会议室、预订人），否则会触发 exit=2 错误。
• 阈值可调：闲置/过热的判定阈值、单场时长上限（默认 12 小时）均可通过命令行调整，并会记录在结果契约中以保证可复现性。