Studio Radar 是一个 Sanity Studio 应用(源码位于 dev/radar,部署在 https://radar.sanity.dev),读取由 CI 写入的数据集,用于在不打开 CI 日志的情况下回答仓库健康度问题:main 分支上的 studio 性能是否漂移、某次运行是什么样、哪个提交引入了问题、何时发布了什么。设计记录见 dev/radar/SPEC.md,修改行为时应同步更新对应章节。查找回归使用 sanity-radar-investigate,生成数据使用 sanity-bench。
主要视图(URL 路径即工具名):/trends 在 main 上按场景与指标绘制小多图,含 p50 线、p75–p90 区间、主机校准虚线、漂移基线叠加以及发布标记,是默认视图;/releases 列出每个同步的 v* 标签及其 dist-tags、下载量、更新日志链接和二分归因的回归;/bisect 基于 gitCommit 做受引导的首父二分,使用各提交的 test-studio 预览构建;/diagnostics 粘贴 studio 诊断 JSON 并渲染;/structure 显示原始文档;/comparisons 显示 A/B 运行的判定结果。
用法与限制:数据位于项目 mhfozd0z、数据集 bench,且为私有。读取需要具备该项目访问权限的令牌(CLI 令牌通过 sanity debug --secrets,或从 sanity.io/manage 获取查看者令牌;已部署的 studio 通过登录认证)。写入需要 RADAR_SANITY_WRITE_TOKEN,仅 CI 拥有,切勿在笔记本电脑上写入。本地运行命令包括 pnpm radar(在 http://localhost:3399 启动 sanity dev,需要 Sanity 登录并读取实时数据)、pnpm vitest run --project=radar、pnpm build:radar、pnpm --filter radar sync-git -- --dry-run(需要 GITHUB_TOKEN)。文档类型包括 benchRun、gitCommit、gitTag、bisectSession、releaseLine、driftAck,查询参考 references/groq-recipes.md。注意不要直接抓取会话文档,时间序列应使用 mode == "absolute",绝对数值与主机相关,需结合 runner.calibrationMs 与 runner.cpuModel 阅读,只有 A/B 比较的 verdict 与主机无关。日常 main 运行由 bench.yml cron 在 05:00 UTC 触发,git 同步在 05:30。其他未在资料中说明的平台支持、收费与限制暂未提供。