
Gnomon 发布面向 AI Agent 的 Postgres 数据版本控制工具
来源标题:Gnomon. Git for Postgres data, built for agents
Gnomon 推出面向 AI Agent 的 Postgres 数据版本控制扩展,可为 Agent 单独创建真实数据库分支,仅通过连接字符串接入。该工具以单个扩展形式运行在现有 Postgres 内,无需复制数据或另建数据库,支持追踪字段变更、三方合并及回滚。目前支持 PostgreSQL 15-18,可用于自托管及 RDS、Aurora、Supabase 等托管环境。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
为 Postgres 数据提供 Git 式版本控制,专为 agent 打造。给 agent 一条你自己真实数据库的分支,只需要一个连接串。它改动的每个字段都看得见,改对了就合并进 main,改错了就撤销。
Gnomon 运行在你已有的 Postgres 里。一个扩展,不复制数据,不需要第二个数据库。
create extension gnomon; select gnomon.track('orders'); -- 历史从此刻开始,无需回填 select gnomon.create_branch('agent/refunds'); select gnomon.use('agent/refunds'); -- 从这里开始的每条查询都在分支上运行 update orders set status = 'refunded' where id = 4182; select * from gnomon.diff('agent/refunds'); -- 它改动的每一行、每一个字段 select gnomon.merge('agent/refunds'); -- 三方合并、类型感知、冲突以行的形式呈现 select gnomon.undo_merge(1); -- 再回退
文档:https://gnomon.bitsinfra.com/
安装:在 PostgreSQL 15-18 上执行 create extension gnomon,支持自建或托管环境(RDS、Aurora、Supabase)。参见 Installation。
第一次来?教程十分钟就能看完。
生产库的分支,瞬间创建
分支从 main 读取一切,只保留自己改动的内容,所以无论数据库多大,它都能瞬间打开,不复制任何数据。每次 agent 运行、每个 pull request、每个测试,都可以分到一条分支。
你的应用不用改。分支就是一个连接串:让一个会话指向它,应用原本就在跑的查询就会读写这条分支,而不是 main。
Schema 变更也一并带上。在分支上跑迁移,加一列、改个名或建张表,main 保持原样,直到合并时,新的结构和它的数据一起带过来。
每条分支都自带一份 diff:它改动的每一行、每一个字段,改动前后都有。在浏览器里审阅,对某一行评论,并排解决冲突。agent 干完活后,Gnomon 会打开审阅页面并把链接发给你。
用 SQL 写检查,Gnomon 会在合并结果上运行这些检查,通过之后才允许合并落地。一次批准只覆盖你当时看到的内容:如果分支在那之后又变了,会重新回到你这里。
当 main 和分支改动了同一个值时,Gnomon 不是简单挑一边。计数相加,JSON 逐 key 合并,文本逐行合并。真正冲突的部分会成为 conflict,留给人来解决,或者用一条查询解决。
分支之间也能互相合并,不只是合并进 main;单个事务可以从一条分支摘到另一条分支上。撤销同理:可以撤销一个事务、agent 今天下午做的所有事,或者一整次合并。
Gnomon 记录你追踪的每张表的历史。用你已有的查询,读取任意时刻的整个数据库,每次都能得到相同的结果。当 agent 做出决定时,你能准确看到它当时看到的是什么。
-- 十月底未结清的发票 select gnomon.use('main', '2026-10-31 23:59'); select sum(amount) from invoices where status = 'open';
同样的历史会实时流出,送到 Kafka、NATS 或 webhook,并作为保留已删除行的 snapshot 进入 dbt。较旧的历史可以转移到对象存储,当查询追溯那么远时,Gnomon 会把它取回来。
当一项原本通过的检查开始失败,gnomon bisect 会找出破坏它的那个事务:谁做的、什么时候、为什么。
一条命令就能给 agent 一个数据库角色、一条专属分支和一个连接串。不管它用什么构建,有这些就够了。它读写自己的分支,其余的一律被数据库拒绝,包括 main,即使 agent 点名要访问也不行。
一个数据库角色、一条专属分支和一个连接串
gnomon agent create support-bot
它只能合并你允许的内容。合并权属于你指定的人,或者在你写下的规则内行动的 agent:最多二十行、仅限这些表、所有检查通过。无论怎么告诉 agent,这些都由 Postgres 强制执行。
未经你批准,任何东西都不会外流。agent 排队的邮件、webhook 和支付,都会留在它的分支上,直到合并。
每个改动都有署名。每处改动都记录了是哪个 agent、哪次运行、给出的理由是什么。
重放它看到的内容。Gnomon 记录每次读取的时刻,所以重放会精确返回 agent 当时读到的那些行。
一次试多种方案。从同一时刻出发多个尝试,比较它们的改动和检查,留下最好的那个。
叫停它,并收回改动。一条命令就能把 agent 锁在外面、关闭它的分支,并撤销它合并过的内容,从最新的开始。
为你的 agent 准备就绪。Gnomon MCP server 可以跑在 agent 的机器上或通过 HTTP 访问,让 agent 探索 schema、试改而不保留、把分支回退到某个 checkpoint。
集成进你的产品
TypeScript 和 Python SDK 为你 agent 承担的每个任务提供一次 run:一条专属分支,限制已经设好。可以合并、提交审阅,或者直接放弃。
import { Gnomon } from "@bitsinfra/gnomon"; import { nodePostgres } from "@bitsinfra/gnomon/pg"; const gnomon = new Gnomon({ app: nodePostgres(appPool), // 你的应用自己的登录 runs: nodePostgres(runsPool), // 每次 agent 运行共用的一个登录 }); // 为这个任务创建一条分支,除非合并或提交,否则丢弃 await using run = await gnomon.startRun({ task: "Refund order 4182", actor: "support-bot", }); await run.sql("update orders set status = 'refunded' where id = 4182"); const { checks, changes } = await run.summary(); if (checks.passed && changes.rows <= 20) await run.merge(); else await run.submit({ title: "Refund order 4182" });
即使多次 run 共用一个数据库登录,它们也读不到彼此的分支。继续用你现有的 agent 框架:Anthropic SDK、Claude Agent SDK、Vercel AI SDK、OpenAI Agents SDK、LangChain 或任何 MCP 客户端,拿到的都是同样几个工具,绑定到同一次 run。它们通过你的 driver 和 ORM 工作,从 node-postgres 和 Prisma 到 psycopg 和 Django。在你的测试里,每个测试都能拿到同一个种子数据库的一条专属分支。
npm install @bitsinfra/gnomon # TypeScript pip install gnomon-postgres # Python
包含哪些内容
Part Path
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。