10 月 25 号晚上,我在改自己那个销售小工具。
这个工具最开始是个玩具。一个 CSV 文件存客户主数据,一个脚本按地区把名单拉出来,再加一个定时任务去抓公开的线索。数据量小的时候,什么都能凑合。
后来往上加的东西越来越多:AI 线索收集、自动跟进、通话记录归档。加着加着复杂度就上来了,原来的结构撑不住。这个月我决定做第一轮重构。
重构怎么分
分四层。
最外面是 CLI 接口层,命令行里敲什么,参数怎么传,输出成什么格式。
底下是工作流层,把“找线索—筛客户—写跟进—记录”这几步串起来,每一步可以单独跑,也可以连起来跑。
再底下是数据层,客户主数据从 CSV 迁到 SQLite,同时保留一份 CSV 镜像,方便我用 Excel 看。
最后是调度层,什么时候跑、失败了重试几次、日志写在哪。
顺手还留了一个 Interface 层,准备以后接 TUI 或者网页界面。现在还没写,只是把口子留出来。
分层这件事本身不难,难的是分完之后每一层的数据怎么对上。分层的代价是多写很多接口定义,一开始觉得啰嗦,真到改存储的时候才觉得值。
真正卡住的地方
不是分层,是数据。
第一版是随手写的,几份 CSV 里的字段不统一。同一个东西,这张表里叫 customer,那张表里叫 client;日期有的写 2026/9/1,有的写 2026-09-01;电话号码带不带区号混着来。
我当时觉得无所谓,反正就几十条数据,写个脚本转一下完事。
真到迁移的时候,看着几百条脏数据,我坐在电脑前两个晚上没动。让 AI 写迁移脚本,脚本能生成,但每张表都要单独看一遍,字段对不上还得改。星期四晚上迁到一半,发现主键重复,同一条客户记录导进去了两次,只能全部回滚重来。
回滚的时候我盯着屏幕想,这活儿要是第一版就规范,大概一个小时能搞完。
走一步看十步
这件事让我重新理解了“走一步看十步”。
以前我以为这句话的意思是,一开始就把未来十步规划清楚。做不到。我根本不知道三个月后的需求是什么。当时连“客户主数据”这个概念都没想清楚,只觉得是个 CSV。
现在我的理解是:不用把路全规划好,但要尽量让当下做的事规范、有条理,提前准备将来可能要复用的东西。
具体到那个玩具模型,就是一开始把字段名定死,日期统一用 ISO 格式,电话统一带区号,再加一列主键。多花半天,后面省两个晚上。
短期看效率甚至更低——定字段、写 schema 的时间,本来可以直接拿去加功能。长期看不一定,得等真的需要复用的那天才知道。
我忘了在哪看过张一鸣说过延迟满足,说他很年轻的时候就想明白了这件事。我看完没什么感觉,直到自己坐那两个晚上。
现在做的事怎么“看十步”
我现在会做三件很小的事。
写新脚本之前,先花十分钟想一遍数据从哪里来、到哪里去、中间会不会被别人用。想不完全正常,但想一遍和不想,差别很大。
字段命名先统一。中文名、拼音、英文混着用,短期看着都懂,长期一定出事。
给每个模块留一个出口。比如数据层只暴露几个函数,别的地方不能直接读 CSV。这样以后换存储,只改一个地方。
听起来像软件工程课本上的话。但我是被自己的数据坑了才真的当回事。
迁移其实分五步
现在回头看,数据迁移大概分五步:导出旧数据、清洗字段、写映射表、导入新库、抽样核对。
前两步最花时间。清洗不是写个脚本就完了,很多字段要看一眼才知道该怎么归。映射表是我手动写的,二十几个字段对了两小时。
导入反而快。抽样核对也快,抽二十条,能对上就过。
耗时最多的是我一开始没想到的“造测试数据”。为了验证迁移脚本,我造了三十条假客户,覆盖各种脏格式。这三十条让后面省了很多事。
会不会是过度设计
有时候我也怀疑,一个自己用的小工具,搞四层结构是不是有病。
后来想了一下,这次重构不是为了“架构好看”,是因为我要加的东西已经加不进去了。再加一个客户端,原来的结构就要崩。
如果这个工具一直只有我一个人用、永远不加新功能,那确实没必要分层。但它现在要接第二个客户端、要给别人用,分层才变得划算。
工具的价值取决于它要扛多少东西,不是取决于它有多少层。
还没做完的部分
重构本身也没做完。智联客户端还没补,网页界面没写,接口层只留了个空壳。
数据迁完了,跑通了一次全流程,勉强能算第一阶段完成。
第一版的数据格式现在回头看,很蠢。但让我回到三个月前,我大概还是会那么写——那时候不知道后面要接什么。
能做的只是下一次写玩具模型的时候,先花半小时把字段定下来。
也可能过一阵子又忘了。忘了就再来一次。说到底这些习惯不是一次想明白的,是被自己的数据坑一次,长一点记性。
