从蜂鸟到Colibri：打造轻量级命令行工具的工程实践

“大型软件”这个词我这两年是越来越怕了。装一个便签工具启动要转圈三秒点一下还要等它同步窗口弹出来之后又用一堆按钮提醒我“你可以升级到专业版”。可我的需求从头到尾只有一个记一句话下次能搜到。这种被工具绑架的感觉从年初开始变得特别强烈于是我决定自己写一个“只做三件事”的命令行小工具代号就叫Colibri。Colibri是法语里的“蜂鸟”。蜂鸟的体长只有几厘米翅膀每秒能扇七八十次可以悬停在花前精准地把嘴探进去采完蜜立刻飞走不做任何多余的动作。我希望这个工具也长这样体积小、启动快、动作精准、用完就走。这篇文章不介绍什么成熟的开源大作纯粹是记录一个以Colibri命名的轻量级工具从命名到设计、从选型到优化、最后发布的过程顺便聊聊“轻量”这两个字在工程上到底意味着什么。如果你最近也在纠结工具选型或者想做自己的小工具再或者已经被各种重型软件折磨到不想打开电脑这篇应该有点用。1. 为什么给一个工具起名叫Colibri蜂鸟身上的工程学答案名字不是随便起的。我给这个工具起名Colibri的时候其实是在给整个项目定性格。蜂鸟最让人印象深刻的几件事恰好对应了轻量级工具最重要的几个工程指标。先说“小”。蜂鸟是目前已知体型最小的鸟类之一一枚硬币都嫌大。对应到软件上就是安装包体积要小、磁盘占用要少最好一个二进制文件到处都能跑不需要装运行时不需要拖一堆动态库。体积这个东西表面上只是“多占点空间”的问题实际上它决定了别人愿不愿意下载你、部署你、保留你。一个几十MB的小工具你说自己是轻量级的没人信只有数据会说话。然后是“快”。蜂鸟扇翅膀的速度快到人眼只能看到残影但它真正厉害的不是“快”这个动作而是“悬停”——在气流里保持位置稳定精准地完成一件事。对应到工具上就是启动要快、响应要快更重要的是不能因为功能而牺牲速度。很多工具一开始很快随着功能加多启动越来越慢内存越来越大最后变成一个用户每天都想卸载的庞然大物。还有一个被忽略的点蜂鸟的代谢率高得惊人它必须不停进食才能维持生命。这意味着它的一举一动都是高频率、高消耗的。反过来想正因为工具会被高频使用它才必须轻。如果一个工具你每天要打开十次每次多浪费三秒一年下来就是好几个小时。这些浪费平时感觉不到但累积起来非常可怕。我给Colibri定下的四条原则就是在模仿蜂鸟的习性一、单文件、小体积二、启动快、响应快三、只做核心场景不做功能堆砌四、所有操作可被脚本调用用完即走。其中第四条尤其重要。严格说Colibri不是一个“应用”它更像一个“零件”。我不会给它做图形界面不会做常驻后台不会做全局快捷键托盘。它的使用方式就是你在终端里敲一条命令拿到结果然后继续干你的事——就像蜂鸟采完蜜就飞走不在花上多待一秒。很多人一听到“轻量”就会觉得是“阉割”“简陋”。我不这么看。轻量不是做得少而是重新定义“完整”。一个完整工具的标准不是“功能有多全”而是“核心场景有没有覆盖到位”“会不会崩”“数据是不是属于你自己”。功能堆满但每次用起来都别扭那不叫完整那叫负担。2. 需求收敛砍掉90%功能之后工具反而完整了Colibri立项的第一周我干的事情不是写代码而是列需求清单。跟大多数项目一样清单越列越长最后变成了下面这样。你感受一下跨平台同步网页剪藏富文本编辑内置数据库插件系统定时提醒标签管理全文搜索团队分享AI摘要列完这个清单我盯着看了半天陷入了所有“什么都想做”的项目都会遇到的自我感动里。马上就要动手了突然脑子里有个声音问这些东西我到底会不会用我逐个问了自己三个问题你多久用一次如果不做你会不会特别难受市面上有没有已经做得很好的替代品答案非常残酷。表格列出来是这样的需求使用频率替代品情况是否保留跨平台同步偶尔已有成熟的同步方案砍掉网页剪藏极少浏览器扩展已经很成熟砍掉富文本编辑每周一两次各家笔记App体验都很好砍掉内置数据库用不上Redis/SQLite已经在等待你砍掉插件系统用不上维护成本极高砍掉定时提醒几乎不用系统日历足够砍掉标签管理经常原生的关键词过滤足够保留简化版全文搜索每天自带的字符串匹配足够保留团队分享用不上不适合个人工具砍掉AI摘要很少性能与成本不符砍掉最后真正留下的只有三个动作记录record、查询query、导出export。我给Colibri定义的性格就是九个字“记下来找得到带得走。”为什么最终保留的是这三个先说记录。这是所有信息工具的