gc-dashboard 是一个编译进 gc 二进制的 Web UI,用于实时监控 convoys、agents、mail、rigs、sessions 和 events。它同时包含 API server 与 Web 面板,面板本身作为独立 Web 服务器运行,需要连接一个 GC API server。
在独立城市(standalone city)模式下,面板与某个城市自带的 API server 通信,需在城市配置文件 city.toml 中启用:[api] port = 9443,然后正常执行 gc start,API server 会随控制器在该端口启动。若使用机器级 supervisor,面板则改为与 supervisor API 通信(默认地址 http://127.0.0.1:8372),此时各城市的 [api] 端口会被忽略。面板会通过 /v0/cities 自动识别 supervisor 模式,启用城市选择器,并将请求路由到 /v0/city/{name}/...。
启动命令包括:gc dashboard(自动发现 API server 并在浏览器打开面板)、gc dashboard --no-open(打印面板 URL 而不打开浏览器)、gc dashboard serve(打印面板的 Web 服务位置)。此外还可通过 gc dashboard --city /path/to/city 提供独立发现所需的城市上下文,或使用 gc dashboard --api http://127.0.0.1:8372 覆盖默认地址。自动发现顺序为:supervisor 管理的城市(使用 supervisor API 并默认显示 supervisor 视图,在城市 UI 中选择城市)、独立城市上下文(使用该城市配置的 [api] 监听器)、无城市上下文时若机器 supervisor 正在运行则使用 supervisor API 并显示 supervisor 级状态。
功能涵盖:Convoys 进度跟踪与创建、Crew 命名 worker 状态与活动检测、Polecats 临时 worker 活动与工作状态、活动时间线(可筛选的分类事件流)、Mail 收件箱与线程/撰写/全部流量视图、Merge queue 展示开放 PR 及其 CI 与可合并状态、Escalations 按优先级着色的升级列表、Ready work(可分配项)、Health(系统心跳与 agent 计数)、Issues(含优先级、年龄、标签、分配的 backlog)以及命令面板(Cmd+K)在浏览器中执行 gc 命令。面板通过 API server 的 SSE(Server-Sent Events)实现实时更新。
限制:资料未说明其收费、价格或具体平台支持范围;面板依赖 GC API server,单独使用需自行准备对应服务。