面向AI智能体的语义版本控制系统

[!NOTE]

Lix目前处于Alpha阶段 · 关注v1.0进展→

---

Lix是一个专为AI智能体设计的语义版本控制系统。

Lix并非Git的替代品，也并非专门为软件工程领域打造。它的目标是将版本控制引入到软件工程以外的行业，例如医疗、金融、政策制定、设计等领域。

Lix的独特之处在于：

• 语义化追踪 - 能够以语义化的视角理解变更，例如“这一段落发生了变化”，而不是“第5行发生了变化”。
• 支持任意文件格式 - 通过插件可以追踪.docx、.pdf、.json等文件中的变更。
• 可嵌入性 - 可作为独立的存储库使用，也可以部署在现有的SQL数据库之上。

---

📖 Lix与Git相比如何？→

---

使用场景

• AI智能体沙箱化 - 智能体对文件所做的更改可以被追踪、对比并回滚。
• 上下文管理 - 了解哪些内容发生了变化以及原因，从而提升人机协作效率。
• 应用内版本控制 - 分支与合并、审计日志等功能可以直接嵌入应用程序中。

何时使用及不使用Lix

如果您的应用或智能体需要修改文档（如Word、PDF等），则适合使用Lix。反之，如果您的主要用途并非修改文档，或者所处理的文档属于不会发生变化的生成物，则不适合使用Lix。

快速上手

JavaScript · Python · Rust · Go

npm install @lix-js/sdk

import { openLix, selectWorkingDiff } from "@lix-js/sdk";

const lix = await openLix({
  environment: new InMemorySQLite()
});

await lix.db.insertInto("file").values({ path: "/hello.txt", data: ... }).execute();

const diff = await selectWorkingDiff({ lix }).selectAll().execute();

语义化变更（delta）追踪

与Git基于行的差异不同，Lix通过插件理解文件结构。Lix能够识别出price: 10 → 12或cell B4: pending → shipped这样的语义级变更，而不仅仅是“第4行发生了变化”或“二进制文件不同”。

JSON文件示例

变更前：

{"theme":"light","notifications":true,"language":"en"}

变更后：

{"theme":"dark","notifications":true,"language":"en"}

Git显示：

-{"theme":"light","notifications":true,"language":"en"}
+{"theme":"dark","notifications":true,"language":"en"}

Lix显示：

属性 theme：
- light
+ dark

Excel文件示例

同样的方法也适用于二进制格式。借助XLSX插件，Lix可以展示单元格级别的变更：

变更前：

  | order_id | product  | status   |
  | -------- | -------- | -------- |
  | 1001     | Widget A | shipped  |
  | 1002     | Widget B | pending |

变更后：

  | order_id | product  | status   |
  | -------- | -------- | -------- |
  | 1001     | Widget A | shipped  |
  | 1002     | Widget B | shipped |

Git显示：

-二进制文件不同

Lix显示：

order_id 1002 的 status：

- pending
+ shipped

Lix的工作原理

Lix使用SQL数据库作为查询引擎和持久化层。在其之上会暴露一些虚拟表，例如file和file_history：

SELECT * FROM file_history
WHERE path = '/orders.xlsx'
ORDER BY created_at DESC;

当文件被写入时，插件会解析该文件并检测实体级别的变更。这些变更（即delta）会被存储到数据库中，从而实现分支、合并以及审计日志等功能。

┌─────────────────────────────────────────────────┐
│                      Lix                        │
│                                                 │
│ ┌────────────┐ ┌──────────┐ ┌─────────┐ ┌─────┐ │
│ │ 文件系统   │ │ 分支     │ │ 历史记录  │ │ ... │ │
│ └────────────┘ └──────────┘ └─────────┘ └─────┘ │
└────────────────────────┬────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────┐
│                  SQL数据库                   │
│            (SQLite, Postgres, etc.)             │
└─────────────────────────────────────────────────┘

深入了解Lix架构→

了解更多

• 入门指南 - 构建您的第一个Lix应用
• 文档 - 完整的API参考与教程
• Discord - 获取帮助并加入社区
• GitHub - 提交问题并参与贡献

博客文章

• 介绍Lix：一个可嵌入的版本控制系统
• 如果存在用于构建应用的Git SDK会怎样？
• Git并不适合应用于实际场景
• 基于Git的架构真的有意义吗？

许可证

MIT

Lix 快速上手指南

Lix 是一个专为 AI Agent 设计的语义化版本控制系统。与 Git 基于行的差异对比不同，Lix 能够理解文件内容的语义变化（例如"JSON 属性值变更”或"Excel 单元格状态更新”），支持 Word、PDF、JSON 等多种文件格式，并可嵌入到应用程序或现有 SQL 数据库中。

注意：Lix 目前处于 Alpha 阶段，主要面向文档修改类应用场景（如 AI 沙箱、上下文管理、应用内版本控制）。

环境准备

• 运行时环境：Node.js (推荐 v18+)
• 包管理器：npm, yarn, 或 pnpm
• 前置依赖：无特殊系统依赖，Lix SDK 内置了内存型 SQLite 支持，也可连接外部数据库。
• 语言支持：当前官方优先支持 JavaScript/TypeScript（Python、Rust、Go 支持开发中）。

安装步骤

使用 npm 安装 Lix SDK：

npm install @lix-js/sdk

国内加速建议：如果下载缓慢，可配置淘宝镜像源：

npm config set registry https://registry.npmmirror.com

基本使用

以下示例展示如何初始化 Lix 实例、写入文件并获取语义化差异。

1. 初始化与写入

import { openLix, selectWorkingDiff } from "@lix-js/sdk";
import { InMemorySQLite } from "@lix-js/sdk"; // 确保导入正确的环境适配器

async function main() {
  // 初始化 Lix，使用内存 SQLite 作为存储后端
  const lix = await openLix({
    environment: new InMemorySQLite()
  });

  // 向数据库中插入一个文件
  await lix.db
    .insertInto("file")
    .values({ 
      path: "/hello.txt", 
      data: "Hello, Lix!" // 此处可以是二进制数据或字符串
    })
    .execute();

  console.log("文件已写入");
}

main();

2. 获取语义化差异 (Diff)

当文件内容发生变化后，Lix 能通过插件解析文件结构，返回语义级别的变更，而非简单的行差异。

// 查询当前工作区的语义化差异
const diff = await selectWorkingDiff({ lix }).selectAll().execute();

console.log("检测到的变更:", diff);

效果对比示例：

• 场景：修改 JSON 配置中的 theme 字段。

• Git 输出：显示整行 JSON 字符串被替换。

• Lix 输出：精准识别为 property theme: light -> dark。

• 场景：修改 Excel 表格中某个单元格的状态。

• Git 输出：Binary files differ（无法识别具体变化）。

• Lix 输出：精准识别为 order_id 1002 status: pending -> shipped。

3. 直接查询历史记录

由于 Lix 基于 SQL 构建，你可以直接使用 SQL 查询文件历史：

// 查询特定文件的历史记录
const history = await lix.db
  .selectFrom("file_history")
  .where("path", "=", "/orders.xlsx")
  .orderBy("created_at", "desc")
  .selectAll()
  .execute();

---

更多详细架构说明与高级用法，请参考 官方文档。