anidoodle 深度评测:32 种手绘风格逐帧纯函数,1356 个 TypeScript 源码与 2028 条断言里的 3 条红

anidoodle 深度评测:32 种手绘风格逐帧纯函数,1356 个 TypeScript 源码与 2028 条断言里的 3 条红

用 AI 出过图的人都撞过同一堵墙:同一个提示词,今天画出来是这个构图,明天再跑一次就换了样子。想改一个字,整张重画;想批量出一套风格统一的图,只能一张张试运气。

GitHub 上有个叫 anidoodle 的项目赌了另一条路——它不「生成」图,它用代码「画」图。32 种手绘风格,每一笔都是代码算出来的,每一帧都是同一个函数的返回值。它的核心承诺只有一句:同一份源码,在任何机器、任何尺寸上,重画出同一张图、同一段音。

我在沙箱里把它 clone 下来、装完依赖、跑了它自带的 2028 条断言,还真的渲染出了图。这个承诺在前半段兑现得很干净,后半段有一条裂缝。

它到底是个什么东西

先说清定位:anidoodle 不是网页应用,也不是命令行工具,它是一份给编码助手用的技能包——装进 Claude Code、Codex 或 Grok Build 里,你对助手说「给我画一张水彩狐狸」,助手去读它的规范,然后按规范写代码、跑代码、出图。

仓库里同时躺着两套安装格式(一套给 Claude Code,一套给 Codex),以及一份 147 行的技能说明书。这份说明书开头就是「七条法则」,第一条是「每件作品都要有一个point」,第六条是「音乐要给出计划,不能只给形容词」。

真正撑起这个技能的是三层结构,每层解决一个不同的问题:

最里层是画核。画核目录下有 291 个文件,每个风格一个模块,模块开头的注释就是这道风格的「配方」——不是参数表,是画法描述。比如蜡笔那一个写的是「来回涂抹,跳过纸纹的凹陷,暗面压一支深色蜡笔,高光拿白色擦,轮廓用粗头描两遍」。代码就是按这句话写的。

中间层是宿主适配,116 个文件,负责把同一份画核塞进不同的渲染后端。四个后端共用一套画法,画核自己完全不知道最终是谁在画。

最外层是工具链,107 个脚本,管脚手架、渲染、出片、审片、查文档。

一个数字能说明这套设计有多较真:引擎的测试目录里躺着 104 个文件,其中 89 个是测试文件。

我实际跑出来的

先给规模,因为这类项目最容易在规模上吹牛。

核实项 我跑出来的原始输出
文件总数(排除 .git) 数出来 1845 个
TypeScript 源码 1356 个源码文件
引擎测试 104 个文件,其中 89 个是测试文件
风格注册表 32 条
参考文档 75 个 md,顶层 11 个入口
插件副本 496 个文件
依赖 2 个直接依赖、2 个开发依赖、5 个可选依赖

依赖清单很短:直接依赖只有 esbuild(打包器)和 three.js(三维渲染库);开发依赖是 playwright-core(浏览器自动化)和 TypeScript;可选依赖是 Remotion 全家桶(一个用 React 写视频的框架)。引擎的依赖锁定文件是提交在仓库里的,所以重新安装能装出完全一样的依赖树——这一点很多同类项目做不到。

装依赖实测:187 个包,3 秒装完,依赖目录占 424M。

然后跑它自己的全套单元测试,一条命令,1 分 38 秒。结果是 2028 条通过,3 条失败。

那 3 条红,我做了三组对照

三条红的原文长这样:

  • 夜曲那一条:无采样器时的音频要与改动前的指纹一致(期望值是 acd240c8 开头的一串)
  • 发射音效计划 1 与计划 2:两条路径的输出要与基准指纹一致

这三条不是「代码算错了」,是冻结的指纹断言——作者把某个版本渲染出来的一段音频的指纹,直接写死在测试里当回归锁。以后谁改动了混音代码,指纹一变,测试立刻红。

我按三种方式排除了「是我环境的问题」:

第一,连跑两次,两次都是同样这三条红,不是偶发的时好时坏。

第二,换 Node 版本。我的 Node 24 跑出 2028 通过 3 失败;换成系统里的 Node 22 再跑一遍,还是同样三条。所以不是新版本 Node 的浮点运算差异。

第三,往回退。我把完整提交历史 clone 下来,切到「声音特效 v2」那次大改之前的提交,重新装依赖再跑全套,结果 1948 通过 3 失败,红的三条一模一样。通过数变少是因为那个提交的测试本来就少。

三条对照指向同一个结论:这组指纹对构建环境敏感。作者写死的是他自己机器或 CI 上跑出来的值,换到我这台机器上,音频的末位就变了。

这里我要说清边界:我拿不到它 CI 的环境,所以我不下「它的确定性是假的」这个结论。确定性对一部渲染出来的视频来说,允许极小的像素级差异(它自己的规范里写的是「视觉上一致、峰值信噪比高于 45 分贝」),音频末位不同不等于人耳听得出。但一个把「同一份源码重画出同一段音」写进核心卖点的项目,最硬的两条指纹断言在本机对不上,这件事本身值得记一笔。

反过来,正面证据也是我亲手拿的

跑测试之外,我起了个真渲染。这一步要 Chromium 浏览器加 ffmpeg,沙箱里都没有,我从系统里借了一个 Chromium 154 和 ffmpeg 7.1,才让它认出来。

生成一张 1080×1080 的静帧,20 毫秒画完,它自己打印了一行「reproducible」(可复现)和一个指纹。同一份源码、同样的参数、再跑一次,指纹一个字符都没变。换两倍尺寸出 2160×2160,指纹变了——不同尺寸得到不同图,这是应该的。

再生成一段 3 秒的视频,它自己打印了一行:6 个抽样帧里,在一张页面上正序画、在另一张页面上倒序画,哈希完全一致。

所以准确的说法是:静帧和画面的确定性,我本机复现了;音频的确定性,我本机没复现出来。

它最狠的地方:把「好不好看」里能机器判的部分写成了脚本

这是 anidoodle 和绝大多数出图类技能最本质的区别。

大多数 AI 出图工具的质量控制是「你自己看,觉得不行就重抽」。anidoodle 的做法是把能机器判的那部分质量,全部写成脚本,跑不过就不许交付。它有三个核心闸门:

闸门 判什么 判据
确定性 同一帧用两种画法、两种并行数、两种顺序画,是不是同一张 逐字节一致,或峰值信噪比高于 45 分贝
契约 静态扫描画核里的每一个模块 禁用时钟、随机数、网络、图片加载等十几类写法
死气 有没有连续相同的帧、有没有半秒内变化不足 0.5% 逐帧算变化面积

「契约」这一项最能看出作者的脾气。它的禁用清单里包括系统时钟、真随机数、浏览器请求、本地存储——只要画核的代码里出现这些,直接判红。理由写在注释里:如果源码能碰到时钟或网络,那再怎么让两次渲染结果一致,都证明不了什么,因为下一台机器可能就不一致了。

我拿一段刚生成的视频去跑主闸门,14 项全过:12 个抽样帧跨一页和三页哈希一致、297 个画核模块零违规、281 处随机全是种子驱动的、90 帧里没有一帧静止、产物是 25KB 的自包含网页且无任何外链。

更值得说的是它有个自检开关。跑自检时,它会拿 6 个故意写坏的样例去喂自己,看自己会不会红。我跑的结果是自检通过:四个应判红的都判红了,两个应放行的也放行了。

注意里面有两个必须判通过的样例。很多项目自带的检查只会「保证能判红」,判红的检查本身是不是过敏、会不会把好片子也毙掉,没人验证。这 6 个样例把两头都锁住了。

还有一个细节,我觉得是全篇最见功力的一处。它有个更狠的交付闸门叫 ship,规则写在一句注释里:「一个看不见的检查就是失败」。意思是某个检查项如果没东西可判(片子没声明配乐、没有评审记录、没有长度预算),它记失败——因为这个检查根本没做,而不是「没问题所以通过」。

注释里还留着一笔账:曾经有六行这样的「没判」加起来,最后得出一个交付通过。

我拿刚生成的 3 秒片子去跑 ship,它判了自己失败,理由包括「第 0 帧接近空白,平台拿它当缩略图,读不出内容」和「没声明配乐、没评审记录、没长度预算」。一个连自己刚生成的样例都不放过的闸门,才算真闸门。

两条路线:拼素材,还是画每一帧

把 anidoodle 放进我们之前评测过的几个视频项目里,坐标就清楚了。

我们评测过 anything2explainer,那是把一段话题拆成脚本、再交给多个助手分工出片;也评测过 MoneyPrinterTurbo 和 OpenMontage,那两个都是找素材、拼素材、剪素材——从图库和生成模型里取料,按脚本拼接。

两条路的代价完全不同:

拼素材这条路,画面质量的上限由素材库决定,好处是随便什么题材都能凑出画面,坏处是你永远不知道自己会拿到什么,同一个片子重做一次素材全换。anidoodle 这条路,画面的上限由写代码的人决定,好处是一旦写对,往后每次都是同一张;坏处是它只能画它被写成能画的东西——你让它画一只蝴蝶,画核里得有蝴蝶。

所以 anidoodle 的适用范围窄得诚实:品牌视觉、插图系列、教学动画、动效标识、说明片。它不适合拍现实世界的视频,也不适合需要「大量不同题材快速出货」的场景。

至于「技能怎么被助手调起来」这一侧,可以对照 agent-autoloop 那篇。anidoodle 在这件事上有个很聪明的取舍:它把「一次写对,往后零成本」当成卖点。作者的算法是——一部 47 秒的片子有 1410 帧,第一次写代码时平均每帧约 60 个词的代码量,之后每次渲染都是零成本。这句是作者的主张,我没实测(要实测得真的把整部片子写完再数一遍)。

几个必须先知道的风险

它不是一个装了就用的东西。三条硬依赖:要 Chromium 浏览器、要 ffmpeg、首装依赖 424M。我这次是靠从系统里借浏览器和 ffmpeg 才跑通的,而且借 ffmpeg 时还缺两个数学库,手动补了软链才行。这类环境摩擦,普通用户会卡在第一步。

音色包是可选但很大的下载。想让它用真实钢琴、竖琴、马林巴这些录音,要额外下 373MB 的音色包(钢琴单独 233MB)。不装也能跑,分数照样合成,只是全部用代码模拟音色。

风格数量有两个口径,我对了一遍。代码里注册的是 32 种(这也是它自己文档检查脚本的基准)。但主 README 的第 187 行写的是「Thirty-one full recipes」,而同一份 README 的第 14、40、49 行都写 32。参考文档 styles.md 开头还留着更早的旧说法「The nine」。

这里有个我实测出来的盲区,值得单独说,因为它解释了为什么这个矛盾能长期存在:anidoodle 有个叫文档检查的脚本,专门检查文档里的风格数量跟代码对不对得上,会扫六种语言的 README。它跑出来的结果是 104 条断言全过。但我把主 README 第 187 行那个「Thirty-one」改成阿拉伯数字「31」,它立刻红了;改成英文单词「Thirty-one styles」,它又绿了。

原因在源码里:这个脚本的英文数字词表只到十二。十三以上的英文数词它根本不认。也就是说,这个文档闸门对「2 到 12 种风格」是真闸门,对更大的数字等于没装。同一个错误,写成阿拉伯数字会被抓,写成英文单词就漏过去——这正好解释了那处矛盾为什么活了这么久。

许可证是 Apache-2.0,商用前要读附件声明。仓库根目录除了许可证还有个附件文件,里面是第三方资产的归属声明(three.js、一个字体)。Apache-2.0 允许商用,但附件里的署名义务得照做。

仓库里的插件目录是裁剪副本,不是全量。它给三家助手各准备了一份安装包,496 个文件。我逐文件比了一下:两边都有的 490 个文件里,489 个字节完全相同,只有一份配置差一点。被裁掉的是测试目录(104 个全没)、示例目录(42 个全没),以及画核源码的一部分(419 个只剩 281 个)。所以插件版装不了自检——你跑自检,它会直接告诉你「样例文件不在这个安装包里」。

判断

anidoodle 是个想法比实现更值得看的项目。它的想法——把画面写成纯函数、把质量判据写成脚本、把「没检查」当「检查失败」——是这一波 AI 出图工具里少见的工程态度。它甚至诚实到在自己的规范文档里记下一次「首跑 0/12 帧一致、之后 7 次都 12/12 通过」的不可复现故障,并写下:「一个失败过一次又通过的闸门,是最危险的结果,因为最省事的做法是重跑到绿然后什么都不说。」

