Rust 终端 ASCII 宠物：用 Git 提交喂食，吃透 trait 与所有权

每天写代码，Git 提交其实记下了你所有的“数字痕迹”。要是把这些痕迹变成一只会在终端里慢慢长大、你偷懒它就枯萎的小东西，是不是有点意思？

我把它叫「代码共生体」（Code Symbiote）。纯 Rust 写的小玩具，功能上确实没什么用，但写它的过程中能把 Rust 几个核心概念摸得很透。下面一边讲它是什么，一边拆我的实现思路。

它到底是个什么玩意儿

说白了，就是终端里的赛博盆栽。

• 它是一只 ASCII 画的小生命，常驻在你的终端里。
• 每提交一次代码、连续 coding 一天，它就“吃”一顿。
• 吃够了就进化：孢子 → 苔藓 → 幼苗 → 发光体。
• 三天不碰键盘，它开始掉叶子、枯萎，最后休眠。
• 状态存在本地文件里。关掉终端它仍然“活着”——靠时间戳判断你今天有没有摸鱼。

为什么好玩？因为它把“坚持写代码”这件反人性的事，变成了一只你会心疼的小宠物。比任何打卡软件都管用。

先把“生命”和“画布”分开

一开始我也总把界面和逻辑搅在一起，后来才想通：先别管怎么画，先把“生物怎么长大”写成纯逻辑。

所以整个东西拆成三层：

1. 引擎层：负责生物的状态、进化规则、进食逻辑。不碰终端界面，也不碰文件读写。
2. 数据层：把 Git 活动变成“进食事件”，再把生物状态写进本地文件。
3. 界面层：用 ratatui 把生物画成会动的 ASCII。

这么拆最大的好处是引擎层能单独跑、单独测。跑一下 cargo test 就能验证进化规则对不对，完全不需要开终端。将来想换桌面 GUI 或者网页版，只动第三层就行。

用 trait 描述“进化”

进化形态有一串：孢子、苔藓、幼苗……每个形态的长相、进化门槛、语气都不一样。如果用 match 硬堆，代码很快会变成一锅粥。Rust 的 trait 正好干这个：

trait Lifeform {
    fn render(&self) -> String;                   // 怎么画
    fn feed_threshold(&self) -> u32;              // 进化要喂多少
    fn mood(&self) -> &str;                       // 当前的心情台词
    fn next(&self) -> Option<Box<dyn Lifeform>>;  // 下一步变成啥
}

每个形态自己实现这套接口：

struct Spore;

impl Lifeform for Spore {
    fn render(&self) -> String { "·".into() }
    fn feed_threshold(&self) -> u32 { 3 }
    fn mood(&self) -> &str { "咕……我还只是一颗孢子。" }
    fn next(&self) -> Option<Box<dyn Lifeform>> {
        Some(Box::new(Moss))
    }
}

关键点在这个 dyn Lifeform：当前形态就是一个 trait 对象，所谓“进化”不过是换一个 Box 装进去。以后想加“开花”形态，只要新写一个 struct 加一段 impl，主循环一行都不用改。这比 enum + match 省心太多——加一个分支就得翻遍所有 match。

存档才是命门

宠物最怕“关掉终端就死了”。Rust 这边 serde 配 toml 特别顺手：

#[derive(Serialize, Deserialize)]
struct CreatureState {
    form: String,             // 当前形态
    fed: u32,                 // 累计进食
    last_fed: DateTime<Utc>,  // 上次进食时间
}

存盘用 toml::to_string，读盘用 toml::from_str，几行就搞定。

但这里有个坑我踩过：存档版本会演进。今天给结构加了个 mood 字段，昨天存的旧档里没有，读出来就报错。解决办法要么把字段写成 Option，要么在加载时做迁移。这事看着小，其实和真实项目里的配置管理、数据库迁移是同一个道理——早点养成习惯，以后少哭。

数据从哪来：跟 Git 说句话

“进食事件”当然来自你的 Git 活动。取法有两种：

• 调命令行 git log --since 然后解析。简单，不依赖额外库，就是慢点、脆点。
• 用 git2 这个 crate 直接读 .git 目录。快、稳，但上手要花点时间。

我的建议是先用命令行版本把整条链路跑通，确认想法靠谱了，再考虑换 git2。别一上来就挑最难的那把武器，很容易想法还没验证完，人先累趴了。

让它真的“活”起来

光画一帧静态图没意思，得会动：叶子轻微晃、台词偶尔变。ratatui 提供 Terminal::draw，我每 200 毫秒重画一帧，render() 根据当前时间让 ASCII 稍微变一变就行。

写这层的时候你会第一次被 Rust 的所有权 教育：draw 的闭包要借用状态，计时器又在改状态，稍微不注意就撞上 borrow checker。不过它逼你写出的那些“先拷贝再画”或者“用 RefCell 管内部可变”的写法，其实就是 Rust 并发安全那套思想的缩小版。烦是烦，但有用。

写这个玩具值得分享的经验

• 把能测的纯逻辑和界面拆开，这是最值钱的一个决定。
• 遇到“一堆类型各自带行为、还会不断加新类型”的情况，用 trait 对象代替 enum + match，加新类型几乎零成本。
• 持久化别等最后才想，格式、字段演进、旧档迁移一起规划。
• 先用最糙的办法把主链路跑通，再为性能换库。验证想法永远比炫技重要。
• borrow checker 不是来找茬的，它逼你把“谁在读、谁在写”说清楚，这种纪律在大项目里就是少 bug 的依仗。

结语

好玩的应用从来不是功能多，而是有一个让你想再打开一次的理由。“代码共生体”的理由是：让写代码这件苦差事，多一点点牵挂。

而把它做出来，顺手就把 Rust 的 trait、所有权、序列化、分层这几块啃熟了——这就是玩具项目的真实回报。