数据分析面板（免费版）

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

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

核心理念

只读安全原则：

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

职责边界：

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

数据存储

输入格式

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

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

快速开始

60秒上手（零配置启动）

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

120秒上手（自定义配置）

// ~/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解答常见疑问

# 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进程）

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

核心能力

功能一：多源数据聚合

数据源配置：

{
  "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

# 方式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秒自动刷新

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

刷新机制：

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

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

功能四：时间筛选

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

筛选能力：

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

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

功能五：基础图表展示

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

使用场景

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

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

配置：

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

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

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

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

配置：

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

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

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

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

配置：

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服务器）

第三方依赖

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

...

错误处理

...

...

...

输出格式

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

...