搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

rauchg/xeet

开发工具

无需浏览器即可把 X 帖子渲染成像素级精确的 PNG,适用于分享图、预览和自动化测试。

105
9
JavaScript
Apache-2.0
创建于 2 天前

项目介绍

xeet 把 X(Twitter)帖子渲染成 PNG,效果对齐 Chrome 打开 x.com 时看到的画面:换行位置、表情、回退字体、「Show more」的位置、卡片、引用、投票和视频封面都尽量一致。它不走「起一个无头 Chromium 截图」的路线,而是用安全 Rust 重新实现了 X 客户端规则、Blink/HarfBuzz 文本排版、外框 flexbox 几何和接近 Skia 的抗锯齿。核心无 I/O、不依赖系统字体,输出确定,渲染不需要网络、文件系统或时钟。

同一套核心提供三种用法:浏览器和 Node 用的 WebAssembly 模块(packages/xeet)、原生 Rust 库(xeet-core,配套 xeet-resolve 做数据补全),以及 CLI(xeet-cli)。适合生成帖子分享图、预览图,或在不方便跑浏览器的服务、测试和机器人里使用。

快速使用

可以先在本地跑 WebAssembly 演示站:执行 vercel dev,会构建并启动本地 playground(构建脚本);线上体验入口是 xeet-rs.vercel.app。

从源码构建和测试的完整流程:

npm run build
npm test
cargo test --workspace
cargo build --release --bin xeet
xeet render post.json --width 390 --theme dark --dpr 3 -o post.png

Chrome 对齐测试需要额外安装依赖:pnpm --dir tools install。帖子 JSON 最少只需 text 字段,作者、媒体、卡片、引用、投票、计数和时间戳都是可选项(Post 模型)。CLI 还提供 explain(查看布局报告)、sheet(生成对比图)和 resolve(把 x.com 链接补全成帖子再渲染):

npm i -g @xeet/cli
xeet resolve https://x.com/NASA/status/2119833829389041896 --media | xeet render - -o nasa.png

在 JavaScript 项目里安装 @xeet/core,Node 端用单例加载:

import { loadXeet } from "@xeet/core/node";
const xeet = await loadXeet();
const { png, report } = xeet.render(post, { width: 390, theme: "dark", dpr: 3 });

浏览器端先初始化 wasm 模块,再用 bind 绑定同一套 Xeet 接口。Rust 端直接调用 xeet_core::render::render(&post, &opts),返回 PNG 字节和布局报告(渲染 API)。

使用约束

  • 字体。 内置六套字体包,但再分发有限制:X 的 Chirp 和 assets/vendor/fonts/ 里的参考字体只用于 CI 和对齐验证,不归 Apache-2.0 授权。公开分发二进制时只能附带你有权分发的字体,或依赖宿主机器提供字体(许可证说明)。没有内置字体的文字会显示为 .notdef 豆腐块,可用 XEET_FONT_DIR 在运行时补充字体。
  • 网络在核心之外。 xeet-core 是纯函数,不做任何 I/O。要用 xeet-resolve 解析链接,调用方必须提供 fetch、可选 DNS 查询和缓存;重定向由库手动跟随(最多 10 跳),并内置 SSRF 防护。不提供这些回调,就无法把 x.com 链接补全成帖子(resolver)。
  • 依赖上游规则。 X 的规则固定在客户端版本 x-web@55591fe0,X 之后改动页面或规则时,需要更新 SPEC.md 和 rules/x-web.json。
  • 适用范围。 渲染器覆盖已验证的四个场景(Web/iOS 的时间线和详情页),输出图片依赖调用方提供媒体字节;输入会按 limits.rs 校验,失败时抛出 XeetError。渲染是纯 CPU 计算,WASM 目标面向浏览器和 Node,原生 CLI 可独立使用。

HotRepo 点评

xeet 是一个新项目,早期热度不高但有一定真实关注:2026-11-17 它出现在 HotRepo 的 JavaScript 新项目记录中,累计 105 星、9 个 fork,记录窗口约一小时内净增 3 星。这些数字不足以判断采用程度,但仓库内容本身比较扎实:有记录 X 规则的规范、对 Chrome 的一致性测试(13,440 个布局 0 换行和 0 高度差异)、2,119 个 twitter-text 用例,以及 24 个用例上原生与 WASM 输出 SHA-256 完全一致。最值得注意的设计是把渲染保持为纯函数,把网络策略完全交给调用方,便于嵌入服务器和 CI,而不需要浏览器。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

Hacker News 讨论

Xeet: WASM+Rust Renderer of X Posts
▲ 1 · 0 条评论 · 2026年11月16日

相关推荐

  1. bytecodealliance/wasmtime在浏览器之外运行 WebAssembly 模块和组件,可用 CLI,也可嵌入宿主语言。Rust18,761
  2. denoland/deno面向 JavaScript、TypeScript 与 WebAssembly 的安全运行时,常用于编写和运行服务器等应用。Rust108,769
  3. pithings/unkernel把真实 Linux 内核编译成 WebAssembly,在浏览器或 Node 中快速启动 Alpine Shell。TypeScript111
  4. tokio-rs/topcoat一个为已经使用 Rust 的团队准备的全栈 Web 框架,把模板、交互和静态资源放进同一套类型化代码里。Rust6,207
  5. serde-rs/serde面向 Rust 开发者的序列化与反序列化框架,通过独立格式 crate 支持 JSON 等多种数据格式。Rust11,046