
xeet 用 Rust 和 WASM 重实现 X 帖子渲染,无需浏览器即可输出 PNG
来源标题:Xeet: WASM+Rust Renderer of X Posts
xeet 不依赖浏览器就能把 X 帖子渲染成与 x.com 一致的 Retina PNG,支持直接传入帖子或 x.com 链接。它用 Rust 重写了 X 客户端规则、Blink/HarfBuzz 文本排版、flexbox 几何和 Skia 抗锯齿,全部代码均为安全 Rust。项目以单个原生二进制和 WebAssembly 核心发布,加载六个字体包后文本帖子渲染耗时 2.8 ms(p50),原生与 WASM 构建输出字节一致。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
xeet 不依赖浏览器,就能按照 X 自己的方式精确绘制 X 帖子。把一条帖子或者一个 x.com 链接交给它,它就会返回一张 Retina PNG,和 Chrome 在 x.com 上显示的效果一致:相同的换行、相同的 emoji、相同的回退字体,"Show more" 也出现在相同的位置。
多数预览工具会启动无头 Chromium 然后截图。xeet 则重新实现了帖子真正依赖的那部分:X 的客户端规则、Blink 和 HarfBuzz 的文本布局、文本周围的 flexbox 几何计算,以及 Skia 风格的抗锯齿。全部代码都是安全 Rust(#![forbid(unsafe_code)])。
它以单个原生二进制加一个 WebAssembly 核心的形式发布,另外还有六个字体包,由宿主在首次使用时注册。这些加载完成后,一条纯文本帖子渲染耗时 2.8 ms(p50,390 px、3×),带四个媒体占位符时为 4.5 ms。渲染不需要网络、不需要文件系统、不需要时钟、也不需要系统字体,原生构建和 WASM 构建产出的字节完全一致。CI 每次运行都会把 Linux x64、Linux arm64、macOS 和 WASM 相互比对。
下面每张图都是 xeet 自己的输出,分别以浅色和深色主题渲染,所以 GitHub 上看到的会与你的外观设置一致。
Emoji 即布局。@NASAGoddard 2017 年的太空场景:连续保留的空格、Apple Color Emoji 和一个 hashtag,全部手动定位。
数学数字、Show more 与嵌套引用。Unicode 数学粗体数字回退到 STIX Two Math,在深度为 2 的引用上方用块级 Show more 截断。
浏览全部 17 个边界场景渲染(Web 与 iOS、轮播图、投票、视频封面、CJK/RTL)请见 docs/GALLERY.md →,或者在 playground 里交互式地试任意帖子。
与 Chrome 一致,并且能证明这一点。文本、布局、卡片和像素全部对照真实的无头 Chrome 检查:文本 oracle 上零换行不匹配、零高度不匹配,每个主题 147/147 帧行、192/192 卡片行,159/159 条抓取帖子端到端通过。参见测试的工作方式。
遵循 X 自己的规则。SPEC.md 记录了每一条规则及其证据(JS chunk、函数、抓取的 payload),对应 x-web@55591fe0,也就是 X 目前提供的版本。crates/xeet-core/rules/x-web.json 是渲染器运行的机器可读副本。
解析链接而不占有网络。xeet-resolve 把推文文本或 x.com URL 变成完整的 Post,但每一个 I/O 字节都由调用方提供(Fetch、Lookup、Cache、Clock)。核心保持为纯函数,网络策略始终归你。
在你需要图像的任何地方运行。一个核心,三个目标:面向浏览器和 Node 的 WebAssembly 模块(packages/xeet)、原生 Rust 库(crates/xeet-core、crates/xeet-resolve),以及 xeet CLI(crates/xeet-cli,由 tools/ship/package-cli.mjs 打包为 npm i -g @xeet/cli)。
逐字节确定性。xeet-core 不做任何 I/O,没有任何核心 crate 使用 unsafe,原生与 WASM 输出在 24/24 个用例上 SHA-256 哈希完全相同。
处理长尾情况。Bidi、CJK、颜文字、多码点 emoji、嵌套引用、卡片、投票、视频、web/iOS 差异,以及安全的链接解析。完整列表见 What it handles。
运行方式 $ vercel dev vercel dev 会运行 tools/ship/vercel-build.mjs,并在本地提供 WebAssembly playground。要从源码构建并测试: $ npm run build # runs the CI test gates, builds wasm, writes dist/ $ npm test # contract, unsafe, golden stamps, and wasm package tests $ cargo test --workspace # rules, text, layout, paint, resolver, iconic posts $ cargo build --release --bin xeet $ xeet render post.json --width 390 --theme dark --dpr 3 -o post.png Chrome 一致性 oracle 需要它自己的一个开发依赖:pnpm --dir tools install。
JavaScript 与 WebAssembly npm i @xeet/core import { loadXeet } from "@xeet/core/node"; const xeet = await loadXeet(); // Promise<Xeet> (singleton per process) const report = xeet.explain(post, { width: 390, theme: "dark", dpr: 3 }); // → Report: { ruleset, verifiedFor, size: { width, height }, length, text, entities, hidden, attachment, warnings } const { png, report: same } = xeet.render(post, { width: 390, theme: "dark", dpr: 3 }); // → { png: Uint8Array, report: Report } (PNG dimensions: ceil(report.size.width * dpr) × ceil(report.size.height * dpr)) if (xeet.hasShowMore(post, { surface: "web-timeline", width: 390 })) { const expanded = xeet.render(post, { surface: "web-timeline", width: 390, expanded: true }); const sheet = xeet.sheet({ post, widths: [382, 390, 600], themes: ["light", "dark"], dpr: 2 }); // → Uint8Array (single labeled PNG grid) 在浏览器中,初始化 WebAssembly 模块并绑定同一套 Xeet 接口: import init, * as wasm from "/wasm/xeet_wasm.js"; import { bind } from "@xeet/core"; await init(); const xeet = bind(wasm); // Xeet const { png, report } = xeet.render(post, { width: 390, theme: "light", dpr: 2 }); 方法与返回值(Xeet · abi.js) 调用 返回类型 说明与源码定义 loadXeet(options?) Promise<Xeet> Node/Bun/Deno 异步加载器({ lazy?: boolean })— node.d.ts · node.js loadXeetSync(options?) Xeet 同步 Node 单例加载器 — node.d.ts · node.js bind(wasm) Xeet 对已初始化的 wasm-bindgen 导出做浏览器/worker 包装 — types.d.ts · abi.js xeet.render(post, options?) RenderResult({ png: Uint8Array, report: Report }) 编码后的 PNG 字节 + 布局 Report — abi.js · render.rs xeet.renderPng(post, options?) Uint8Array 仅编码后的 PNG 字节 — types.d.ts · abi.js xeet.renderRgba(post, options?) RgbaResult({ width, height, rgba: Uint8Array, report: Report }) 设备像素尺寸 + 直通 alpha 的 RGBA8(width × height × 4 字节)+ Report — abi.js · render.rs xeet.renderMany(post, optionsList) BatchItem[]({ png: Uint8Array, report: Report, paint: number }[]) 跨多个 RenderOptions 只解码一次帖子媒体;paint 为渲染毫秒数 — abi.js · render.rs xeet.explain(post, options?) Report 布局盒、字符数、entities 和规则决策,零光栅化 — abi.js · render.rs xeet.hasShowMore(post, options?) boolean 当帖子在 options 下渲染为折叠的 "Show more" 时为 true — abi.js · render.rs xeet.sheet({ post, widths?, themes?, dpr? })
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。