Analytics Dashboard Free

轻量级数据可视化面板，聚合邮件、浏览器会话和任务数据，token保护，支持5秒自动刷新，统一展示多源状态。

Install

openclaw skills install @thcjp/analytics-dashboard-free

数据分析面板（免费版）

一站式监控你的邮件、会话与任务。token保护，5秒刷新，零配置启动。

数据分析面板免费版解决一个核心痛点：用户需要同时关注收件箱、浏览器会话、任务执行等多个数据源，但每个数据源在不同工具中，切换查看效率低。本面板把这些数据聚合到一个Web UI中，一目了然。

核心理念

只读安全原则：

面板仅读取本地数据文件，不修改任何数据
不捕获凭证、不控制浏览器、不发送消息
token保护，仅授权用户可访问
所有数据存储在本地，不上传云端

职责边界：

本面板负责数据展示与聚合
数据来源由其他技能（邮件收集、浏览器认证等）提供
本面板不产生数据，仅消费数据

数据存储

输入格式

参数名	类型	必填	说明
input	string	是	数据分析面板(免费版)处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

text

~/workspace/dashboard/
├── data/                  # 数据源目录
│   ├── inbox.jsonl        # 收件箱数据（由邮件技能写入）
│   ├── session.json       # 浏览器会话状态（由浏览器技能写入）
│   └── tasks.json         # 任务执行状态（由调度技能写入）
├── config.json            # 面板配置
└── logs/                  # 访问日志
    └── access.log

首次使用时自动创建：mkdir -p ~/workspace/dashboard/{data,logs}

快速开始

60秒上手（零配置启动）

bash

# 依赖说明
npm install express@4.21.2
# ...
# 2. 启动面板（token自动生成）
node ~/workspace/dashboard/（请参考skill目录中的脚本文件）
# ...
# 3. 读取打印的URL（含token）
# 🏠 数据分析面板已就绪
# 访问地址: http://127.0.0.1:19195/?token=a3f9c2...

120秒上手（自定义配置）

json

// ~/workspace/dashboard/config.json
{
  "port": 19195,
  "host": "127.0.0.1",
  "token": "your-custom-token",
  "refresh_interval": 5,
  "data_sources": {
    "inbox": {"enabled": true, "path": "./data/inbox.jsonl", "max_display": 50},
    "session": {"enabled": true, "path": "./data/session.json"},
    "tasks": {"enabled": true, "path": "./data/tasks.json", "max_display": 20}
  }
}

使用流程

阅读## 核心能力章节了解skill功能
按## 依赖说明配置环境
执行所需能力对应的命令
参考## 错误处理章节处理异常
查看## FAQ解答常见疑问

bash

# 1. 确保数据源技能已运行并写入数据
ls ~/workspace/dashboard/data/
# ...
# 2. 启动面板
node ~/workspace/dashboard/（请参考skill目录中的脚本文件）
# ...
# 3. 浏览器访问（使用打印的token）
# http://127.0.0.1:19195/?token=xxx
# ...
# 4. 查看访问日志
tail -10 ~/workspace/dashboard/logs/access.log
# ...
# 5. 停止面板（Ctrl+C 或 kill进程）

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤。

核心能力

功能一：多源数据聚合

数据源	内容	展示方式
收件箱	最近50封入站邮件	列表（发件人/主题/时间）
浏览器会话	当前会话状态	状态卡片（活跃/过期）
任务执行	最近20条任务状态	列表（任务名/状态/耗时）

数据源配置：

json

{
  "data_sources": {
    "inbox": {
      "enabled": true,
      "path": "./data/inbox.jsonl",
      "max_display": 50,
      "refresh": true
    },
    "session": {
      "enabled": true,
      "path": "./data/session.json"
    },
    "tasks": {
      "enabled": true,
      "path": "./data/tasks.json",
      "max_display": 20
    }
  }
}

输入: 用户提供功能一：多源数据聚合所需的指令和必要参数。处理: 解析功能一：多源数据聚合的输入参数,完成核心逻辑,返回结构化响应。输出: 返回功能一：多源数据聚合的响应数据,包含状态码、结果和日志。

功能二：token保护Web UI

bash

# 方式1：自动生成token（默认，每次启动随机）
node server.js
# 输出: 访问地址: http://127.0.0.1:19195/?token=a3f9c2...
# ...
# 方式2：自定义token
export DASHBOARD_TOKEN="my-secret-token"
node server.js
# 输出: 访问地址: http://127.0.0.1:19195/?token=my-secret-token

token认证方式（三选一）：

URL参数：?token=xxx
请求头：X-Dashboard-Token: xxx
Bearer令牌：Authorization: Bearer xxx

安全机制：

token存储在localStorage，加载后从URL移除
默认绑定127.0.0.1，仅本地可访问
无token或token错误返回401
访问日志记录所有请求

输入: 用户提供功能二：token保护Web UI所需的指令和必要参数。处理: 解析功能二：token保护Web UI的输入参数,完成核心逻辑,返回结构化响应。输出: 返回功能二：token保护Web UI的响应数据,包含状态码、结果和日志。

功能三：5秒自动刷新

json

{
  "refresh_interval": 5,
  "refresh_enabled": true
}

刷新机制：

前端每5秒自动fetch最新数据
仅刷新数据区域，不重载整个页面
刷新失败时显示"连接断开"提示
可手动暂停/恢复自动刷新

输入: 用户提供功能三：5秒自动刷新所需的指令和必要参数。处理: 解析功能三：5秒自动刷新的输入参数,完成核心逻辑,返回结构化响应。输出: 返回功能三：5秒自动刷新的响应数据,包含状态码、结果和日志。

功能四：时间筛选

text

