凡人修仙传：交付之日与工具包的四颗真 bug

长征的最后一公里，走的往往不是路，是排雷。凡人修仙传的交付日，排出了四颗。

一、收官

二百四十七批全量扫描零失败收官——中途进程被外部回收过一次，断点续跑机制自动跳过已完成的一百六十六批接续；最后一批落地后，合并层、世界条目落盘、人物分档、组装、校验在一天内流水跑完。校验 0 issue、0 warning：九千三百六十七条、六十万字符，人物 290（S17/A41/B71/C161，女性 95 人全部带攻略提示）、世界 4,908、剧本库 4,144、手写层 25、六套开局，PNG 十二兆回读校验一致。三件交付物（PNG 卡、卡 JSON、独立世界书）落进 card 目录，桌面原件全程未动。

二、四颗真 bug

交付的真正价值，是沿途拆掉的工具包四颗真 bug——它们不是这张卡的病，是所有后续书籍都会踩的坑：

其一，gen_src.py 把 llm_stream.chat 返回的 (text, model) 元组直接写盘（gen_cast 有解包、gen_src 漏了）——TypeError 崩溃。其二，merge.py 的 load_overrides() 在 __main__ 里才调用，而合并计算在模块级早就跑完——reject_pairs.txt、force_links.txt 这些覆写文件实际从不生效，此前的”干净”全靠垃圾词规则偶然兜住。其三，gen_cast.py 不校验空内容，模型 reasoning 吃满预算时写出 0 字节文件还记 [OK]——三十个空条目里躺着红拂、石蝶、邪莲这些 A 档角色，加了三次重试才全部救回。其四，batch_scan.py 的 SSE 请求会被网关心跳挂成死锁（连接 ESTABLISHED 但八十五分钟零数据，Python 的 recv 超时被心跳不断重置）——加了九百秒墙钟强制断开重试。

三、合并审计：称谓桥爆破

凡人修仙传的群像密度极高，合并审计成了一场称谓桥的爆破工程。半程合并曾曝出四大 hub：韩立簇一百二十四人（吸进厉飞雨和一堆”X师侄”）、极阴祖师簇一百一十人、南宫婉簇六十人（把所有女角吸成一条）、银月簇吸进所有妖兽名。工程兵没有手修，而是把并查集图导入进来按度数定位全部桥接词——仙子、师侄、门主、女修、老魔、岛主、儒生、古魔——再逐条回原文查证：厉飞雨是韩立挚友（两个独立人，扫描批误报）、温天仁是独立元婴修士、韩天生（亡兄）与韩天啸（韩家之主）被错字规则串了糖葫芦，而韩天尊/韩魔尊/圣子查证是韩立本人的尊号、用 force_links 接回本尊。最终 1,260 簇、零 hub，韩立簇收敛到十六个合法别名；“修炼境界”这个概念词混进人物簇也被 JUNK_EXACT 清出。

四、流水线的成年礼

这批交付连同四颗 bug 的修复，等于给工具包做了一次成年礼：覆写文件从此真正生效、空响应从此必被重试、挂死请求从此有墙钟——后来者（校花的贴身高手）的流水线上，这三颗雷已经预先拆除。长征的终点不是交付物，是一条更结实流程。

真实坐标

• 收官：247/247 批零失败（中断一次，resume-safe 续跑）；校验 0 issue 0 warning
• 交付物：PNG 卡（12MB）+ 卡 JSON（13MB）+ 独立世界书（11MB），在 拆书做卡工具包/card/；桌面原件未动
• 规模：9,367 条 / 60 万字符；人物 290（S17/A41/B71/C161，女 95 全带◆攻略提示）、世界 4,908（功法法宝 2,248/地点 643/体系 369/势力 364/种族 434/规则 404/杂项 446）、剧本库 4,144、手写层 25、六开局
• 四 bug：gen_src 元组崩溃；merge 的 load_overrides 调用时机（覆写从不生效）；gen_cast 空文件零校验（30 空条目三次重试救回，含红拂/石蝶/邪莲/魏无涯等 A 档）；batch_scan SSE 挂死（加 900s 墙钟）
• 合并审计：四大 hub（124/110/60 人）→ 桥接词按图度数定位（仙子/师侄/门主/老魔…）→ 逐条回原文裁决（厉飞雨、温天仁、韩天生、韩天啸拆出；韩天尊/韩魔尊/圣子接回）→ 1,260 簇零 hub；“修炼境界”概念词清出
• 交付注意：网关 token 取自会话历史缓存并硬编码进工作区 config.py；全程只用 step-5-preview