ByteRover 知识管理

使用brv命令行界面来管理您项目的长期记忆。 安装：npm install -g byterover-cli知识存储在.brv/context-tree/目录下，为人类可读的 Markdown 文件。

无需身份验证。 brv query和brv curate开箱即用。仅在需要云同步（push/pull/space）时才需要登录——如果您不需要云功能，请忽略这些。

工作流程

1. 在思考之前：运行brv query以理解现有模式。
2. 实施后：运行brv curate以保存新的模式/决策。

命令

1. 查询知识

概述：从项目知识库中检索相关上下文。使用配置的LLM提供者，从.brv/context-tree/内容中综合答案。

在以下情况下使用此技能：

• 用户希望你回忆某些内容
• 你的上下文中不包含你需要的信息
• 你需要回忆你的能力或过去的操作
• 在执行任何操作之前，需要检查相关规则、标准或偏好

在以下情况下请勿使用此技能：

• 信息已存在于你当前的上下文中
• 查询是关于一般知识，而非存储的记忆

brv query "身份验证是如何实现的？"

2. 整理上下文

概述：分析并将知识保存到本地知识库。使用配置的LLM提供者对你提供的上下文进行分类和结构化处理。

在以下情况使用此技能：

• 用户希望你记住某些信息
• 用户有意整理记忆或知识
• 存在来自用户交互的有意义的、应被持久化的记忆
• 存在关于你所做之事、所知之事或你所做决定和行动的重要事实

在以下情况请勿使用此技能：

• 信息已存储且未更改
• 信息是临时的、仅与当前任务相关，或只是通用知识

brv curate "认证使用JWT，有效期24小时。令牌通过authMiddleware.ts存储在httpOnly cookie中"

包含源文件（最多5个，仅限项目范围内）：

brv curate "认证中间件详情" -f src/middleware/auth.ts

查看整理历史：以检查过去的整理记录

• 显示最近条目（最近10条）

brv curate view

• 查看特定条目的完整详情：所有文件和执行的操作（logId 由brv curate命令在完成时打印，例如cur-1739700001000）

brv curate view cur-1739700001000

• 列出包含可见文件操作的条目（无需logId）

brv curate view detail

• 按时间和状态筛选

brv curate view --since 1h --status completed

• 查看所有筛选选项

brv curate view --help

3. LLM 提供商设置

brv query和brv curate需要配置一个 LLM 提供商。连接默认的 ByteRover 提供商（无需 API 密钥）：

brv providers connect byterover

要使用其他提供商（例如 OpenAI、Anthropic、Google），请列出可用选项并使用您自己的 API 密钥进行连接：

brv providers list
brv providers connect openai --api-key sk-xxx --model gpt-4.1

4. 项目位置

概述：列出已注册的项目及其上下文树路径。返回项目元数据，包括初始化状态和活跃状态。使用-f json以获得机器可读的输出。

在以下情况下使用：

• 您需要查找项目的上下文树路径
• 您需要检查哪些项目已注册
• 您需要验证项目是否已初始化

在以下情况下请勿使用：

• 你已从当前上下文中得知项目路径
• 你需要的是项目内容而非元数据——请使用brv query而非

brv locations -f json

JSON字段：projectPath、contextTreePath、isCurrent、isActive、isInitialized。

5. 云端同步（可选）

概述：通过ByteRover云服务将本地知识与团队同步。需完成ByteRover身份验证。

设置步骤：

1. 登录：从ByteRover账户获取API密钥并进行验证：

brv login --api-key sample-key-string

2. 列出可用空间：

brv space list

示例输出：

brv space list
1. human-resources-team （团队）
   - a-department （空间）
   - b-department （空间）
2. marketing-team （团队）
   - c-department （空间）
   - d-department （空间）

3. 连接到一个空间：

brv space switch --team human-resources-team --name a-department

云同步命令：一旦连接后，brv push和brv pull会与该空间同步。

# 拉取团队更新
brv pull

# 推送本地更改
brv push

切换空间：

• 首先推送本地更改 (brv push) — 如果存在未保存的更改，切换将被阻止。
• 然后切换：

brv space switch --team marketing-team --name d-department

• 切换会自动从新空间拉取上下文。

数据处理

存储：所有知识都以 Markdown 文件的形式存储在.brv/context-tree/ 目录下。在项目目录内。文件具有人类可读性且支持版本控制。

文件访问：`brv curate` 命令的-f标志仅从当前项目目录读取文件。项目根目录之外的路径将被拒绝。每条命令最多处理5个文件，仅限文本和文档格式。LLM 使用

：`brv query` 和 `brv curate` 会将上下文发送至已配置的 LLM 提供商进行处理。LLM 将看到查询或整理文本以及任何包含的文件内容。除非您显式运行 `brv push`，否则不会将任何数据发送到 ByteRover 服务器。云端同步：`brv push` 和 `brv pull` 需要身份验证（通过 `brv login`）并将知识发送至 ByteRover 的云服务。所有其他命令均无需 ByteRover 身份验证即可运行。andbrv curatesend context to a configured LLM provider for processing. The LLM sees the query or curate text and any included file contents. No data is sent to ByteRover servers unless you explicitly runbrv push.

Cloud sync:brv pushandbrv pullrequire authentication (brv login) and send knowledge to ByteRover's cloud service. All other commands operate without ByteRover authentication.

错误处理

用户操作要求：发生错误时必须向用户展示此故障排除指南。

"未认证" | 运行brv login --help以获取更多详细信息。 "未连接提供商" | 运行brv providers connect byterover（免费，无需密钥）。 "连接失败" / "实例崩溃" | 用户应终止 brv 进程。 "令牌已过期" / "令牌无效" | 运行brv login以重新认证。 "计费错误" / "超出速率限制" | 用户应检查账户额度或等待后重试。

代理可修复错误：你必须优雅地处理这些错误，并在修复后重试命令。

"缺少必需参数。" | 运行brv <命令> --help以查看使用说明。 "最多允许5个文件" | 每次整理减少至5个或更少的-f标志。 "文件不存在" | 使用ls验证路径，使用项目根目录的相对路径。 "不支持的文件类型" | 仅支持文本、图像、PDF和办公文件。

快速诊断

运行brv status以检查认证、项目和提供商状态。