Agent Dashboard Sync
Operate dashboard data sync as a no-LLM pipeline.
Hard Rules
- 1. Keep high-frequency state out of Git commits.
- Use Cloudflare Worker + KV for runtime sync.
- Run collector from local cron (
*/2 * * * *) and do not call LLM in collector path. - Never commit or print production tokens/secrets in files, logs, or screenshots.
- Do not publish absolute paths in skill docs; use relative paths or placeholders (
<PROJECTS_ROOT>, <SHARED_ROOT>).
Scope Boundary
- - This skill owns: collector, Worker ingest/read API, KV schema, cron deployment, dashboard data source wiring.
- This skill does not own: cross-agent protocol, constitution governance, Discord routing rules.
KV Data Contract (v1)
- - INLINECODE3
- INLINECODE4
- INLINECODE5
- INLINECODE6
- INLINECODE7
- INLINECODE8
See references/schema.md for payload shape.
Minimal Rollout
- 1. Deploy Worker + KV namespace.
- Configure dashboard env to
cloudflare mode. - Install collector cron on each node with unique
AGENT_ID. - Verify
/health, then /fleet, then dashboard UI.
Security Checklist
- - Store
INGEST_TOKEN and READ_TOKEN as worker secrets. - Keep dashboard read token server-side (
DASHBOARD_READ_TOKEN), never client-exposed. - Keep
NEXT_PUBLIC_* vars non-sensitive only. - Redact tokens before sharing commands/logs.
Runbook Links
- - Worker setup and command sequence: INLINECODE18
- Collector and crontab setup: INLINECODE19
- Env variable matrix: INLINECODE20
- Data schema reference: INLINECODE21
- Security policy for all agents: INLINECODE22
技能名称: agent-dashboard-sync
详细描述:
代理仪表盘同步
以无大语言模型管道方式运行仪表盘数据同步。
硬性规则
- 1. 高频状态数据不得提交至Git提交记录。
- 使用Cloudflare Worker + KV实现运行时同步。
- 通过本地定时任务（/2 *）运行采集器，且采集器路径中不得调用大语言模型。
- 切勿在文件、日志或截图中提交或打印生产环境的令牌/密钥。
- 技能文档中不得发布绝对路径，应使用相对路径或占位符（ROOT>、ROOT>）。
范围边界
- - 本技能负责：采集器、Worker数据摄取/读取API、KV模式、定时任务部署、仪表盘数据源对接。
- 本技能不负责：跨代理协议、章程治理、Discord路由规则。
KV数据合约（v1版）
- - fleet:registry
- fleet:heartbeat:id>
- fleet:cron:id>
- fleet:runtime:id>
- fleet:events:recent
- fleet:updatedat
具体载荷格式请参见 references/schema.md。
最小化部署
- 1. 部署Worker及KV命名空间。
- 将仪表盘环境配置为 cloudflare 模式。
- 在每个节点上使用唯一 AGENT_ID 安装采集器定时任务。
- 依次验证 /health、/fleet，最后验证仪表盘用户界面。
安全检查清单
- - 将 INGESTTOKEN 和 READTOKEN 存储为Worker密钥。
- 仪表盘读取令牌保留在服务端（DASHBOARDREADTOKEN），切勿暴露给客户端。
- 仅保留非敏感信息的 NEXTPUBLIC* 变量。
- 在分享命令/日志前对令牌进行脱敏处理。
操作手册链接
- - Worker设置及命令序列：references/worker-setup.md
- 采集器及crontab设置：references/collector-cron.md
- 环境变量矩阵：references/env-matrix.md
- 数据模式参考：references/schema.md
- 所有代理的安全策略：references/security-rules.md
