deepseek v4微信机器人无法识别电子名片是因未启用msgtype="share"与appmsgtype="contact"解析，需配置白名单、开发名片提取插件、扩展prompt模板、集成ocr识别图片名片，并对接本地通讯录实现同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用DeepSeek V4微信机器人时发现其无法自动识别微信聊天中接收到的电子名片（即联系人卡片），则可能是由于当前消息解析机制未启用或未正确处理微信协议中的msgtype="share"与appmsgtype="contact"类型数据。以下是解决此问题的步骤：
一、启用微信消息类型白名单解析
DeepSeek微信机器人依赖底层框架（如chatgpt-on-wechat）对原始微信协议消息进行结构化解析。默认配置可能忽略名片类消息，需显式开启支持。
1、打开项目根目录下的config.json文件。
2、定位到"message_types"字段，确认其值包含"share"与"contact"。
3、若不存在，手动添加： "message_types": ["text", "image", "voice", "share", "contact"]。
4、保存文件并重启机器人服务。
二、配置名片内容提取插件
微信名片以XML格式嵌套在<appmsg></appmsg>标签内，含<username></username>、<nickname></nickname>、<alias></alias>、<province></province>等关键字段。需通过自定义插件提取并结构化为JSON供DeepSeek调用。
1、在plugins/目录下新建contact_extractor.py文件。
2、写入以下核心逻辑：必须捕获msg.appmsgtype == 43且msg.msgtype == 57。
3、使用xml.etree.ElementTree解析msg.content中的XML字符串。
4、提取username、nickname、alias、province、city、signature六项字段，组装为字典。
5、将该字典注入context["contact_info"]，确保后续prompt可引用{contact_info.nickname}来自{contact_info.province}。
三、修改Prompt模板以支持名片上下文理解
DeepSeek V4模型需明确接收结构化联系人信息才能生成符合场景的响应，如“添加备注”、“发起好友验证”或“归类至客户池”。原始prompt未预留名片字段占位符，必须扩展。
1、打开config.json中"model_args.prompt_prefix"字段。
2、在末尾追加一段条件提示语：若用户发送微信名片，请优先提取其中的昵称、地区、个性签名，并据此判断身份属性（如客户/同事/亲友）；禁止复述原始XML内容。
3、保存后执行python bot.py --reload热重载配置。
四、启用OCR辅助识别图片型名片
部分用户仍会发送截图形式的纸质名片或设计类电子名片图片。此时需调用OCR模块识别文字内容，并与微信原生名片字段融合校验。
1、确保已安装cnocr==2.3.0与opencv-python依赖。
2、在plugins/contact_extractor.py中补充图像路径检测逻辑：当msg.type == "image"且文件名含"businesscard"或"vcard"时，触发OCR识别流程。
3、OCR结果需与微信协议解析出的字段做相似度比对（如昵称+手机号匹配度＞85%），仅当一致时才写入contact_info。
4、识别失败时返回固定话术：“检测到图片名片，但文字模糊，请发送微信原生电子名片以便准确录入”。
五、对接本地通讯录实现双向同步
机器人识别名片后，若需自动保存至手机通讯录或企业CRM，必须打通系统级API。此操作依赖运行环境权限与平台适配。
1、Windows平台：调用pywin32执行Outlook联系人新增命令，需提前授权COM接口。
2、macOS平台：使用osascript执行AppleScript脚本写入Contacts.app，命令中set thePerson's first name to "{contact_info.nickname}"必须存在。
3、Linux平台：暂不支持图形界面通讯录写入，仅可导出CSV至/tmp/deepseek_contacts.csv。
4、所有平台均需在config.json中开启"enable_contact_sync": true开关。