它的实现也够扎实:1845 个文件、1356 个 TypeScript 源码、2028 条断言、14 项闸门全过、6 个自检样例两头都锁。1,713 个 Star、45 天 316 个提交,其中 9 月 28 日一天就提交了 166 个。

但它也有那条裂缝:最核心的 3 条冻结音频指纹,在我这台机器上、两种 Node 版本、退回到更早的提交,都对不上。我不认为这推翻了它的确定性主张,因为画面层面的确定性我亲手复现了。但一个以「同一段源码重画出同一段音」为旗号的项目,这条旗杆在本机没立住。

适合谁:做品牌视觉、插图系列、教学动画,且愿意读代码、接受较陡环境配置的人。它给你的不是「一口气出 100 张图」,是「这一张图以后每次都是这一张」。

不适合谁:想开箱即用、或者要快速覆盖各种陌生题材的人。它的能力边界就是它画核里写过的东西。

—

关注 AI商业快讯,每天一篇 AI 热点深度解读。

相关阅读:

AnyModelBot 深度评测:19 天 314 个提交 35 个版本,2045 个测试跑出 6 条红,其中 4 条是宿主限制

AnyModelBot 深度评测:19 天 314 个提交 35 个版本,2045 个测试跑出 6 条红,其中 4 条是宿主限制

想在微信里让 AI 干活,绕不开一个尴尬:网页版聊得再顺,它也碰不到你电脑上的文件、开不了你的软件;真让它动手,又要自己搭沙箱、配审批、做记忆。AnyModelBot 想省掉的正是这一步——一个装在自己电脑上的桌面应用,机器人有记忆、能跑命令、能在授权后操作电脑,还能接进微信、飞书、Telegram、Slack、Discord。19 天里它涨到 4,097 Star,发了 35 个版本。

先把它是什么说清:它是应用,不是按订阅卖的模型服务。应用本体 MIT 免费,模型走作者自家的 Modelflare 按量付费,也可以填各家的官方 Key 直连。这条边界我放在后面单独一段讲。

我把仓库整个 clone 下来,在隔离沙箱里装了依赖、跑了两遍类型检查、分三段跑完它自带的 2,045 个测试。下面全是自己跑出来的数字。

一、19 天 314 个提交:两天搭骨架,之后小步发版

仓库 2026-10-27 建,最后一次提交是 11-15。314 个提交分布在 17 个有提交的日子里:

日期 提交数 备注
2026-10-27 9 首提交一次性落地运行时、飞书/微信渠道、内置网关、界面、Electron 桌面壳、Docker
2026-10-30 ~ 11-01 19 + 82 + 105 三天 206 个,占全部 314 个的 65.6%
2026-11-02 ~ 11-03 17 + 16 收尾与修复
2026-11-04 ~ 11-11 每天 1 ~ 10 个 进入小步节奏
2026-11-14 ~ 11-15 12 + 13 冲 0.1.36 到 0.1.40

10 月 31 日和 11 月 1 日两天合计 187 个提交,占总量 59.6%。之后单日再没超过 17 个。

版本节奏更极端:GitHub Release 35 条(31 条语义版本 v0.1.5 到 v0.1.40,加 4 条 win-x64-<版本>-unsigned 的早期 Windows 包),tag 41 个,全部压在 20 天里,平均一天 1.75 个。版本号在这个密度下几乎没有索引作用——想知道两个相邻版本差什么,得翻更新日志而不是记版本号。

二、架构:小依赖树,三个重子模块

真正好看的地方是它的分层,也是我评测里最想让人抄的部分。

生产依赖只有 10 个,开发依赖 12 个。装依赖这一步全部可复现:

项 我跑出来的值
生产依赖 / 开发依赖 10 / 12(另有 29 条脚本、要求 Node 22.13 以上)
npm ci 结果 395 个包、283MB、4.0 秒
锁文件 已提交进仓库(218KB,格式第 3 版)——很多热门仓库不带,它带了
类型检查 两份配置各跑一次,退出码都是 0(1.1 秒 / 1.7 秒)

锁文件在仓库里这一点值得单独说:很多热门大仓库不带锁文件,装出来的依赖每次都不一样;它带了,所以上面这 4 秒可以复制。10 个生产依赖里最重的四个是飞书官方开发包、给桌面壳用的自动更新器、做界面的 preact 和 htm、以及通信库。

但依赖树小不等于项目轻。它真正的重量在三个 git 子模块:

子模块 用途 语言
magpie 子模块 内置模型网关,负责把请求转给各家供应商 Go
deepseek-harness 子模块 代理运行时(也就是机器人的执行引擎,项目里叫 DSH) TypeScript
kimi-computer-use 子模块 电脑操作技能包 TypeScript

src/ 下 20 个模块目录,342 个 TypeScript 文件、57,586 行;其中 src/i18n 一个目录就占 170 个文件(140 个语言包、28 个消息命名空间),所以真正的业务代码是 48,006 行。模块划分是照着产品动作切的,不是照着框架切的:core/ 管统一消息类型与会话队列,delivery/ 管主动消息的免打扰与每日上限,agent/ 是代理宿主与审批桥接,tools/ 是联网搜索、生图生视频、电脑操作、PowerShell、连接应用,tasks/ 是后台任务与规则,store/ 用 Node 自带的 SQLite 所以不需要原生编译。

一个我没想到的细节:架构约束是拿测试兜的,不是写在文档里——有一份测试文件专门检查依赖方向,存储层只能依赖数据形状层,反过来就报错。

规范也几乎不在仓库根:

位置 行数 管什么
仓库根的约定文件 7 第 1 行禁止切分支,其余 6 行全是发版纪律(官网要真的部署上线、发布包与镜像与官网全同步才算发完)
技能目录里的开发规范 42 加一个新目录 Bot 的全部规矩,第一句就把深文档指走
目录 Bot 的参考文档 330 包格式、检查、签名、界面接口
开发文档 311 20 个模块各一句用途,加工程细节

这和那些把规范写成一大摞技能文档矩阵的同类项目正好相反:根上只有发版纪律,代码规矩交给测试,人的规矩交给那 42 行。

三、实证:2,045 个测试,三段式从「1 红」到「全绿」再到「6 红」

测试是我这次评测的主证据,因为它自己会分层:缺哪个前置条件就跳过哪一层,跳过的名单和条件都写在测试文件里。

阶段 前置 文件 用例 耗时
d1 裸跑 三个子模块都没检出 1 失败 / 105 通过 / 13 跳过(共 119) 1 失败 / 1,842 通过 / 202 跳过(共 2,045) 118.5 秒
d2 拉电脑操作子模块 单独拉那一个子模块,浅克隆一层(0.4 秒,17 个文件) 106 通过 / 13 跳过 1,843 通过 / 202 跳过 117.2 秒,退出码 0
d3 装代理运行时 node scripts/prepare-dsh.mjs(570 个包、裁剪后 119.3MB) 2 失败 / 110 通过 / 7 跳过 6 失败 / 1,973 通过 / 66 跳过 291.1 秒,退出码 1

d1 那一条红很好懂:有个用例要读子模块里的技能说明文件,子模块没拉,文件不存在。拉下来 0.4 秒,它就绿了——这也是 d2 能做到 106 个文件全绿、退出码 0 的原因。

但 d2 的全绿有水分:13 个文件被整段跳过,其中包括 agent.integration(49 个用例)、rules.integration、tasks.integration。跳过条件是「找不到代理运行时或找不到 bwrap(Linux 上的沙箱工具)或不是 Linux」。所以 d2 阶段,它最有卖点的那部分根本没被测。

d3 装上运行时之后,那些用例才真正跑起来,于是 6 条红。这 6 条我逐条查了原因,得分成两类。

第一类 4 条,是宿主环境限制,不是项目缺陷:

用例 期望 我这里的实得
遮蔽宿主数据目录 看不到数据库 能列出 anymodel.db、-shm、-wal 等
拦回环管理接口 返回 403 返回 200
默认档位:工作区外的写入被关住、提权要审批 看不到数据库 能读到
完全权限档:命令不装沙箱 回环接口仍被拦 返回 200

原因链我复现了。这些用例要在测试里再起一层沙箱,而我这边已经是沙箱里了,套不了第二层:

验证动作 结果
在沙箱内起一层最小沙箱(bwrap 加两个只读挂载) 报 setting up uid map: Read-only file system
同一条命令在沙箱外跑 退出码 0,正常通过
单独新建用户命名空间 通过
新建用户命名空间并映射成 root 失败:写不进进程的用户映射文件

根因是嵌套环境里 /proc 是只读挂载,而新建用户命名空间的最后一步要往那里写一个映射文件,写不进去。

bwrap 探不通之后,它会按设计退到备选的 Landlock 沙箱——这个我实测是可用的(探针返回「完整」)。但 Landlock 只按路径授权读写,不做网络隔离,所以「遮住数据库」和「拦回环接口」这两件事在这个环境里就落空了。换句话说:这 4 条红测的是宿主有没有能力关住自己,我这台机器没有,不是它写错了。

第二类 2 条,是实现改了、断言没跟上,跟沙箱无关:

用例 断言 实际
系统提示词里机器人设定在最后 结尾等于机器人设定 结尾是「技能和应用」段
规则会话的观察模式提示 含「这次是观察:只看、只查,不改任何东西」 实际是「观察:只看、只查,不写文件、不发消息、不调用写入接口」

第一条我做了探针:在测试里临时打一行日志把系统提示词尾部打出来(跑完已还原),尾部确实是「技能和应用」。翻代码看,拼接顺序从 0.1.36(11-14,加技能库那次)起就变成「机器人段、连接的应用、技能和应用」了,断言还停在旧约定。第二条更明显:那句提示文案在 0.1.33(11-14)改写过,测试没跟着改;规则段本身是正确加载的,探针里能看到。

所以准确的说法是:2,045 个用例里,1,973 个在完整环境下通过,2 条是仓库自己该修的回归,4 条是我这台机器的局限。它的自动构建跑的其实是 d2 那种形态(有电脑操作子模块、没有代理运行时),所以这 6 条里有 2 条在自动构建里根本不会被执行——这是「测试全绿」这句话在这里容易误导的地方。

四、坐标系:它跟谁在一个架子上

把它放进读者熟悉的两个位置看,轮廓更清楚。

第一个位置是「自己电脑上的 Agent 应用」。OpenMuse 是同一赛道最近的参照,6.3k Star、520 个测试,但当时一个正式版本都没发;它走的是另一条路——两天把骨架搭完,然后用 35 个 release 一点点补,测试规模也大一个量级。

第二个位置是「自托管 AI 前台」。LibreChat 是 4.7 万 Star 的自托管对话前台,它解决的是「模型和对话归自己管」,形态是网页。它多走了一步:桌面端、能跑命令、能在授权后操作电脑,代价是它必须处理沙箱与审批——也就是上面那 4 条红的来源。agent-autoloop 代表第三侧——「谁在跑 Agent」这一层,它的答案是把调度放在命令行中台;它的答案是放在你自己的桌面上,让人在微信里就能批。

适合谁:想在自己电脑或家用存储服务器上有一个能读写文件、能定时干活、能从微信说话的助手,并且愿意用 Docker 或装包而不愿自己拼沙箱、审批、记忆、渠道这四件事。不适合谁:介意请求经过第三方网关的人;以及想从源码自己跑通的人——下面这段要有心理准备。

五、边界、代价与结论

先说利益边界,这是这篇最该建议你读的一段。应用本体按开源协议免费开放,包里没有任何订阅或付费字段。但模型默认走作者自家的 Modelflare,按量付费。项目说明文档里有一段自称「一条诚实的边界」的原文:模型请求会经过 Modelflare 转发给你选定的供应商,Modelflare 会保留请求日志,保留什么、保留多久见它的信任中心。同一份文档另一处写得更直白:不声称能做到万无一失,凡是你发给模型的内容都会离开你的设备。本次评测没有购买任何付费服务、没有收取任何费用,与作者也没有往来。

代价清单,按我撞到的顺序:

  • 从源码跑一条通要四样东西:Node 22.13 以上(文档写 22.13 以上,镜像里用 22)、Go(编内置网关,文档写 1.26.8 以上,镜像里用 1.27)、三个子模块、代理运行时。少一样,测试就会静默跳过一整层。
  • 我这台机器没有 Go,所以网关没编出来,也就没跑真模型对话——聊天质量这篇不做评价,我评的是它的工程与测试。
  • 苹果系统上的电脑操作还是测试版,要求系统版本 14.4 以上。
  • issue 区只有 3 条(1 条未关:Windows 安装版启动即退,无窗口无日志)。低 issue 数不等于没坑,也可能是用户规模还没上来——19 天的项目,样本太薄。
  • 贡献者 4 人:作者内圈 3 人占了 310 个提交(98.7%),外部两位分别 14 个和 1 个。这不是社区项目,是一个团队的高频迭代。

