可将任意Git仓库转为生成式海报

背景

在软件开发社区中，Git 仓库不仅是代码的版本管理工具，更承载着项目演变的完整历史。每一次提交、每一行代码的增删，都记录着开发者的工作节奏与项目生命周期。然而，这些数据通常只能通过命令行或可视化工具以表格或图表形式查看，缺乏直观、艺术化的呈现。Show HN 上由用户 unable0_ 发布的开源项目 Codebase Posters，试图通过生成式艺术将任何 Git 仓库的提交历史转化为可打印的海报，让开发者能够以视觉方式“挂上墙”展示其项目的独特形态。

核心内容

Codebase Posters 是一个轻量级命令行工具（通过 npx codebase-posters 一键运行），它读取本地 Git 仓库的提交日志，实时生成 18 幅风格各异的生成式海报。每幅海报都基于仓库的提交历史动态绘制，包括代码新增（蓝色笔触）、代码删除（绿色笔触）、重大提交（带日期的圆点）以及开发者工作习惯的视觉映射（如凌晨 2 点的提交形成“星座”）。用户可以通过浏览器打开一个画廊界面，选择喜欢的海报，观看其逐帧绘制动画，并可导出为高清 PNG（3600×4800 像素，300 DPI，适合打印成 12×16 英寸海报）或 MP4 动画视频。

所有海报具有确定性：相同的仓库和相同的随机种子（seed）会生成完全相同的像素。工具完全在本地运行，不上传任何数据，无遥测、无需账户，体积仅 101 kB，零依赖。它读取 Git 日志后立即绘制，绘制完毕后忘记数据。用户可通过 npm install && npm run dev 启动画廊工具（内置仓库选择器，扫描 ~/code_base 目录），或使用 npm run build 构建分发包后通过 npx 调用。项目还支持扩展：在 src/recipes/ 目录下添加符合 CanvasRecipe 类型（定义于 src/core/types.ts）的文件即可自动注册新海报样式。

灵感来源于 Zeh Fernandes 的 GenCup，由 Kamil 开发，采用 MIT 许可证。

关键要点

• 一键命令 npx codebase-posters 即可在任何 Git 仓库内运行，打开浏览器展示 18 幅实时生成的海报。
• 海报视觉元素：蓝色笔触代表代码新增，绿色笔触代表代码删除，带日期的圆点标记最大的提交，这些提交会扭曲周围图形。
• 所有结果确定性：同一仓库、同一种子，产生完全相同的像素。
• 导出选项：3600×4800 px 的 PNG（300 DPI，12×16 英寸）和编码在浏览器中的 MP4 绘制动画。
• 完全本地运行：不上传任何数据，无遥测，无需账号，体积仅 101 kB，零依赖。
• 可扩展：在 src/recipes/ 中放入符合 CanvasRecipe 接口的文件即可自动注册新海报样式。
• 项目灵感来自 Zeh Fernandes 的 GenCup，由 Kamil 开发，MIT 许可证。

意义与影响

Codebase Posters 将冷冰冰的 Git 日志转化为有温度的艺术作品，为开发者提供了一种新颖的、情感化的方式来纪念和展示自己的项目。它降低了技术数据的呈现门槛——无需设计技能，只需一条命令即可生成专业级的海报，适合打印后挂在办公室或家中。同时，该项目作为开源工具，鼓励社区贡献新的海报样式（recipe），有望催生更多基于 Git 历史的创意可视化。从技术角度看，其零依赖、极简体积、完全本地运行的设计理念，也体现了对隐私和性能的重视。对开发文化而言，它让“代码仓库”从幕后工具变成可展示的成就标识，强化了开发者与项目之间的情感连接。