用途:ByteRover Explore 提供一套结构化流程,用于系统探索代码库与文档,并把发现整理进 ByteRover 的上下文树,覆盖代码结构、文档与知识缺口。适用于接手陌生代码库、新项目入职、重大变更后审计知识覆盖度,以及从零构建项目知识库。
主要能力与流程:先运行 brv status 检查状态,若出错需在 brv 终端解决。第一阶段用 brv query 查询已有知识,避免重复工作。第二阶段做代码库映射,逐项阅读真实文件后用 brv curate 整理,涵盖技术栈(包清单、配置文件、SDK 导入)、架构与结构(目录布局、入口点、模块边界、数据流)、约定与模式(lint/格式化配置、命名、导入顺序、错误处理)、测试模式(框架、组织、mock、fixture)、集成(环境变量示例、SDK、数据库、ORM、迁移)以及风险与技术债(TODO/FIXME、大文件、空桩、安全问题)。第三阶段评估文档覆盖度并做知识缺口分析,对覆盖不足的区域补充整理。完成后用 brv query 汇总验证,并向用户报告探索区域、关键发现、剩余缺口与建议下一步。
使用方式:核心命令为 brv status、brv query "..."、brv curate "..." -f <文件>,可用 brv curate view <logId> 验证存储内容,brv curate view --help 查看选项。
限制与规则:不得读取 .env、.key、credentials.json 等机密文件;每条发现须引用具体文件路径;表述应具规定性;大上下文需拆分为多次 brv curate;用 -f 让 ByteRover 直接读文件,每条命令最多 5 个文件;查询要具体;关键上下文存储后应验证。具体收费、平台支持等信息暂未提供。