我的判断:它是一个把「桌面 Agent 的脏活」做扎实了的项目——沙箱、审批、记忆、渠道、多语言,每一样都留了测试;依赖树小、锁文件在、自动构建只跑能跑的那一层,这些是它敢一天发近两个版本的底气。真正要观察的是两件事:那 2 条与实现脱节的断言什么时候补上(补上说明它在意测试可信度),以及模型必须过自家网关这条边界,读者能不能接受。

如果你的用法是「在微信里让助手把电脑上的活干完」,它现在的成熟度值得装一个试试;如果你要的是完全自建、谁的网关都不经过,那还是回到自托管方案更省心。

RAPTOR 深度评测:4,023 Star 的自主安全研究框架,AI 写代码人来定方向,正式版落后主干 9,181 个提交

RAPTOR 深度评测:4,023 Star 的自主安全研究框架,AI 写代码人来定方向,正式版落后主干 9,181 个提交

用过 Claude Code 的人大概率见过这一幕:让它查一处可疑代码,它翻两个文件就回你「这里没有安全问题」;你再追问,它换个说法,结论还是没问题。

安全这件事不能靠猜。可真请人做一次代码审计,报价动辄几万起步,小团队根本排不上。

有个 4,023 Star 的开源项目想换掉这个「猜」字:让模型只负责提假设,判决权交给工具。奇怪的是,它的作者一再劝你别用最新代码。

一、RAPTOR 到底是个什么东西

一句话:它把「AI 帮你查漏洞」这件事拆成几道工序——先机械扫描,再逐一验证告警真假,最后给出可复现的攻击样例和补丁草稿。

名字是「递归自主渗透测试与观察机器人」的缩写,作者们自己也承认,取这个名字纯粹是因为听着带劲。

它的作者名单本身就是一层背书:Gadi Evron、Daniel Cuthbert、Thomas Dullien(安全圈更熟的名字是 Halvar Flake)、Michael Bargury、John Cartwright。这几位在攻防研究里属于「名字印在教材致谢页」的那一类人。

最值得注意的是它对自己血统的坦白。仓库首页原话大意是:这套东西大部分由 AI 写出来,人负责定方向、审输出、做设计决策,靠测试和静态分析把质量线钉住。

二、关键设计:谁提假设,谁下判决

多数「AI 查漏洞」工具有同一种毛病:模型看一眼代码,说这里危险,谁也没法证伪。

RAPTOR 反过来分工。模型读完上下文只能提出猜测,比如「这个入口的输入可能直接拼进数据库查询」;接着它必须调用真正的分析工具去验证——把代码路径追下去、把数据流画出来,拿到工具的判定结果才算数。模型不能自己给代码下「有漏洞」的结论。

这套规矩带来一个副作用:它对环境极其挑剔。

能力 依赖的外部工具 我这台机器上的状态
源码扫描 Semgrep 或 CodeQL 缺失
模糊测试(拿随机输入把程序撞崩) AFL++ 缺失
跨函数追踪污点数据 Joern 缺失
二进制逆向 radare2 缺失
数学可行性验证 Z3 求解器 缺失
崩溃根因定位 gdb、rr 缺失

跑它自带的体检命令,结果是 0 项失败、7 项通过、13 条警告。逐条看这 13 条:1 条只是「某个环境变量没设」的提示,剩下 12 条里 10 条是「某件外部工具没装」(包括上表没列出的补丁校验器、动态插桩工具和它的追踪工具),还有 1 条是「某个可选语法组件没装」、1 条是「某朵云没配好」。也就是说,「失败为零」完全不等于能用,这 12 条能力缺口才是它真正需要的东西。

作者给的最省事路线是用官方准备好的容器镜像,把工具链一次性装齐;手工安装则要自己凑齐上面这张表。

三、我把代码拉下来实测了什么

规模是真的,而且大头在测试上。 仓库 9,316 个 Python 文件、278 万行代码。拆开看:产品代码 109.6 万行、2,252 个文件;测试代码 169.1 万行、7,064 个文件,测试占 60.7%。一般开源项目里测试代码往往少于产品代码,它是反过来的 1.5 倍。

测试不是凑数。6,709 个测试文件里,只有 42 个短于 20 行(0.6%),绝大多数是真写了一堆断言。

但文件拆分吓人。 单一个审计调度文件就有 38,704 行、518 个函数,其中最长的单个函数 3,508 行,后面还有 2,498 行、2,150 行、2,033 行的。这很像 AI 生成代码的典型形态:机器不怕长,人不忍拆。

最实用的坑:文档和主干差两个月。 最新正式版本发布于 9 月 7 日,而主干分支已经领先 9,181 个提交。首页上「用稳定版」的劝告是真的——你照着最新文档敲命令,碰到的可能是两个月后的代码。这不是新鲜度的优点,而是实打实的使用门槛。

唯一不靠模型也能跑的部分,我跑通了。 依赖与供应链检查不需要任何模型接口:

实测项 结果 意味着什么
耗时 1.1 秒 可以塞进每次提交的自动检查
解析依赖 145 个 连工作流里引用的第三方动作都算进去了
生成的物料清单 106 个包 这是回答「你的软件到底装了什么」的凭据
检出条目 167 条(许可证 97、卫生 62、供应链 5) 注意是「待处理项」不是「漏洞」
已知漏洞 0 个 但见下一行
漏洞库查询 86 次全部失败 我那台机器出网受限,它如实报「查询不可用」

最后一行是我最认可的一处设计:它没有把「查不到」悄悄算成「没漏洞」,而是明确标出本次覆盖不完整、这些依赖的安全公告可能缺失。安全工具最怕的就是这种沉默。

许可证要留个心眼。 仓库里的许可证原文是标准 MIT,但代码托管平台的自动识别标成了「未识别」,因为它捆绑了一份公有后缀列表(那部分适用另一份开源协议),还挂了一个子模块(第三套协议)。要商用的话,得先读它的第三方声明文件。

自己也要花点钱。 用模型做分析时,单个源码扫描任务默认给了 5 美元的消费上限,全自动流程默认 10 美元——这个设计挺务实,但意味着它不是一个「免费跑」的工具。

四、谁该用,谁别碰

同类里可以对照两个方向:偏「技能包」的轻量安全审计(把规则和提示词打包,装进助手就能跑),和商业化的代码审计平台(按项目收费,结论有人签字)。RAPTOR 站在中间:比重型平台便宜,比轻量技能包重得多,成本主要花在装工具链上。

适合:手上有代码要过一遍、愿意花半天配环境的安全工程师;想给自家产品做上线前自查、并且只把报告当参考线索的小团队;想学「模型+工具」怎么分工的开发者——它的仓库本身就是一份可读的工程范本。

别指望:装完就出结论。它的报告是线索,不是结论,更不是「这份代码安全」的证明,作者把这句话写在了首页。

对非技术读者,它给不了一条「装上就能赚钱」的捷径。真正值钱的部分不是这套代码,而是它示范的那套分工:让擅长说的去说,让擅长证的去证。

五、我的判断

值得放进观察清单,但别急着上手。

它最像的不是一个产品,而是一份公开的工程笔记:几位资深攻防研究者花一年时间,演示了「AI 写代码、人定方向、测试守底线」能走到哪一步。这套分工值得每个正在用 AI 写生产代码的人抄回去。

真要用来干活,建议等它的容器镜像和文档追平主干——现在这个版本,差着九千多个提交。

关注 AI 商业快讯,每天一篇 AI 热点深度解读。

Cursor 安全复盘:第三方推理商的密钥泄露,5,000 名开发者装上带 SSH 后门的 Claude Code 扩展

Cursor 安全复盘:第三方推理商的密钥泄露,5,000 名开发者装上带 SSH 后门的 Claude Code 扩展

5,000 名开发者,装了一个假的 Claude Code。

不是他们贪心,也不是点了钓鱼链接。他们只是在 Cursor 的扩展市场里,更新了一个自己天天用的插件。11 月 13 日,Cursor 用一篇 6 分钟的复盘承认:这把刀,是从供应商那边递过来的。

发生了什么

事情的起点不在 Cursor,在 Fireworks——一家提供模型推理服务的第三方厂商。推理(也就是模型跑一次回答)这块活,Cursor 把一部分交出去了。

Cursor 发给 Fireworks 一把访问钥匙(一把只能读数据的凭证),用来共享训练用的数据。按照 Cursor 的说法,这把钥匙是被 Fireworks 那边泄露的。攻击者拿它打开了一个只读存储桶——只能读、不能改的网盘——里面存着历史编码对话记录,大部分是 2025 年的,来自没开隐私模式的用户。

问题出在这些记录里:有一小部分,其中的接口密钥(就是调用各家 AI 服务时要出示的那串口令)忘了打码。拿到它们,攻击者一路摸进 Cursor 内部若干个 SaaS 工具(在线客服、监控这类第三方服务),读到归档的非生产源码仓库、部分客服邮件、产品使用数据、部分对话摘要,还有用户以前发给客服的凭证。

最后一步最狠。10 月 29 日,攻击者用偷来的一个市场发布凭证,把两份假的 Claude Code 扩展直接放进了 Cursor 用来分发扩展的缓存,版本号 2.1.312 和 2.1.313。从凌晨 2 点 27 分到下午 1 点 35 分,挂了大约 11 个小时。Cursor 估算,最多 5,000 名在这段时间请求了这两个版本的用户,可能装上了带 SSH 后门的版本。

(SSH 是远程登录服务器的常用通道;后门,就是有人给自己留了一把能随时进来的钥匙。)

数字与一手细节

关键数字摆齐,全部来自 Cursor 官方复盘与 10 月 29 日的安全公告:

  • 暴露时长:约 11 小时(10 月 29 日 2:27 至 13:35,太平洋时间)
  • 潜在中招人数:最多 5,000 人
  • 对话记录被波及的用户:不到 0.05%;接口密钥被波及的客户:不到 0.01%
  • 恶意版本:Anthropic.claude-code 2.1.312 与 2.1.313,仅 macOS 与 Windows
  • 最后一次攻击者活动:11 月 1 日,已被阻断

恶意代码干的事很具体:收集主机名、用户名、系统版本、工作目录、Git 邮箱和公网 IP,把攻击者的公钥(备注名 svc-telemetry)写进你的免密登录名单,再拉起一条反向隧道——从你的机器主动连出去,让外面的人能反向进来。它还会在 macOS 上装开机自启,在 Windows 上建计划任务,后台每 60 秒重试一次。

反过来说,这条后门在多数机器上其实没打通。Cursor 自己写明:开启本地 SSH 服务需要管理员权限,而恶意扩展在绝大多数 mac 和 Windows 上没有这个权限;再加上恶意代码本身有错误,这一步大概率失败。攻击者的服务器也已被托管的云厂商下线。

还有两个容易被忽略的事实:Anthropic 没有发布过这个版本,Cursor 的上游扩展源 Open VSX 里也从未出现这个恶意包。换句话说,问题不在模型厂商,也不在开源源站,而在中间那层分发缓存。

反转:挡住攻击的是运气,不是防线

这里有两层反转,值得分开看。

第一层,Cursor 的口径和事件本身是矛盾的。官方反复强调「绝大多数客户没有受影响」,从比例上讲没错——0.05%、0.01% 都是很小的数字。但对被点中的那 5,000 个人来说,比例毫无意义:他们在自己的编辑器里,装了一个带 SSH 后门的扩展。而且 Cursor 在 10 月 29 日的公告里明确写了一句:光卸载扩展可能不够,因为恶意代码会丢下独立的常驻脚本,继续跑。

第二层反转更冷酷:这次没出事,很大程度上是因为攻击者写错了代码。安全研究者复盘发现,恶意脚本在多数没有预先开启 SSH 服务的 mac 和 Windows 上都会失败。救下这批开发者的是攻击方的失误,不是防守方的能力。

把镜头拉远,Cursor 不是孤例。安全厂商 Wiz 把这轮针对 AI 开发平台的连环入侵叫「黑色十月」:10 月 9 日 Fireworks 首次披露,10 月 15 日 Lightning AI,10 月 16 日 OpenCode,10 月 20 日 Railway,10 月 23 日 Warp,10 月 30 日 Northflank,再加上 Cursor 与 Fireworks 的第二次。平台 Zeabur 已经因为这起事件宣布关停。

