请问在 Letstalk 的 PC 客户端中，应该怎样一次性移除列表中重复添加的好友？

功能解析：重复联系人为何会导致运营效率低下

在 Letstalk IM 的加密社交场景里，一个钱包地址常因多次扫码进群而被反复保存为独立名片。电脑版左侧联系人栏每多一条冗余记录，搜索索引就得多做一次哈希比对。经验性观察显示，当重复率超过 15% 时，冷启动搜索延迟会从亚秒级滑到 1.2–1.8 秒；对日更 200 条公告的 Web3 社群运营者而言，成员每次 @ 管理员都要多等一拍，答疑效率被肉眼可见地拉低。

批量删除的操作并不只是简单地“勾选并移除”，其背后还涉及到持续保存聊天记录、钱包红包流水以及NFT门禁权限等数据。在此基础上，将分散的名片信息整合为唯一的主档案。Letstalk 官方将这一流程集成至“联系人去重”功能中，且该功能仅在电脑客户端提供；这是因为桌面版支持左右并排比对，能有效降低误操作删除的风险。

执行前确认：有哪些特定情形是必须优先完成数据备份的？

1. 要不要启用「私密保险箱」功能

如果某位联系人的完整聊天记录此前已归档至保险箱，在进行去重处理后，原始消息ID将发生重定向，虽然保险箱功能依然正常，但历史记录的水印会变为“Merged ID”。鉴于DAO财务官可能需要追溯链上红包的来源，建议在执行合并操作前，先从保险箱导出相关记录至.md文件，以确保审计链路完整无断点。

2. 检查是否仍处于进行中的链上红包活动参与状态

处于待处理状态的USDT红包关联着联系人的钱包地址。地址合并操作完成后，原地址会显示为“已归档”，虽然红包依然可以领取，但在链上浏览器中查看交易详情时，TxFrom字段会更新为新的主地址。对于合规性要求严格的企业群组，建议暂时停止发放新红包，待所有待处理红包均被领取后，再进行地址去重操作。

操作指南：Windows 系统与 macOS 系统的快速启动入口

适用于 Windows 10 或 11 系统

1. 请依次点击主面板右上角的「⚙设置」，进入「数据管理」后选择「联系人去重」。
2. 初次启动时会出现“本地索引构建”的进度提示，处理约十万条联系人数据通常需要几十秒，具体耗时取决于SSD硬盘的性能。
3. 构建结束后，左侧列表会出现重复分组的情况。系统默认依据“钱包地址及首字母”进行归类，你也可以通过顶部选项将其更改为基于“手机号哈希”或“邮箱哈希”的聚合方式。
4. 首先选中需要合并的项目，接着点击右下角的“合并选中”按钮，最后在弹出的窗口中指定哪一条作为主记录予以保留。
5. 确认操作后，系统将在安装目录下的 MergeLog 子文件夹中生成带时间戳的本地日志文件（MergeLog），以便后续进行审计。

macOS 12 及以上版本

1. 请在顶部菜单栏依次点击：Letstalk 菜单 → Preferences → Data → Contacts →「Find Duplicates」。
2. 接下来的操作和 Windows 平台一致，不过合并按钮的文字显示为「Merge」。
3. 一旦激活“文件保险箱”的全盘加密机制，MergeLog 会将数据同步至支持 Time Machine 备份的卷中；在进行数据恢复时，只需将文件放回原始路径即可完成回滚操作。

数据合并方案解析：涵盖三项内置规则及自定义应用场景

向导提供“保留信息最完整”“保留最近互动”“保留最早创建”三种官方规则。多数社群运营者选“最近互动”，因为 NFT 门禁群常踢掉旧地址再拉新地址，可确保 @ 功能指向最新钱包。若你管理的是投研频道，需要最早创建时间以匹配早期私募记录，可切换规则后再跑一次，系统会提示“已合并的条目不再重复处理”，避免循环。

以某游戏公会要求“仅保留包含 ENS 域名的记录”为例，鉴于 Letstalk 不支持直接识别 ENS，建议操作如下：首先点击页面右上角的“Export”按钮导出 CSV 文件，随后在本地通过脚本筛选出含有“.eth”后缀的条目，最后手动选中这些条目进行合并。需要说明的是，导出的数据仅包含昵称、地址的前后各四位以及创建时间，不附带任何私钥信息，完全符合隐私合规标准。

回退操作与日志分析：怎样取消错误的合并

