AI 创建 Android 联系人并检查重复：从字段提取到 FoneClaw 确认保存
用 FoneClaw 在 Android 上创建本机联系人前，先整理姓名、电话或邮箱，检查已有记录，经用户批准后直接写入并核对结果；公司、职位、备注和跨账号处理需在通讯录中手动完成。
- AI 创建 Android 联系人并检查重复，应按五步走：提取来源信息、整理姓名及电话或邮箱、检查已有记录、审阅本机创建提案、批准后写入并核对结果。
- 联系人不是一段自由文本。Android 通讯录由账号、原始联系人和姓名、电话、邮箱、组织、备注等数据行组成，字段越清楚，重复检查和后续编辑越可靠。
- 重复检查是决策辅助：FoneClaw 创建工具遇到已有的完全相同电话或邮箱会阻止重复创建；姓名等线索仍需人工判断，更新或合并应转到通讯录中处理。
- FoneClaw 支持经批准直接创建一条设备本地联系人，需要联系人读写权限、姓名及至少一个电话或邮箱；保存后应打开记录核对，不代表已同步到 Google 或工作账号。
先创建一条已确认且不重复的联系人
AI 创建 Android 联系人并检查重复，最实用的流程可以从一个具体场景开始：你收到一条短信，“我是林悦，星河设计，手机号 13800138000，邮箱 yue.lin@example.com，下周对接报价。”这时不要把整段话直接塞进通讯录，而是让 FoneClaw 先提取候选姓名、电话和邮箱，按姓名或电话查找已有记录；创建工具还会检查完全相同的电话或邮箱，防止重复写入。
我们建议按五步处理。第一，选定信息来源，可以是短信、聊天截图、邮件签名、会议笔记或你口述的一段内容。第二，整理姓名、电话和邮箱，公司、职位、备注等额外信息单独留作审阅。第三，检查已有记录与可能重复项。第四，审阅将创建在设备本地的联系人。第五，经用户批准后写入，再搜索并打开保存结果核对。
FoneClaw 支持直接创建一条设备本地 Android 联系人，需要姓名及至少一个电话或邮箱，并要求用户批准。若已有完全相同的电话或邮箱，创建工具会阻止重复创建；它不提供任意保存账号选择，也不自动更新或合并已有联系人。需要补充公司、职位、备注或处理已有记录时，应转到通讯录中手动操作。
联系人写入属于会改变手机数据的动作。FoneClaw 会把它放在可见确认流程里，而不是把一句“帮我存一下”直接变成静默写入。关于高影响手机动作为什么需要理由、确认和恢复入口，可以继续阅读AI Agent 操作确认界面设计：建议、置信度、理由与手机恢复流程。
把消息签名或笔记整理成联系人字段
联系人创建的质量，取决于字段整理是否清楚。Android 通讯录并不是只保存一个“联系人文本块”。根据Android Contacts Provider 文档，联系人数据会涉及聚合联系人、账号内的原始联系人，以及姓名、电话、邮箱等类型化数据行。普通用户不需要记住这些底层名词，但需要理解一个结果：姓名、号码、邮箱、公司和备注最好分开确认。
从消息签名里提取联系人时，要先区分确定信息和需要用户判断的信息。比如“张凯｜华南渠道｜WeChat 同号｜下周寄样品”里，张凯是姓名，华南渠道可能是部门或备注，WeChat 同号说明手机号和微信号可能相关，但它不等于一定存在一个可写入的微信字段。FoneClaw 的直接创建工具接收姓名、电话和邮箱；其余信息可以整理供审阅，但不代表能由该工具保存。
电话和邮箱尤其要保留原始语义。一个数字可能是手机号、办公室电话、分机、订单号或会议号；一个邮箱可能属于个人、团队或客服邮箱。AI 的任务是帮用户把来源信息整理成候选字段，并标出不确定处。确认号码与邮箱含义后，再进入重复检查；公司、职位和备注如需保存，应在通讯录支持的字段中手动补充。
一个实用输入方式是这样说：“从这条短信整理联系人候选，姓名林悦，手机号和邮箱按短信提取，公司星河设计和下周对接报价单独列出供我核对，先不要保存。”这种表达让 FoneClaw 知道来源、字段和停止点。若来源是多条短信，可以先让 FoneClaw 汇总上下文；相关短信整理方法可以参考AI 汇总 Android 短信指南：按时间范围整理收件箱、找出待回复消息。
我们的FoneClaw 从名片照片创建联系人演示以识别 Mike Anderson 并创建联系人为例。名片可提取姓名、电话、邮箱、公司和职位，但提取到额外字段不等于这些字段已写入。实际操作时，先审阅识别结果，缺失内容留空，再批准保存姓名及电话或邮箱，最后打开本机记录核对。重复查询、保存后回查，以及需要云端账号时在通讯录中手动选择受支持的复制或移动方式，是我们建议补充的检查，不是对视频中已展示步骤或完成速度的声明。
写入前检查精确匹配和可能重复项
重复检查要分两层：精确匹配和可能匹配。FoneClaw 的创建工具会检查已有的完全相同电话或邮箱，命中时阻止重复创建。联系人列表查询支持按显示姓名或电话号码筛选，返回数量有限，不支持把邮箱作为查询条件。需要按邮箱查找或补充已有记录时，应在通讯录中手动核对和编辑。
可能匹配还可以结合姓名、公司、职位、昵称或备注人工判断。比如“王磊”这个名字很常见，单靠姓名无法确认同一个人；“王磊，星河设计”和“王磊，设计顾问”更接近，但仍需要看电话、邮箱或上下文。这些是身份核对线索，不代表 FoneClaw 能按公司、职位或备注搜索通讯录。
Android 的联系人系统本身会进行聚合。ContactsContract.RawContacts 参考文档说明，姓名、组织、电话、邮箱或昵称等变化可能触发重新聚合。这个机制有助于把相关记录显示在一起，但聚合结果仍然依赖数据质量和账号结构。对于真实用户来说，聚合相近记录不等于证明两个条目属于同一个人。
Google Contacts 也提供重复联系人建议和合并入口。Google Contacts 合并重复联系人帮助说明，用户可以查看建议并决定是否合并；同时，不同 Google 账号中的联系人在该流程里有账号边界。这是通讯录应用的能力，不是 FoneClaw 直接创建工具提供的合并或更新功能。
| 匹配信号 | 适合怎样判断 | 保存前动作 |
|---|---|---|
| 相同手机号 | 强重复信号，也可能是家庭、前台或共享业务号码 | 创建工具会阻止完全相同号码的重复创建；到通讯录核对已有记录 |
| 相同邮箱 | 强重复信号，团队邮箱需要额外核对 | 创建工具会阻止完全相同邮箱的重复创建；按邮箱查找或补充记录需在通讯录手动处理 |
| 相同姓名 | 可能重复，不能单独认定 | 结合电话、邮箱、公司、来源消息继续判断 |
| 相同公司或职位 | 辅助线索，适合缩小范围 | 在通讯录中手动查看相关记录，不作为 FoneClaw 列表查询条件 |
| 相似备注 | 可提示上下文相关 | 保留来源和时间，避免误合并不同联系人 |
确认保存账号、字段和动作
联系人保存到哪个账号，会影响它出现在哪里、如何同步、能否在其他设备看到，以及以后如何合并或迁移。Android 手机上可能同时有本机账号、Google 账号、工作资料账号、厂商账号或企业管理账号。FoneClaw 的直接创建工具保存的是设备本地联系人，不提供任意账号选择。需要放入其他账号时，应先核对本机记录，再按通讯录应用和账号支持的方式手动复制或移动。
批准前应确认四件事：本次创建的是本机联系人，姓名和电话或邮箱是否正确，是否发现已有记录，以及是否仍要继续创建。若已存在完全相同的电话或邮箱，不应反复提交；需要补充已有联系人时，转到通讯录中手动编辑。创建批准不包含更新、合并或账号迁移。
字段级确认同样重要。直接创建前应核对显示姓名、国家区号、电话号码和邮箱，不确定内容留空；姓名和至少一个电话或邮箱必须具备。公司简称、职位和备注可以先整理供审阅，再在通讯录中手动补充。不要把识别结果中出现了这些信息当成已经保存。
权限是写入动作的基础。FoneClaw 直接创建联系人需要 READ_CONTACTS 和 WRITE_CONTACTS 两项 Android 权限，并且必须获得动作批准；权限缺失或审批未通过时，不能把任务视为已完成。想理解为什么手机 Agent 即使安全设计良好也需要系统权限边界，可以继续读AI Agent 沙箱与 Android 权限：运行隔离、手机授权和动作确认怎么分清。
用 FoneClaw 直接创建已批准联系人
FoneClaw 支持不打开其他 App，直接通过 Android Contacts Provider 创建一条已批准的设备本地联系人。输入需包含显示姓名，以及至少一个电话号码或邮箱地址；联系人读写权限和用户批准都不可缺少。创建前若发现完全相同的电话或邮箱，工具会阻止重复写入。
一次完整指令可以这样说：“从这条短信整理联系人候选，姓名林悦，手机号和邮箱按短信提取。先按姓名或电话查找已有记录，创建前检查重复，保存到本机前让我确认。公司和下周对接报价单独列出，不写入联系人。”核对候选字段后再批准创建；如需保存额外字段或处理已有记录，转到通讯录手动完成。
直接创建的范围是姓名、电话和邮箱，不包含自动更新、合并或选择 Google、工作等目标账号。批准后要查看工具结果，再打开本机联系人核对实际字段。具体支持范围可以在FoneClaw 功能页查看。
可以先用一条来源明确、已获同意的联系人信息做小范围验证：只创建一条本机记录，不发送消息、不拨号、不创建日历事项。核对姓名、电话或邮箱正确且没有重复后，再决定是否在通讯录中手动补充其他信息。这是建议的验证流程，不是已完成的设备测试或耗时承诺。
处理共用号码、国际格式和跨账号联系人
重复值并不总是错误。一个家庭成员可能共用固定电话，一个公司前台号码可能属于多个联系人，一个客服邮箱可能代表整个团队。但 FoneClaw 的直接创建工具遇到已有的完全相同电话或邮箱仍会阻止创建，不会提供绕过检查的独立保存。确需保留共用号码的不同联系人时，应在通讯录中手动核对并按应用支持的方式处理。
国际格式也要谨慎处理。号码中的国家区号、前导零、分机、空格和短横线会影响显示和拨打。AI 可以帮助标准化格式，但不能改变用户提供的真实号码含义。比如 “+86 138 0013 8000” 和 “13800138000” 在中国手机号场景下可能指向同一号码；带分机的办公电话则需要把主号码和分机拆清楚。
跨账号联系人是另一个常见边界。同一个人可能同时存在于个人 Google 账号和工作账号中。Google Contacts 的合并流程对不同 Google 账号有边界，企业账号还可能受到管理策略影响。FoneClaw 直接创建的是本机记录；如需复制或移动到其他账号，应在通讯录中手动选择受支持的操作，并核对目标账号和同步状态。
还有一种情况是信息不完整。只有名字和公司时，可以先整理联系人候选，但不能通过 FoneClaw 的直接创建工具保存，因为还缺少电话或邮箱。可以先保留来源信息，等待补齐再创建；公司、备注等内容如需写入联系人，仍需在通讯录中手动处理，不应猜测缺失字段。
如果权限、同步或通知状态影响联系人创建，用户可以先做一次手机状态检查。AI 检查 Android 手机健康：耗电、发热、权限和通知声音排查指南提供了权限和设备状态排查思路，适合在联系人读取或写入入口缺失时使用。
保存后核对结果并安全恢复
联系人创建完成后，验证点应该是可见记录，而不是一句“已保存”。可以按姓名或电话查找，再打开本机联系人核对姓名、电话和邮箱；若要按邮箱查找，应使用通讯录应用支持的手动搜索。公司、职位和备注若由你另行补充，也要分别检查，不能从提取结果推断它们已经写入。
重复预防也包括写入后的复查。创建完成后，在通讯录中再次核对相同号码或邮箱，确认是否出现两个独立条目；如果系统把原始联系人聚合到已有联系人下，也要打开聚合后的记录查看显示是否符合预期。对于工作联系人，最好再发起一个低风险操作，例如准备短信草稿但不发送，确认联系人名和号码能被正确识别。
遇到不确定结果时，先检查再重试。联系人显示筛选、权限中断或通讯录界面刷新都可能影响记录的可见性；本机保存也不等于云端同步完成。先按姓名或电话重新查询，并在通讯录中打开记录确认。需要修改、补充、删除或迁移时，使用通讯录应用支持的手动操作，不要反复创建或假定 FoneClaw 会自动修复。
- 用姓名或电话查找保存结果；按邮箱查找时使用通讯录支持的手动搜索。
- 打开联系人，确认是本机记录并核对姓名、电话和邮箱。
- 检查是否存在同名、同号或同邮箱的重复项。
- 需要修改或补充其他字段时，在通讯录中手动处理。
- 结果不确定时先刷新或重新搜索，再决定是否重试创建。