其中 Railway 公布的一手数据最能说明这门生意的规模:最多 1.85% 的工作区(约 10 万个) 的环境变量可能被解密,1,852 名用户的关联令牌被重置,被偷走的钥匙造成的未授权消费估计达到 74 万美元。攻击者在数据库里按正则表达式专门筛「AI 供应商密钥」这一类变量,还专门挑环境变量数量多的客户下手。

动机并不神秘:偷到的 AI 凭证可以转卖给路由网关,用来做大模型盗刷(行话叫 LLMJacking,也就是盗用别人的账号额度,转手把模型调用卖出去),也可以拿去炼自己的模型——行话叫蒸馏,意思是拿别人的模型输出去训练自家的模型,省下大笔训练成本。Wiz 记录的两个下游滥用案例,光按标价计算就烧掉了超过 10 万美元。

对你意味着什么

如果你用 Cursor、VS Code 或任何带扩展市场的编辑器,这件事的关键不在「Cursor 安不安全」,而在这条链条有多长:

你的编辑器信任扩展市场,扩展市场信任发布凭证,发布凭证来自内部系统,内部系统被一把发给第三方推理商的钥匙打开,那把钥匙被推理商泄露。

五层里,你只能看见第一层。你点「更新」的时候,实际是在替后面四层一起背书。

更值得记住的是数据侧的教训:一份 2025 年的历史对话记录,因为几句忘了打码的密钥,就能把攻击者从「只读」抬到「能写入」。这不是某家公司的疏忽,而是整个行业为了做模型训练而长期保留对话数据这个默认设置带来的结构性风险。这也是为什么 Cursor 这次的处置里,最彻底的一条是把所有推理流量从 Fireworks 整体迁走。

我该做什么

按优先级,四件事。

一,先自查。恶意扩展会在免密登录名单里留一个备注为 svc-telemetry 的公钥。macOS 终端执行:

grep -qs svc-telemetry ~/.ssh/authorized_keys && echo "命中" || echo "干净"

Windows 在 PowerShell 里查 %USERPROFILE%\.ssh\authorized_keys 与 C:\ProgramData\ssh\administrators_authorized_keys 两个文件,搜 svc-telemetry。命中就按 Cursor 公告里的清理脚本处理,并考虑重装系统。

二,判断自己在不在名单里。开了隐私模式的用户,对话记录不在那个存储桶里;没开的,如果当时装了这两个恶意版本,你应该已经收到 Cursor 的站内通知或邮件——Cursor 说没收到通知,你的数据就不在这批记录里。

三,轮换凭证,别只卸载。只要你的机器在 10 月 29 日那两个版本期间装过扩展,就从一台干净设备上重置这台机器能碰到的所有密钥,尤其是你曾经发给过客服的那些。

四,对团队来说,把供应商事故写进自己的应急清单。这次真正的入口是一家你大概率没听说过的推理服务商。提问方式可以很简单:我们交给第三方的数据,留存多久、存在哪、谁能读、泄露了怎么通知我们。答不上来的,就是风险敞口。

—

过去一个月,同一个剧本在至少七家 AI 开发平台上重演了一遍,Cursor 只是其中第一个把完整链路公开到「一把钥匙怎么变成 5,000 个后门」的公司。这类事故还会再来,因为只要 AI 凭证能直接换成钱,撞供应商的门就永远比撞你的门便宜。

关注 AI商业快讯,每天一篇 AI 热点深度解读。

相关阅读:

参考来源:

  1. Cursor 官方复盘《An update on our recent security incident》(2026-11-13,一手)https://cursor.com/blog/security-incident-update
  1. Cursor 官方安全公告《Security notice — malicious version of Anthropic.claude-code 2.1.312 and 2.1.313》(2026-10-29,一手)https://cursor.com/blog/claude-code-extension-security-notice
  1. BleepingComputer《Cursor confirms security breach led to malicious Claude Code extension》(2026-11-14)https://www.bleepingcomputer.com/news/security/cursor-confirms-security-breach-led-to-malicious-claude-code-extension/
  1. Wiz《”Black October” for AI Developer Platforms》(安全厂商分析)https://www.wiz.io/blog/black-october-for-ai-developer-platforms
  1. Railway 官方事件报告《Incident Report: October 21st Security Attack》(2026-11-10,一手)https://blog.railway.com/p/incident-report-october-security-incident

anything2explainer 升级版评测:3,319 星零 release 零 tag,31 个 commit 把审美改成了能跑的脚本

anything2explainer 升级版评测:3,319 星零 release 零 tag,31 个 commit 把审美改成了能跑的脚本

想把一个技术概念讲明白,最省事的路是丢给 AI 视频模型:画面很唬人,可图上那几个字全是糊的,数字一个都不敢用。第二省事的路是自己开剪辑软件,四分钟的一条片要摆一晚上。

9 月 12 日本号实测过一个叫 anything2explainer 的开源项目:给它一个话题,它产出一条带配音、带逐字字幕、带章节进度条的黑底讲解片,每一帧都由代码画出来。当时它上线三天多,954 星。

两个月过去,这个数字变成 3,319 星、423 个 fork,星数涨了 3.5 倍。而从 9 月 17 日到 11 月 9 日这两个月里,仓库只落了 11 次提交:全部 31 个 commit,零个 release、零个 tag。一个讲「怎么把活干好」的方法型仓库,两个月不打一个版本号,星数却翻了 3.5 倍,这个反差本身就是这篇要写的东西。

这篇是上次那篇实测的续集,旧文讲过的功能介绍(四层交付物、九个阶段、样片档案怎么读)这里一句都不重复,只写这两个月新长出来的东西,以及我这次在沙箱里逐个重新核过的数字。

跟 9 月那版比,改了什么

先说结论:这两个月它没加功能,全在改「怎么判断一条片好不好看」。这 11 次提交分成两批,一批在 9 月 17 到 18 日,一批在 11 月 9 日,中间隔了快两个月,一次都没动。

第一批是审美与节奏规则。9 月 17 日一天落了 6 次提交,18 日又补 2 次。改动摊在主入口、八个规范文档和一个检测脚本上:

改了什么 落到了哪里 读者的实际感受
片尾默认署名「built by Anything2Explainer skill」 片尾配置里一行开关,设成空字符串就去掉 用它的模板出的片,收尾会自己带一行署名
章与章之间要有起承转合 章末解说留钩子、章首先回指上一章的成果再开题、章首画面承接上一章的主角 不再出现「讲完就切一张标题卡」的断裂感
章名与顶部小节名定位为导航标签 写进分镜规范:名词短语、中文不超过 6 字、各章结构平行 看一眼进度条就知道这段讲什么,而不是看一句俏皮话猜
配音默认语音不加速 语速参数从加 8% 改回原速,字数预算按每秒 5.5 字重算 听着不赶了,代价是同长度文案的成片变长
停顿只放在段末 段内句间留 10 帧、段末留 30 帧 小句之间不再一顿一顿,只有讲完一段、画面切换时才停
紫光扫光全片不超过 2 处,并加一份「扫光白名单」 分镜里多一列白名单,自检脚本按文件计数 那种三条紫光横扫的炫技镜头,从「每章都有」压到整片最多两次
落位停留规则 静止上限 3 秒、末拍停 1 到 1.5 秒再离场、镜头不等于句子、句间空白 20 帧 元素落地后不许立刻消失,也不许站着不动太久

这批改动里最值得说的是最后两条。它们不是「让画面更好看」的形容词,而是把「看起来赶」「看起来空」这两种主观感受,翻译成了秒数和帧数:一个元素入场之后不许完全静止超过 3 秒,一个镜头最后一个元素落位后必须停够 30 帧(1 秒)再离场。

换句话说,它把「审美」这件事切成了能被程序逐帧数出来的指标,有了这两个数,才能写脚本去量。

第二批在 11 月 9 日,一天落了 3 次提交,性质完全不同:不是审美,是让模板脚本能在别人的机器上跑起来。三件事:把五个 shell 脚本的入口统一成 bash(之前有写死 zsh 的,Linux 机器上第一步就中止);Python 读取文件时强制按 UTF-8 编码(避免 Windows 中文环境默认按 GBK 读取导致乱码);找不到 python 命令时回退到 python3(或反过来)。

同一天还补了一份口播写作规范的简体中文译本,76 行。

跟着这批改动一起进来的还有一个自测文件,166 行,8 个用例——这是全仓库唯一能真跑起来的测试,下面实证段细说。

实证:三个判据脚本、一份能跑的自测

旧文里我夸过它「把审美写成了可判定的数字」。当时那句话靠的是规范文档里的阈值。这次我把三个判据脚本逐个读完了,才发现阈值和脚本是两回事:阈值可以写在文档里糊弄人,脚本不能。

脚本 行数 它到底检查什么 判据写在哪
静态自检 106 每个镜头源码里写的起止帧和分镜表对账,报空洞与重叠;每个镜头的闪烁动效次数和白名单比;用了紫光扫光类效果的文件和白名单比,白名单超过 2 条直接判问题;从源码里抠出所有会上屏幕的字符串,比对事实清单 白名单列在分镜表里,脚本按正则抓
节奏体检 138 每 3 帧抽一张,裁掉顶部信息条和底部字幕带,量中间内容区的逐帧变化:最长静止多少秒、最后一个元素落位后停了多少帧 三个常量写死在文件头:静止阈值 0.35、静止上限 3.0 秒、停留下限 30 帧
构图与光 159 逐镜头量最大物体高度、主角区柔光面积、紫色碎片数量、空场持续帧数;主角区柔光面积低于 800 就报「主角无光」 主体小于 170 像素报「主角不够大」,小主体持续 45 帧报空场

这三份东西的分工很有意思:第一份不需要渲染,读源码和分镜表就能跑,几秒钟出结果,所以能在派活给 AI 之前拦住「帧没排满」「闪烁多了一处」这类硬错;第二份和第三份要渲染出来的帧,所以只能在渲完之后查,而且作者自己写明「成片复测才算判据,分组预览的读数偏松」。

第二个脚本里有个细节很能说明作者的较真程度:它量「变化」时不是看整帧像素动不动,而是先把顶部信息条和底部字幕带裁掉,只看中间内容区。判断「静止」的阈值是 0.35,判断「大面积变化」的阈值是 1.5,中间那段 0.4 到 1.2 的变化被明确归为「落位之后还在跑的动词动作」。

翻译成人话:元素停稳之后,画面上那条还在流动的数据线不算「动」,只有整块版面在变才算动。这样量出来的停留,才是观众眼里的停留。

至于那份自测,我在沙箱里跑了:

项 结果
跑法 用系统自带的 Python 3.13 直接执行,不装任何依赖
结果 Ran 8 tests / OK,用时 0.5 秒,8 个用例全过
它怎么绕开环境 用假命令顶替打包工具、渲染器和视频转码工具,不真装;另模拟 GBK 默认编码,测 UTF-8 回归
覆盖什么 五个入口脚本的入口格式与可执行位、python3 坏掉时回退、缺 rsync 时改用安全暂存、指定帧全部输出、不经 zsh 直接运行

这台机器上没装 Node,也没装视频转码工具,这份自测照样全绿——因为它压根不需要那些东西,它测的是「脚本在别人的机器上会不会因为路径带空格、编码不同、命令名不一样而崩」。一台没有 Node 的机器上,一个 Remotion 项目的测试全过,这件事本身就是 11 月 9 日那批改动的目的。

没跑成的部分一并说清楚:静态自检对着样片档案跑到一半报错退出,因为样片目录里没带时间轴文件;构图脚本因为沙箱里没有数值与图像处理库,直接退出;整条渲染流程要装 Node、Remotion 全家桶和转码工具,本机按规矩不装。

所以这篇不评价它成片的实际观感,只评它把判据写成脚本这件事。

顺手把仓库规模过了一遍。211 个文件、39MB 的仓库,两个月的增量全在规范和判据上,不在代码量上。

项 数字
仓库文件数(不含版本库目录) 211
组件文件 / 其他脚本文件 85 个 / 29 个,合计 8,041 行
Python 工具 7 个、1,143 行,最大的一个是配音工具 523 行
规范文档 11 份、913 行
主入口 / 中英两份说明 92 / 234 / 234 行
样片镜头源码 44 个镜头组件,加每组的预览与索引文件共 62 个,分 9 个构建组
样片质检报告 4 章各一份加 1 份终检,583 行
提交 / 发行版 / 版本标签 31 / 0 / 0

