ISSUE-0135 · 上传出口零闸 + 一个被拦下的错误修法¶
原始缺陷:闸挂错了边界(第七次同形状复发)¶
ISSUE-0125/0130/0132/0133 四刀都把「共享数据写入前必须 validate」解释成
writeContactRecord(写本地 IndexedDB)/ writeCloudRecords(云端拉回)。
但数据真正离开本机、成为别人可见的共享事实的边界是
flushContactPoolUploads → getPendingUploads(where { syncedAt: 0, source: 'local' }
的裸 select)→ 逐字段直传 apiContactPoolUpload。
⇒ 本地写入端的闸只保护「从此刻起新抓的行」;上传端搬的是整个存量。 同一份数据两个消费者,一个够得到判据、一个够不到 —— 与前四次同一形状。
触发条件(诚实记录):enableCloudSync 默认 false、服务端未上线、
ensureAuth() 会失败 ⇒ 今天一条都传不出去。这是引信,不是在产泄漏。
且接收端 writeCloudRecords 已对三类清洗 ⇒ 对 ≥v0.10.156 的对端扩散被挡住。
🔴 首版修法引入了比原缺陷更危险的东西 —— 被双路对抗审拦下¶
第一版(未进 main)在 getPendingUploads 里加了清洗并写回:
病灶¶
getPendingUploads 名义上读取待上传行,上一轮却在构造上传 payload 前调用
connection.update,把过滤后的 emails、phones、socials 覆盖回本地库。
这发生在网络请求之前:API 失败时,用户本地唯一副本也已经丢失。
这还绕过了项目既有止损边界:cleanPollutedContactPool 的存量写回有 dry-run,
并由 ENABLE_CONTACT_POOL_COORDINATE_CLEANUP = false 默认关闭;上传调度不应成为
另一条无预演、无知情的存量清理通道。
修复¶
getPendingUploads只返回内存中的清洁投影,不再写库。- 投影仍有至少一个 email、phone 或 social 的行才上传。
- 投影全空的行不发送空 payload,只推进
syncedAt,并写cloud-sync/upload-skip-empty系统日志;原始三个联系方式字段逐字保留。 - API 失败时,可上传行的所有本地字段和
syncedAt均保持不变,下轮重试。
这里不复用 cleanPollutedContactPool:该函数的职责是用户可预演后清理存量;上传出口
只负责决定什么能离开本机。把两者绑定会让启用云同步隐式等价于批准本地清理。
空转与残余边界¶
全空投影通过 syncedAt 进入跳过终态,不再占住按 scrapedAt 取出的最老 200 条,
所以不会每 30 秒重复过滤同一批空行。代价是当前 schema 没有独立 skipReason,
只能从系统日志区分“上传成功”和“因出口过滤为空而跳过”;数据本身仍完整留在本地。
出口闸只能拦住现有纯字符串判据识别出的脏值。基准集明确保留的
KNOWN_MISS_ambiguous 20 条仍会上行;用户可配置的邮箱黑名单/噪音偏好也不属于
“数据损坏”判据,仍可上行。任何尚未被 isPhoneFitForPool、
isEmailLikelyBroken、isSocialUrlFitForPool 识别的新型假阴性同样是残余口子。
验证¶
fixtures-coord-noise.json全量:MUST_DROP 56、MUST_KEEP 38、KNOWN_MISS 20、误杀 0。- 变异恢复上传读取写回:
Tests 2 failed | 1 passed (3)。 - 变异删除全空行状态推进:
Tests 1 failed | 2 passed (3)。