SuperAPI AI 工具集

bv

智能体与模型

查看项目

更新于 10-15 21:09

技能介绍

BV(Beads Viewer)是面向 Beads 项目(.beads/beads.jsonl)的图感知分诊引擎,计算 9 项图指标、生成执行计划并给出确定性建议。它提供人类使用的 TUI 浏览界面,以及供 AI 智能体使用的 --robot-* 标志。相比直接解析 beads.jsonl,BV 以固定摘要结构降低上下文成本,并预先计算图逻辑(PageRank、介数、环),显式标记循环依赖。

主要能力:计算 PageRank、Betweenness、HITS、关键路径、Eigenvector、Degree、Density、Cycles、Topo Sort 共 9 项指标;支持分诊与规划(--robot-triage、--robot-next、--robot-plan、--robot-priority)、图分析(--robot-insights、--robot-label-health、--robot-label-flow、--robot-label-attention)、历史与变更(--robot-history、--robot-diff --diff-since <ref>),以及 --robot-burndown、--robot-forecast、--robot-alerts、--robot-suggest、--robot-graph、--export-graph 等命令。内置 default、actionable、high-impact、blocked、stale、triage、quick-wins、bottlenecks 等 recipe,并支持 --label、--as-of、--recipe 等范围与过滤选项。

使用方式:智能体切勿直接运行裸 bv,因其会启动阻塞会话的交互式 TUI,应始终使用 --robot-* 标志,例如 bv --robot-triage、bv --robot-next、bv --robot-plan、bv --robot-insights。机器人输出为 JSON,包含 data_hash、status(computed|approx|timeout|skipped)等字段,可用 jq 提取。典型工作流:先运行 bv --robot-triage 获取建议,再用 bv --robot-insights 检查 cycles,随后用 br claim 认领任务、br close 关闭。BV 读取由 br CLI 创建的 .beads/beads.jsonl,可与 Agent Mail 通过 bead ID 作为 thread ID 协同。

限制:分析采用两阶段异步计算,第一阶段(degree、topo sort、density)即时完成,第二阶段(PageRank、betweenness、HITS、eigenvector、cycles)有 500ms 超时;大型图(超过 500 节点)部分指标可能为近似值或被跳过,需检查 status 字段。结果按 data_hash 缓存。TUI 视图(列表、看板、图、树、洞察、历史、计划、流矩阵、注意力)仅供人类交互使用。具体安装方式、收费与平台支持暂未提供。