← 返回 Skills 市场
32
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install ikuai-report
功能描述
从 iKuai 路由器的 ikuai-cli JSON 数据生成可视化 HTML 流量报表。触发词：生成/创建/构建 iKuai HTML 报表、爱快流量报表、ikuai report
使用说明 (SKILL.md)
iKuai 流量报表
从 iKuai 路由器的 ikuai-cli 输出生成可视化 HTML 流量报表（5标签页、Canvas 动画图表、全静态无依赖）。
数据收集
执行以下 ikuai-cli 命令收集数据：
# 系统状态
~/.local/bin/ikuai-cli monitor system --format json
# 流量总览
~/.local/bin/ikuai-cli monitor traffic-summary --format json
# 应用流量
~/.local/bin/ikuai-cli monitor app-traffic-summary --format json
# 协议分布
~/.local/bin/ikuai-cli monitor protocols --format json
# 在线客户端
~/.local/bin/ikuai-cli monitor clients-online --format json
# 物理网口
~/.local/bin/ikuai-cli monitor interfaces-physical --format json
# WAN / LAN / DNS
~/.local/bin/ikuai-cli network wan --format json
~/.local/bin/ikuai-cli network lan list --format json
~/.local/bin/ikuai-cli network dns get --format json
# 安全规则
~/.local/bin/ikuai-cli security acl list --format json
~/.local/bin/ikuai-cli qos ip list --format json
~/.local/bin/ikuai-cli log system --format json --human-time
报表结构
| 标签页 | 内容 |
|---|---|
| 总览 | 系统状态 + 资源使用 + 流量总览 + 网口状态 + 4个图表 |
| 网络配置 | WAN/LAN/DNS/NAT/VPN/QoS 完整配置 |
| 流量分析 | 协议柱图 + 应用 Top20 + 设备 Top20 表 |
| 安全状态 | ACL/L7/MAC 过滤 + VPN + 在线设备表 |
| 系统日志 | 时间排序的关键事件日志 |
数据注入字段映射
| ikuai-cli 字段 | JS 变量 |
|---|---|
sysinfo.hostname |
hostname |
sysinfo.version |
version |
sysinfo.uptime |
uptime (秒) |
cpu_use[0/1/2] |
CPU 各核使用率 |
terminal_total |
设备总数 |
terminal_total_flow |
总流量字节 |
all_flow.down/up |
totalDown/totalUp |
data[].app_name |
应用名称 |
data[].total_byte |
应用总流量 |
data[].proto_name |
协议名称 |
data[].ip_address |
设备 IP |
ether_info.\x3Cnic>.link |
网口 link (1=up, 0=down) |
输出
报表输出到 /tmp/ikuai-report.html，用浏览器打开：
open /tmp/ikuai-report.html
故障排查
ikuai-cli 返回空数据（exit 0 但 body 为 {"data":[]}）
- 路由器 LAN IP 不对或不可达 —
ping 10.10.10.253确认连通性 - ikuai-cli 未配置正确地址 —
ikuai-cli config list查看目标地址 - 认证失败（401/403）— 固件 4.0.x 可能需要登录 token
- API 版本不匹配 — 固件 4.0.210 使用
/api/v1/session/login认证
快速验证：
curl -s --connect-timeout 3 http://10.10.10.253:80/api/v1/monitor/system 2>&1 | head -c 200
返回 JSON 说明 API 可达；返回 HTML 说明需要认证。
安全使用建议
如果你确实想生成 iKuai 路由器流量报表，可以安装使用；运行前请确认 ikuai-cli 是可信版本、目标路由器正确、凭据权限尽量最小，并把生成的 /tmp/ikuai-report.html 当作敏感文件处理。
功能分析
Type: OpenClaw Skill
Name: ikuai-report
Version: 1.0.0
The skill bundle is designed to generate a local HTML traffic report for iKuai routers by executing a series of 'ikuai-cli' commands. It collects system status, network configuration, and traffic statistics, then populates a self-contained HTML template (assets/template.html) which is saved to /tmp/ikuai-report.html. No evidence of data exfiltration, unauthorized remote execution, or malicious prompt injection was found; the skill's behavior is entirely consistent with its stated purpose of local reporting.
能力评估
Purpose & Capability
用途清晰且基本一致：通过 ikuai-cli 查询路由器状态、流量、配置、安全规则和日志，再生成 HTML 报表；这些数据本身较敏感，用户应确认愿意让代理读取。
Instruction Scope
SKILL.md列出的命令主要是读取/查看类命令，未见修改路由器配置、删除数据、外传数据或隐藏执行流程。
Install Mechanism
这是 instruction-only 技能，没有安装脚本或代码包；但说明中依赖本地 ~/.local/bin/ikuai-cli，而元数据未声明必需二进制，用户需要自行确认该 CLI 的来源与配置。
Credentials
本地命令执行、对路由器 API 的连通性检查以及生成本地 HTML 文件都与报表用途相符；需要注意 /tmp 输出路径可能不适合长期保存敏感网络报表。
Persistence & Privilege
未见后台常驻、自启动或权限提升；主要持久化结果是 /tmp/ikuai-report.html，其中可能包含路由器配置、在线设备和系统日志。
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install ikuai-report - 安装完成后，直接呼叫该 Skill 的名称或使用
/ikuai-report触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Initial release of ikuai-report.
- Generates visual HTML traffic reports from iKuai router's ikuai-cli JSON data.
- Supports five report tabs: Overview, Network Config, Traffic Analysis, Security Status, and System Log.
- All reports are static, dependency-free HTML with animated Canvas charts.
- Data mapping and output procedures documented for easy setup and troubleshooting.
元数据
常见问题
ikuai-report 是什么？
从 iKuai 路由器的 ikuai-cli JSON 数据生成可视化 HTML 流量报表。触发词：生成/创建/构建 iKuai HTML 报表、爱快流量报表、ikuai report. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 32 次。
如何安装 ikuai-report？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install ikuai-report」即可一键安装，无需额外配置。
ikuai-report 是免费的吗？
是的，ikuai-report 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
ikuai-report 支持哪些平台？
ikuai-report 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 ikuai-report？
由 VEE（@veelove）开发并维护，当前版本 v1.0.0。
推荐 Skills