BrokkAi/bifrost

Bifrost

快速开始 ·
文档 ·
十分钟评估 ·
Discord

为什么选择 Bifrost？

bifrost 是 Brokk 基于 Rust 构建的静态分析工具箱，面向 AI 编程工具链、
编辑器和大型代码仓库。

Bifrost 为每种受支持的语言提供共享的中间表示，因此相同的结构化查询与导航
工作流可以在混合语言仓库中通用，而不会止步于语言边界。

- 统一的跨语言 IR。 解析未构建或部分损坏的工作区，并规范化其源码结构
以进行跨语言分析。
- 真正的查询语言。 使用 JSON CodeQuery 或 Rune 查询语言（RQL）查找
语言中立的代码形态，并遍历已建立索引的声明、引用、调用、导入和类型
关系。
- 为智能体和编辑器而构建。 向编程智能体暴露结构化的 MCP 工具，向编辑器
提供 LSP 功能，并通过 CLI、Python 和 Rust 提供相同的分析器。
- 为活跃仓库而设计。 快照隔离、增量更新、基于内容的缓存以及
git/worktree 感知能力，使仓库变化时分析仍保持响应迅速。

请参阅选择 Bifrost 以了解适合
你工作流的接口，并查看语言与分析
能力矩阵，了解逐语言支持、精度层级
以及当前分析边界。

运行你的第一个查询

安装已发布的 CLI，克隆小型且经过验证的评估夹具，并运行其保存的 RQL 查询：

curl -fsSL https://raw.githubusercontent.com/BrokkAi/bifrost/refs/heads/master/install.sh | bash
git clone --depth 1 https://github.com/BrokkAi/bifrost.git
cd bifrost/docs/fixtures/ten-minute-evaluation
bifrost --root . --query-file queries/find-audit.rql
使用 uv 或
pipx 的用户可以改为运行 uv tool install brokk-bifrost 或
pipx install brokk-bifrost；两者都会在隔离环境中从平台 wheel 安装相同的原生 bifrost 命令。uvx brokk-bifrost --version
可以在不进行持久安装的情况下运行它。

Node 用户可以运行 npm install -g @brokkai/bifrost，或使用
npx -y @brokkai/bifrost --version。npm 包会为当前平台安装相同的已发布原生命令。

安装程序会将经过校验和验证的发布二进制文件下载到 macOS（Apple Silicon 和 Intel）、glibc 2.28+ Linux（x86-64 和 ARM64）、WSL，
以及 Termux 下的 Android 上的 ~/.local/bin。macOS 和 glibc Linux 上的 Homebrew 用户可以改为运行
brew install brokkai/tap/bifrost。在 Windows 上，请使用已发布的归档文件或从源码构建。像 Alpine 这样的 musl 发行版没有
受支持的预构建发布版本；用户可以尝试使用
cargo install brokk-bifrost --locked 从源码构建。完整平台
表请参见
安装 Bifrost。

结果会标识规范化后的 Python 调用及其精确源位置：

{
"isError": false,
"structuredContent": {
"results": [
{
"enclosing_symbol": "src.app.handle",
"end_line": 5,
"kind": "call",
"language": "python",
"path": "src/app.py",
"result_type": "structural_match",
"start_line": 5,
"text": "audit(value)"
}
],
"truncated": false
}
}

继续阅读十分钟
评估，通过 CLI、连接到 MCP 的编码代理和 VS Code 运行相同的
查询。

查看 Bifrost 的实际效果

在 VS Code 中将源码转换为查询

选择一个源码结构，然后运行 Bifrost: Show Rune IR，以检查其
语言中立的 .rune 形式，并获得一个保守的起始 RQL 查询。从编辑器中运行该
查询，浏览按文件分组的类型化结果，并跳转到
精确的源码范围。该扩展还提供定义、引用、悬停、
重命名、符号、层次结构、诊断、补全以及其他 LSP 功能。

从 CLI 使用相同的分析器

直接运行已保存的 RQL 或 JSON 查询，或调用通过
MCP 暴露的相同命名工具，以用于 shell 脚本和可复现的分析工作流。

语言覆盖范围

Bifrost 包含针对 C、C++、C#、Go、Java、JavaScript、Kotlin、PHP、
Python、Ruby、Rust、Scala 和 TypeScript。请参阅能力矩阵，了解每种语言支持的分析和精度边界。

文档

公共文档站点位于 docs/，并发布在
bifrost.brokk.ai。

有用的起点：

- 选择合适的 Bifrost 接口
- 第三方声明
- 安装 Bifrost
- 十分钟评估 Bifrost
- MCP 服务器和工具集
- LSP 服务器
- CLI 用法
- 代码查询

在本地运行文档站点：

cd docs
npm install
npm run dev

GitHub Pages 发布由 .github/workflows/docs.yml 处理。发布标签
构建会同时发布最新的文档站点和位于
versions// 下的版本化快照。

仓库布局

仓库围绕公共产品界面进行组织：

- 核心分析： crates/ 包含 Rust 工作区 crate；
src/ 提供顶层外观和 CLI；schemas/
存放共享数据契约。
- 集成与分发： editors/zed/ 包含
Zed 扩展；VS Code 扩展维护于
BrokkAi/bifrost-lsp。
plugins/ 包含编码代理插件；npm/、
packaging/ 和
bifrost_searchtools/ 暴露或打包分析器。
- 文档与示例： docs/ 是文档站点；
examples/ 包含可运行的示例。
- 分析数据与项目默认值： semantic-packs/
包含随附的语义知识；.bifrost/ 包含
项目级分析默认值。
- 开发支持： benchmark/ 涵盖可复现的
测量；scripts/ 和 tools/ 存放维护
和发布辅助工具。根清单文件以及 .github/、.cargo/ 和 .config/
定义构建、检查和自动化。

许可证与商业使用

Bifrost 的公共开放核心采用 Apache-2.0 许可，可用于
研究、内部系统、托管服务和商业产品。阅读
许可证页面了解项目
条款，以及第三方声明
了解适用于官方二进制文件和语义包的附加条款。

贡献

项目贡献者  

该公共仓库是从 Bifrost 的开源核心源码投射而来，因此其
GitHub 贡献者图表并未反映所有帮助构建该项目的人。

有关本地开发、测试命令、仓库本地 Python 工作流以及
发布打标签的信息，请参阅 CONTRIBUTING.md。