SuperAPI AI 工具集

byterover-headless

通用与其它

查看项目

更新于 10-16 05:44

技能介绍

ByteRover 是一个知识库管理工具,通过 brv 命令行维护一棵上下文树,用于保存项目的模式、决策与实现细节。本技能面向无头/自动化使用,重点是加 --headless --format json 以取得可机器解析的 JSON 输出(brv login 除外,其输出文本)。

用途与准备:先确认是否已登录且已在当前目录初始化 .brv/,可运行 brv status --headless --format json,查看 authStatus 与 projectInitialized。若未就绪,需要用户提供 API key(从 https://app.byterover.dev/settings/keys 获取)以及团队和空间(名称或 ID)。

主要命令:登录使用 brv login --api-key <key>;初始化使用 brv init --headless --team my-team --space my-space --format json(可用 ID,亦可用名称,名称不区分大小写,强制重初始化加 --force);检索知识使用 brv query "问题" --headless --format json;添加上下文使用 brv curate "内容" --headless --format json,可用 --files 附带相关文件(最多 5 个);同步使用 brv push 与 brv pull,可加 --branch 指定分支,push 需加 -y 跳过确认。

返回与限制:所有 JSON 响应含 success 字段,失败时检查 data.error 或 data.message。pull 在存在未推送的本地改动时会失败(状态 local_changes),需先 push;push 状态可能为 success、no_changes、cancelled、error。执行 push/pull 前应先征得用户许可。资料未提供价格、平台范围等信息。