ByteRover 概览
ByteRover 为 AI 代理提供长期记忆，通过本地知识管理系统保持跨会话一致性。
使用 brv CLI 可将项目模式、架构决策与编码规则以 Markdown 形式存入 `.brv/context-tree/`，并在执行任务前查询。
工作原理
在任务开始前使用 `brv query` 检索相关知识。
完成变更后运行 `brv curate` 保存新模式、决策与规则。
知识以 Markdown 形式存放在 `.brv/context-tree/`，便于版本控制。
需要时使用 `brv login`、`brv push` 与 `brv pull` 进行云同步。
核心功能
知识查询
用自然语言问题通过 `brv query` 获取相关上下文。
上下文归档
通过 `brv curate` 保存新规则与决策，可附带最多 5 个源文件。
无需 API Key
默认 ByteRover LLM 可直接使用，无需额外 Key。
多模型支持
可选择接入 OpenAI、Anthropic、Google 等自有提供商。
归档历史
使用 `brv curate view` 查看历史记录并按时间/状态过滤。
可选云同步
认证后可将知识同步到 ByteRover 云端进行团队共享。
可读存储
所有知识以 Markdown 形式存储在本地目录中。
环境要求
- 无需虚拟机。
- 安装 brv CLI 需要 Node.js。
使用场景
跨会话一致性
记住项目约定、编码模式与关键决策。
架构文档
存储并回忆架构规则、认证模式、数据库结构与设计决策。
团队知识共享
通过云同步共享知识库。
快速上手
新人或新代理可以查询知识库了解项目规范。
安装方式
npx clawhub@latest install byterover在终端运行命令，或点击页面顶部安装按钮一键完成。
常见问题
使用 ByteRover 需要 API Key 吗？
本地使用不需要；只有启用云同步时才需要。
知识存储在哪里？
存放在本地 `.brv/context-tree/` 目录中的 Markdown 文件。
可以使用自己的 LLM 提供商吗？
可以。支持自带 LLM，按 ByteRover 文档配置即可。
数据会发送到 ByteRover 服务器吗？
只有开启云同步时才会发送；否则全部保留在本地。
如何查询或归档上下文？
用 `brv query` 检索，用 `brv curate` 保存新知识。
可以团队同步吗？
可以。`brv login` 认证后使用 `brv push` 与 `brv pull`。