项目客服设置
客服二维码与接待链接
将二维码放到网站、公众号或宣传材料中，客户扫码后会进入本项目绑定的微信客服。
人工客服（本项目独立配置）
上传可向咨询客户公开发送的人工客服二维码。AI 无法解决或客户要求真人时，发送图片供长按识别，AI 继续接待。请勿上传仅付费会员可见的入群二维码。
模拟咨询
使用已保存的配置测试，答复直接显示在下方，不会发给微信客户。
内部客服工作台
登录后管理项目、人设与知识，查看会话并接管客服。
聊
选择一个会话
左侧选择客户，在这里查看聊天记录。
微信接入
为微信客服选择对应项目，即可使用该项目的知识和回复规则。
首次接入说明
服务域名：kefu.zzdv.com 回调地址：https://kefu.zzdv.com/callback
首次开通、API 授权和回调设置仍在企业微信官方后台完成。公众号入口绑定也需要在官方后台操作。完成后，日常客服配置在这里管理。
＋ 新建微信客服账号
新建微信客服账号
创建会实际新增微信客服账号。头像限 PNG/JPEG，2 MB 内。创建后同步列表并绑定项目。
高级：通过账号编号手动绑定
手动绑定现有账号
发送状态
消息同步状态
运行日志
按任务或会话追踪收消息、媒体识别、回复生成、重试和发送。日志只记录诊断信息，不保存客户原文、授权码、密钥或完整 AI 输入输出。
使用指南
怎样像微信一样查看会话？
左侧选择客户，右侧显示聊天。打开会话时定位最新消息；向上滚动查看历史，到顶部自动加载更早记录。查看旧消息时，刷新不会将你拉到底部，点击「新消息」或「回到最新消息」即可跳回。手机上点客户进入聊天，点「会话」返回列表。客户备注、教 AI 回复和任务日志收在右上角「客户资料」；接管后在底部输入回复，Enter 换行，Ctrl / ⌘ + Enter 发送。
客户连续发几条消息，会怎样回复？
客户停顿约 3 秒后开始处理。如果 AI 生成时又收到补充问题，会合并后重新生成；已生成但尚未发送的旧回复也会更新。最终在一条回复中回答这批问题。已经开始发送或已发送的回复无法撤回，后续消息会结合已答内容继续处理。
客服怎样兼顾销售与快速回复？
客服根据客户目标解释真实价值、回应顾虑，客户明确想购买时给出付款链接和下一步。普通咨询使用快速回复，复杂问题深入处理。核心资料完整保留，补充文档按问题检索；修改本地资料后下次生成会使用新版本。顶部出现知识资料异常时，可点击查看日志。
客服怎样查询家谱门订单和权益？
客户访问 https://jiapu.men/support-link，登录后同意生成一次性客服授权码，点击「复制授权消息」，将整段说明连同授权码发给家谱门客服。有效期10分钟，关联后查询权限有效30天，可在同页撤销。AI 每次查询本人订单、权益及服务进度；普通咨询不要求关联账号。这里查询的是业务系统记录，不代表刚刚向支付平台查单，也不能退款或改权益。
怎样教 AI 回复？
打开会话中的「教 AI 回复」，填写你的处理方法，点击「让 AI 理解并整理」。核对适用场景、回复原则及待核实点，可直接修改，再点击「确认并学会」。经验只用于本项目后续生成，不会自动发送给当前客户，也不改写已有草稿。过期经验可停用。个人需求仍放在客户备注中。AI 会深入分析项目资料与客户顾虑，给出实用下一步，不虚构价格、效果或优惠。
本机客服为核心：项目资料、客户历史和回复处理保存在 Mac；服务器负责微信消息收发与离线暂存。本机断网或关机时暂停回复，上线后接续处理。
首次使用按下面 4 步操作；配置完成后，日常主要看「客服会话」。
配置项目
打开「项目设置」→「＋ 新建项目」，填写项目名称、客服说话风格、产品与售后知识，以及人工联系方式。先选「审核草稿」，点击「保存配置」。每个项目分别填写自己的内容。已绑定本地项目时，按页面显示的本地文件维护资料，下一次生成会重新读取。
绑定微信客服
打开「微信接入」，在对应客服账号下选择所属项目，点击「绑定项目」。绑定后回到「项目设置」，即可查看、下载客服二维码或复制接待链接。每个项目的二维码对应其绑定的微信客服；没有绑定时不能生成。已有绑定的账号可跳过这一步。
没有账号时，展开「＋ 新建微信客服账号」，填写名称并上传头像，创建后再绑定项目。绑定后暂不支持在后台直接更换项目。
测试回复
回到「项目设置」，在「模拟咨询」输入客户常问的问题，点击「测试回复」。答复会显示在下方，不会发给微信客户。不满意就补充知识再测试；本地资料请修改对应项目文件，后台填写的知识请先保存。
处理客户咨询
打开「客服会话」，按项目或「待审核」筛选，选择会话。支持按客户、备注或历史消息搜索，使用上一页、下一页查看更早的会话，打开会话后可「加载更早记录」。核对或修改草稿后点击「确认并发送」。需要自己回复时，点击「接管会话」；处理完后点击「恢复 AI」。
回复模式怎么选？
- 审核草稿：AI 起草，你确认后才发送，适合刚开始使用。
- 自动回复：AI 生成后直接发送，适合知识和回复已验证稳定的项目。
- 暂停：暂停该项目的 AI 回复。已有咨询可在会话里人工处理。
修改配置后点击保存才会生效；保存改动会取消尚未发送的旧草稿。编辑中的回复仅在当前页面暂存，关闭或刷新页面前请先处理。
客户没有收到回复，先看哪里？
- 顶部显示「AI 客服离线」：检查运行客服服务的 Mac 是否开机联网，以及 Veee 网络代理是否可用。
- 处于「审核草稿」模式：需要在会话中确认发送；「人工接管」中的会话需要人工回复。
- 显示生成异常：点击任务旁的「查看任务日志」，可查看具体错误、耗时及重试情况；也可在「运行日志」按任务编号查询并下载诊断记录。系统最多自动尝试 3 次，仍失败后可检查原因并「重试生成」。生成重试与微信发送重试是两回事。
- 出现发送异常：去「微信接入」查看发送状态。若是「发送结果未知」，先在微信核对是否收到，再选择对应结果，避免重复发送。
还需要去微信官方后台吗？
日常项目知识、回复模式、会话审核和人工接管都在这里管理。首次开通、API 授权、回调设置，以及公众号咨询入口的配置，仍需在微信官方后台完成。当前服务域名为 kefu.zzdv.com。
客户历史和备注保存在哪里？
客服数据库保存在 Mac 的 autoKefu/data-core 中。已绑定的本地项目还会在 .autokefu/customers 下保存每位客户的会话、备注及回复依据；模拟咨询有单独标记。会话中的「客户备注」可记录已确认需求和处理进度，下一次生成会参考备注及近期对话。已生成的草稿不会因资料更新自动改写，请发送前核对。
图片、语音和测试会话在哪里处理？
图片会交给 AI 分析，语音由本机调用 MiniMax ASR 转写，失败时使用本机 Whisper 兜底，再交给 AI 回答。识别不清时会请客户补充说明。确需人工核实时登记「后续跟进」，可邀请客户自愿留下联系方式，AI 继续辅助；工作人员点击「接管会话」后才停止 AI。模拟咨询默认不出现在会话列表，勾选「显示模拟咨询」即可查看。