Newshot

Show HN:为什么 HTTP 200 在对你的 AI 智能体撒谎(以及 Postgres 做了什么)

Translation(model translation, not the source's own text)
Deedglass
Deedglass

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),每个结果都会封存为一条带签名的记录,任何人都可以离线校验。它还能撤销某个操作所更改的行。

Terminal recording of a real make demo-hero run. Order 42 ships: Proven, Matches, 1 row. A legacy trigger is turned on and the same UPDATE runs: Proven, Doesn't match, Postgres changed 301 rows in public.orders, the agent reported 1, with the row diff. Then every record verifies offline.
Terminal recording of a real make demo-hero run. Order 42 ships: Proven, Matches, 1 row. A legacy trigger is turned on and the same UPDATE runs: Proven, Doesn't match, Postgres changed 301 rows in public.orders, the agent reported 1, with the row diff. Then every record verifies offline.

一次真实的 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
Gogo 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 行)回读未覆盖的副作用
ProvenPostgres 的变更日志(逻辑解码):事务提交的每一行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 playNode,以及来自 npm 的 deedglass 0.1.1 或更新版本。无需 Docker。规则实时决定每次调用,记录在你的机器上封存并检查;Postgres 的输出行来自一次录制好的真实运行回放,并已标注为回放。无
扫描你的环境npx deedglass scanNode。只读地读取你的 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 msp50 < 5 ms · p99 < 25 ms(p50 未达标)
策略 · 50 条规则p99 148 µsp99 < 1 ms
见证 · L2,100 次写入/秒p50 118 ms · p99 317 msp50 < 1 s
验证 · 100,000 条 deed1.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 发布,因此任何人都可以注明出处地实现、复制或改编它们。

通俗地说(这是摘要,不是法律建议;以许可文件为准):

QuestionAnswer
公司、医院或项目能否免费运行 Deedglass 的全部功能,包括 ee/ ?可以。自托管,全部功能,无需许可密钥。
我能阅读和修改代码吗?可以。核心是 Apache-2.0。ee/ 是 FSL-1.1-ALv2,允许为除竞争产品之外的任何目的进行修改。
什么不被允许?将 ee/ 或基于它构建的东西作为与 Deedglass 竞争的商业产品或服务提供给他人。每个 ee/ 版本在发布两年后转为 Apache-2.0 时,该限制随之取消。
我能自己实现记录格式吗?可以。spec/ 是 CC-BY-4.0:注明出处地实现、复制或改编。

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by HN AI
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