功能定位：为什么重复联系人会拖慢运营
在 Letstalk IM 的加密社交场景里，一个钱包地址常因多次扫码进群而被反复保存为独立名片。电脑版左侧联系人栏每多一条冗余记录，搜索索引就得多做一次哈希比对。经验性观察显示，当重复率超过 15% 时，冷启动搜索延迟会从亚秒级滑到 1.2–1.8 秒；对日更 200 条公告的 Web3 社群运营者而言，成员每次 @ 管理员都要多等一拍，答疑效率被肉眼可见地拉低。
批量删除并非简单的“选中-删除”，而是要在保留聊天记录、钱包红包记录、NFT 门禁权限的前提下，把多条名片合并成一条主记录。Letstalk 官方把这套逻辑封装在“联系人去重”向导里，入口仅放在电脑版——桌面端能同屏展示横向对比表，误删概率更低。
前置检查：什么情况下必须先做备份
1. 是否开启「私密保险箱」
若目标联系人曾整条聊天被存入保险箱，去重后原消息 ID 会被重新映射，保险箱入口仍可用，但历史水印会显示“Merged ID”。对需要审计链上红包来源的 DAO 财务官，建议先去保险箱把相关记录导出为 .md，再做合并，以免审计追踪断档。
2. 是否参与未完结的链上红包
进行中（Pending）状态的 USDT 红包以联系人钱包地址为索引。合并后，旧地址会被标记为“已归档”，红包仍可领取，但浏览器链上查看时，TxFrom 字段将指向新主地址。对合规要求高的企业群，可先暂停发放新红包，待所有 Pending 完成后再执行去重。
操作路径：Windows 与 macOS 的最短入口
版本前提
以下截图与菜单位置基于 Letstalk 电脑版截至当前的最新版本（安装包签名日期 2026-02-24）。若你的客户端早于 2025-12，请先到官网下载重新安装，否则看不到“去重”按钮。
Windows 10/11
- 主面板右上角「⚙设置」→「数据管理」→「联系人去重」。
- 首次进入会弹“本地索引构建”进度条，十万级联系人约需数十秒，视 SSD 性能而异。
- 构建完成后，左侧出现重复分组，默认按“钱包地址+首字母”聚合，可在顶部切换为“手机号哈希”或“邮箱哈希”。
- 勾选需要合并的条目→右下角「合并选中」→弹窗确认保留哪一条为主记录。
- 确认后，系统会生成一条“MergeLog”本地日志，路径在安装目录下 MergeLog 子文件夹，文件名带时间戳，可供后续审计。
macOS 12+
- 顶部菜单栏 Letstalk → Preferences → Data → Contacts →「Find Duplicates」。
- 后续步骤与 Windows 相同，但合并按钮文案为「Merge」。
- 若开启“文件保险箱”全盘加密，MergeLog 会额外写入 Time Machine 可备份的卷，还原时可直接放回同路径实现回退。
合并策略：三种默认规则与自定义场景
向导提供“保留信息最完整”“保留最近互动”“保留最早创建”三种官方规则。多数社群运营者选“最近互动”，因为 NFT 门禁群常踢掉旧地址再拉新地址，可确保 @ 功能指向最新钱包。若你管理的是投研频道，需要最早创建时间以匹配早期私募记录，可切换规则后再跑一次，系统会提示“已合并的条目不再重复处理”，避免循环。
自定义场景示例：某游戏公会要求“保留含 ENS 域名的那条”。由于 Letstalk 并未内置 ENS 识别，你可先导出 CSV（同一页面右上角「Export」），在本地用脚本筛出含“.eth”字段，再手动勾选对应条目进行合并。导出文件不含私钥，仅含昵称、地址前 6 后 4 位、创建时间，符合隐私合规。
回退与日志：如何撤销一次误合并
合并一旦提交，服务器端不会同步删除任何聊天记录，但本地索引会立即重写。若发现误操作，可在 30 天内使用 MergeLog 回退：关闭客户端→将对应日志文件拖入启动图标→弹出“检测到回退标记”→选择「Undo Merge」。回退后，被合并的旧记录会恢复为独立条目，但期间产生的新消息只会保留在主记录里，需要手动复制。
注意
回退操作只能执行一次，重复拖入同一日志会被拒绝，防止循环索引膨胀。
性能观测：如何验证去重后搜索变快
经验性观察表明，去重后搜索延迟下降幅度与重复率正相关。你可复现以下步骤：在合并前，随便选 3 个汉字关键词，用顶部搜索框各执行 5 次，取平均耗时；合并后，再执行同样关键词 5 次，若延迟从 1.5 秒降至 0.6 秒，即视为优化成功。样本虽小，却足以让日常体感从“卡顿”回到“秒出”。
如需更严谨的数据，可打开「设置→高级→诊断日志」，开启后将生成 Debug_SearchLatency 字段，单位毫秒。关闭日志后文件会自动删除，避免占用磁盘。
不适用场景：何时应该放弃批量合并
- 联系人总量低于 500 且重复率不足 5%，手动滑动删除更快；
- 群聊内正在进行匿名投票（SnapVote 插件），合并后钱包地址变动会导致票权错位；
- 你即将在 7 天内进行全量数据导出做合规审计，此时任何合并都会改变 MergeLog 时间戳，增加解释成本；
- 电脑版为便携版（Portable）且安装在 U 盘，索引重建时频繁拔插会触发“数据库锁定”错误，建议先复制到本地硬盘。
与第三方 Bot 的协同：为什么官方不开放 API
Letstalk 的联系人索引采用本地 LMDB + 加密哈希，官方未开放写权限给任何第三方 Bot。经验性观察发现，部分社群试图用“第三方归档机器人”导出全部名片再做外部去重，结果因哈希盐值不同，导回时全部被判为新记录，导致重复率反升。官方 GitHub 曾回复 #4112：合并操作必须走本地向导，确保钱包地址与 DID 映射一致性。换言之，不要尝试用脚本绕过，时间成本更高。
故障排查：合并按钮灰色无法点击
| 现象 | 可能原因 | 验证步骤 | 处置 |
|---|---|---|---|
| 按钮灰色 | 本地索引未构建完 | 看进度条是否 100% | 等待或重启客户端再进 |
| 弹窗“钱包冲突” | 选中条目含不同钱包 | 查看地址前 6 位 | 拆分组再合并 |
| 合并后搜索不到 | 主记录昵称被清空 | 看主记录详情页 | 手动补昵称，重建索引 |
最佳实践清单：上线前 10 分钟检查表
- 确认所有 Pending 红包已完结；
- 导出 CSV 留档，文件名带日期；
- 关闭“后量子加密”开关，减少 CPU 占用；
- 用搜索框预演 3 个高频关键词，记录耗时；
- 选“最近互动”规则，执行合并；
- 再测 3 个关键词，延迟应下降；
- 把 MergeLog 复制到群共享盘，供审计；
- 重新开启“后量子加密”；
- 公告栏发置顶：钱包地址已统一，谨防旧地址钓鱼；
- 72 小时内观察 @ 功能报错率，若高于 1%，考虑回退。
FAQ：电脑版去重常见疑问
合并后，手机端会同步吗？
手机端不会立即同步索引，需退出账号重新登录，或等待本地缓存 24 小时失效后拉取新索引。
能否只合并昵称，不合并钱包？
官方向导强制把钱包地址一并合并，若需保留多钱包，请放弃去重，改用“备注名”手工区分。
MergeLog 会泄露隐私吗？
日志仅含地址前后 4 位、昵称、时间戳，不含私钥与聊天内容，可放心传群共享盘。
便携版报错“数据库锁定”怎么办？
把安装目录复制到本地 SSD，再运行 letstalk.exe --portable，重建索引即可。
可以定时自动去重吗？
官方未提供自动脚本，API 也无写权限，需手动定期执行，建议季度一次。
总结与下一步行动
Letstalk 电脑版的批量删除重复联系人功能，本质是用本地加密索引做“合并而非删除”，在保留聊天记录与链上权限的前提下，把搜索延迟压回亚秒级。对 Web3 社群、DAO 财务、游戏公会等高互动场景，季度跑一次去重，能显著降低 @ 错误与红包误发。
读完本文，你只需打开电脑版，按「设置→数据管理→联系人去重」走一遍导出-合并-验证三连；若群红包正在 Pending，先暂停发放，待合并完成后再恢复。把 MergeLog 存到共享盘，未来审计就能少一句解释。下一步，不妨把「后量子加密」开关也顺手打开，让通讯录与聊天一起进入量子安全时代。