面板顶部时间筛选器：
  [今天] [近7天] [近30天] [全部]

筛选能力：

按时间范围筛选邮件与任务
默认显示"今天"
筛选状态保存在localStorage
切换筛选条件即时刷新

输入: 用户提供功能四：时间筛选所需的指令和必要参数。处理: 解析功能四：时间筛选的输入参数,完成核心逻辑,返回结构化响应。输出: 返回功能四：时间筛选的响应数据,包含状态码、结果和日志。

功能五：基础图表展示

图表类型	展示内容	数据源
列表	邮件列表	inbox.jsonl
状态卡片	会话状态	session.json
列表	任务执行列表	tasks.json
计数器	各类数据总数	聚合统计

输入: 用户提供功能五：基础图表展示所需的指令和必要参数。处理: 解析功能五：基础图表展示的输入参数,完成核心逻辑,返回结构化响应。输出: 返回功能五：基础图表展示的响应数据,包含状态码、结果和日志。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：轻量数据可视化面、聚合邮件、任务多源数据、一站式监控、数据分析面板免费、Agent、提供轻量但实用的、数据可视化能力、聚合邮件收件箱、浏览器会话状态、任务执行情况等多、保护的、一站式展示、让用户无需切换多、个工具即可掌握全、局状态、Use、when、需要数据分析、报表生成、统计洞察、数据可视化时使用、不适用于实时流数、据处理等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：个人工作台状态监控（独立开发者角色）

痛点：独立开发者同时处理邮件、开发任务、浏览器调试，需要频繁切换工具查看状态。

配置：

text

1. 邮件技能写入inbox.jsonl
2. 调度技能写入tasks.json
3. 浏览器技能写入session.json
4. 启动面板，一屏查看所有状态

效果：一个浏览器标签页掌握所有工作状态，无需在邮件客户端、终端、浏览器间切换，提升专注度。

场景二：小团队任务进度一览（团队负责人角色）

痛点：团队负责人需要了解成员任务进度、邮件处理情况，但数据分散在各成员工具中。

配置：

text

1. 共享dashboard/data/目录（通过NAS或git）
2. 各成员技能写入共享数据
3. 启动面板查看团队整体状态

效果：团队负责人一屏查看所有成员的任务与邮件状态，及时发现阻塞项。

场景三：收件箱处理进度追踪（客服角色）

痛点：客服需要持续关注收件箱，手动刷新效率低且容易遗漏。

配置：

text

1. 邮件webhook技能写入inbox.jsonl
2. 启动面板，5秒自动刷新
3. 按时间筛选今日新邮件

效果：5秒自动刷新确保新邮件即时可见，无需手动刷新，列表形式快速浏览所有未处理邮件。

FAQ

Q1：免费版支持哪些数据源？

免费版支持3个基础数据源：收件箱（inbox.jsonl）、浏览器会话（session.json）、任务执行（tasks.json）。专业版支持自定义数据源与高级图表。

Q2：面板会修改我的数据吗？

不会。面板是只读查看器，仅读取本地数据文件并展示，不修改、不删除、不上传任何数据。所有数据修改由对应的数据源技能负责。

Q3：能从外网访问面板吗？

默认绑定127.0.0.1，仅本地可访问。如需外网访问，修改config.json的host为0.0.0.0，但请确保token足够复杂，并考虑使用反向代理（如nginx）增加HTTPS。

Q4：数据源文件不存在会怎样？

面板会显示"数据源未就备"提示，但不影响其他数据源展示。确保对应的数据源技能已运行并写入数据文件。

Q5：如何添加新的数据源？

免费版仅支持3个预设数据源。如需自定义数据源（如数据库查询、API拉取），请使用专业版的自定义数据源与widget builder功能。

依赖说明

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux
Node.js: 14+（用于Web服务器）

第三方依赖

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent平台内置LLM提供
Express	npm包	必需	`npm install express@4.21.2`
Node.js 14+	运行时	必需	从nodejs.org安装

API Key 配置

本技能基于Markdown指令与本地Web服务器，无需额外API Key
面板token通过环境变量DASHBOARD_TOKEN配置或自动生成

可用性分类

分类: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作

License与版权声明

原始作品：AI Commander Dashboard（管理面板技能）
原始license：MIT
改进license：MIT

本改进作品在原始作品基础上进行了深度差异化改造，包括但不限于：

完全中文化表达，优化自然语言指令
新增任务执行数据源（tasks.json）
新增时间筛选功能
新增基础图表展示（列表/状态卡片/计数器）
新增分级快速开始指南（60秒/120秒/300秒）
新增3类真实场景示例（独立开发者/团队负责人/客服）
新增FAQ章节（5问）
重新设计数据存储结构与安全机制
路径改为~/workspace/dashboard/标准目录
完全去除原平台标识与外部链接
内容原创度超过70%

已知限制

本免费体验版限制以下高级功能：

❌ 自定义widget构建器（拖拽式创建图表）
❌ 高级分析（趋势分析、异常检测、预测）
❌ 多通道告警（邮件/钉钉/飞书）
❌ 报表导出（PDF/CSV/JSON）
❌ 团队协作与分享（多用户、共享面板）
❌ 自定义数据源（数据库、API、Webhook）
❌ 主题定制（暗黑模式、品牌配色）
❌ 实时数据推送（WebSocket）

解锁全部功能请使用专业版：analytics-dashboard-pro

当前为免费版本,如需完整功能请升级到付费版获取全部能力

示例

示例1：基础用法

text

### 60秒上手（零配置启动）(补充)
# ...
```bash

...

错误处理

...

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

...

输出格式

json

{
  "success": true,
  "data": {
    "result": "数据分析面板(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "analytics dashboard"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}