Lix

面向 AI Agent 的语义化版本控制系统

[!NOTE] Lix 处于 Alpha 阶段 · 追踪 v1.0 开发进度 →

Lix 是一个面向 AI Agent 的语义化版本控制系统。

Lix 并非 Git 的替代品，也并非专门为软件工程设计。其目标是将版本控制引入医疗、金融、政策制定、设计等非软件工程领域。

Lix 的独特之处：

语义化追踪 - 从语义层面理解变更，例如“此段落已更改”，而不是“第 5 行已更改”。
支持任何文件格式 - 通过插件追踪 .docx、.pdf、.json 等格式的变更。
可嵌入 - 可作为独立仓库运行，也可叠加在现有的 SQL 数据库之上。

📖 Lix 与 Git 的对比 →

应用场景

AI Agent 沙盒 - 可追踪、对比并回滚 Agent 对文件所做的更改。
上下文管理 - 了解变更内容及其原因，从而提升人类/Agent 的协作效率。
应用内版本控制 - 内置于应用程序中的分支、合并及审计追踪功能。

何时使用及何时不建议使用 Lix

如果你的应用程序或 Agent 需要修改文档（如 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 的识别结果：

property 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 的识别结果：

-Binary files differ

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;

当文件被写入时，插件会对其进行解析并检测实体级别的变更。这些变更（Deltas）存储在数据库中，从而实现分支、合并和审计追踪功能。

┌─────────────────────────────────────────────────┐
│                      Lix                        │
│                                                 │
│ ┌────────────┐ ┌──────────┐ ┌─────────┐ ┌─────┐ │
│ │ Filesystem │ │ Branches │ │ History │ │ ... │ │
│ └────────────┘ └──────────┘ └──────────┘ └─────┘ │
└────────────────────────┬────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────┐
│                  SQL database                   │
│            (SQLite, Postgres, etc.)             │
└─────────────────────────────────────────────────┘

阅读更多关于 Lix 架构的信息 →

了解更多

快速开始指南 - 使用 Lix 构建你的第一个应用程序
文档 - 完整的 API 参考和指南
Discord - 获取帮助并加入社区
GitHub - 报告问题并参与贡献

博客文章

许可证

MIT

opral/lix

Lix