olares-dashboard

dashboard（概览 + 应用，AI Agent 优先）

**共享入口：**加载 ../olares-shared/SKILL.md，了解套件路由、活动配置文件选择、平台入口，以及认证继续/停止关卡。只有在确实需要登录、切换配置文件、存储令牌或恢复认证时，才加载其中的认证参考。

使用 olares-cli dashboard <verb> --help 查看语法。

适用场景

• 查看 CPU、内存、磁盘、网络、Pod、风扇或 GPU 指标。
• 按资源使用量排列应用/工作负载。
• 观察仪表板指标随时间的变化，或使用其稳定的 JSON 信封。

**思维模型：**dashboard 回答的是“资源使用情况和健康状态如何”。如需查看清单和生命周期，请转到其他位置。如果指标显示存在问题（资源压力，或处于 running 状态但运行缓慢/无法访问的应用），请交给 ../olares-doctor/SKILL.md 进行根因诊断。

快速入口

任务	阅读	首条命令
查看机器当前负载	本文件	olares-cli dashboard overview -o json
查找哪个应用正在使用资源	本文件	olares-cli dashboard applications -o json
查看某项指标并了解其含义	概览各部分的含义	olares-cli dashboard overview memory -o json
判断空结果是否表示失败	信封和空状态	olares-cli dashboard overview gpu -o json，然后读取 meta.empty_reason

持续观察不是快速入口——观察、时间窗口、NDJSON 是单独的阅读内容，而且观察指标绝不是处理它时的第一步。

子命令索引

子命令	用途	触发时阅读
applications（apps）	按工作负载粒度显示资源表	表格中的行代表工作负载，而非应用，因此一个应用可能占据多行；通过 (app, namespace) 与 overview ranking 联结
overview	物理、用户和排名部分	概览各部分的含义；信封和空状态
`overview cpu	memory	disk
schema	提供的 JSON 架构	这是 CLI 唯一一个无需运行就能说明输出结构的地方；阅读它，而不是抽样查看实时响应
任何带有观察/时间窗口意图的指标	重复快照/历史时间窗口	观察、时间窗口、NDJSON

信封和能力语义

• 自动化应依据 kind、raw 和 meta.empty_reason，而不是表格标签。
• 没有硬件、没有集成或受到能力门控时，通常会返回 exit 0 的空信封，而非命令失败。
• 聚合子命令（overview、overview disk|fan|gpu）仅在所有部分都带有 meta.error 时才以非零状态退出；部分降级的信封仍是 exit 0 的真实数据。无论退出状态如何，信封都会输出到 stdout，因此应读取各部分的错误，而不要只看退出代码。
• 整个实例中断时，每个部分都会显示 HTTP 530——Olares 无法访问，因此请先确认其处于在线状态，再诊断 dashboard 本身。
• 只有在 Olares One 上，风扇指标才有意义。设备门控提示该功能不可用后，请停止探测。
• 对于非管理员配置文件，GPU 侧边栏被隐藏仅供参考；如果仍返回数据，就无需据此判断。vgpu_unavailable 是暂时性证据，并不能证明设备没有 GPU。

监控与诊断

• 监控会持续输出快照；JSON 模式采用 NDJSON。按 Ctrl-C 会结束观测，但不会停止任何工作负载。
• 监控会在迭代多次失败后中止。请区分临时指标收集失败和实际资源压力。
• 根据用户的问题选择相对或绝对时间窗口，不要同时使用两者。
• 仪表板用于定位压力，不负责解释 Pod 调度、崩溃、镜像拉取或入口故障。请将这些问题交由 olares-doctor 处理。

安全与升级处理

• 仪表板为只读，但跨用户指标需要平台管理员权限。未经批准，不要切换配置文件或扩大目标用户范围。
• 不要将空的集成封套报告为“健康”或“零使用量”；应保留其为空的原因。
• 对持续存在的上游指标错误，在有限次数的重试后停止并升级处理，同时说明受影响的部分和时间窗口。