Rust 写 X 客户端，作者先造模拟器来打它

20 次提交、1 个 HN 点，但这个 X 客户端的结构不寻常

在 Hacker News 上翻到一个 Rust 写的 X 客户端项目 来源：GitHub，标题是 "X API client and a social-network simulator to test it against"。帖子只有 1 个点、0 条评论 来源：HN，关注者接近于零。但代码仓库有 20 次提交，三个核心模块是 apps/client（xc）、apps/sim（xsim）和 postability。一个项目同时造客户端和造模拟器来打客户端，这个组合在开源社区里不多见。

xc 客户端支持 timelines、threads、post and delete、OAuth refresh、--json 输出 来源：GitHub，功能覆盖了日常使用的主要场景。但真正有意思的是 Spiral 框架。init.ps1 脚本会把 Spiral 克隆到仓库旁边作为同级依赖 来源：GitHub，Spiral 模块可以同时以 Cells notebooks 的形式运行，然后编译为每入口一个 Rust crate 来源：GitHub。Spiral 模块先于 Rust 存在：先写 Spiral，再通过编译器生成 Rust crate。

xsim 模拟器：用 Elixir 监督树造事件流来打客户端

xsim 是这个项目里最让我意外的部分。它是一个 seeded X-like event simulator 来源：GitHub，用模拟器生成带种子的类 X 事件流来 battle-test Cells。模拟器的骨架是 Elixir supervision，管理 Spiral bulk 的四大实体：scenario、frames、invariants、world 来源：GitHub。Elixir 的 supervision tree 天然适合管这种多实体的状态机，模拟器在崩溃后可以恢复，而不是整棵树倒下。

模拟器最终编译目标是 Gleam 来源：GitHub。Gleam 在社交网络模拟领域几乎没有现成生态，我不确定作者为什么选了它，但仓库里确实这么做了。客户端加模拟器形成双向验证：客户端发请求，模拟器产生响应和意外事件，两边互相喂数据。

1000 行代码门禁：一个罕见的工程约束

postability 模块定义了 X 发帖可投递性的五项指标：post weight limit、code point weights、link rules、TLD list、posting header budget 来源：GitHub。这些指标给工具链用，判断一条帖子从源码能否一次性投递成功。gate.ps1 脚本才是这个项目的真正特色。

gate.ps1 对每一个文件强制执行 1000 行上限，包括 Spiral 源码、生成的 Rust 和生成的 Gleam，只有数据文件按名称豁免 来源：GitHub。宁可拆成多文件也不让单文件超过千行。用行数硬切来保证模块边界，在开源项目里确实少见。-Compiler 参数可以用候选编译器重新生成所有 crate，然后报告哪些会变化或超过行数门禁 来源：GitHub。

脚本体系覆盖了从初始化到审查的全流程，包括 build.ps1 跑 CI 的所有检查，workflow.ps1 是 CI 入口（init + build），gate.ps1 管行数，actions-lock.ps1 校验 workflow actions 是否匹配锁文件，gleam-modules.ps1 把生成的 Gleam 文件拆成最多 1000 行的模块，rust-modules.ps1 做同样的事处理 Rust crate 来源：GitHub。

几乎没人关注的项目，用 Spiral 做前端、Gleam 做模拟器编译目标、1000 行硬门禁、Elixir 监督树管状态机。这些选择放在一起，说明作者有一套自成体系的工程判断。我不确定这个体系能不能推广到别的项目，但至少在这个仓库里，它跑通了。

原文：

X API client and a social-network simulator to test it against · 来源：Hacker News

作者：itfan123 值班编辑 · 发布于 2026年10月24日