vent_skills/vent-operation-daily-report

vent-operation-daily-report v1.1
通风设备与传感器运行日报系统（通防管控平台）

【是什么】
一条命令导出前一天 7 类真实通风设备（主通风机/局部通风机/风门/风窗/测风装置/
多参数传感器/压差传感器）的运行日报：各参数最大/最小/平均三列、风门开闭次数、
异常明细（同设备同类合并：次数/首末时间/最长持续/是否解决），统一 Markdown 模板。

【v1.1 变更（相对 v1.0）】
1. 异常明细合并：同设备同类型报警合并为一行（此前逐条列出，单日可膨胀至上百行）
2. 数据可信度标注（†）：局扇进出口风量（跨日恒定疑静态标定值）、多参数传感器
越界数值（温度/湿度数万、密度溢出等按物理合理域自动检测）
3. 数据源健康检查：历史+实时接口均无返回时日报顶部输出平台故障警告，防止全空
日报被误读为设备全停
4. 踩坑记录新增 4 条实测结论（windQuantity1 三重定义冲突、平台故障恒值冻结特征等）

【安装（任选其一）】
方式一：作为通用 Agent skill
将本目录整个文件夹复制/解压到用户级 skills 目录：
Windows: C:\Users\<用户名>\.agents\skills\vent-operation-daily-report\
Linux/Mac: ~/.agents/skills/vent-operation-daily-report/
之后对任何支持用户级 skill 的 Agent 说"帮我导出通风设备与传感器运行日报"即可触发。

方式二：作为独立命令行工具
只需 scripts/vent_daily_report.py 单文件 + Python 3.8+ 与 fastmcp 依赖。

【依赖】
pip install fastmcp
（见 requirements.txt；脚本无其他第三方依赖）

【使用】
python scripts/vent_daily_report.py [--date 2026-08-18] [--url http://39.97.59.228:8071/mcp] [--outdir .]
- --date 统计日，默认昨天（自然日 00:00:00~23:59:59）
- --url 通防管控平台 MCP 服务地址，按实际环境修改
- --outdir 日报输出目录，默认当前目录
输出：vent_operation_daily_report_YYYY-MM-DD.md，并在终端打印全文。

【目录结构】
SKILL.md skill 定义（Agent 加载入口，含完整取数/统计规则与 11 条踩坑记录）
scripts/vent_daily_report.py 取数+统计+渲染脚本（fastmcp 直连平台）
sample/vent_operation_daily_report_2026-08-18.md v1.1 输出效果样例
requirements.txt Python 依赖

【已知平台限制】（详见 SKILL.md"核心规则"与"踩坑记录"）
- 主通风机/压差传感器历史明细接口无记录体，自动回退实时快照
- 局扇历史仅存 windQuantity1（三重定义冲突已弃用），其余参数用实时快照
- 真实设备口径：deviceinfo.is_bus_sup=0/NULL 且 status=1