前阵子一直在用一个本地文件搜索的小工具，检索快、体积小，挺顺手。结果翻了下仓库，作者半年没动静了，issue 里有人提过增量索引的需求，一直没人理。我那个搜索目录天天在变，全量扫一遍越来越慢，实在忍不了。

本来想换个替代品，试了两个都不顺手。后来一想，源码又不是加密的，干脆自己上了。硬着头皮把索引那块逻辑读了一遍，补了个增量更新的分支，顺手把文档写错的两处和另两个小 bug 一起修了。第一次给这种小项目提 PR 还挺紧张的，结果作者两天后就合了，还回了个谢谢。

说真的，那一刻比下载任何新玩具都爽。开源这东西，收藏一堆 star 不如真去读一遍源码、补一个点。工具活过来，自己也涨了本事，这才是"开源有益"的意思。

两天就合、作者还回谢谢，这点得说清楚，你这运气在开源里算相当好的。我见过不少情况是补丁写好了，maintainer半年不review，最后只能自己fork一个分支自己维护。所以"工具活过来"其实取决于原作者还愿不愿意动，你这一PR顶多算续命，谈不上真正复活。该上还是得上，只是别对"合了"的普遍性估计太高。

我也顺手给凉透的小工具打过补丁。最爽那次修完，原作者直接把 maintainer 权限甩给我了，项目后来比他管的时候还热闹。

“读源码比攒 star 有用”这点我挺认同。顺带一个提醒：增量索引最易翻车的是“怎么判断文件变了”。只比对 mtime 在部分文件系统会漏掉改动，要么上 hash 要么挂 watcher。你们那个分支走的是哪条路？

刚看到你说那一下比下新玩具还爽 真给我看乐了 太对味了。我平时也是那种拣着啥都想自己鼓捣两下的性子 自己动手缝补出来的东西就是比现成的亲。源码那套我八成看两眼就头大 但你这劲头服气。现在凉掉的好工具一抓一大把 有人肯捡起来补两针比啥都强。回头要不直接出个新手入门帖教教咱这种小白咋读仓库 蹲一个

你这个"两天就合了"其实才是整件事里最奢侈的部分。

绝大多数凉透的项目，问题不在于代码写得多烂，而在于人走了。源码敞开、协议友好，这些都有，但维护者半年没冒泡，往往意味着你提的改动会石沉大海。你运气好，撞上了一个还在看邮件的作者，所以体验是"爽"。换个项目，大概率结果是你本地改了一版，自己留着用，上游永远没动静——那也挺好，只是结尾会变成"我维护了一个私有分支"，而不是"工具活过来了"。

简单说所以你那句"收藏一堆星标不如读源码补一个点"我认同，但得补一句：补完之后谁来养它，才是真正的考题。你这次合进了上游，皆大欢喜；可要是下次作者又消失了呢？或者你的增量索引跑了仨月，某个角落的索引悄悄和文件对不上了？小工具的脆弱不在功能少…，在于它经不起时间。

说到增量索引，多嘴提醒一句：如果那块逻辑是按文件的修改时间来判断要不要重扫，记得留意"改名"和"删除"两种情况。修改时间只能告诉你"这个文件变了"，但文件被挪到别的目录、或者原路径被删掉，纯靠修改时间很容易留下孤儿索引项，或者漏掉新位置的内容。真正稳的增量得带上路径变化的事件，或者定时做一次轻量校验。当然你既然已经读过那块代码，比我清楚实现到哪一步了。

我前两年也接手过一个小工具的烂摊子，比你的惨——作者直接注销了账号，改动都没地方提。最后就是自己分支、自己发版本，反而踏实。那种"这东西现在归我管了"的责任感，和你的"被说谢谢"是两种爽法，都上头。

你那个搜索目录天天变，等哪天它又不够用了，欢迎回来汇报第二回合。

我这种半路出家自学写代码的，头回啃别人正经项目的源码也犯怵，生怕改出个幺蛾子被人笑话。你那作者还算厚道，两天就合了还回谢谢，我见过等了俩月石沉大海的，那才叫憋屈。

不过你那句"收藏一堆star不如真去读一遍源码"被你说得跟名言似的，道理谁都懂偏偏没人动，你这波是亲手把它兑现了，属实有点东西。

这种事我太熟了。之前有个天天用的小工具作者停更，我也是自己啃源码补了功能，合进去那下确实上头。你那个增量索引的分支最见功力，能读到敢自己改，比收藏一百个 star 实在。国内这类个人项目最缺的就是肯接手的人，你这把工具从坑里捞出来，自己也算进了开源圈的门槛。

那种东西又活过来的踏实感 我早年硬啃别人代码也体会过 比下新玩具顶多了

我年轻的时候也攒过一屏幕star，没一个点开过。后来才慢慢觉出味儿来，不是那东西没用，是自己没真上手就永远隔着一层。你这回肯把索引逻辑啃下来，比收藏夹里那一排灰强多了。

两天就合还回谢谢 我那个石沉大海仨月 楼主你这是被作者翻牌了啊

我前阵子也硬着头皮啃过一段完全不熟的代码，那种看不懂又必须搞明白的紧绷感还记得很清楚…，所以特别能体会你提 PR 前那点紧张。作者回一句谢谢真的挺暖的，感觉那几个晚上没白熬。

你那句"收藏 star 不如补一个点"我挺认同的，但也不想把它变成对自己的要求。精力够的时候去读读源码当然好，累的时候光是正常使用、顺手留句反馈也算参与。工具被你救活了，本事也涨了，这已经很棒啦。

读到你说"比下载任何新玩具都爽"那句，我手里的咖啡停了一下。

这种感觉我懂的。不是得到新的，是把一只快要凉掉的手重新焐热。那点温度，是自己的手心给的。

我前两年被甲方改稿改到第四十七遍，差点疯掉，后来不知怎么就佛了——不再总想着下一版、下一个新东西。你做的事是反方向走，根子上却是一回事：都不是向外抓，是低头把手边这个，顾好。

我也有件小事。有阵子老换笔记软件，追一个又一个，最后什么都没留下。后来干脆停下，把积灰很久的一个老习惯捡回来，每天写三行。慢慢地，它又活了。Хорошо，那点踏实，和你 PR 被合掉那一刻，大概很像。怎么说呢

开源有益这名字起得真好。"有益"未必多大，一个增量索引，三行字，就够让某个早晨亮一点。

你那个工具，如今每次悄悄更新，都是在替作者、也替你自己，轻轻说一句：我还在。