漂移

面向人工智能的代码库智能工具。能够检测模式和约定，并在不同会话间记住决策。适用于任何 IDE 的 MCP 服务器。支持离线命令行界面。

仓库结构

• drift v1 depreciated/ – 旧版 TypeScript 实现（已弃用）
• drift v2/ – 当前的 Rust/TypeScript 单体仓库（正在开发中）

有关 v2 的设置和使用，请参阅 drift v2/README.md 或 drift v2/docs/ 中的文档。

Drift 快速上手指南

Drift 是一款专为 AI 设计的代码库智能工具，能够检测代码模式与规范，并在不同会话间记忆决策。它支持作为 MCP 服务器集成到任意 IDE，也提供离线 CLI 使用方式。

注意：当前活跃开发版本为 Drift v2（基于 Rust/TypeScript），旧版 v1 已废弃。本指南仅针对 v2 版本。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS, 或 Windows (WSL 推荐)
• 前置依赖：
  • Rust (最新稳定版)
  • Node.js (v18 或更高版本)
  • Git

国内加速建议：

• 安装 Rust 时，建议使用国内镜像源配置 rustup：

  export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
  export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
  curl --proto '=https' --tlsv1.2 -sSf https://mirrors.ustc.edu.cn/rust-static/rustup-init.sh | sh
  

• Node.js 推荐使用 cnpm 或淘宝镜像源进行包管理。

安装步骤

由于 Drift v2 采用 Monorepo 结构，需克隆仓库并进入对应目录进行构建。

1. 克隆仓库

   git clone https://github.com/drift-labs/drift.git
   cd drift
   

2. 进入 v2 目录

   cd "drift v2"
   

3. 安装依赖并构建

   首先安装 Rust 依赖：

   cargo build --release
   

   接着安装 TypeScript/Node 依赖（如项目包含前端或 TS 工具链）：

   npm install
   # 或者使用国内镜像
   cnpm install
   

4. 验证安装 构建完成后，可尝试运行 CLI 帮助命令确认安装成功：

   cargo run --release -- --help
   

基本使用

Drift 主要作为 MCP (Model Context Protocol) 服务器运行，以便让 AI 助手理解您的代码库。

启动 MCP 服务器

在项目根目录下运行以下命令启动服务：

cargo run --release -- mcp serve

集成到 IDE

一旦服务器启动，您可以在支持 MCP 协议的 AI 编程助手（如 Cursor、Zed 或配置了 MCP 的 VS Code 插件）中连接该服务。

配置示例（以通用 MCP 客户端配置为例）：

{
  "mcpServers": {
    "drift": {
      "command": "cargo",
      "args": ["run", "--release", "--", "mcp", "serve"],
      "cwd": "/path/to/your/project"
    }
  }
}

启动后，AI 将自动获取代码库的上下文信息，包括代码规范、历史决策记录及模式分析，从而提供更精准的代码建议。