ARTICLE · 1182716
族谱软件开发日志2026-10-14
族谱软件开发日志2026-10-14
tags: []parent: ""collections:- 软件开发
最近更新：2026-10-14（第 7 篇） 我是老闫。家族修谱多年，想把老谱和新资料整理成电子版，但市面的族谱软件要么必须联网上传，要么臃肿难用。我的底线很明确：家族的资料是隐私，必须全部存在自己电脑上，一个字节都不许往外发。 我一行代码都不会写，办法是找 AI 结对：我出需求、出主意、做验收，AI 负责敲代码。规矩是：每做一个功能之前，先用选择题把边界敲清楚；每发一个版本之前，测试不全绿不打包。 上一篇（第 6 篇）写到拿老谱原文给软件"换脑"、装下结构化字段。这一篇记两天——10 月 13 日把整套族谱按老谱重录"换血"，10 月 14 日再把两份底稿合成一份、把老谱的细节补进去。
前面导入《族人信息（部分）》只是试水。这天动了大手术：我把老谱分六段重录成六份 JSON（每段格式统一：世代、名讳、字号、行次、生卒、配偶、子嗣），让软件一份份吃进去，从头重建整库。 丈夫的备注存老谱原文全文——世代、行次、生卒原话、全部配偶、子嗣，一字不丢； 年号自动换算公历：乾隆四十年 = 1736 + 40 - 1；看到"卒于""享寿"就自动点亮"已故"； 配偶名规范化："蔡氏（书英）"自动拼成"蔡书英"，没写名字的按姓记，继娶的写进丈夫备注； 子嗣支持顿号拆分，女儿、嗣子、"无记载"都认。 六段合起来724 人。地基打牢了，但还有 13 条边因为人没同时出现连不上，我列了张"待接边清单"打算手动补。 这一轮的体会是：与其在旧数据上修修补补，不如按权威底稿重建来得干净。旧库我留了备份，随时能回滚。
13 日重录完，我手上就有了两份底稿：一份基准版（人多、备注和配偶信息全），一份2021 修订版（父子、过继关系最全）。问题来了——两份都对不齐，怎么办？ 我和 AI 用选择题把规则一条条敲死： 以基准版做底，把 2021 版的父子、过继关系补进来； 父亲名字一字之差的冲突（比如"闫克法"和"闫克发"），一律以 2021 版为准； 过继按 2021 版，姓名加星号，还顺手修正了 6 例养父记错的； 重名的人逐条定夺：父亲不同就当两个人，各挂各的父亲；父亲相同就当同一个人。 合并完是894 人。中间踩了个大坑，值得单说：数据库里存父子关系的那张表，"父亲"和"孩子"两列的摆放顺序，跟过继表正好是反的。AI 第一版按同一个方向去理解，结果父子边全接反了，跑出来一堆"孩子当爹、爹当孩"的怪图。好在有测试兜底，一跑就露馅，改对方向重来才正常。这种坑，光看代码看不出来，得靠真数据跑一遍才现形。 地基打牢，再补肉。我把三支（有贵后裔，从五世到十三世）的老谱 JSON 导进去： 103 人补上字号、生卒； 新建 119 张妻子卡、8 张女儿卡——之前这些妻子在库里是"氏未详"，现在有名有姓有生卒了； 全库到1033 人，其中女性 505 人——差不多一半，可见老谱里女人的信息此前被埋没了多少。 趁收尾，把当天提的界面要求一次做完： 备份能起名字了：点备份弹出命名框，写上"合并前""导入老谱后"，以后一眼认出是哪次； 恢复前先问要不要留后路：点恢复先弹窗问"要不要先把当前数据存份备份"，推荐选"是"，万一恢复错了还能找回； 恢复对话框讲清楚两个按钮：「覆盖恢复」= 彻底替换（回到从前某天），「合并导入」= 添砖加瓦（当前数据保留、只补缺的）；顺手把"双击就自动合并"关了——太容易误触； 备注框自动放大：写多少字就撑多高，全部文字一眼可见、不用滚动；还会自动识别——在备注里手写"行次：行七""生于道光十二年五月二十七日巳时；卒于……"，停半秒就自动填进上面的行第、生卒、时辰字段，年号自动换算公历，只补空白、绝不覆盖我已经填的； "氏未详"统一改"未知"：全库 129 处，没有配偶信息的统一叫"未知"，看着清爽。 版本收在1.2.8，五套测试全绿。正式版我没动，等自己手动更。
收个账：这两天软件从"有 500 人"长到"1033 人、快一半是女性"，还把两份打架的底稿合成了一份干净的。最大的体会有两条： 两套数据打架，先定谁说了算。父子以 2021 版为准、过继以 2021 版为准、备注以基准版为准——规则定清楚，机器才不会和稀泥。 坑要靠真数据跑出来。父子边接反那种错，盯着代码看一万遍也看不出来，一跑真数据就现形。所以每轮改动测试全绿，不是走过场。 能重建就别修补。与其在错综复杂的旧数据上打补丁，不如拿权威底稿重建干净——旧的留着备份，随时能回。 规则先于执行。合并两份数据前，用选择题把每种冲突怎么处理敲定，机器照做；别让它自己猜。 一半是女性，说明过去漏了多少。老谱里女人的信息以前基本是"氏未详"，这轮补出 119 张妻子卡——修谱不能只记男人。 自动识别只补空白，绝不覆盖人填的。机器帮忙可以，抢人的活不行。 13 条"待接边"手动补齐，把整棵树彻底接通 《族人信息（完整）》整理稿校订后导入（还欠着） 「分享包」压缩包，拷给家里其他人的电脑用（一直欠着） 老照片、谱书扫描件陆续补进各成员的「史料与附件」 （未完待续，下一篇见文首新的时间节点。）
老闫的族谱软件开发日志
—— 一个不会写代码的人，和 AI 结对做软件的真实记录
这是一份持续更新的开发日志。我按时间节点记录「族谱管理」软件从想法到交付的全过程，每有新进展就续写一篇。本文为第 7 篇，全程文字记录，不涉及任何真实族人信息。
