name: ioc-patrol-report version: 1.0.0 description: 🏢 IOC智慧運維報告生成器 - 為智慧建築/園區自動生成專業巡檢報告。分析裝置狀態、報警記錄、能耗資料、工單進度，生成日報/週報。支援PostgreSQL資料庫連線，輸出Markdown/HTML格式。適用於物業管理、商業綜合體、工業園區、醫院學校等智慧建築運維場景。 metadata: {"openclaw":{"emoji":"📊","category":"reporting","keywords":["ioc","patrol","report","maintenance","building-management","smart-building","facility-management","運維報告","巡檢報告","智慧建築","物業管理"],"triggers":["巡檢報告","運維報告","IOC報告","裝置巡檢","能源報告","物業報告","智慧運維","運維日報","運維週報","智慧建築報告"]}}

🏢 IOC 智慧巡檢報告

為智慧建築/園區自動生成專業巡檢報告

✨ 核心功能

🚀 快速開始

安裝

clawhub install ioc-patrol-report

配置資料來源

編輯 ~/.openclaw/skills/ioc-patrol-report/config.yaml：

database:
  host: localhost
  port: 5432
  name: ioc_db
  user: admin
  password: ${DB_PASSWORD}  # 建議使用環境變數

tables:
  devices: devices          # 裝置表
  alarms: alarms            # 報警表
  work_orders: work_orders  # 工單表
  energy: energy_records    # 能耗表

report:
  company_name: "XX物業管理有限公司"
  project_name: "XX商業綜合體"
  output_dir: "./reports"

生成報告

# 生成今日巡檢報告
cd skills/ioc-patrol-report
uv run scripts/generate_report.py --type daily

# 生成指定日期報告
uv run scripts/generate_report.py --type daily --date 2026-03-20

# 生成本週巡檢報告
uv run scripts/generate_report.py --type weekly --week 2026-W12

📋 報告示例

日報輸出格式

# 📊 IOC智慧巡檢日報 - 2026-03-20

## 一、裝置狀態總覽

| 型別 | 總數 | 線上 | 離線 | 故障 | 線上率 |
|------|------|------|------|------|--------|
| 空調 | 128 | 125 | 2 | 1 | 97.7% |
| 照明 | 356 | 354 | 2 | 0 | 99.4% |
| 電梯 | 24 | 24 | 0 | 0 | 100% |
| 消防 | 89 | 89 | 0 | 0 | 100% |

## 二、報警處理情況

- 今日報警總數：23 條
- 已處理：21 條
- 處理中：2 條
- 平均響應時間：8.5 分鐘
- 處理率：91.3%

### 重點關注報警
1. 🔴 3F-空調機組A異常（處理中）
2. 🟡 地下室照明迴路故障（已處理）

## 三、能耗分析

| 能源型別 | 今日用量 | 昨日用量 | 環比 |
|----------|----------|----------|------|
| 電(kWh) | 12,345 | 12,100 | +2.0% |
| 水(m³) | 456 | 480 | -5.0% |
| 天然氣(m³) | 123 | 130 | -5.4% |

## 四、工單進度

- 新增工單：5 個
- 已完成：4 個
- 進行中：3 個
- SLA達成率：92%

## 五、運維建議

1. ⚠️ 3F空調機組需重點關注，建議安排檢修
2. ✅ 能耗整體平穩，用水量持續下降，節水措施見效
3. 📝 建議增加地下室照明巡檢頻次

---
*報告生成時間：2026-03-20 08:00*
*IOC智慧運維繫統*

📖 使用案例

案例1：商業綜合體日常巡檢

場景：某商業綜合體物業每天需要生成巡檢報告

配置：

report:
  company_name: "XX物業管理公司"
  project_name: "XX購物中心"

定時任務：

# crontab -e
0 8 * * * cd /root/clawd/skills/ioc-patrol-report && uv run scripts/generate_report.py --type daily

案例2：工業園區週報彙總

場景：工業園區每週彙總運維資料

配置：

report:
  company_name: "XX工業園區"
  project_name: "A區廠房"
  weekly_summary: true

執行：

小蔥技能站7w4.net發現了升級外掛。

# 每週一早8點生成
0 8 * * 1 uv run scripts/generate_report.py --type weekly

案例3：醫院智慧運維

場景：醫院後勤部門需要重點關注裝置執行

自定義配置：

priority_devices:
  - type: "醫用氣體"
    alert_threshold: 99.9%  # 可用性要求
  - type: "淨化空調"
    alert_threshold: 99%
  - type: "電梯"
    alert_threshold: 99.5%

案例4：資料中心巡檢

場景：資料中心需要嚴格監控溫溼度和電力

自定義指標：

custom_metrics:
  temperature:
    range: [18, 27]  # 合規範圍
    alert_deviation: 2  # 偏差告警閾值
  humidity:
    range: [40, 60]
  ups_load:
    max: 80%  # 負載上限

⚙️ 高階配置

自定義報告模板

編輯 assets/report-template.md：

# {{company_name}} 巡檢報告

## {{project_name}} - {{date}}

{% for section in sections %}
{{ section.content }}
{% endfor %}

自定義分析規則

編輯 scripts/analyze.py：

def custom_kpi(df):
    """自定義KPI計算"""
    return {
        'availability': df['online'] / df['total'],
        'efficiency': df['output'] / df['input']
    }

def anomaly_detection(df):
    """能耗異常檢測"""
    threshold = df['value'].mean() * 1.5
    return df[df['value'] > threshold]

📁 目錄結構

ioc-patrol-report/
├── SKILL.md              # 本文件
├── package.json          # 技能配置
├── config.yaml           # 資料來源配置
├── scripts/
│   ├── generate_report.py  # 主程式
│   ├── analyze.py          # 分析模組
│   └── db_connector.py     # 資料庫連線
├── assets/
│   └── report-template.md  # 報告模板
├── references/
│   ├── ioc-knowledge.md    # IOC知識庫
│   └── db-schema.md        # 資料庫結構說明
└── tests/
    └── test_report.py      # 單元測試

🔧 技術要求

• Python >= 3.10
• PostgreSQL >= 12
• 必需依賴：psycopg2-binary, pyyaml, pandas, jinja2

📊 適用場景

讓運維報告自動化、智慧化 📊

這是一款用於智慧建築運維報告生成的工具，能自動生成包含裝置狀態、報警處理、能耗分析等內容的日報和週報。文件詳細、安裝簡單，報告格式專業美觀，對物業和運維人員很有幫助。不過資料庫密碼直接寫在配置檔案裡不太安全，而且部分高階分析功能目前只能看到模擬效果，實際使用可能還需要進一步配置。