首页 > 开源 > 记录创作历史， 而不只是代码历史 —— Libra，面向 Agent 的 AI 原生扩展版本控制系统

记录创作历史， 而不只是代码历史 —— Libra，面向 Agent 的 AI 原生扩展版本控制系统

OSChina资讯 2026-10-08 14:58 6 阅读 查看原文
AI版本控制 Libra系统

Libra 是 AI 原生软件开发的版本控制系统。它将版本控制从代码变更记录扩展为软件创建过程管理，通过捕获需求上下文、AI Agent 交互、代码生成过程和验证记录，将不可见的开发过程转化为可追溯、可复用的工程知识。因此，Libra 可以帮助开发者理解代码为何产生、如何演进，并支持 AI Agent 在不同任务和项目之间复用已有上下文，从而提升 AI 开发的可靠性和协作效率，特别适用于 AI Coding、Agent Workflow 和大型软件工程场景。

Libra 与现有 Git 生态兼容，并支持主流 AI 编程工具。开发者可以在不改变现有工作流的情况下，引入 AI 原生版本控制能力。

核心差异

能力

传统版本控制（Git）

Libra

版本化内容

仅源代码

代码 + AI 推理 + 决策 + 验证报告 + 会话记录

AI 协作

手动提交信息

原生 AI Agent 线程，完整审计追踪

知识复用

代码快照

跨项目可复用的智能资产

安全

外部 GPG/SSH 配置

内置 Vault，每个仓库独立隔离密钥

供应商锁定

不适用

7+ 家 AI 提供商，自由切换

自动化

外部 CI/CD

内置 Cron 驱动的 Agent 自动化

快速开始

安装

# macOS / Linux（推荐）# 安装器先验证 Ed25519 签名的 release manifest 及二进制 sha256/size 再安装；# 信任模型见 docs/installation.zh-CN.md。
curl -fsSL https://download.libra.tools/install.sh | sh

# Homebrew（macOS）
brew install libra

# 从源码编译（需要 Rust）
git clone https://github.com/wingwangsz/libra.git
cd libra
cargo build --release

脚本安装器还会创建可选短命令 ~/.libra/bin/lba -> libra（相对 symlink）。 重复安装同一版本会修复缺失的 alias，不替换二进制。使用 --no-alias 或 LIBRA_NO_ALIAS=1 可关闭；已存在的用户自有 lba 绝不会被覆盖。详见 安装器行为与选项。

初始化你的第一个仓库

# 创建新的 Libra 仓库
libra init my-project
cd my-project

# 或从现有 Git 仓库转换
libra init --from-git-repository /path/to/existing/git/repo

使用 Agent 捕获

# 为你的 Agent 启用捕获钩子（以 codex 为例）
libra agent enable

# 正常使用你的 Agent 工具——Libra 会自动捕获会话和检查点
codex

# 查看已捕获的会话
libra agent session list
libra agent checkpoint list

查看 Agent 捕获文档了解所有支持的 Agent、高级配置和会话管理。

核心特性

🧠 AI 原生线程与持久化

每一个 AI Agent 会话都是 Libra 中的一等公民。线程、计划、任务、决策、验证报告、工具调用和代码补丁快照都直接持久化在仓库中，与代码共存。没有外部状态——一切都是可持久化、可查询、可回放的。

.libra/
├── libra.db              # SQLite：Git 核心 + AI 线程 + 运行时合约
├── vault.db              # 加密密钥库（提供商密钥、签名密钥）
├── objects/              # 对象存储（loose + pack，与 Git 兼容）
├── sessions/             # AI 会话记录（JSONL 格式）
└── ai/                   # AI 运行时工作文件

🔄 Git 兼容基础

Libra 使用 Git 的语言。磁盘格式（objects、index、pack、pack-index）和传输协议与标准 Git 服务器（GitHub、GitLab、Gitea 等）完全兼容。你可以零摩擦地向任何 Git 远程仓库 push 和 pull。

  • 关键区别：Git 管理文件。Libra 管理创造。

🔐 Vault 安全

每次 libra init 自动创建仓库级加密密钥管理：

  • GPG 签名密钥用于提交验证

  • SSH 密钥用于远程认证

  • AI 提供商凭证安全存储

无需外部密钥管理配置。每个仓库的密钥独立隔离，永不离库。

🛡️ 命令安全沙箱

每个 AI Agent 的工具调用都经过可配置的安全沙箱，包含命令预检、网络策略执行和可选的 seccomp/seatbelt 限制。定义 Agent 能做什么、不能做什么。

☁️ 分层云存储与备份

  • 分层存储：将大对象卸载到 S3/R2/RustFS，本地 LRU 缓存

  • 云端备份：将完整仓库状态（含 AI 历史）同步到 Cloudflare D1 + R2

  • 可移植：在不同机器之间迁移 Libra 仓库，AI 上下文完整保留

🌐 原生 MCP 协议支持

Libra 原生支持 Model Context Protocol，可直接与 Claude Desktop、Cursor 和任何 MCP 兼容客户端集成。配置一次，到处使用。

{
  "mcpServers": {
    "libra": {
      "command": "/path/to/libra",
      "args": ["code", "--stdio"],
      "cwd": "/path/to/your/libra/repo"
    }
  }
}

支持的 AI 提供商

Libra 目前已支持 Claude Code、CodeX 和 OpenCode；对其他主流 Agent 的支持将陆续发布。

前往 docs.libra.tools 查看提供商配置详情。

相关推荐