通讯录插件

多平台身份映射与通讯录同步管理。

概述

通讯录插件是 OpenVort 的核心插件（不可禁用），负责管理团队成员在不同 IM 平台上的身份映射。同一个人可能在企微、钉钉、飞书上有不同的用户 ID，通讯录插件将它们统一关联。

工具列表

工具名	功能	说明
`contacts_sync`	同步通讯录	从外部平台（企微/钉钉/飞书）拉取成员列表并导入
`contacts_search`	搜索成员	支持姓名、昵称、称谓的模糊匹配
`contacts_match_suggestions`	查看匹配建议	系统自动识别的跨平台身份匹配建议
`contacts_resolve_match`	处理匹配	接受或拒绝跨平台身份匹配建议
`contacts_bind_identity`	绑定身份	手动将成员与某个平台的用户 ID 关联

核心功能：跨平台身份映射

团队成员通常在多个 IM 平台都有账号。通讯录插件解决的核心问题是：让 OpenVort 知道"企微里的张三"和"钉钉里的 zhangsan"是同一个人。

成员：张小明
  ├── 企微 ID: ZhangXiaoming
  ├── 钉钉 ID: dingxiaoming
  └── 飞书 ID: feishu_zhang

有了身份映射，AI 员工就能：

在企微收到消息后，用飞书回复同一个人
在 VortFlow 中分配任务时，自动关联正确的成员
生成工作汇报时，跨平台汇总同一个人的活动

使用场景

首次同步

连接 IM 通道后，首先同步通讯录：

用户: 帮我同步一下企微的通讯录

AI: 好的，正在从企微拉取成员列表...
  同步完成：
  - 新增 25 位成员
  - 更新 3 位成员信息
  - 发现 5 条跨平台匹配建议（需要你确认）

处理匹配建议

系统会根据姓名、手机号等信息自动建议跨平台匹配：

用户: 看看有哪些匹配建议

AI: 共 5 条待确认的匹配建议：
  1. 企微「张小明」← → 钉钉「zhangxm」（姓名匹配）
  2. 企微「李小红」← → 飞书「lixh」（手机号匹配）
  ...
  要接受全部建议还是逐一确认？

手动绑定

用户: 帮我把钉钉的 wangwu 绑定到王小刚

AI: 已将钉钉用户 wangwu 绑定到成员「王小刚」。

CLI 命令

通讯录也可以通过 CLI 管理：

openvort contacts sync      # 同步通讯录
openvort contacts list      # 列出所有成员
openvort contacts match     # 查看匹配建议
openvort contacts accept    # 接受匹配建议
openvort contacts reject    # 拒绝匹配建议