用途:Beads Viewer(BV)是面向 Beads 项目(.beads/beads.jsonl)的图感知分诊引擎,用于分诊任务、分析依赖图、查找瓶颈、检测循环依赖、规划并行执行轨道、生成冲刺燃尽数据以及比较历史项目状态。
主要能力:计算 9 种图指标,包括 PageRank、Betweenness、HITS、关键路径、Eigenvector、Degree、Density、Cycles 和拓扑排序,并输出执行计划与确定性建议。指标分两阶段计算:第一阶段(degree、topo sort、density)即时完成;第二阶段(PageRank、betweenness、HITS、eigenvector、cycles)有 500ms 超时。
使用方式:在代理会话中必须始终使用 --robot-* 标志,不能运行裸 bv 命令——裸 bv 会启动交互式 TUI 并阻塞会话。常用命令包括 bv --robot-triage(完整分诊与建议)、bv --robot-next(单一最优项)、bv --robot-plan(并行执行轨道)、bv --robot-insights(全部 9 项指标)、bv --robot-priority、bv --robot-alerts、bv --robot-suggest、bv --robot-graph(支持 JSON、DOT、Mermaid 格式)。可用 bv --recipe <name> --robot-<cmd> 预过滤,内置 recipe 有 default、actionable、high-impact、blocked、stale、triage、quick-wins、bottlenecks。也可用 --label 限定子图。
输出结构:所有 robot JSON 输出包含 data_hash(验证一致性)、status(每项指标状态:computed、approx、timeout 或 skipped),使用 --as-of 时包含 as_of / as_of_commit。仅 stdout 是 JSON,诊断与警告输出到 stderr。
适用场景:适合在开始实现前检查循环依赖、规划冲刺工作、分析项目依赖健康和查找瓶颈。
限制:不适合直接解析原始 beads.jsonl(BV 已预计算图指标)、简单 bead CRUD 操作(应使用 bd CLI),以及没有 .beads/beads.jsonl 的项目。大图可能因 500ms 超时导致部分指标为 approx 或 skipped,需检查 status 字段。结果按 beads.jsonl 指纹缓存,变更后需检查 data_hash。
收费、价格、平台和具体安装步骤在现有资料中暂未提供。