31 个提交里有 5 个来自四位外部贡献者,作者自己 26 个。13 个合并请求里还有 2 个挂着没合:一个让渲染并发(也就是同时开几个进程一起渲)按机器核数自适应,一个让构建脚本能在 Windows 的 Git Bash 里跑。所以「零版本号」不是没人管,是作者把版本号这件事整个略过了。

许可这块也得更新。旧文写的是「作者对商用咨询没有回复」,现在不成立了:仓库里累计有 4 个人问商用授权(教育自媒体、律所、带付费课程的频道),作者每条都回了,回法是「请发邮件说明使用场景、规模、是否再分发,我们私下谈范围与费用」。

所以现状是:有授权通道,但没有公开条款、没有公开价格。

许可证本身是 PolyForm 非商业许可 1.0.0 加一段自定义声明。原文两句是关键:用它产出的视频归创作者所有;本许可只约束工具本身,非商业使用免费,任何商业使用需事先获得作者授权。GitHub 的接口把这份许可读成「其他」(无法识别为标准许可证),所以它也不会被自动当成开源许可收录。

它和自动剪片工具不是一条路

要理解它的位置,得先看另一条路。

MoneyPrinterTurbo(11 月 2 日那篇,13.7 万星)和 OpenMontage(10 月 17 日那篇,6.89 万星)走的是同一条路:把现成的素材、配音、字幕拼成一条片。素材从哪来?图库里搜、模型生成、或者干脆用免版权片段。强项是快和全自动,弱项也在这里——画面是找来的不是画出来的,所以每一帧的构图你管不了,一个错误数字也没法在画面层面改。

anything2explainer 走的是另一条:每一帧都由代码画。代价和收益都很极端。

代价三条。第一,你要会写代码,或者至少让 AI agent(也就是能自己多步干活的 AI 程序)会写——它的每一帧都是一个组件文件,一条四分钟的片有 44 个镜头,光镜头源码就 62 个文件。

第二,agent 必须带着审美判据干活,否则它画出来的东西在技术上完全正确、在观感上一塌糊涂。这正是那三份脚本存在的理由:不给判据,你只能靠「我觉得不好看」这种话返工。

第三,硬件和时间要付:样片档(3 到 5 分钟)约 2 小时、每片磁盘约 2GB,并行构建镜头时建议留 5GB 以上。

收益也是三条。画面完全原创,不用为素材授权发愁;可复现,同一份解说词和分镜改一个字号重跑一遍,其余帧不会自己漂移;可 lint,这是最稀缺的一条——它的质量判据能当机器检查跑,不是文档里的形容词。

顺带把旧文那句「8 个 Agent 并行 40 分钟出一条片」对齐一下,免得读者误读成「40 分钟全自动」。40 分钟指的是 8 个构建组并行画镜头那一段。

整条流水线从建项目、调研、写解说词、定分镜,到打样、并行构建、渲染、质检修复,样片档合计约 2 小时。中间还有四个确认点会停下来等人回话:时长与语言、解说词定稿、配音方案、前 30 秒样片。最后那个尤其关键——风格、字号、语速在这种地方改一次,成本是一个组;等整片渲完再改,成本是全部组。

所以它从来不是无人值守的东西。这也和零版本号的性格一致:作者显然把它当成一套要人盯的手艺,而不是一个该自动升级的产品。

判断

如果你要的是「一句话出片」,这篇可以直接跳过,它给不了,也不打算给。

如果你要的是「把一篇稿子讲成四分钟、画面上每个数字都能追到出处」,而且手上有一个愿意读规范的 AI agent,那它是目前我见过路径最完整的一个:流程、规范、图例、判据、样片五样齐全,判据还能跑。

真正稀缺的不是模板——模板谁都能搭——而是它把「嫌赶」「嫌空」「嫌乱」这些话,说成了 3 秒、30 帧、2 处、170 像素。规则可判定,才谈得上验收;验收能自动化,才谈得上批量。

风险照实写:非商业许可,商用要单独谈,目前只有邮件通道、没有公开价格;四个确认点决定了它必须有人盯;模板没有提交锁文件,也没有 Python 依赖清单(5 个生产依赖倒是全部写死精确版本,所以 Node 那一侧风险不大,Python 那一侧要自己锁);跑通一条片要装 Node、Remotion 全家桶和视频转码工具,约 2 小时和 2GB 磁盘起步。

以及本次的局限:本机没跑成它自己的渲染流程,所以成片观感我不评价。

两个月涨 3.5 倍星、一个版本号都不发,说明有一批人认的正是这个:他们要的不是又一个自动剪片工具,而是一套能验收的做法。它值得放进观察清单,也值得当成一面镜子——如果你也在让 AI 干活,你的验收标准是写在文档里的形容词,还是能跑起来的脚本。

关注 AI商业快讯,每天一篇 AI 热点深度解读。

Headroom 深度评测:79,671 Star 的上下文压缩层,官方 41% 省 token 复现无误,代码却被压成日志残片

Headroom 深度评测:79,671 Star 的上下文压缩层,官方 41% 省 token 复现无误,代码却被压成日志残片

你有过这种体验:让 AI 助手处理一份两万行的日志,它读得很欢,账单也很欢。更难受的是,等你想追溯某一行到底出了什么错,它已经把那行连同上下文一起挤出了窗口。

Headroom 就是冲这件事来的。它把自己插在你的程序和模型之间,把日志、接口返回、代码、对话历史先压一遍再送上去,号称在四个真实场景里省下 21% 到 57% 的输入。这个项目拿了 79,671 颗星,作者还留了一份「可以自己复算」的脚本。

我把整个仓库拉进隔离环境,装了正式发布的版本,先跑他们的脚本,再写了一组自己的对照测试。官方那张表我一个字不差地复现了。但我自己的测试里出现了两个官方文档没提的情况:一份普通代码被它当成日志压掉了 97%,我动手挑的几个关键词,压完之后一个都不剩。

一、它到底在压什么:不是删字,是按类型换写法

先说清楚它在干什么,因为它做的不是「总结」,而是「换一种更省字的写法」。

举个例子。你要给模型看五百条一模一样的订单记录,每条都有客户名、状态、金额三个字段。原样发上去,同样的文字重复五百遍,模型看第一遍就懂了,剩下四百九十九遍纯属白付钱。Headroom 的做法是把这份清单改写成「表头加数据行」的样子,字段名只写一次,后面只留值。信息没丢,长度掉了大半。

这是它对结构化数据的处理。对日志,它把几百行同构的记录合并,中间留几行有代表性的,再给一个「原文存在这里,需要就取」的凭证。对散文和代码,它另有更重的办法,需要额外下载一个模型,也就是一个专门学过的压缩器。

它还做了一件事:把原文存在你本机,模型要是想看完整版本,可以凭凭证取回来。这个设计挺关键——它意味着压缩默认是有损的,但有后路。官方文档把这条后路叫可逆,意思是压完还能取回原文。

判断值不值得装,只需要看一件事:你每天喂给模型的那些内容,重复度高不高。重复度决定省多少,不重复的内容一分都省不下来。

二、官方那张表,我复现了,一字不差

它仓库里有个专门的脚本,用来重新生成官网首页那张省字表。这一点值得说明——作者自己写过一段注释,说首页的数字以前没人能复现,那对他们来说是负债,不是证据。

我在断网、没有密钥、不调用任何模型的情况下跑了一遍。四个场景,输入从 178,024 个计量单位压到 104,261 个,整体省 41%。四个场景分别是省 21%、57%、42%、30%,与官网完全一致。

场景 压缩前 压缩后 省下
代码搜索(100 条结果) 17,199 13,597 21%
线上故障排查 55,957 24,340 57%
代码库探索 58,801 33,895 42%
工单分诊 46,067 32,429 30%

这张表本身没有水分。省得最多的是故障排查那段,因为日志天然重复;省得最少的是搜索结果,因为它每条都不一样。这个排序很符合直觉,也说明数字不是挑着报的。

三、我自己测出的三个情况:一个比官方说的低,一个比官方说的狠

第一件:重复数据没有那么神。

官方简介里写,重复的接口返回和日志行能省九成以上。我照这个说法造了五百条字段完全相同、值也完全相同的记录,实测从 36,000 个字符压到 11,062 个,省 69%。换成五百行完全相同的日志,倒是真的省了 100%——因为它把这五百行合并成了一行加一个凭证。

差别在于「重复」的粒度。整行一模一样,它可以放心合并;字段一样但值在动,它只能改写格式,不能删信息。所以「九成以上」这个说法对日志成立,对接口返回就要打折。这不是造假,是宣传口径比实测宽了一档。

第二件:代码可能被当成日志处理,压完就没法读了。

这是我最意外的一处。我造了两段代码:一段是八十个结构相似的函数,一段是三百个带注释和校验的增删改查函数,后者二十五万个字符。第二段它省了 97%。

省得多本来是好事,但我把产物打印出来一看,问题来了:

我检查的东西 压缩后还在不在
某个具体函数的名字 不在
函数里那句保存数据的调用 不在
报错返回语句、校验函数名 还在
原文能否取回 能,凭凭证

我原本以为会看到「保留函数签名、合并函数体」这种聪明做法,实际看到的是按日志规则切出来的残片:一个函数的第一行、重复的返回语句、一句「省略了多少行,需要就凭凭证取回」。也就是说,在只关心「报了什么错」的场景里,这种产物够用;在「帮我改这个函数」的场景里,它把要改的东西删了。

根子在于它自己把这段内容判定成了日志,判定错了,而压缩过程不会告诉你它判错了。要定位这类误判,得跑它自带的分析开关,逐条看它给每个消息贴了什么标签——我这边看到的那条标签,写的是按日志规则压缩。

第三件:有损和无损是两档,别搞混。

它提供两种模式。默认那档为了省字什么都敢做,日志三百行能压到九行;另一种模式承诺可逆无损,同样的日志一行不删,省 0%。

这个设计其实合理——你要是让助手继续读这份日志找原因,就得给它完整的东西;你要是只让助手知道「有一大批正常记录加一条致命错误」,压掉就无所谓。问题是这两个模式在文档里没有放在一起对比,得自己翻配置说明才看得明白。

至于它宣称的「压缩开销可以忽略」,这点我认可。预热之后,压一份一万字左右的日志稳定在 1.2 毫秒,压一份一万字左右的接口返回是 1.4 毫秒。第一次调用慢了约一百多倍,那是程序冷启动,跑第二轮就正常了。

四、跟同类比,它站哪

省字这一类工具最近出了不少,大致三种路子。

一种是改说话方式,让模型少啰嗦、少用词,省的是模型吐出来的那部分。另一种是检索式,先把代码库做成索引,需要哪里取哪里,省的是「不用把整个仓库塞进去」这件事。Headroom 属于第三种:不动你的习惯,在中间把内容换一种写法,省的是每次请求的输入。

三种可以叠着用,不冲突。区别在于风险不一样:改说话方式顶多让回答变简短;检索式可能取错文件;换写法最怕的就是我上面撞到的那个——它把不该压的东西压了,而且不打招呼。

适合谁:每天要处理大量日志、接口返回、数据库查询结果的人,收益立竿见影。它支持主流编码助手的命令行包装,也支持当独立代理跑,还提供直接调用的库方式。

不适合谁:主要在写代码、让助手改函数的人。这类工作里,代码是最不该被简化成摘要的内容,而你恰恰会因为它把代码误判成日志而丢掉细节。

五、结论

Headroom 是个工程做得挺认真的项目:它愿意为自己的数字提供复现脚本,误判时有凭证可以找回原文,冷启动之后的开销确实可以忽略。79,671 颗星不算虚。

但它也有两条必须知道的边界。宣传里「重复数据省九成以上」只对整行重复的日志成立,字段重复的接口返回实际在七成左右。代码有被误判为日志的风险,压完可能连函数名都不剩——如果你要用它,第一件事是把项目里最要紧的那类内容挑出来,单独跑一遍压缩,看看产物还认不认得。

值得一试,但别整条链路默认打开。先在一类内容上试,确认它判对了类型,再放大。

关注 AI商业快讯,每天一篇 AI 热点深度解读。

相关阅读:caveman 深度评测:10.8 万 Star 的省 token 技能;context-mode 深度评测:3.1 万 Star 的上下文插件

美国 FAA 全国停飞 5 小时:SMART 空管铺开 3 天,1 万航班延误,官方最终归因于 1980 年代的通信设备

