Dashboard

Dashboard Skill 是一套面向开发者和数据工程师的本地仪表盘构建方法论与架构指南。该技能并非提供开箱即用的软件，而是通过系统化的文档指导用户从零构建自定义数据可视化中心，支持 API、数据库、IoT 传感器及业务指标等多源数据接入。

核心用法遵循"脚本化优先"原则（Scriptable > Heartbeat）。用户通过建立 ~/dashboards/ 目录结构，利用 cron 脚本定期抓取数据生成 data.json，再由静态 HTML 页面读取展示。这种架构将昂贵的 Agent 调用转化为免费的系统定时任务，仅在初始设置、故障排查或设计变更时才需 Agent 介入。技能强制要求执行"视觉 QA 循环"——在交付前必须通过浏览器截图验证无文字重叠、字体可读（正文≥14px，KPI≥24px）、色彩对比度符合 WCAG AA 标准等七项视觉准则，确保交付质量。

显著优点体现在成本效益与安全性设计。通过将数据获取脚本化，实现零 Token 成本的持续监控；架构默认监听 127.0.0.1 确保本地隐私；提供完整的安全清单（Security Checklist）要求凭据存于 Keychain、避免日志记录敏感数据；法律边界章节明确区分了官方 API、网页截图、逆向工程的风险等级，引导用户合规使用。同时支持通过 registry.json 管理多项目，可扩展至数十个仪表盘。

潜在局限包括：作为 T3 级社区文档，缺乏官方技术支持与持续维护保障；纯文档形态意味着用户需具备 Bash、HTML/CSS、JavaScript 开发能力；截图策略虽提供了无 API 场景下的解决方案，但存在违反服务条款（ToS）的合规风险，且需额外配置 headless 浏览器环境；对于需要秒级实时更新的场景，文件轮询架构可能不适用。

适合群体主要为具备技术背景的开发者、DevOps 工程师、数据分析师，以及注重数据隐私、希望自托管监控面板而非使用 SaaS 服务的中小企业。特别适合需要集成内部系统、IoT 设备或小众数据源，且对实时性要求不极端（分钟级更新）的场景，也适合作为团队内部数据可视化标准的技术规范。

使用风险主要来自合规与技术实现两方面：截图自动化可能触犯某些平台的使用条款，需严格控制频率（建议每日 1-2 次）；多数据源集成时需自行处理速率限制、熔断机制与令牌刷新，文档虽提供指导但需用户正确实现；虽然文档建议使用 Keychain，但用户若未遵循安全清单，仍可能因配置不当导致凭据泄露。此外，长期维护 cron 脚本、处理 API 变更或数据格式演变需要持续的工程投入。