wireless-energy-saving

name	wireless_energy_saving
description	分析无线节能工单系统的全能助手。包含柱状图统计分析（fetch_engblacklist_barchart）和白名单小区列表详情查询（fetch_whitelist_cell_list）两大核心功能。该工具通过 CDP 寄生技术直接连接用户浏览器获取鉴权 Token。

核心工作原理

本 Skill 采用 “人机协同 (Human-in-the-loop) + CDP 寄生” 架构，解决复杂的企业级系统鉴权问题：

1. 身份认证托管：所有的登录、滑块、验证码操作完全由人类用户在日常浏览器中完成。
2. 状态就地取材：Agent 通过 Playwright 访问本机的 9222 调试端口，直接提取浏览器 SessionStorage 中的有效 Token。
3. 动态业务请求：构造真实的 Header 和 Payload 发起 API 请求，随后自动断开连接，对用户的正常浏览无干扰。

前置环境要求 (Prerequisites)

在调用本工具内包含的所有函数前，必须满足：

1. 开启 Debug 端口：Chrome 必须带有 --remote-debugging-port=9222 参数启动。
2. 保持登录状态：浏览器必须有至少一个存活的标签页并成功登录目标工单系统 (http://192.168.188.1:8080/)。

---

工具列表 (Tools)

1. 柱状图统计查询 (fetch_engblacklist_barchart)

功能描述：用于快速获取某天特定网络类型下，各个地市的工单数量统计图表数据。 适用场景："看看今天的柱状图"、“LTE类型各地市有多少单”。

参数名	类型	必填	描述与规范
date	String	是	目标查询日期，必须符合 YYYY-MM-DD 格式。例如："2026-03-03"
network	String	是	目标网络类型，系统目前支持的枚举值："LTE" 或 "NR"

响应结构示例：

{
    "code": 0,
    "data": [
        {"date": "2026-03-03", "count": 1, "distName": "新乡市"},
        {"date": "2026-03-03", "count": 10, "distName": "武汉市"}
    ]
}

2. 白名单小区列表查询 (fetch_whitelist_cell_list)

功能描述：用于获取工单的详细列表信息。大模型必须推断和填充任意它已知的业务参数。 适用场景："帮我查武汉市华为的单子"、"24号到2号符号关断的详情"。 Agent交互建议：如果有用户意图模糊（例如没指定时间），Agent 应当主动补全默认时间周期（如最近一周），以防止查询失败。在拿到全量结果后，Agent 应当总结汇报（共多少行、核心厂商/地市分布等），避免输出生硬、超长 JSON。

参数名	类型	必填	描述与规范
startTime	String	是	查询开始日期。格式: YYYY-MM-DD
endTime	String	是	查询结束日期。格式: YYYY-MM-DD
distName	String	否	地市名称。示例："武汉市"
neName	String	否	网元名称/ID。示例："123"或"BTS001"
networkName	String	否	网络制式。默认空字符串(查全部)。可传"LTE","NR"
vendorName	String	否	厂家名称。示例："华为", "中兴"
jdType	String	否	故障/节点类型。示例："符号关断", "通道关断"
page	Integer	否	分页页码，默认 1
limit	Integer	否	单页数据量，默认 20

响应结构示例：

{
    "code": 0,
    "data": {
        "total": 150,
        "pageNum": 1,
        "pageSize": 20,
        "list": [
            {
                "distName": "武汉市", 
                "networkName": "LTE", 
                "vendorName": "华为",
                "jdType": "符号关断",
                "...": "..." 
            }
        ]
    }
}

---

异常定位指南 (Error Debugging)

调用本工具如果返回附带 error 字段的信息：

• Failed to fetch... Connection refused 说明未检测到开启 9222 端口的浏览器。请提醒用户检查启动参数。
• 未找到包含 192.168.188.1 的标签页 说明目标网页被关闭。请提醒用户重新打开目标系统页面。
• Session中未找到... / Token 解析失败 说明未登录或已过期。请提醒用户在保持页面开启的情况下完成系统登录操作。