美国 FAA 全国停飞 5 小时:SMART 空管铺开 3 天,1 万航班延误,官方最终归因于 1980 年代的通信设备

11 月 13 日下午,美国联邦航空管理局把全国的空域关了。所有从美国机场起飞的航班停在地面,按联邦航空局的公告,空域从下午 3 点 54 分关闭到晚上 8 点 15 分,约四个半小时。按 FlightAware 当晚的统计,当天超过 1 万架次延误、4,000 多架次取消;英国广播公司次日给的数字更高,延误 8,500、取消近 8,000。

这件事只在一个前提下才变得刺眼:三天前,也就是 11 月 10 日,FAA 刚把它的 AI 空管系统 SMART 从华盛顿周边三个机场,一步铺到了全美 22 个航路管制中心。

于是 13 日晚上,全美国的记者都在问同一个问题:是不是 AI 干的。

发生了什么:五小时,22 个中心,一句「通信问题」

先按时间把事实摆清楚。

11 月 13 日午后,FAA 在芝加哥的管制设施先出现通信异常,随后问题扩散。下午 4 点前,FAA 下达全国停飞令,措辞是「特殊情况与安全原因」。交通部长肖恩·达菲最初的解释只有一句:通信问题影响了所有的航路管制中心。航路管制中心,也就是飞机在巡航阶段被指挥的地方,全美一共 22 个。

Flightradar24 当时记录到约 3,100 架飞机正在空中、目的地是美国机场;达菲在当晚发布会上说的是 3,500 多架。天上的飞机继续落地,地面上的全部按住。达特茅斯学院研究航空物流的教授 Vikrant Vaze 给 NBC 的估算是,那两三个小时里被卡住的航班大约 3,000 到 4,000 架次。

晚上 8 点 15 分,达菲宣布空域重新开放——英国的广播公司给的表述是「超过四小时」,多家美媒按小时取整写作约五小时。FAA 随后发的公告说,放行之前「彻底测试过系统,确认稳定」。达菲同时打了预防针:不会一下子全飞起来,取决于机组还够不够用,有些飞机可能要到周六早上才走。

上一次全美停飞是 2023 年 1 月 11 日,飞行员通告系统(NOTAM,向飞行员发布航行通告的系统)故障,停了大约 90 分钟;再往前是 2001 年 9 月 11 日。也就是说,这是 9·11 以来美国第二次全国性停飞,也是 2023 年以来第一次。

数字与一手细节:锅最终落在了 1980 年代的铜线上

真正有价值的部分在晚上那场发布会。官员们给出了一个和「AI 出事」完全不同的因果链。

达菲的说法是:FAA 的电信网络里,老旧的交换机和路由器被数据压垮了,开始吐出一致性错误的数据,管制员看到的东西对不上,于是系统被关掉。他原话里有一句很难忽略——「我们的新 IP 交换机没挂,挂的是老硬件」,以及 FAA 至今还在用「1980 年代的细铜线」。

国土安全部长马克韦恩·马林补了一层:压垮老系统的是 FAA 正在装的新设备和新补丁。系统一边打补丁、一边加新技术,老的吃不消。两人都没说清那批新设备具体是什么。

美国哥伦比亚广播公司从多个消息源拿到的版本更具体:出问题的是连接全美空管系统的私有通信网络,一次更新导致全网重启,进而崩溃。那套网络叫 FTI,2002 年 7 月由 Harris 公司(L3Harris 的前身)拿下合同,负责现代化、运营和管理,到今天已经 24 年。2023 年 11 月一份 FAA 委托的安全审查当时就把 FTI 定性为「过时」,依赖的是已经不被电信基础设施支持的 TDM 技术,并警告过一次意外故障可能让单个设施、甚至整个区域管制中心脱离网络。

改造工程已经在跑:今年 8 月 AT&T 接手主导,首笔合同 7,430 万美元,目标是 2028 年底完成。

对照一下 SMART 那一侧的数字。这套系统的全名是「空域、航路与轨迹战略管理」,2026 年 9 月 21 日在华盛顿特区周边的里根、杜勒斯、巴尔的摩三个机场开始有限运行;11 月 10 日扩到全部 22 个航路中心。合同是 12 年、8.75 亿美元,承包方是波士顿的 Air Space Intelligence。它接入约 200 条数据流,包括天气、航路、流量和管制员排班,由 FAA 在华盛顿的专家审阅建议,再经沃伦顿的管制系统指挥中心转给各设施,最后由地方决定采不采。

FAA 给 SMART 的成绩单是:在华盛顿区改道了 180 个航班,平均每班省 10 分钟、近 80 加仑燃油。

反转:先查 AI,再排除 AI,然后要钱

这篇文章真正的戏剧冲突不在技术,在 13 号那一天里官方口径的变化。

白天,马林在电视上被记者问到「是不是 SMART」时,回答是「我们正在看这个」,并说 DHS 旗下的网络安全局 CISA 也在参与。到晚上发布会,他的说法变成了:没有网络攻击的证据,和微软前一天的办公套件大故障也没有关系,「我知道很多人正在往那个方向跳」。微软同步发声明说没有任何迹象表明停飞与自家服务有关。

达菲的否认更硬:「SMART 根本不可能影响今天发生的事」,因为它没有接进管制员用来跟踪航班的核心系统。

承包商 Air Space Intelligence 在 X 上的声明是当天最快的:现在的停飞不是基于、也不是 SMART 系统的结果,与这家公司的任何产品、与 FAA 和空管的集成都无关。

另一条线更值得记住。10 月 9 日,超过两打美国议员联名致信达菲和 FAA 局长布莱恩·贝德福德,要求暂停 SMART 在华盛顿空域的运行,并回答三件事:上线前做过什么安全测试、恶劣天气或设备故障时系统怎么表现、出了事谁负责。11 月 10 日 FAA 宣布铺向全国时,这三个问题一个都没答。

再往上一层是钱。就在停飞发生的几个小时之前,白宫和交通部已经向国会申请额外 301 亿美元的航空基础设施经费,其中 101 亿给空管升级。当晚发布会上,达菲把数字抬到了 500 亿,说特朗普已把这件事定为国家紧急状态。他在发布会结尾留了一句话:「你们还会遇到更多这样的事,除非美国人民和国会让我们去建。」

把这几件事排在一起,逻辑就出来了:一场由 24 年前的铜线引发的事故,正好发生在一套新 AI 系统全国铺开的第三天,于是它同时成为了「AI 不可信」的现成证据和「必须拨款改造」的最强论据。而官方的最终结论——问题在底层的老设施——恰恰说明,AI 在这个案子里连肇事的机会都没有。

对读者意味着什么

如果你做的是 AI 落地:这是今年最好的一课,而且和模型能力无关。SMART 被质疑的原因,不是它答错了,而是没人能证明它在故障时不会答错——议员 10 月问的那三个问题,本质上是「你的系统在边界条件下是什么行为」。这类问题不能靠发布会回答,只能靠预先写好的失效模式和演练记录回答。所有把 AI 放进关键链路的团队,都会被问到同样的话。

如果你在做基础设施:真正的教训是「新东西压垮了旧东西」。马林说的那句话值得抄下来——一边打补丁一边加新设备,老系统承受不住。现实里绝大多数事故都不是某个组件坏了,而是新旧两代在同一个总线上互不适应。上新技术前先量一遍老链路的余量,比事后写复盘有用。

如果你是普通乘客:这次事故不含 AI 成分,但它告诉你在美国坐飞机要多留一层缓冲。达菲自己说排班要花时间解开,这类停飞的恢复期通常比停飞本身长。感恩节前的这波出行高峰,他承诺会恢复正常,但没给具体保证。

如果你关心 AI 监管的走向:注意这次舆情是怎么形成的。事实是通信故障,传播是「AI 停飞全美」,两者之间的时间差只有几个小时,而澄清只出现在深夜的发布会上、还带着一堆他同时要推的预算数字。等下一次真有 AI 相关的航空事故,公众不会重新从零开始判断——他们会记得这一次。

我该做什么

第一,如果你在往生产链路里塞 AI,今天就补一份「失效时怎么办」的一页纸:哪些步骤 AI 挂了可以降级、哪些必须人工接管、接管需要多久。这不是合规动作,这是让下一次事故里的你,不必靠发布会解释自己。

第二,如果你在评估「AI 上关键基础设施」的新闻,养成一个习惯:先看因果链有没有落到具体部件上。「通信故障」「老旧设备」「一次更新」都是可核查的;「AI 失控」在这次是一个从未被证实的假设,但它传播得最快。等官方口径出来再下判断,通常不会错过什么——这次从传闻到澄清只隔了五小时。

第三,如果你想理解 AI 真正进入公共系统的路径,别只看性能榜单。SMART 的 8.75 亿美元合同、12 年周期、200 条数据流、180 个改道航班、每班省 80 加仑油——这套数字才是它存在于现实里的方式。AI 在基础设施里不是一个模型,是一份长合同和一堆没人读的测试报告。

一句话判断:这一次不是 AI 把飞机按在地上,是 1980 年代的铜线;但 10 月那些没人回答的安全问题,会一直在那儿等着下一次。

关注 AI商业快讯,每天一篇 AI 热点深度解读。

相关阅读

信息来源

LobeHub 深度评测:8.5 万 Star 的 Agent 工作台,116 个内部包一个根锁文件都没提交,许可证写着 MIT 实际是社区许可

LobeHub 深度评测:8.5 万 Star 的 Agent 工作台,116 个内部包一个根锁文件都没提交,许可证写着 MIT 实际是社区许可

团队里想给自己搭一个 Agent 工作台的人,最近半年问得最多的一句话是:能不能装在自己服务器上,数据不外流,界面还像样?

LobeHub 是这个问题的热门答案之一。它现在是 85,397 星、16,292 个分叉,11 月 14 日当天还在提交代码,前身就是那个很多人用过的 LobeChat。我把整个仓库拉进沙箱,不装任何依赖,只做静态核对,数了 24,954 个文件,也数出了三个会直接影响你决策的事实:116 个内部包,仓库里一个根锁文件都没提交;package.json 里写的是 MIT,根目录的许可证文件却是另一套带商业附加条款的社区许可;最近 100 条发行版里,93 条是每次提交都会生成的预发布构建。

先说清一件事:它虽然带了 56 份写给 AI 看的技能说明,但它不是技能库,是一个近三万个文件的应用仓库。这一点后面还会绕回来,因为它恰好是这篇里最有意思的地方。

它到底长成了什么

一句话:一个可以自己托管的 Agent 工作台。网页端、桌面端(Electron 打包的本地应用)、命令行工具三个入口共用一套后端;后端是 Next.js 16 + React 19,界面用 React 单页应用的形式挂在 Next.js 里,数据层是 PostgreSQL 加 Redis,文件走对象存储。

先看规模。我拿到的这份快照是默认分支 canary(它们把开发分支叫这个名),目录分布非常不均匀:

目录 文件数 装什么
src 10,108 网页端界面与前端状态
packages 7,217 116 个内部包:数据库、Agent 运行时、工具集、多语言文案
apps 4,872 服务端、桌面端、命令行、分享页、工作台
locales 1,062 18 种语言的文案

src、packages、apps 三个目录加起来 230MB 上下,全仓 21,602 个 TypeScript 文件(.ts / .tsx),测试文件 6,669 个,占全部代码文件约三成。对一个要同时发网页版、桌面版、命令行版本的产品来说,这个测试比例是合理的工程习惯,不是刷数字。

它跟别的开源聊天前端最不一样的地方

不是界面,也不是模型接得多。是这个仓库里塞了一整套「给 AI 看的说明书」,而且是真在用的。

根目录有一份 199 行的开发规范文件,开头就写清了分工:仓库全局的架构和流程归这份文件管,具体实现规则全部下沉到技能目录,做到「单一事实来源」。然后它逐条点名——改 React 组件之前先读 react 这份技能;改页面路由之前先读 spa-routes;要理解代码分层先读 project-overview。

我去核了这套说法有没有真落地,结论是落地了:

我核的地方 结果
技能说明文件数量 56 份
这 56 份合计行数 8,689 行
给 AI 读的文档目录下 Markdown 总数 287 份
这个目录的体积 5.3MB
根规范里点名要读某份技能的地方 26 处
被标成「可手动调用」的技能 3 份,其余由 AI 按场景自动读

也就是说:规则不是写在规范文件里堆成一大坨,而是一份规则一个文件,规范文件只当目录和入口。举个具体的——改页面路由这件事,spa-routes 那份技能里明确写着公共的网页端和桌面端路径必须注册在同一个共享文件里,两个平台各自的配置文件只许写真正的差异,不许把同一条路由抄两遍。

