Deedglass
检查你的 AI 智能体到底改了什么。
一个智能体说它更新了 1 行。Postgres 却改了 301 行。
为在数据库和健康记录上工作的 AI 智能体提供安全保障。规则裁定每一次 AI 智能体工具调用;Deedglass 核查真正发生了什么变更,并封存一份记录。开源、自托管,所有功能免费。
一条命令启动
npx -y deedglass
浏览器中会打开一个应用。它运行在你自己的电脑上,登录后即可使用,无需账号、无需注册、无需配置 Docker 或数据库,也不会向我们发送任何数据。选择使用者(诊所、医院 IT,或用 AI 构建应用的人),然后连接 Claude Desktop、Cursor、VS Code、记录系统或数据库。需要 Node 18 或更新版本。阅读 Start here 了解简短导览,或前往 deedglass.com/play 免安装试用。
对开发者而言,三条命令:
npx -y deedglass start # 一个智能体报告 1 行,Postgres 却改了 301 行,被当场抓住
npx -y deedglass protect # 守护 Claude Code、Cursor 及其他编码智能体
npx -y deedglass help # 八条日常命令;“help all” 列出全部命令
没有 Docker 时,start 会在二进制文件内部播放同一场景,每一行都标注 live 或 replay,30 秒内完成。更多:Quickstart · Docs · Policy Generator · Healthcare · Benchmarks · Security · deedglass.com
觉得有用?点个 star 能帮更多人发现 Deedglass。想了解新版本发布,请使用 Watch › Custom › Releases。
它的作用
Deedglass 位于 AI 智能体与其所更改的系统之间。规则裁定每一次工具调用,一项核查会将系统的实际变更与智能体所报告的内容进行比对(Claimed、Checked 或 Proven;Matches、Doesn't match 或 Can't check),每个结果都会封存为一条带签名的记录,任何人都可以离线校验。它还能撤销某个操作所更改的行。
一次真实的 make demo-hero 运行(提交 97a524c,2026-10-14),每一行都在其打印的时刻显示。来源:docs/assets/demo-hero.cast.json,由 scripts/demo/capture.mjs 录制,由 scripts/demo/cast2svg.mjs 绘制(make demo-svg)。
安装
curl -fsSL https://deedglass.com/install.sh | sh # macOS 和 Linux:校验 sha256,将 deedglass 复制到 ~/.local/bin
npx -y deedglass help # 或免安装运行(Node 18 或更新版本)
npm install -g deedglass # 或从 npm 安装
| 其他方式 | 命令 |
|---|---|
| 二进制包 | 最新 release 上提供 macOS、Linux 和 Windows 的压缩包,附带 checksums.txt |
| Go | go install github.com/deedglass/deedglass/cmd/deedglass@latest(CLI,不含 Console) |
| Docker | 从代码检出构建镜像:make web-build docker(标签为 deedglass:dev ;Node 24 构建 Console) |
安装脚本会下载适用于你平台的 release 压缩包,对照该 release 的 checksums.txt 校验其 sha256(若安装了 cosign,还会校验签名),然后将 deedglass 复制到 ~/.local/bin;请先阅读它:scripts/install.sh。它从 deedglass.com 上的一份 release 副本下载,失败时回退到 GitHub:在印度的一个网络上约需 7 秒,而仅从 GitHub 安装耗时 81-119 秒。公共容器镜像即将推出;在发布之前,请按上述方式在本地构建镜像。校验和、签名与 SBOM:docs/INSTALL.md。
适用对象
文章标题:Show HN: Why HTTP 200 is lying to your AI agents (and what Postgres did)
正文:
- 在数据库上运行 agent 的开发者。Claude Code、Cursor 或你自己的 agent 会写入 Postgres。你的规则先决定每次调用,Postgres 的变更日志显示实际提交了什么,而某次操作改动的行可以在有人会签后撤销。MySQL 及其他数据库可通过 Debezium 变更流检查(docs/WITNESS_DEBEZIUM.md)。
- 使用 FHIR 的健康科技团队与医院。FHIR 连接器(beta)通过 SMART Backend Services 将 FHIR R4 服务器置于 Deedglass 之后,按服务器报告的版本回读每次写入,并在运行于 Postgres 的 HAPI FHIR JPA 8.x 和 Medplum 5.x 上校验 Proven。参见 deedglass.com/healthcare 和 FHIR 基准测试。若想先在合成数据上体验,无需 Docker、无需服务器,运行 npx deedglass health pilot(15 分钟医院试点)。
- 安全团队。Lockdown 会让 agent 的每次写入都等待人工,高风险写入以及关闭 lockdown 都需要两个人,并且每个 agent 只能使用一个连接器(docs/LOCKDOWN.md)。记录经过签名,任何人可用 deedglass verify 离线校验。
项目状态
- Pre-1.0。每个版本都记录在 CHANGELOG.md 和 releases 页面。deed 格式是带版本的公开规范(spec/),因此旧记录可以持续校验。
- 一位维护者。Deedglass 由印度的 Arjun Prabhakaran 构建(GOVERNANCE.md)。回复为尽力而为(SUPPORT.md)。
- 免费且自托管。在我们成长期间所有功能免费,包括 ee/,且运行在你自己的机器和你自己的 Postgres 上。没有任何许可证校验,也不会向 deedglass.com 发送任何内容(Security)。
- 尚未具备:没有 SOC 2 报告、没有外部渗透测试、没有 SSO。已知限制见 docs/LIMITATIONS.md 和 KNOWN_ISSUES.md。
工作原理
flowchart LR
A["AI agent<br/>Claude · OpenAI · Cursor · any MCP client"] -->|tool call + agent key| R
subgraph D["Deedglass · one binary + Postgres"]
R["1 · Rules<br/>allow · deny · ask a person"] --> X["2 · Run<br/>with credentials from the vault"]
X --> C["3 · Check<br/>what really changed"] --> S["4 · Seal<br/>a signed record"]
end
X --> T["Tools<br/>Postgres · FHIR · GitHub · Slack · Stripe · MCP servers"]
T -->|change log or read-back| C
S --> U["Undo<br/>Postgres rows, after a person countersigns"]
H[People] -->|approve · stop| R
每次工具调用都携带 agent 的密钥经过 Deedglass。你的规则(策略)决定 allow、deny 或 require_approval;Deedglass 使用 agent 从未持有的凭据执行调用;检查环节将实际发生的情况与请求的内容进行比对;结果作为记录封存进该组织的链中。
每种检查的确信程度
| 级别 | 检查什么 | 看不到什么 |
|---|---|---|
| Claimed | 工具自身的回答,对照 schema 和你的后置条件 | 回答是否真实 |
| Checked | 从目标回读(GitHub、Slack、Stripe、Notion、REST、Postgres 行) | 回读未覆盖的副作用 |
| Proven | Postgres 的变更日志(逻辑解码):事务提交的每一行 | DDL、序列、unlogged 表以及该数据库 WAL 之外的任何内容 |
每条记录声明一个级别和一个结果:Matches、Doesn't match 或 Can't check。当 Deedglass 无法判断某个工具是否运行时,结果为 Can't check,绝不会是 Matches。API 保留短名称(L0/L1/L2、VERIFIED/MISMATCH/UNVERIFIABLE);术语表给出了映射。
301 行的场景
agent 报告的内容并不总是系统实际存储的内容,而 agent 自己写的日志无法显示其中的差异。某个 agent 被要求将订单 42 标记为已发货。它执行了一条 UPDATE,其工具报告 1 行。一个遗留触发器在同一事务中又发货了 300 个订单。以下是 2026-10-14 Quickstart 最后一步的真实输出(在你看到 … 的地方做了缩短):
$ npx -y deedglass init --trigger
…
✕ UPDATE order 42 Proven · Doesn't match · Postgres changed 301 rows in public.orders. The agent reported 1.
expected UPDATE 1 row in public.orders where id = 42 · sets status
observed UPDATE 301 rows in public.orders · 300 outside id = 42
…
✓ Trigger off orders_ship_open_batch dropped
✓ Undo preview Undo available · 301 rows in public.orders · 301 updates
policy undo-needs-approval · a person countersigns first
Agent 的日志说只改动了 1 行。Deedglass 读取了 Postgres 自身针对该事务的变更日志,发现实际是 301 行,把差异封存为一条记录,并基于这些行规划了一个撤销操作,该操作只有在有人联署确认后才会执行。
快速开始
Docker 正在运行,约 2 GiB 空闲磁盘,Node 18 或更新版本,以及 macOS 或 Linux,然后(从已测试的快速开始出发)。在 Windows 上,npx deedglass 运行原生 Windows 二进制文件,无需 WSL;deedglass init 在 macOS 和 Linux 上使用 Docker,因此在 Windows 上请从 npx deedglass app 开始,它不需要 Docker:
mkdir acme-agents && cd acme-agents
npx -y deedglass init --yes
npx -y deedglass doctor
npx -y deedglass init --trigger
deedglass init 在 Docker 中启动两个 Postgres 18.6 容器(Deedglass 自己的数据库和一个演示数据库),在 127.0.0.1:8080 上运行 deedglass serve,创建一个组织、一个 agent 和 postgres-check 策略(读取和写入可执行,每次写入都在 Proven 级别检查,DROP 和 TRUNCATE 永不执行;在生产环境中使用 postgres-safe,写入需要等待人工确认),最后以一个被阻止的 DROP TABLE 和一个在 Proven 级别检查的 UPDATE 结束。deedglass doctor 运行十七项只读检查,每项都附带修复方法。deedglass init --trigger 打开演示数据库的 legacy trigger,发送同样的一行 UPDATE,最后停在上面展示的 301 行不匹配和撤销预览上。它的最后一行是撤销运行命令;撤销操作等待人工确认,undo run 会打印批准链接。
端口 8080 或 55432 被占用?npx -y deedglass init --yes --listen 127.0.0.1:8090 --pg-port 55440(--listen 是 deedglass serve 监听的地址;--pg-port 是 Deedglass 自己的 Postgres,演示数据库使用比它高 10 的端口)。在该目录中运行的后续每条命令都会从 .deedglass/stack.json 中找到端口。完成后,npx -y deedglass init --purge 会移除容器、卷以及 .deedglass/ 中的文件。
一条命令保护所有 agent:npx deedglass protect 将 shell guard 添加到 Claude Code、Cursor、Codex CLI、Gemini CLI 和 GitHub Copilot CLI,因此 railway volume delete、supabase db reset --linked 或 terraform destroy 之类的命令会等待你确认(Codex 和 Gemini CLI 则会直接拒绝)。它会先备份每个文件,--undo 可将它们恢复:这是第二道检查,而非沙箱(docs/protect.md)。
然后把你自己的 Postgres 接在后面(Supabase、Neon 或任何 Postgres 16 到 18):npx -y deedglass connect "$DATABASE_URL" 运行只读检查并打印计划;--apply 进行设置(指南)。
四种使用方式
| 命令 | 所需条件 | 离开你机器的数据 | |
|---|---|---|---|
| 在浏览器中 | deedglass.com/play | 一个浏览器标签页。Postgres 在页面中运行;打开时是“说 1,改了 301”的场景。 | 无 |
| 在终端中 | npx deedglass play | Node,以及来自 npm 的 deedglass 0.1.1 或更新版本。无需 Docker。规则实时决定每次调用,记录在你的机器上封存并检查;Postgres 的输出行来自一次录制好的真实运行回放,并已标注为回放。 | 无 |
| 扫描你的环境 | npx deedglass scan | Node。只读地读取你的 MCP 配置,如果你指定了数据库,还会读取其 catalog。对你的 agent 可能造成的变化进行评级,A 到 F。 | 无,除了对你指定的数据库执行只读 catalog 查询 |
| 观察模式 | deedglass observe run --connector pg-demo -- ./agent.sh | 一个开启观察的 Postgres 连接器。无需改造:它在你已有的任何 gate 旁边读取 Postgres 的变更日志。 | 无 |
文章标题:Show HN: 为什么 HTTP 200 在欺骗你的 AI 智能体(以及 Postgres 做了什么)
正文: 当扫描在智能体可写入的表上发现触发器或级联时,它会明确告知并指向 301 场景。观察模式如下。
观察模式:无需重新接线
deedglass observe run --connector pg-demo -- ./agent.sh # open a watched session, run the agent, close it
deedglass observe show obs_01k… --undo-sql # the undo as SQL you review and run (free)
deedglass observe run --connector dev --undo-sql ~/deedglass-undo -- claude # watch a Claude Code session, shell included
在连接器配置中设置 witness.observe.enabled: true 即可开启。观察模式仅通过 deedglass connector postgres init 创建的角色和复制槽读取 Postgres 的变更日志,因此它可以与你现有的任何门禁配合使用,或者在没有门禁时独立运行。它会展示会话期间被监视表上提交的每一行,并将会话封存为一条记录。它无法分辨是哪个程序写入了某一行,因此会话不会得到 Matches 或 Doesn't match 的判定;行镜像保留 30 天;TRUNCATE 无法从记录中撤销。撤销 SQL 免费,通过 Deedglass 进行的一步撤销同样免费:在我们成长期间所有功能均免费。详情见:docs/OBSERVE.md。
添加到你的智能体客户端
在 VS Code · LM Studio · Goose · Claude Desktop · 所有客户端中安装
claude mcp add --scope user deedglass -- npx -y deedglass mcp serve
任何链接都不包含密钥。请先运行 npx deedglass init;每个客户端会向 Deedglass 请求它写入的密钥。
Claude Code 插件(MCP 服务器,/deedglass:scan、/deedglass:wrap 和 /deedglass:watch 命令,以及用于读取扫描结果和安全授予智能体 Postgres 访问权限的技能),来自本仓库自己的市场:
/plugin marketplace add deedglass/deedglass
/plugin install deedglass@deedglass
所有格式及其来源:docs/INSTALL_CLIENTS.md。
SDK 与客户端
- TypeScript:@deedglass/sdk,提供针对 AI SDK、OpenAI Agents SDK、LangChain 和 Claude Agent SDK 的适配器。
- Python:deedglass,提供 LangChain 和 Claude Agent SDK 适配器。它尚未发布到 PyPI;请从本仓库或某个 release 的 wheel 安装(docs/SDK_PYTHON.md)。
- Go:github.com/deedglass/deedglass/pkg/deedglass。
- MCP:deedglass mcp wrap 可管控任意 stdio MCP 服务器;deedglass mcp serve 为 Claude Desktop、Claude Code、Cursor、VS Code 和 Windsurf 管控远程 MCP 服务器。
连接器
Postgres(Proven)、REST、GitHub、Slack、Stripe(仅测试模式)、Gmail 草稿、Notion 和远程 MCP 服务器。凭据存放在加密保险库中;每次出站调用都经过唯一的出口。参见 docs/CONNECTORS.md。
基准测试
每个基准测试都会公布 Deedglass 漏掉的内容与它捕获的内容。
| 基准测试 | 捕获 | 漏掉 | 来源 |
|---|---|---|---|
| Postgres:12 个合成用例,其中 11 个智能体的报告有误 | 11 个中的 5 个 | 6 个(其中 2 个它表示无法检查);0 次误报 | corpus/results/latest.md |
| Medplum 5.2.6 上的 FHIR:17 个场景,其中 11 个报告与服务器实际存储的内容不一致 | 11 个中的 4 个(无检查器,或信任 HTTP 状态码:11 个中的 0 个) | 7 个;6 个对照项上 0 次误报 | corpus/fhir/results/latest.md |
每个场景及其漏掉项的名称:corpus/BENCHMARK.md、corpus/fhir/BENCHMARK.md 和 deedglass.com/benchmark。
| 项目 | 实测 | 目标 |
|---|---|---|
| 门禁 · 允许,无见证 | p50 5.81 ms · p99 19.4 ms | p50 < 5 ms · p99 < 25 ms(p50 未达标) |
| 策略 · 50 条规则 | p99 148 µs | p99 < 1 ms |
| 见证 · L2,100 次写入/秒 | p50 118 ms · p99 317 ms | p50 < 1 s |
| 验证 · 100,000 条 deed | 1.53 s · 80.9 MiB | < 5 s · < 256 MiB |
| 停止 · 跨 2 个实例 | 20 次试验中最大 23.5 ms | < 2 s |
测量方式及漏掉项:docs/BENCHMARKS.md。
它不做的事
- Proven 检查仅覆盖 Postgres,且需要在被监视的表上设置 wal_level=logical 和 REPLICA IDENTITY FULL。
- 被劫持的智能体若拥有有效密钥并执行策略内操作,则会被放行。策略、预算和审批可以缩小这一范围;但无法彻底堵住。
文章标题:Show HN: Why HTTP 200 is lying to your AI agents (and what Postgres did)
- Deedglass 信任 Postgres 服务器、其超级用户、运行它的主机及其密封密钥。它无法保护你免于主机被攻陷。
- 记录保存的是摘要,不是载荷。一组密封密钥为实例上的每个组织签名。
- 它不能替代最小权限的数据库角色。两者都要用:角色限制代理能做什么;Deedglass 检查它用它做了什么。
完整列表及变通方法见:docs/LIMITATIONS.md 和 KNOWN_ISSUES.md。
替代方案
你可能不需要 Deedglass,或者你可能想把它与以下之一并列使用。每一项都有一个更长的页面,包含来源和每次检查的日期,见 deedglass.com/compare。
| 如果你需要 | 使用这个 | Deedglass 的定位 |
|---|---|---|
| 一个只读的代理 | 一个只带 SELECT 权限、别无其他的 Postgres 角色。无论代理发送什么,它都无法更改数据,而且无需安装任何东西。 | 你不需要它。它是为必须写入的代理准备的。( 比较 ) |
| 一个让代理尝试更改的地方 | 一个数据库分支:Neon 分支是你数据的写时复制克隆;Supabase 分支默认不启动生产数据。 | 用于必须到达生产的写入:先规则,再检查和记录。( 比较 ) |
| 为多个 MCP 服务器提供路由、隔离和凭证 | 一个 MCP 网关,例如 Docker 的网关,它在隔离容器中运行每个服务器并注入凭证。 | 在网关之后,用于写入 Postgres 的服务器。( 比较 ) |
| 每个步骤的追踪和评估 | Langfuse 或 LangSmith。 | 在它们旁边:追踪是代理一方的故事;检查读取 Postgres 提交的内容。( 比较 ) |
| 在传输层为 Postgres、Kubernetes 和 HTTP 设置规则 | Claw Patrol,它根据解析后流量上的规则对每个操作进行门控。 | 它也先做决定;它增加了对 Postgres 提交内容的检查、任何人都可以离线检查的记录,以及撤销。( 比较 ) |
| 扫描代理发送的内容及其工具返回的内容 | Pipelock,一个在两个方向扫描 MCP 流量的代理防火墙。 | 它在每次调用后增加对 Postgres 提交内容的检查,以及对行的撤销。( 比较 ) |
安全性
攻击套件在每个候选版本上对真实服务器和真实 Postgres 运行 82 个案例:82 个匹配,0 个不同 (attack/results/latest.json, docs/ATTACK_SUITE.md)。另外 23 个库级和 CLI 级案例(组 Y 和 T:加密敏捷性、A2A 代理、Debezium 见证、shell 守卫、时间戳)在每次拉取请求时用 go test ./attack 运行。私下报告漏洞:SECURITY.md。
在我们发展期间,所有功能都是免费的,因此没有任何东西检查许可证,也不会向 deedglass.com 发送任何内容:扫描读取你机器上的文件,使用 --postgres-dsn-env 时,只连接到你所指定的数据库。deedglass 许可证命令,为以后的付费选项保留,是唯一会调用 Dodo Payments 或 deedglass.com 的命令,而且只有在你运行它们时才会调用;DEEDGLASS_NO_NETWORK=1 会阻止这些调用。deedglass version --check 以及 deedglass policy install 和 policy packs 的 --latest 选项会在你使用时联系 GitHub。头部时间戳默认关闭;使用 deedglass.yaml 中列出的 TSA 或透明度服务时,deedglass deeds timestamp 和每次导出只联系那些服务。如果以后的构建要求密钥,许可证路径如何工作:docs/LICENSING.md。
文档和链接
- 文档:docs.deedglass.com · 快速开始 · 工作原理 · docs/
- 代理客户端:Claude Code · Cursor、VS Code 和 Windsurf · Claude Desktop · 你自己的 Postgres
- 框架:Vercel AI SDK · Claude Agent SDK · OpenAI Agents SDK · LangChain · Mastra · Pydantic AI · Google ADK · CrewAI · LlamaIndex
- 医疗保健:deedglass.com/healthcare · FHIR 连接器 · PHI 模式 · Medplum 示例 · FHIR 基准测试 · 医院试点 · IT 审查包
- GitHub Action:GitHub Marketplace 上的 Deedglass Scan
- 安全:SECURITY.md · 锁定 · 攻击套件 · 限制 · 验证记录
- 贡献:CONTRIBUTING.md · 适合新手的问题 · 讨论
贡献
文章标题:Show HN: 为什么 HTTP 200 在欺骗你的 AI 智能体(以及 Postgres 做了什么)
正文: 阅读 CONTRIBUTING.md:make dev、make ci、一项改动所需的测试,以及 DCO 签署(git commit -s)。问题请发到 Discussions(SUPPORT.md);决策如何做出见 GOVERNANCE.md。
如果 Deedglass 让你看到了日志里没有的东西,一个 GitHub star 能帮其他人找到它。
License
核心采用 Apache-2.0 或 MIT 双许可。TypeScript SDK 和示例采用 MIT。ee/ 中的功能采用 FSL-1.1-ALv2(在我们成长期间可免费使用),它们的每个版本在发布两年后转为 Apache-2.0。发行二进制、@deedglass/cli-* npm 包和容器镜像包含 ee/,因此其许可为 Apache-2.0 AND FSL-1.1-ALv2。
FSL-1.1-ALv2 允许你阅读、运行和修改 ee/,用于除提供竞争产品之外的任何用途(ee/LICENSE);Deedglass 为安全所做的一切都是免费的,且在 ee/ 之外(docs/LICENSING.md)。其余内容见 LICENSE;第三方声明见 NOTICE。欢迎以新名称复刻:TRADEMARKS.md。
记录规范(spec/:deed 格式和导出包)以及意图-vs-效果语料库(corpus/)以 CC-BY-4.0 发布,因此任何人都可以注明出处地实现、复制或改编它们。
通俗地说(这是摘要,不是法律建议;以许可文件为准):
| Question | Answer |
|---|---|
| 公司、医院或项目能否免费运行 Deedglass 的全部功能,包括 ee/ ? | 可以。自托管,全部功能,无需许可密钥。 |
| 我能阅读和修改代码吗? | 可以。核心是 Apache-2.0。ee/ 是 FSL-1.1-ALv2,允许为除竞争产品之外的任何目的进行修改。 |
| 什么不被允许? | 将 ee/ 或基于它构建的东西作为与 Deedglass 竞争的商业产品或服务提供给他人。每个 ee/ 版本在发布两年后转为 Apache-2.0 时,该限制随之取消。 |
| 我能自己实现记录格式吗? | 可以。spec/ 是 CC-BY-4.0:注明出处地实现、复制或改编。 |