> 核心功能: 本技能提供中文交互、化工作流场景等能力。

AIC 仪表盘监控

AI Commander 配套管理仪表盘。轻量级只读 Web UI,读取邮件收集器写入的 inbox.jsonl 和浏览器认证写入的 session.json,在 token 保护的本地端口统一展示。不捕获凭证、不控制浏览器、不发送消息.
范围外（本技能不做）: 邮件收发、浏览器自动化控制、凭证捕获与存储、远程会话管理.

输入定义

专业版增值服务

前置条件

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

能力矩阵

• 邮件展示: 读取 inbox.jsonl,显示最近 50 封入站邮件的发件人、主题、时间、摘要
• 会话状态: 读取 session.json,显示浏览器会话是否活跃、隧道地址、过期时间
• Token 保护: 所有请求需携带有效 token,支持 3 种传递方式
• 自动刷新: 前端每 5 秒轮询后端,无需手动刷新页面
• 零配置启动: 未设置 DASHBOARD_TOKEN 时自动生成随机 token

快速入门指南

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

环境变量

安全机制

• 每次启动时,若 DASHBOARD_TOKEN 未设置则生成 32 字符随机 token
• 所有请求必须携带 token,支持 3 种方式:
• URL 查询参数: ?token=未指定
• 请求头: X-Dashboard-Token: 未指定
• Bearer 认证: Authorization: Bearer 未指定
• 前端将 token 存入 localStorage,页面加载后从 URL 中移除,避免泄露
• 默认绑定 127.0.0.1,仅本机可访问;需局域网访问时设 DASHBOARD_HOST=0.0.0.0

使用说明

Step 1: 安装依赖

npm install express@4.21.2

Step 2: 启动服务

# 零配置启动（自动生成 token）
node （请参考skill目录中的脚本文件）
# ...
# 自定义端口与 token
DASHBOARD_TOKEN=mysecret123 PORT=8080 node （请参考skill目录中的脚本文件）

Step 3: 获取访问 URL

启动后终端输出:

AIC DASHBOARD READY
Access URL: http://127.0.0.1:19195/?token=a3f9c2e7b1d4...

Step 4: 浏览器访问

复制完整 URL（含 token）到浏览器打开。页面加载后 token 自动存入 localStorage,URL 中的 token 被清除.

Step 5: 验证数据源

• 邮件区为空: 检查 INBOX_PATH 指向的 inbox.jsonl 是否存在且有内容
• 会话显示离线: 检查 SESSION_PATH 指向的 session.json 是否存在且未过期

案例展示

案例1: 本机默认启动

场景: 开发者需要快速查看邮件收集器与浏览器会话状态

node （请参考skill目录中的脚本文件）

输出:

AIC DASHBOARD READY
0.0.1:19195/?token=a3f9c2e7b1d4f8a6...

说明: 零配置启动,自动生成 token,绑定 127.0.0.1:19195,仅本机可访问。读取 ./data/inbox.jsonl 与 ./data/session.json.

案例2: 局域网共享监控面板

场景: 团队需要在同一局域网内共享监控面板

DASHBOARD_HOST=0.0.0.0 PORT=19195 DASHBOARD_TOKEN=team-shared-key node （请参考skill目录中的脚本文件）

输出:

AIC DASHBOARD READY
Access URL: http://0.0.0.0:19195/?token=team-shared-key

说明: 绑定 0.0.0.0 允许局域网设备通过 http://<本机IP>:19195/?token=team-shared-key 访问。使用固定 token 便于团队共享.

案例3: 自定义数据源路径

场景: 邮件与会话数据存储在非默认位置

INBOX_PATH=/var/data/mail/inbox.jsonl \
SESSION_PATH=/var/data/auth/session.json \
node （请参考skill目录中的脚本文件）

说明: 通过环境变量指向自定义路径,仪表盘读取指定文件渲染内容.

异常应对机制

热门问题

Q1: 仪表盘是只读的吗? 会修改邮件或会话数据吗?

A: 是的,仪表盘是纯只读视图。仅读取 inbox.jsonl 与 session.json 文件内容进行展示,不写入、不修改、不删除任何数据,也不发送邮件或控制浏览器.

Q2: token 每次启动都变吗?

A: 若未设置 DASHBOARD_TOKEN 环境变量,每次启动都会生成新的随机 token。如需固定 token,启动前设置 DASHBOARD_TOKEN=your-fixed-token.

Q3: 如何让团队其他成员访问仪表盘?

A: 将 DASHBOARD_HOST 设为 0.0.0.0,团队成员通过 http://<你的IP>:<PORT>/?token=<TOKEN> 访问。注意: 局域网内任何拿到 token 的人都能访问,请妥善保管.

Q4: 最多显示多少封邮件?

A: 仪表盘读取 inbox.jsonl 的最后 50 封邮件进行展示。如需查看更多,建议直接查看原始 JSONL 文件或调整收集器的轮转策略.

Q5: 页面需要手动刷新吗?

A: 不需要。前端每 5 秒自动向后端轮询最新数据,邮件与会话状态会自动更新。也可手动刷新页面强制重新加载.

Q6: 浏览器会话状态显示"离线"是什么意思?

A: 表示 session.json 文件不存在、内容为空或会话已过期。检查浏览器认证服务是否正常运行,以及 SESSION_PATH 路径是否正确.

使用约束

1. 仅展示最近 50 封邮件: 不支持分页浏览历史邮件,需查看原始文件获取完整记录
2. 只读视图: 不支持邮件回复、会话控制等写操作
3. 依赖外部数据源: 邮件与会话数据由配套服务写入,仪表盘本身不采集数据
4. Token 安全性: token 以明文形式存在于 URL 与 localStorage,HTTPS 环境下更安全
5. 单用户设计: 不支持多用户权限隔离,任何持有 token 的人拥有完整查看权限
6. Node.js 依赖: 需安装 express@4.21.2,非零依赖运行

问题排查手册

创新亮点

| 效率提升量化分析 |
| --- | --- |
| 邮件监控效率提升 | 30% | 通过自动刷新机制，用户无需手动刷新页面即可获取最新邮件信息，节省了时间 |
| 会话状态监控效率提升 | 25% | 自动轮询会话状态，减少了对浏览器或邮件服务的直接查询，提高了效率 |
| 数据展示清晰度提升 | 20% | 清晰的 Web UI 展示，提高了用户对数据的理解速度和决策效率 |
| 安全性提升 | 15% | Token 保护机制，有效防止未授权访问，提高了数据安全性 |

| 差异化对比表格 |
| --- | --- |
| 产品 | AIC仪表盘监控 | 其他邮件监控工具 |
| 功能 | 轻量级只读监控，展示入站邮件和浏览器会话状态 | 可能包含邮件收发、浏览器自动化控制等复杂功能 |
| 安全性 | Token 保护，防止未授权访问 | 可能存在安全漏洞，如密码存储、传输加密等 |
| 易用性 | 轻量级 Web UI，操作简单 | 可能需要复杂的配置和操作 |
| 性能 | 高效的数据读取和展示，自动刷新 | 可能存在性能瓶颈，如邮件查询速度慢等 |

功能梳理

• 自动化执行: 轻量级只读监控面板,展示入站邮件与浏览器会话状态,token保护,5秒自动刷新。AI Commander 配套管理仪表盘
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

用户问题解答

Q1: AIC仪表盘监控支持哪些输入格式？

A1: 轻量级只读监控面板,展示入站邮件与浏览器会话状态,token保护,5秒自动刷新。轻量级只读 Web UI,读取 inb。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

性能评估

优势分析