还有一层更少见的:那个目录下面另有一整套「验收」流程,51 个文件,包含截图、录屏、探针脚本,还有一份把项目专属命令、端口、服务写全的说明文件。它要求改完行为之后,到真实产品上跑一遍,把证据(截图或录屏)发布出来,PR 里贴上验收链接。规范文件里还特别写了一句提醒:本地开发时有个能连到线上后端的调试代理,但那是开发便利,不是验证环境。

这是它和同类项目最本质的差别:它在用 Agent 维护一个 Agent 产品。 顺带一个小反差——自动选品工具看到仓库里有 56 份技能说明,会直接把它判成「技能库」,可这明明是个应用。

三个硬事实,都自己核过

第一,没有根锁文件。 锁文件记录每个依赖的确切版本,是「今天在你机器上装出来的东西,和三个月后别人装出来的东西一致」的唯一凭据。这个仓库的情况是:

核对项 实际结果
根目录的依赖锁文件 不存在
另外三种常见锁文件 全部不存在
忽略清单第 54 行 *.lock
忽略清单第 151 行 pnpm-lock.yaml
工作区配置第 1 行 lockfile: false
生产依赖 + 开发依赖 313 + 110 = 423 条
内部工作区包 116 个
唯一被提交的锁文件 桌面端自己的那一份(54 万字节),因为桌面端是独立工作区

配置里那一行写得很直白:根工作区不生成锁文件。它们改用了另一套办法——在工作区配置里固定了一批关键依赖的版本,还有一条「新版本发布后最短等待期」的策略,代价是每次安装都可能解出一组不完全相同的依赖树。对 423 个外部依赖加 116 个内部包的组合来说,这是「可复现性」上的一处空白,不是笔误。同一份配置里还留着一句注释,说某个补丁是为了「在没有根锁文件的情况下」保持生效。

第二,许可证三处口径不一致。 这条最需要你自己判断,我只列事实:

出处 写的是什么
打包配置里的许可证字段 MIT
npm 上同名包的许可证字段 MIT
根目录许可证文件 自称社区许可,基于 Apache 2.0,附两条额外条件
GitHub 接口返回的许可证 识别为「其他」,标准标识无法匹配

许可证文件里那两条附加条件,原文大意是:一,可以商业使用,包括直接把它当前后端服务跑起来、不改源码;二,如果你想基于它做一个衍生品再分发,必须先向出品方拿到商业授权,联系邮箱也写在了里面。另外它声明贡献者同意出品方可以自行收紧或放宽开源协议,且贡献的代码可被用于其云版本。

对普通读者意味着什么:自己部署来给自己团队用、改了自己用,条款没拦你;但把它改造成一个产品对外分发,需要先发邮件谈授权。三处口径里打包配置和 npm 那两处写 MIT,与根目录文件的实际条款不一致——这是打包元数据没有跟着许可证变化更新,不是隐藏条款。要不要在意,取决于你打算走到哪一步。

第三,版本号几乎失去了索引意义。 我拉了最近 100 条发行版记录分类:

类别 条数
每次 PR 触发的夜间构建 86
预发布版本(带 canary 后缀那种) 7
真正的语义化版本 7
被标记为「预发布」的比例 93%

这 100 条覆盖 10 月 7 日到 11 月 13 日,38 天,平均每天 2.6 个发行版。把这三个数字摆在一起对照着看,更能说明问题:仓库里的版本号是 2.3.3,GitHub 上最近的稳定标签是 v2.3.3、最新的标签是 v2.3.4-canary.1,而 npm 上这个包的最新版本停在 2.1.26,发布于 2026 年 2 月 10 日——九个月没动过。想靠版本号判断「我装的是哪个功能状态」,在这个项目上基本走不通。

自托管不是一条命令的事

它们的部署目录里备了三套容器编排文件(也就是描述「要起哪些容器、怎么连起来」的配置文件,分开发用、部署用、评测用),部署那套我逐个服务数了:

服务 作用 能不能省
应用本体 网页与接口 不能
网关 把 Agent 的运行过程推给浏览器,走长连接 不能,默认开启
PostgreSQL(带全文检索扩展) 主数据库 不能
Redis 缓存与会话 不能
RustFS 对象存储,存图片和文件 不能
RustFS 初始化任务 建桶、设跨域规则,一次性的 不能
SearXNG 联网搜索 可去掉,但联网搜索功能就没了
Elasticsearch 三件套 全文搜索的进阶方案 可选,默认不开,开了要单独 2GB 内存

必需的环境变量 19 个,其中四个密钥由安装脚本自动生成(配置加密密钥、登录签名密钥、网关令牌、内部签名密钥对);另有 13 个可选变量在示例文件里以注释形式给出。安装脚本 862 行。根目录的构建文件 375 行、4 个阶段,CI 流水线 31 条。

结论很直接:这不是一个 docker run 就能跑起来的聊天前端,是一套要起五个以上容器、配四个密钥、还要给对象存储单独配跨域的服务。示例文件里甚至专门写了一句——如果应用地址是内网 IP,AI 生图这类功能会失败,得额外补一个内部地址变量。

测试面:我跑成了什么,没跑成什么

本机沙箱里没有现成的 Node 环境,我把宿主机的 Node 二进制(v24.22.2)拷进沙箱,只跑那些不依赖第三方包的自测脚本:

脚本 结果
构建跳过逻辑自测 8 项全过
PR 准入检查自测 19 项全过
打包体积闸门自测 10 项全过
体积基线查找自测 1 项全过
体积评论生成自测 8 项全过
命令行发版脚本自测 跑不起来,缺第三方模块(未安装依赖)

这 46 项全过,说明它们的构建和发版自动化本身是带回归测试的。但这只是一个边角:项目主体那 6,669 个测试文件我一个都没跑——423 个依赖在 700MB 内存上限的沙箱里装不完,装了就是拖垮这台机器。所以本篇不评价它的测试质量,只记录我实际跑过的那部分。

放进坐标系里看

站内评过的对照物里,LibreChat 是最直接的对照组:同样是自托管 AI 前台,同样接多家模型,许可证是干净的 MIT,部署要 5 个服务、203 个环境变量。差别在定位——LibreChat 卖的是「把对话留在自己服务器」,LobeHub 卖的是「一群能自己干活的 Agent」,所以它多了网关、桌面端、命令行,也多了那套给 AI 读的规则库。

Agent 框架那一侧可以看 deepagents:它给你一套拆任务的框架,你自己写业务;LobeHub 反过来,把界面、存储、权限、工具全配好,你要的是接受它的做法。前者适合要嵌进自己系统的人,后者适合要一个能直接用的成品。

我的判断

值得放进观察清单,但别被 8.5 万星冲昏。它的工程质量在同类里偏上:测试覆盖到三成、自动化脚本自己带测试、规则写得克制(一份规则一个文件,规范文件只当目录)。真正的门槛在三个地方,而且都不在代码里:

一,运维成本。五个必需容器、四把密钥、对象存储跨域、内网地址这类坑,配下来是半天到一天,不是五分钟。

二,许可证边界。自用、自托管、自己改,条款没拦;做成衍生品对外分发要先拿商业授权,而打包元数据里写的还是 MIT,容易让人误判。

三,发版噪音。93% 的发行版是自动构建,npm 上的包九个月没更新,别把「发行版页面很热闹」当成「功能在按版本迭代」。

没跑成它自己的完整测试,所以我不评价它的测试质量。 这一条比前面三个数字都重要:你可以相信我说过的每一个数字,但别把「46 项全过」外推成「这项目很稳」。

关注 AI商业快讯,每天一篇 AI 热点深度解读。想对照自托管这一侧的取舍,可以翻我们评过的 LibreChat;想看 Agent 框架那一端怎么拆任务,可以翻 deepagents。

pydantic-ai 深度评测:21,195 Star 的 Python AI 框架,精简安装 20 个模型只通 2 个,654 项测试全绿主干却挂 7 项

pydantic-ai 深度评测:21,195 Star 的 Python AI 框架,精简安装 20 个模型只通 2 个,654 项测试全绿主干却挂 7 项

如果你想用 Python 接一个大模型做产品,大概率踩过同一串坑:先装个框架,它默认把各家的官方客户端全带上;装完发现磁盘多吃了一百多兆;等真要换模型时,又得回头补装另一个厂商的包。

今天评测的 pydantic-ai 就是冲着这串坑来的。它在 GitHub 上有 21,195 颗星,用的是麻省理工学院的宽松开源许可,背后是做了多年数据校验库 Pydantic 的那个团队。它的宣传语很直接:所有模型,一行字符串就能换。

我把它的发布版装进隔离环境,按官方口径跑了测试,也量了三档安装方式的体积。结论有两句:它的分层打包确实解决了一部分痛点,但「换个模型只要换一行字符串」这件事,在默认安装下并不成立。

一、它是什么:给 AI 应用套了一层「类型检查」

先说人话:这是一个帮你写 AI 应用的 Python 库。你定义好要模型输出的数据结构,它负责调用模型、检查输出格式、格式不对就让模型重答,直到符合你定义的结构为止。

这个「不符合就重来」的机制是它最值钱的地方。传统写法里,模型返回的是一段自由文本,你还得自己写代码去解析、去猜格式;pydantic-ai 把这层苦活接过去了。官方文档里的说法是「端到端都有类型」,翻译成日常话:你提前声明好收据上有金额、有供应商、有日期,它保证交给你的对象里这几项一定在、类型一定对。

它的第二个卖点是双包策略。仓库里同时发了两个包:全量的那个把主流厂商的官方客户端都捆进来,精简的那个只留内核,谁家要用谁自己装。

我实测了三档安装的代价,Python 3.13 干净环境,同一天同一台机器:

装法 占用空间 装了多少个包
全量包 pydantic-ai 146 MB 95
精简包 pydantic-ai-slim(基础) 34 MB 17
精简包 + 四个厂商接入(OpenAI、Anthropic 这类) 95 MB 40

这个数字说明什么:精简包确实省下了四分之三的空间,但只要你真的想接两三家模型,空间就会迅速回到一百兆附近——省下来的主要是你压根不会用的那几家。全量包里最占地方的就是几家厂商的官方客户端,一家十六兆,另一家十七兆,加起来接近五十兆。

顺带量了启动开销。光是导入一次这个库,全量包要 1.54 秒,精简包 0.34 秒。对一个要频繁启动的命令行工具来说,这个差别是能被用户感觉到的。

二、实测第一问:精简安装下,到底几个模型能用

这是我最想验的一条,因为它直接决定「换模型只需换一行字符串」成不成立。

仓库的模型目录下我数出 20 个厂商接入模块。我在精简包的基础安装(不装任何厂商附加包)下逐个尝试导入,结果是:

结果 数量 说明
能直接用 2 一个是测试用的假模型,一个是函数式模型
报缺包错 18 全部是「请先安装某某包」的提示

也就是说,默认装完精简包,市面上你叫得出名字的模型一家都接不上。想用 OpenAI 的要补一个包,想用 Anthropic 的再补一个,谷歌家又是另一个。

这里要给官方说句公道话:报错信息做得很好,每一句都直接告诉你该装哪个附加包、命令长什么样。所以这不是「坑你无门」的缺包,而是「按需付费」的设计。只是宣传语和实际体验之间差了一层:那句话的完整版应该是「换一行字符串,前提是你已经装好了对应厂商的包」。

另一种常见写法是直接传给应用对象一个带冒号的模型名。我在基础安装下试了,报错同样指向缺包或缺凭证,没有被静默忽略——这一点是加分项,它不会让你在半夜收到一张巨额账单才发现接错了模型。

三、实测第二问:官方测试在发布版上全绿,主干上却有 7 个失败

这个库的测试规模是我见过最重的之一。仓库里有 942 个测试文件、18,625 个测试函数,测试目录占了 291 兆,其中还带着 270 份录制的真实接口请求(上游发来的原始应答被存成文本,回放时不用真连网,也就不会真的花钱)。文档有 375 篇。

我在隔离沙箱里把依赖版本调成和仓库锁文件一致(也就是作者们自己测试时用的那一套),然后分两次跑:

跑在哪 用例数 结果
发布版 2.68.0 标签 665 654 通过、11 跳过、0 失败
主干最新提交(两小时前) 496 479 通过、10 跳过、7 失败

失败的那 7 个全挤在同一处:文本输出模式下的参数校验。测试原本期待应用在创建时就把不合规的函数拒掉,实际却没拒绝;另有一个是参数别名传进函数时名字对不上。

