AIC仪表盘监控
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/analytics-dashboard-free。
技能介绍
要解决什么问题
在跑 AI Commander 这类多组件编排时,邮件收集器会往 inbox.jsonl 里追加入站记录,浏览器认证服务会写 session.json 表示隧道和会话是否还活着。若只靠 tail 或手工打开 JSON,很难一眼确认「最近来了哪些信、会话有没有掉线」,也缺少统一的只读观察面。
本技能提供 轻量级只读 Web UI:在本地端口挂载面板,从配置路径读取上述两个文件并渲染,全程不写入数据、不代发邮件、不驱动浏览器。
技能如何工作
- 邮件区:解析
inbox.jsonl,展示最近 50 封入站邮件的发件人、主题、时间、摘要。 - 会话区:读取
session.json,展示会话是否活跃、隧道地址、过期时间等状态字段。 - 访问控制:所有 HTTP 请求须携带有效
DASHBOARD_TOKEN(查询参数、X-Dashboard-Token或 Bearer);未设置环境变量时启动会自动生成随机 token。 - 数据刷新:前端每 5 秒轮询后端,邮件与会话块随文件变化更新,无需手动刷新页面。
典型启动链:确认 INBOX_PATH / SESSION_PATH 指向真实数据源 → 设定 PORT、DASHBOARD_HOST(本机默认 127.0.0.1)→ 用终端输出的带 token URL 打开浏览器;页面加载后 token 会落到 localStorage,URL 中的 token 会被清掉以降低泄露面。
适用边界与注意点
仪表盘 仅展示、不修改 上游文件;邮件与会话内容完全依赖邮件收集器与浏览器认证服务是否正常写入。不支持分页浏览 50 封以外的历史、不支持回复邮件或远程控制浏览器。默认绑定本机;若设 DASHBOARD_HOST=0.0.0.0 做局域网共享,任何持有 token 的人都可读全量展示内容,token 需自行保管。
使用场景
- 本地调试邮件收集器时,想在不打开 JSONL 的情况下核对最近入站主题与时间
- 浏览器认证写出 session.json 后,需确认隧道地址与会话过期时间是否仍有效
- AIC 多进程同机部署时,用单一页面同时扫邮件与会话两块状态
- 团队内网演示编排效果时,将 DASHBOARD_HOST 放开并用固定 token 共享只读面板
适合人员
- 自维护 AI Commander 编排、需对照 inbox 与 session 文件排障的集成工程师
- 负责邮件收集链路的同学,要在收集器跑通后快速确认写入是否正常
- 运维安全岗位中关注本地 token 暴露面、默认 127.0.0.1 绑定策略的审查者
- 在局域网内给同事展示只读运行态、又不愿开放邮件客户端权限的项目负责人