Software Factory 在一个月内构建了 30 个复杂的开源库
我的软件工厂构建的是那种我预期专业团队会花很长时间来做的软件,并且会在发布后持续维护这些软件。到目前为止,这包括一个兼容 SQLite 的数据库引擎、一个基于确定性物理的游戏引擎、一个带有自己着色器编译器的 GPU 栈,以及 Word、Excel 和 PowerPoint 文件的读写器。我一个人运行它。
总共有 30 个库。28 个在 10 月初到 11 月中旬之间达到 1.0,它们合计有近 190 万行手写库代码。到目前为止,它们已有 241 次发布,其中 183 次是在已经超过 1.0 的库上。它们是 NuGet 上的 C# 库,oneyaml 还以 Rust 和 Go 发布。
它构建了什么
Software Factory 一个月内构建 30 个复杂开源库
OnePath · 复杂性 · 创新
在网格、图和导航网格上寻路,构建导航网格,并引导人群。
OnePhysics · 复杂性 · 创新
模拟 2D 和 3D 刚体、布料、软体、流体和车辆,在所有地方都逐位一致。
OneScope · 复杂性 · 创新
拖动、分叉并比较确定性模拟的运行,支持录制或实时。
近距离看几个
OneGame
OneGame 是一个没有编辑器的 C# 游戏引擎。一个游戏就是纯 C# 加上文本资产。Roslyn 源生成器编写每个实体的变更跟踪、编解码器、增量和快照,分析器将引擎规则变成编译错误:同步状态是定点数,只能通过命令改变,视图代码从不写入它。
客户端和服务器运行同一套栈,因此状态在进程之间同步,并带有预测、权限转移和漂移检测。它运行在 Windows、Linux、macOS、Android、iOS 和 Web 上,CLI 和 MCP 控制协议让代理可以从终端构建、运行、检查和重放游戏。它直接建立在该工厂的其他九个库之上。
仓库中包含示例游戏,CI 在 Linux 和 Windows 上运行它们。Solitaire 和 Lanterns 在每个场景中在两者上都得到相同的状态哈希。
OnePhysics
OneGame 的物理来自 OnePhysics,这是从第一性原理编写的确定性 2D 和 3D 物理:刚体和关节、绳索、布料、软体、断裂、粒子流体、浅水、车辆和布娃娃,并具有用于回滚网络代码的字节精确快照和恢复。
确定性是困难的部分。普通的
文章标题:软件工厂一个月内构建 30 个复杂开源库
正文: 最难的部分是一点都不能丢。OOXML 文件是由多个部件组成的包,保存时必须原封不动地保留每一个部件,包括那些库根本没必要碰的部件。OneDocument 打开并保存了 4,900 个真实世界的文件,没有做任何改动,全部 111,239 个部件输出后都字节一致。
然后是真正的 Office 来评判输出。我笔记本电脑上的桌面版 Word、Excel 和 PowerPoint 都能打开它写出的文件,全部 104 个创作和修订文档也不例外,公式引擎还针对 Excel 自身的重算进行了运行。
它们是相互构建的
30 个库中有 21 个依赖集合中的其他库。文档这一侧最能说明问题:OneDocument 通过 OneRender 进行渲染,而 OneRender 又构建在工厂另外四个库之上。
OneDocument 的 1.0 发布日,即 11 月 6 日星期五,展示了这在实践中意味着什么。它下面的三个库先交付了它所需的东西。OneRender 添加了 OneDocument 所需的有标签 PDF 角色,OnePdf 修复了 OneDocument 在往下两层发现的 PDF/UA 失败,OneImage 修复了 OneDocument 的模糊测试器发现的一个崩溃。
智能体需要我做的任何事情都会放到我手机上的项目看板上。发布请求就是一张 Ship 卡片:发布的证据加上一个 Ship 按钮。三个修复都在 OneDocument 的 Ship 卡片送到我之前就上了 NuGet,卡片到达后大约十分钟我就点了 Ship。没有哪个团队会编辑另一个团队的仓库;需要下层库提供东西的团队会通过项目经理向那个库的团队提出请求。
工厂如何运转
每个库都从一个规划智能体开始,它通过一次一个的多选题来设计库。项目经理智能体替我回答这些问题,除非只有我能回答,而每一个设计决策都会记录是谁做出的。
每个库的构建负责人智能体把工作拆分成单元,并把每个单元交给各自 git worktree 中的工程师智能体。工程师不能 push、打标签或发布;负责人用自己的命令检查他们的工作并合并。每次运行都从无记忆开始,所以状态存在于文件中。每个库的 PLAN.md 就是其负责人的记忆,而项目经理这一角色自 11 月 4 日以来已经历经 12 个智能体实例,每个都通过笔记交接。
每个库的发布都以适合它的任何证据为门槛。如果某个标准有自己的符合性测试套件,那个套件就是门槛。如果有参考工具,它从其已发布的版本作为黑盒运行;如果有真实应用,它们必须能打开库写出的文件。如果外部什么都不存在,比如游戏引擎和物理,门槛就是跨平台的哈希矩阵和示例游戏。任何智能体都不能放宽门槛。
当发布候选版本在四个操作系统上通过 CI 后,项目经理就发布它的 Ship 卡片。当我点了 Ship,发布工作流就会给它打标签并发布到 NuGet,然后项目经理检查每个包都已列出。
图表:开源项目上的看板项,11 月 4 日至 17 日。
我的部分是规则和 Ship 点击。在那两周里,16 个发布中的每一个都是点一下就发出去了。
来自陌生人的三个问题
OnePdf 于 10 月 23 日达到 1.0,现在已是 1.23.0,不到四周内发布了 30 次。1.23.0 来自我不认识的人提交的三个 GitHub issue。第一个在 11 月 10 日星期二提交,来自一个正在从商业 PDF 库迁移的团队:他们需要重命名嵌套在父级下的表单字段,同时保持其 widget 关联,并且要用重建的外观流来设置字段的外观。另外两个在 11 月 16 日星期一下午提交:关于表格密集型布局中每段短文本分配约 6 KB 的问题,以及无需第二次布局就能得到精确的“N/M”页数总计。
那个周一晚上,我让项目经理开始监控每个开源项目上的 GitHub issue 并处理它们,像对待邮件一样谨慎,因为 issue 是不可信输入。它在几分钟内自己回复了全部三个;自动 issue 轮询器当晚稍晚上线,却一个都没处理。OnePdf 的负责人把 issue 当作数据读了一遍,然后写了简报,因此工程师们从未看到 issue 原文。
图表:OnePdf 1.23.0,从我的请求到已关闭的 issue。

周二早上我点了 Ship,并询问文档是否已更新,项目经理给我指出了 docs/forms.md、docs/layout.md 和 changelog。分配问题的修复,正如 issue 上所发布的:单词单元格从约 6.6 KB 降到约 2.2 KB,快了约 3 倍,PDF 字节未变。我没有写代码,没有审查 diff,也没有写任何回复。
这些库在 libraries 页面上,源代码在 github.com/recursive-ai-oss。