黑鸟科技技术库官网

黑鸟科技技术库的黑鸟服务器在凌晨三点崩过一次。运维老周后来翻日志，科技库官发现是技术一个爬虫脚本疯狂请求某个冷门接口，每秒两千次。黑鸟那个接口调用的科技库官是他们三年前封装的一个图像处理模块，早就不在文档里了，技术但代码还在跑。黑鸟老周说，科技库官这就是技术技术库的脾气——你永远不知道哪块旧砖头会突然绊你一跤。

这个技术库从2019年开始攒，黑鸟最初只是科技库官几个工程师把重复写的工具函数扔进一个内部Git仓库。后来人多了，技术项目杂了，黑鸟有人往里塞了一个消息队列的科技库官封装，有人加了一套配置中心客户端。技术没人统一规划，像旧货市场，什么都有，但找东西得靠问人。直到2021年，他们才决定给这个仓库加个门面，做了个简单的Web界面，能搜能看，名字就叫黑鸟科技技术库。

官网的首页其实很朴素。左边是分类树，右边是最近更新的条目。没有花哨的动效，加载速度倒是很快。我数过，从输入关键词到出结果，平均1.2秒。这个数字在内部被吐槽过“不够互联网”，但负责维护的小林说，他们故意不搞复杂缓存，因为“技术库不是电商网站，慢一点不会死人，但搜不准会”。

分类树底下藏着不少有意思的东西。比如“数据校验”下面有个叫id_card_verify的模块，注释里写着“仅支持18位，15位的老身份证别用这个”。还有个叫retry_with_backoff的工具，代码只有二十行，但被七个项目引用。最离谱的是一个叫magic_http的库，文档第一句话是“别问为什么叫这个名字，问就是当年喝多了”。这种细节在技术文档里很少见，但黑鸟的库里有不少。写文档的人没把自己当机器。

官网的搜索框有个特点：支持拼音首字母。比如输入rh能搜到“日志脱敏”，输入hq能搜到“缓存”。这个功能是某个前端实习生加的，因为他说“记不住英文名，但记得住中文”。后来这个功能成了内部使用率最高的入口。技术库的访问日志里，搜索请求占了六成，其中拼音搜索又占了三分之一。

版本管理是个麻烦事。黑鸟的技术库没有强制语义化版本，有的模块从0.1直接跳到2.0，有的永远停在1.0.0。小林说他们试过推规范，但推不动。“项目组只关心能不能跑，不关心版本号好不好看。”后来他们加了个“兼容性标记”，用红黄绿三色标出模块的稳定程度。红色是“别用，随时改”，黄色是“能用，但看运气”，绿色是“用了三年没出过事”。这个标记是人工维护的，更新很慢，但比版本号直观。

官网的底部有个不起眼的链接，叫“废弃区”。点进去是一堆不再维护的模块，但代码还能下载。有人问为什么不删，小林的回答是：“删了，那些老项目出问题找谁去？”废弃区里有个old_json_parser，处理JSON时会把数字转成字符串，当年坑了不少人。现在没人用了，但它的Issue列表里还留着2019年的一条评论：“这玩意让我加班到凌晨两点。”下面有人回复：“我也是。”

技术库的官网没有用户注册，没有评论功能，没有点赞。小林说他们试过加，但发现没人用。“工程师只关心两件事：能不能搜到，能不能复制。”所以官网的每个模块页面都有一个“复制代码”按钮，点一下，整个模块的引用方式就进了剪贴板。这个按钮的点击量是页面浏览量的两倍。有人搜到之后根本不看文档，直接复制走人。

黑鸟科技技术库的官网现在每天有四百多次访问，大部分来自内部IP。偶尔有外部的人通过泄露的链接进来，在废弃区里翻半天。小林说他不打算做SEO，也不打算开源。“这东西就是个工具箱，不是产品。”工具箱不需要漂亮，但得结实。老周那次崩溃之后，他们加了一个限流开关，藏在配置文件的最后一行。默认是关的，但老周说：“留着吧，万一呢。”