提交合并操作后，服务器上的聊天记录不会被删除，但本地索引会即时更新。如果操作失误，用户可在 30 天内借助 MergeLog 进行回退：先关闭客户端，然后将相关日志文件拖拽到启动图标上，当出现“检测到回退标记”提示时，点击「Undo Merge」即可。回退完成后，原被合并的旧记录将恢复为独立条目，但在此期间产生的新消息仅保存在主记录中，用户需自行将其复制出来。

性能监控：确认去重机制是否提升了检索效率

基于实践观察，搜索结果去重带来的延迟降低效果与数据重复率呈正比关系。为验证这一优化成效，您可以按以下步骤进行实测：首先在数据合并前，选取三个常见的中文词汇，通过顶部搜索栏各查询5次并记录平均响应时间；合并数据后，使用相同的三个词汇再次各查询5次。如果平均响应时间能从1.5秒显著缩短至0.6秒，则说明优化达到预期。尽管测试样本量有限，但这种提升足以让日常使用体验从明显的延迟卡顿转变为即时响应。

如需更严谨的数据，可打开「设置→高级→诊断日志」，开启后将生成 Debug_SearchLatency 字段，单位毫秒。关闭日志后文件会自动删除，避免占用磁盘。

适用性局限：在什么情况下应停止执行批量合并操作

• 当联系人总数少于500且重复比例低于5%时，采用手动滑动删除的方式效率更高；
• 当前群聊正通过 SnapVote 插件进行匿名投票，若后续合并钱包导致地址变更，可能会引发投票权归属混乱；
• 鉴于你将在未来 7 天内导出全量数据以配合合规审计，若此时进行合并操作，将会导致 MergeLog 的时间戳发生变化，从而加大后续的解释难度；
• 若便携式（Portable）版本存储在 U 盘中，在重建索引期间若频繁插拔设备，极易引发“数据库锁定”异常，因此推荐先将其复制至本地硬盘进行操作。

探讨第三方机器人协作机制：官方为何拒绝提供API接口

Letstalk 的联系人索引采用本地 LMDB + 加密哈希，官方未开放写权限给任何第三方 Bot。经验性观察发现，部分社群试图用“第三方归档机器人”导出全部名片再做外部去重，结果因哈希盐值不同，导回时全部被判为新记录，导致重复率反升。官方 GitHub 曾回复 #4112：合并操作必须走本地向导，确保钱包地址与 DID 映射一致性。换言之，不要尝试用脚本绕过，时间成本更高。

问题诊断：合并按钮呈现灰色且无法响应点击事件

现象	可能原因	验证步骤	处置
按钮灰色	本地索引未构建完	检查进度条是否已加载至百分之百	建议您稍作等待，或者重启客户端后再次尝试进入
弹窗“钱包冲突”	当前选中的项目涉及多个不同的钱包账户。	检索地址的前六位字符	拆分组再合并
合并后搜索不到	主记录昵称被清空	看主记录详情页	手动补充昵称并完成索引重建

上线前 10 分钟必查清单：最佳实践指南

1. 请核实所有待处理的红包状态均已关闭；
2. 将数据导出为 CSV 格式以备存档，并在生成的文件名中包含日期信息。
3. 关闭“后量子加密”选项，以降低 CPU 的资源消耗；
4. 在搜索栏中分别输入3个常用关键词进行试用测试，并记录下每次搜索所花费的时间；
5. 选择应用“最近互动”规则，随后进行合并操作；
6. 随后对另外3个关键词进行测试，预计响应延迟会有所降低；
7. 请将 MergeLog 上传至群共享文件夹，以便进行审计。
8. 恢复启用“后量子加密”功能；
9. 公告栏置顶通知：统一使用新的钱包地址，请务必警惕利用旧地址进行的诈骗行为；
10. 72 小时内观察 @ 功能报错率，若高于 1%，考虑回退。

常见问题解答：关于电脑端去重功能的那些事儿

总结与下一步行动

Letstalk 电脑版的批量删除重复联系人功能，本质是用本地加密索引做“合并而非删除”，在保留聊天记录与链上权限的前提下，把搜索延迟压回亚秒级。对 Web3 社群、DAO 财务、游戏公会等高互动场景，季度跑一次去重，能显著降低 @ 错误与红包误发。

依据本指南，请在电脑客户端依次进入「设置 - 数据管理 - 联系人去重」，执行导出、合并及验证操作。如果期间有群红包处于待处理状态，建议暂缓发放，待数据合并完毕后再行恢复。此外，务必将合并日志保存至共享驱动器，以便应对日后的合规审查。最后，建议同步启用「后量子加密」功能，为你的通讯记录全面升级至量子级别的安全防护。