这条要小心解读,我做了三个交叉验证才写下来:一是我把依赖版本调成和仓库锁文件里那份一模一样,失败照旧;二是同一个环境、同一批依赖,回到发布标签上全绿;三是这 7 个失败点都在「检查某个错误有没有被抛出」上,跟我本机缺什么东西无关。所以这是主干上正在发生的事,不是发布版的问题,也不是我环境的问题。

对你来说意味着什么:如果你照着主线代码写东西,最近这两天最好钉死版本号,别跟着主干漂。

四、实测第三问:没有凭证能不能玩

很多人想先试试手感再决定要不要充钱。这个库留了一个口子:一个测试用的假模型,不需要任何接口凭证。

我写了个提取发票信息的例子,定义了供应商、金额、币种、日期四个字段,用假模型跑了一遍。流程全部跑通,导入 0.54 秒、构建应用 0.75 秒、跑一次 0.03 秒。

但它的输出是这样的:供应商是一串字母 a,金额是 0,日期也是字母 a。连跑三次结果完全一致。

这个设计的用意是让你验证「接线通不通」——数据流、类型校验、工具调用这些机制都能跑起来。它不产生任何真实内容,所以别指望用它看效果。想看出模型水平,你还是得有至少一家的接口凭证。

五、版本这件事,值得单独说

这个项目在 2025 年 9 月到 1.0 时承诺过:在 2.0 之前不做破坏性改动。现在 2.0 出来了,官方专门写了一篇升级指南,把攒了一年的破坏性变更一次性列全。

我取了最近 300 个版本记录来看,1.x 那条线有 148 个,2.x 那条线有 85 个,两条线到今天还在同时发版——1.x 最近一次发布是 11 月 4 日,2.x 是 11 月 12 日。这在开源库里不常见,通常是给还在旧版上的使用者留一段过渡期。

官方对弃用的处理是「留一个版本再删」:2.x 里标为弃用的功能会一直能用,但每次调用都会发一条警告点名它的替代写法,到 3.0 才真正移除。我用同一段代码分别跑了 1.x 和 2.x 的最新版,两个版本都能跑通,同一处旧写法在里面都给出了升级提示。

对读者的意义:这是个沉淀得比较正规的项目,不是那种一个月换三次接口的野路子。代价是文档量大、概念多,第一次上手需要留出半天到一天。

六、和同类比,它站在哪

Python 这一侧的 AI 应用框架,大致有三个流派。

一派是「全家桶」:装一个包,所有模型、所有工具、所有界面都能用,代价是体积和耦合。

一派是「薄封装」:只做最薄的调用层,灵活但什么都要自己搭,包括输出格式校验、重试、多步工具调用。

pydantic-ai 走的是第三条:内核薄、能力按需加、类型检查是硬约束。它的取舍很清楚——愿意为「结构化输出的可靠性」付出一套概念的学习成本,换取业务代码里少写一大堆解析和重试。

适合谁:要把大模型嵌进已有业务流程(比如从合同里提字段、从工单里判优先级)、对输出格式稳定性有硬要求、团队本来就熟悉数据校验这套思路的。

不适合谁:只想调一次接口做个小脚本的;模型只要固定用一家、也不想多装一个框架的;以及完全不想碰「类型声明」这件事的新手,它的语法门槛确实比直接调官方客户端高一档。

七、判断

值得放进观察清单,也值得在你真的要做一个结构化的 AI 业务功能时认真试一次。

它最扎实的地方不是宣传的那句口号,而是三件能验的事:输出格式的强制校验确实内建、缺东西时报错指向明确、测试与文档的体量撑得起一个长期项目。最需要打折的也是宣传的那句口号:默认安装下你一家模型都接不上,「换一行字符串」省掉的是改代码,不是装依赖。

给一个具体建议:如果你要试,别装全量包,先装精简包加你真正要用的那一家,体积能压在一半以下,改起来也清楚。想零成本看代码风格,用它的假模型跑一遍流程就够了,记得别拿那个结果去评估模型。

关注 AI商业快讯,每天一篇 AI 热点深度解读。

Gemini 4 Hydrogen 全面开放:每百万 token 1.5 美元,谷歌却说旗舰别全程用它

Gemini 4 Hydrogen 全面开放:每百万 token 1.5 美元,谷歌却说旗舰别全程用它

每百万输入 token 1.50 美元,输出 7.50 美元——这是谷歌 11 月 12 日给 Gemini 4 Hydrogen 定的价。比它两天前才开放的旗舰 Gemini 4 Carbon 便宜四分之一,比 Carbon 促销期结束后的 4 美元、20 美元,只剩三分之一多一点。

更反常识的是另一件事:在 Artificial Analysis 的智能指数上,这个「日常干活用」的便宜模型拿了 51 分,超过了谷歌自家更贵的 Argon——后者 50 分。

同一天谷歌做了三件事:发布 Hydrogen、把它设成搜索 AI Mode 的默认模型、并且在官方博客里承认,用一个前沿模型从任务开头跑到结尾,是浪费。

发生了什么:一次覆盖所有入口的同一款模型

11 月 12 日,谷歌同时上线 Gemini 4 Hydrogen,落地位置基本覆盖了它所有的 AI 入口:Google 搜索、Gemini 应用、Google AI Studio 的所有档位、Gemini API、Gemini for business 企业版,以及付费的 AI Pro 和 Ultra 订阅用户在 Google Antigravity 里的使用权限。

谷歌 DeepMind 负责人 Koray Kavukcuoglu 在官方博客里的定位很克制:Carbon 和 Argon 负责「深、长、难」的推理,Hydrogen 负责「快速执行」,是「日常工作的模型」。这里的 agentic workflow,指的是让模型自己连续调用工具、一步步把一件事跑完,而不是你问一句它答一句。

搜索那头的说法就没这么克制。搜索产品副总裁 Robby Stein 直接写:这是「搜索迄今最大的一次模型升级」。Hydrogen 现在是 AI Mode 的默认模型,同时负责 AI Overviews 里「最难的那些问题」。

这意味着换模型这件事,不发生在开发者敲代码的时候,而发生在你明天打开搜索框的时候。

数字与一手细节:便宜四分之一,分数翻三倍

先把价目表摆清楚。Hydrogen 定价为每百万输入 token 1.50 美元、每百万输出 token 7.50 美元,并且在整整 100 万 token 的上下文窗口里全程同价。上下文窗口,也就是模型一次能读进去的文本总量:很多厂商的定价会随着窗口变大而加价,Hydrogen 没有。作为对照,Carbon 在 11 月 10 日全面开放时的促销价是每百万输入 2 美元、输出 10 美元,11 月 30 日之后回到 4 美元和 20 美元。

性能上,谷歌给的数字如下:

  • Artificial Analysis 智能指数:默认 high 档 51 分,最高 xhigh 档 54 分,两个都高于 Argon 的 50 分。
  • Terminal-Bench 4.1(考终端里连续执行任务的真实能力):57%,上一代 Gemini 3.8 Flash 是 18.2%,翻了三倍还多。
  • high 默认档下完成任务快 2.5 倍;编造性说法降到原来的五分之一以下(官方说法是「减少超过 5 倍」)。
  • HLE-Diamond 58.8%,Vals 税务 Agent 榜第一 52.3%,法律检索榜并列第一 55.8%,多模态知识工作榜 53.4%,Agents’ Last Exam 71.6%。
  • 合作方早期测试:在复杂图结构、SQL、数据密集的企业工作流上,比 3.8 Flash 快 2 到 2.8 倍,同时省下 12% 到 23% 的 token。

安全侧也给了具体数:agent 任务里的越权行为最多减少 81%,「该做没做」最多减少 79%,工具调用和编程评测里的错位动作与抄近路行为减少 12 倍;遇到不可能完成的任务,绕过权限边界的概率最多降一半;20 万次以上的审计回合里,思维链 99.9% 保持可读,官方称零欺骗性推理改写。

这些数字全部来自谷歌自己,没有第三方复现。这一点要记住。但即便打个折,「同等任务快两三倍、便宜四分之一」,也足够改变一家公司的选型。

反转:谷歌拆了自己两天前刚卖的东西

真正的戏剧性不在 Hydrogen 本身,而在它和 Carbon 的关系。

11 月 10 日,谷歌才把 Carbon 全面开放,通稿的核心词是「最强模型」,定价 2 美元、10 美元,还特意标了 11 月 30 日后翻倍。两天之后,谷歌在 Antigravity 里推出一个叫 Orchestrator 的功能,描述是这样的:不要让一个模型从任务开头干到结尾。

具体做法是让 Carbon 先进入只读阶段,探依赖、消歧义、出一份带重规划触发条件的计划;然后切给 Hydrogen 去写代码、改依赖、跑测试;Hydrogen 一旦卡住,再交回 Carbon 去看现场、修计划、继续执行。谷歌给的实测是:在 Terminal-Bench 4.1 上,任务成功率接近纯用 Carbon,但平均少用 24% 的配额,快 19%。

它同时承认了行业里那种「静态路由」的老办法为什么失效:传统路由器靠你第一句话猜任务难度,然后把整条任务都交给最便宜的那个够用的模型。可 agent 任务越跑越长,不同阶段需要的复杂度完全不同,而且往往是在执行中才被发现。

翻译成人话:谷歌一边卖你 4 美元、20 美元的旗舰,一边在官方博客里论证「大部分步骤不该用它」。这不是自相矛盾,这是把定价逻辑讲透了——贵的那部分只该用在判断上,不该用在打字上。

另一层反差在榜单。Hydrogen 超过了自家的 Argon,但没超过自家的 Carbon:同一个智能指数上,Carbon 是 60 分级别(这是我们 11 月 11 日那篇报道里记录的数字),Hydrogen 是 51。也就是说,谷歌这次做的是「把中端做到足够好」,不是「把旗舰拉下马」。

放到整个行业看,这也不是谷歌一家的动作。过去半年「快而省」这条线一直在往下压价,前沿那一档越来越贵、越来越慢。Hydrogen 的 1.5 美元入场,等于把这个分层正式写进了产品结构。

对读者意味着什么

如果你写代码:账单结构会变。以前是「选一个模型,全都用它」,现在更划算的是「贵的做计划、便宜的做执行」。这不等于要你手动切来切去——Orchestrator 这类东西会替你做,但你要理解它在替你做什么,不然出了错不知道该怪哪一层。

如果你做内容或 SEO:这是全文最容易被忽略的一段。搜索的 AI Mode 换了默认模型,谷歌的说法是答案会更视觉化——更多图片、对比表格、按需生成的交互小工具,链接覆盖范围也更广(靠查询扇出,也就是把一个复杂问题拆成多个子问题同时搜)。对做站点的人,这既是机会(长尾问题更容易带出链接)也是风险(答案更完整,用户更不需要点进去)。值得这周去搜几个自己的核心关键词,看 AI Overviews 引用的是谁。

如果你在公司里管采购:企业版同步可用。要盯的两个条款是配额和可用性。Hydrogen 有四个思考档(低、中、高为默认,以及新增的「极高」),低档更便宜更快,但同时意味着同样的钱买到的推理深度是可变的,「我们买了多少智力」这句话在合同里开始说不清。

如果你是普通用户:不用做任何事,明天打开搜索就是新版。唯一的变化是,复杂问题会得到更完整的答案,而你点开网站的几率会更低一点。

我该做什么

第一,如果你是开发者,这周就把 API 调一次,用自己的真实任务跑 A/B:同一批任务分别用 Hydrogen 单跑、Carbon 单跑、以及两者编排(编排,也就是让一个模型做计划、另一个模型照着执行,在同一个会话里接力)。别只看榜单——榜单是通用题,你的任务是专门的。重点是记录三件事:成功率、耗时、token 花费,缺一个都判断不了值不值。

第二,如果你还在用 3.8 Flash,迁移理由很实在:速度两三倍、编造率降到五分之一以下、价格在同一量级。但先测你的边界场景,特别是工具调用失败、搜索返回空的时候——谷歌这次专门强调这两种情况下的表现,说明它是被当成问题在解决的,通常也说明之前确实不好。

第三,如果你关心成本结构,记住一个判断:单模型跑全程的时代正在结束。真正要建的能力不是「选对模型」,而是「知道哪一步该问贵的」。

一句话判断:Hydrogen 不是谷歌最强的模型,但它是谷歌第一次公开承认——旗舰模型不该被用来干所有的活。这条承认,比 51 分这个数字值钱。

关注 AI商业快讯,每天一篇 AI 热点深度解读。

相关阅读

信息来源