日报报表生成器#

生成传输单边故障日报报表，按考核周期统计，每个考核周期一个 sheet，最后保留原始清单。

功能特点#

• 按考核周期统计：每个考核周期（如 2026年2月 = 1月27日-2月26日）一个独立 sheet
• 全年累计报表：第一个 sheet 为全年累计报表，格式与考核周期一致
• 完整统计指标：汇聚骨干单边、重要接入环单边、一般接入环单边的工单数量、平均时长、超时数量、及时率
• 风险评分过滤："一般接入环单边（有业务）"自动剔除风险评分为0的记录
• 原始清单保留：最后一个 sheet 包含所有原始数据，方便查证
• 自动格式化：表格样式、冻结窗格、自动调整列宽

考核周期规则#

考核周期：上个月27日 - 本月26日

• 2026年1月：2025-12-27 ~ 2026-01-26
• 2026年2月：2026-01-27 ~ 2026-02-26
• 2026年3月：2026-02-27 ~ 2026-03-26
• 以此类推...

使用方法#

基本使用#

bash

cd /Users/ahs/.openclaw/workspace/传输单边故障
python3 scripts/generate_assessment_period_report.py

指定输入文件#

bash

python3 scripts/generate_assessment_period_report.py \
  --input /path/to/结果D_最终数据.xlsx \
  --output /path/to/output/

指定考核周期范围#

bash

python3 scripts/generate_assessment_period_report.py \
  --start-year 2026 \
  --start-month 1 \
  --end-year 2026 \
  --end-month 3

输出文件#

生成的 Excel 文件包含以下 sheet：

1. 全年累计 - 所有数据的累计统计
2. 2026年1月（12月27日-1月26日） - 该考核周期的统计数据
3. 2026年2月（1月27日-2月26日） - 该考核周期的统计数据
4. 原始清单 - 所有原始数据（34列）

统计指标#

每个考核周期 sheet 包含以下指标：

汇聚骨干单边#

• 工单数量
• 平均时长（小时）
• 超时数量
• 及时率（%）

重要接入环单边#

• 工单数量
• 平均时长（小时）
• 超时数量
• 及时率（%）

汇聚骨干和重要接入单边#

• 工单数量
• 平均时长（小时）
• 超时数量
• 及时率（%）

一般接入环单边（有业务）#

• 工单数量
• 平均时长（小时）
• 超时数量
• 及时率（%）

超时标准#

• 汇聚骨干单边：4 小时
• 重要接入环单边：12 小时
• 一般接入环单边：24 小时

输入数据要求#

输入文件应为 Excel 格式（.xlsx），包含以下字段：

• 告警发生时间（datetime）
• 告警清除时间（datetime）
• 持续时长（小时）（numeric）
• 故障类型（string）
• 重要环（string）
• 所属片区（string）
• 网元名称（string）
• 告警标题（string）
• 所属传输系统（string）
• 督办类型（string）
• 管控记录（string）
• 风险评分（numeric）
• 其他字段...

依赖项#

• Python 3.6+
• pandas
• openpyxl

安装依赖：

bash

pip3 install pandas openpyxl

文件结构#

text

daily-report-generator/
├── SKILL.md                          # 本文件
├── scripts/
│   └── generate_assessment_period_report.py  # 主脚本
└── references/
    └── example_output.xlsx          # 示例输出文件（可选）

触发条件#

当用户提到以下内容时，应使用此技能：

• "生成日报报表"
• "按考核周期统计"
• "传输单边故障报表"
• "日报统计"
• "考核周期报表"

注意事项#

1. 数据时间范围：脚本会自动根据数据的时间范围确定需要统计的考核周期
2. 空考核周期：如果某个考核周期没有数据，会跳过该周期
3. Sheet 名称限制：Excel sheet 名称限制在 31 个字符以内，脚本会自动截取
4. 原始清单：原始清单包含所有 34 列数据，确保完整性
5. 风险评分过滤："一般接入环单边（有业务）"会自动剔除风险评分为0的记录，确保统计的是有业务影响的故障

示例输出#

text

正在生成按考核周期统计的日报报表...
数据时间范围: 2026-01-01 09:36:28 ~ 2026-02-26 23:26:22

生成全年累计报表...
  ✅ 全年累计报表已生成（885 条数据）

共 3 个考核周期:
  - 2025年12月（11月27日-12月26日）
  - 2026年1月（12月27日-1月26日）
  - 2026年2月（1月27日-2月26日）

处理考核周期: 2025年12月（11月27日-12月26日）
  ⚠️  该考核周期无数据

处理考核周期: 2026年1月（12月27日-1月26日）
  数据量: 493 条
  ✅ 已生成报表

处理考核周期: 2026年2月（1月27日-2月26日）
  数据量: 392 条
  ✅ 已生成报表

添加原始清单...
  ✅ 原始清单已添加（885 条记录）

✅ 报表已保存: /path/to/日报报表_按考核周期_20260429_085611.xlsx
  共 4 个 sheet:
    - 全年累计
    - 2026年1月（12月27日-1月26日）
    - 2026年2月（1月27日-2月26日）
    - 原始清单

故障排查#

问题：找不到输入文件#

解决方案：确保输入文件路径正确，文件存在且可读。

问题：数据时间范围异常#

解决方案：检查输入数据中的"告警发生时间"字段是否为有效的 datetime 格式。

问题：考核周期计算错误#

解决方案：考核周期规则为"上个月27日 - 本月26日"，确保理解正确。

问题：Excel 文件打不开#

解决方案：确保文件没有被其他程序占用，尝试重新生成。

扩展功能#

如需扩展功能，可以考虑：

1. 自定义考核周期：支持用户自定义考核周期的起止日期
2. 多数据源合并：支持从多个 Excel 文件读取数据并合并
3. 图表生成：在报表中添加可视化图表
4. 邮件发送：自动将报表发送到指定邮箱
5. 定时任务：设置定时任务自动生成报表

相关技能#

• data-analysis - 数据分析相关技能
• excel-automation - Excel 自动化相关技能
• report-generator - 报表生成相关技能