Analytics Dashboard Free

SKILL.md

---
slug: analytics-dashboard-free
name: analytics-dashboard-free
version: 1.0.0
displayName: 数据分析面板(免费版)
summary: 轻量数据可视化面板，聚合邮件、会话、任务多源数据，token保护，5秒自动刷新，一站式监控。
license: Proprietary
edition: free
description: 数据分析面板免费版为AI Agent提供轻量但实用的数据可视化能力。聚合邮件收件箱、浏览器会话状态、任务执行情况等多源数据，通过token保护的Web
  UI一站式展示，5秒自动刷新，让用户无需切换多个工具即可掌握全局状态。Use when 需要数据分析、报表生成、统计洞察、数据可视化时使用。不适用于实时流数据处理。
tags:
- 数据可视化
- 监控面板
- 集成工具
- 状态监控
tools:
- - read
- exec
homepage: https://skillhub.cn
pricing_tier: "L2-标准级"
pricing_model: per_use
suggested_price: "19.9 CNY/per_use"
tools: ["read", "write", "exec"]
tags: "工具,效率,自动化"
---
# 数据分析面板（免费版）

> **一站式监控你的邮件、会话与任务。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}
  }
}
```

### 使用流程

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## 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
- 改进作品：数据分析面板（免费版） © 2026
- 改进license：MIT

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

原始MIT license允许使用、复制、修改和分发，需保留版权声明。本改进作品在保留原始版权声明的基础上添加自有署名，完全符合MIT license要求。

## 已知限制

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

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

解锁全部功能请使用专业版：analytics-dashboard-pro
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力
## 示例

### 示例1：基础用法

```
### 60秒上手（零配置启动）(补充)
# ...
```bash
```
# ...
## 错误处理
# ...
# ...
| 错误场景 | 原因 | 处理方式 |
|:------|------:|:------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |
# ...
## 输出格式
```json
{
  "success": true,
  "data": {
    "result": "数据分析面板(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "analytics dashboard"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}
```
# ...