小V机器人简明操作手册

小V机器人是本项目的微信智能客服界面，支持关键字回复、聊天提炼知识、知识库问答、AI 回复和群管理。

网页版更新：2026-10-21。基础操作说明来自项目用户手册，定时群发与日报步骤按当前界面补充。

1. 第一次使用：按这个顺序操作

登录电脑微信 → 打开程序 → 检查激活状态 → 提取微信密钥 → 配置回复方式 → 导入或提炼知识、添加规则 → 启动服务 → 测试回复。

1. 在 Windows 电脑上打开微信并登录要使用的账号。当前密钥提取针对微信 4.x，具体版本兼容性以程序检测结果为准。
2. 使用发布包时，先完整解压，再双击包内的程序 EXE（发布文件可能仍叫“微信智能客服.exe”）。使用源码版时，双击项目根目录的 start_ui.bat，打开本机控制面板。 首次打开会弹出“使用须知与免责声明”。阅读后勾选确认，再点击“同意并继续”进入功能页面；点击“退出”会退出桌面程序，浏览器版会停止进入功能页面。确认状态保存在本机当前桌面配置或浏览器中，后续打开不再重复弹出；清除本机站点存储、更换浏览器或配置后需要重新确认。
3. 点击左侧 产品激活，检查试用或授权是否有效。有兑换码时，在“卡密兑换”中输入并点击“兑换”。
4. 点击 微信密钥提取，在对应账号右侧点击“提取密钥”，等待出现已保存提示。没找到账号时，确认微信已登录，再点“重新检测”。

在线客服使用时，微信保持登录，电脑保持开机、不要进入休眠，客服服务才能持续运行。只打开面板还不代表客服已启动。授权版如果只是从已有明文库提炼知识，可不登录微信、不启动客服服务，见第 3 节。

2. 选择怎样回复客户

三种方式可以组合使用：

配置 AI（需要 AI 生成回复时）

进入 系统设置 → AI 引擎：

1. 打开“AI 自动回复”，选择自己的“AI 提供商”。
2. 填写该提供商的 API Key。Base URL 和模型可以使用该提供商默认值；自定义接入时，按服务商提供的参数填写。
3. 在“系统提示词”中写清客服身份、业务范围和回复要求，例如：回答简洁，按已有资料作答，不知道的内容不要编造。
4. 点击右上角 保存配置。

仅使用关键字回复或知识库直答时，可以不配置 AI 密钥。调用 AI 产生的费用按所选服务商规则计算。

配置触发方式和未命中处理

在 系统设置 → 客服行为 中设置“触发模式”：

• 仅 @我 触发：群内需要通过微信的 @ 选择器选中机器人账号，再发问题。建议首次使用先选这一项。
• 所有群消息都回复：群内消息进入自动回复流程，实际是否回复还取决于规则、知识命中及其他设置。

关键字规则对私聊和群里 @我 的消息优先匹配，不受 AI 触发模式影响。

在下方 知识库检索 中，重点看这三个选项：

• 启用知识库：打开后才能使用知识库直答或让 AI 参考知识。
• 知识库直答：打开时，满足匹配条件就直接发送原答案；关闭时，可以由 AI 参考知识生成回复。
• 直答未命中时：可选“回复转人工话术”“不回复”或“回落 AI 生成回复”。想让 AI 兜底，应选择“回落 AI”，并配置有效的 AI 密钥。

“转人工话术”只是发送一段提示，仍需工作人员在微信里自行接待，并不代表系统已自动转接给真人。

AI 开关、提示词、模型配置保存后从下一次请求起生效；知识库总开关立即生效。触发模式、知识库直答及其他需重启的配置，保存后到控制台点击 重启。

3. 导入和维护知识库

知识可以从聊天中提炼，也可以用 Excel 导入。已有聊天记录用“聊天提炼知识”，已有整理好的问答用 Excel 导入。

从群聊或私聊提炼知识（新增功能）

进入左侧 聊天提炼知识，或在“知识库管理”中点击 从聊天提炼。

完整流程：选聊天与时间 → 预览消息范围 → AI 生成草稿 → 核对来源并保存审核 → 确认入库。草稿不会直接用于客服回复。

第一步：准备聊天来源

先在 系统设置 → AI 引擎 配置有效的提供商、API Key 和模型。聊天提炼需要调用 AI，即使在线回复只用固定规则，也需要这项配置。

授权版也可以选择“微信原始库（客服服务连接）”，这种方式仍需客服服务和调度器运行，但没有上述总量限制。

明文目录示例：E:\decrypted\账号目录，里面应有 contact/contact.db 和 message/message_*.db，也支持中间带 db_storage 的结构。已有明文库无需密钥；只有加密库时，先到“解密数据库”完成解密。首次获取密钥仍需登录微信。不同账号分别创建任务。

第二步：选择聊天和时间，预览内容

1. 用 全部聊天 / 群聊 / 私聊 筛选，搜索群名、好友昵称、备注或 ID，勾选要处理的聊天；可混合选择群聊和私聊。
2. 填写 目标知识分组，例如“产品售后知识”，用于后续分类管理。
3. 选择最近 7 天、30 天等快捷范围，或填写起止时间。时间按北京时间计算，包含开始时间、不包含结束时间；要包含某天全天，结束时间选次日 00:00。
4. 点击 预览消息范围，查看各聊天消息数量、读取情况、脱敏样本和未解析附件数量。

建议第一次先选少量聊天和最近 7 天，确认结果合适后再扩大范围。

第三步：生成草稿，人工审核后入库

1. 检查预览和当前 AI 服务，勾选 我已了解文本处理范围，开始生成待审核草稿，点击 开始 AI 提炼。
2. 完成后进入 待审核，逐条检查标准问题、答案、关键词和适用范围；用 来源证据 / 查看讨论批次 对照原消息。
3. 选择处理方式：新增知识、排除，不入库，或在有相似知识提示时 明确更新已有知识。更新前核对目标和新旧答案，已有人工答案不会自动覆盖。
4. 修订后勾选 我已核对原消息，点击 保存修改与审核；不需要的条目保存排除决定。
5. 选中已审核条目，点击 确认入库所选条目，每批最多 200 条。保存审核和确认入库是两个步骤，必须完成入库后客服才会使用。
6. 查看新增、更新、重复跳过数量，到 知识库管理 核对结果。入库条目标记为人工校对；当前服务刷新索引，其他服务约一分钟热重载。确保“启用知识库”开关打开。

提炼会把脱敏文本提交给所配置的 AI 服务，并产生模型用量费用。开始前核对样本中的客户名称、地址等内容；图片、语音和文件当前不会自动 OCR 或转文字，需要人工补充。私聊中的专属报价、承诺和个案条件不能直接当作通用规则。模型置信度也不代表答案正确率。

任务中断或结果需要撤回时

• 在 历史任务 → 查看与继续 中继续审核。失败或中断时，可点 重试未完成部分，成功批次不会重复请求模型。
• 停止后续处理会保留已完成结果，当前模型请求可能需等待返回或超时。
• 切换页面不会停止任务；离线模式需保持整个程序运行，退出程序会中断执行，重新打开后可重试。
• 已发布结果需要撤销时，可用 回退本批次；若条目后来又被修改或关联，系统会拒绝回退以保护后续工作。

用 Excel 导入已有问答

日常补充已整理好的知识，使用 Excel 导入：

1. 点击 知识库管理 → Excel 导入 → 下载模板。
2. 打开模板，在“知识条目”工作表填写问答。保留表头和工作表名称，删除或替换不需要的示例行。
3. 问题、答案必填；分组和关键词按需填写，来源推荐填 human（人工校对）。
4. 回到导入窗口，选择填好的 .xlsx 文件。
5. 设置重复问题处理方式：忽略保留原答案，覆盖用表格中的答案更新原条目。重复按“分组 + 问题”判断。
6. 点击 开始导入，查看新增、覆盖、忽略数量及错误行；有错误的行改好后再导入。

单次最多导入 5000 行。导入后约 1 分钟生效，无需重启。

修改已有知识时，在知识库页面搜索问题，点击条目，修订问题、答案或关键词后点 保存修改。保存后标记为人工校对，约一分钟内生效。

“解密数据库”只生成可读的本地数据库，不会自动生成问答；解密完成后可在“聊天提炼知识”中加载并提炼。正常在线回复不需要每次重新解密。更详细的提炼说明见 聊天提炼知识库操作说明。

4. 设置关键字固定回复

进入 关键字回复，打开总开关，点击 新建规则：

1. 选择匹配方式：精确匹配要求整条内容一致；包含匹配只要含该词即可；正则表达式适合熟悉规则的人使用。
2. 填写关键字和回复内容。例如，关键字填“营业时间”，回复填“我们的营业时间为工作日 9:00–18:00。”（示例，请换成自己的业务信息）。
3. 需要发送图片、视频或文件时，填写本机实际存在的素材路径。
4. 确认启用该规则，点击 保存，立即生效。
5. 用页面下方的 匹配测试 输入模拟消息，检查命中规则和回复内容，再用测试微信验证实际发送。

规则从上到下匹配，首条命中生效；较具体的规则放在前面。规则页面也支持 Excel 导入和导出。

5. 启动、测试和停止

1. 回到 控制台，点击右上角 启动服务，确认显示“运行中”。
2. 用另一个微信账号发一条普通文本消息；群测试时，用微信 @ 选择器选中机器人账号，再问一个已有知识或规则能回答的问题。
3. 检查微信是否收到回复，同时查看控制台 运行日志。
4. 暂停使用时，点击 停止。修改需要重启的设置后，点击 重启。

关闭“AI 自动回复”只停用 AI 生成回复，关键字和知识库直答仍可能回复。需要整体暂停时，请停止客服服务。

桌面版关闭窗口通常是收起到托盘，服务可能继续运行；需要完整退出时，使用托盘中的“退出（停止服务）”。

6. 其他功能按需开启

6.1 定时群发：提前安排好要发送的消息

1. 先登录电脑微信，启动客服服务，在 系统设置 → 定时任务 中启用调度器。
2. 进入 定时任务 / 消息群发，点击 新建任务，填写便于识别的任务名称。
3. 选择调度方式：手动触发仅保存，需点击立即执行；定时单次指定一次日期时间；固定间隔循环按设置间隔重复；每天定点按每天的时间执行。
4. 从联系人列表选择群或好友，可按名称搜索。首次使用建议只选一个测试会话，确认接收对象无误。
5. 填写文字，或选择本机存在的图片、视频、文件路径；至少填写一种内容。多种内容按文字、图片、视频、文件顺序发送。
6. 保存任务。先用 立即执行 验证内容，再按需启用定时执行。
7. 在任务列表和运行历史中查看状态、发送结果；需要中止当前批次时使用停止操作。

电脑、微信、客服服务和调度器需要持续运行。发送对象之间会按配置留出间隔，这不代表平台允许无限发送。请按自己的服务场景选择必要的对象和频率。

联系人列表为空时，确认微信和服务均在运行，等待联系人快照更新后刷新。发送图片、视频或文件失败时，检查路径与文件是否存在，并查看运行记录中的错误说明。

6.2 群日报：把一天的讨论整理成回顾

1. 登录微信并启动客服服务，确认 系统设置 → 定时任务 中调度器已启用。需要 AI 话题与内容整理时，先配置 AI 提供商、模型和 API Key。
2. 进入 定时任务 / 群日报，点击 新建任务，填写任务名称。
3. 选择 手动触发、定时单次 或 每天定点，按需要填写执行时间。
4. 选择日报日期：今天、昨天 或 指定日期。「今天」只统计实际执行时已产生的消息；「今天 / 昨天」按实际执行日期计算。
5. 选择需要处理的群，勾选 HTML 网页、PNG 长图 中至少一种格式。
6. 先不勾选发送，保存后点击 立即执行，在 日报产物 中下载检查。PNG 生成失败时，检查是否已有 HTML 产物，并查看运行日志。
7. 确认内容合适后，可在任务中勾选发送 PNG 到对应群；每个群只接收自己的日报。HTML 支持生成和下载，发送能力请以当前发布版界面及测试结果为准。
8. 在任务列表查看上次 / 下次执行时间，在运行记录查看生成、发送和失败情况；详细阶段可到控制台查看日报运行日志。

日报可包含消息与活跃统计；配置有效 AI 服务时，还可整理讨论话题、问答和资源等内容，实际内容取决于当日聊天。AI 未配置或生成失败时，会提示并降级为纯统计版；PNG 渲染失败不代表已生成的 HTML 无效。

AI 日报会将相关聊天文本发送给你配置的模型服务商，按其规则产生费用。请检查处理范围和生成结果，再决定是否发送；定时任务需要运行环境持续在线。

6.3 入群欢迎语：给新成员一份清楚的指引

1. 点击左侧 入群欢迎语，开启 启用入群欢迎语。
2. 编辑 欢迎语模板。可使用 {nickname} 代表新人昵称，{group} 代表群名，例如「欢迎 {nickname} 加入 {group}，请先阅读群公告」。
3. 在 适用群 中选择要使用欢迎语的群；留空表示所有群生效。保存前检查适用范围。
4. 点击 保存配置，配置即时生效，无需重启服务。
5. 可在页面下方填写示例昵称、群名，使用 渲染预览 检查文字。预览不会真实发送。

欢迎语依赖入群系统提示触发，同一人短时间内重复入群会做去重。当前 @ 新人 功能暂时禁用，欢迎语按普通文本发送。在线工作仍需微信登录和客服服务运行。

6.4 退群播报：查看成员变化并设置提醒

1. 点击左侧 退群播报，阅读页面的 工作原理与局限。
2. 开启 启用退群播报，设置 扫描周期（秒） 与 确认缺失次数；首次可保留界面默认值。
3. 编辑 播报文案，可使用 {nickname}、{group} 占位符。
4. 选择 监控群，点击 保存配置。保存后即时生效。
5. 在页面下方查看 运行状态、成员基线和最近播报记录；首次启用需要先扫描建立成员基线。

该功能通过成员快照比对判断离开，不能区分主动退群和被移出，也不能给出精确离开时间。服务离线期间的成员变化可能在恢复后的扫描中被发现。

6.5 防撤回：配置本机会话原消息保留

1. 点击左侧 防撤回，开启 启用原消息保留防撤回。
2. 点击 保存配置，在 生效状态 查看客服服务是否运行，以及配置下发时机。
3. 服务未运行时，启动后会自动下发；运行中保存配置后约 1 秒内下发到当前登录的微信进程。
4. 用测试会话确认原消息保留效果；页面显示指令已下发，不等于所有消息类型都已验证成功。

本功能作用于当前账号所在的本机微信进程，不新增桌面通知，也不显示撤回痕迹提示。图片、文件等媒体的保留效果，以当前微信客户端的实际表现为准。

6.6 数据备份与目录：保存你的配置和知识

1. 先停止客服服务、解密任务，并停止或等待聊天提炼任务完成。
2. 进入 系统设置，滚动至底部的 数据和配置备份，点击 导出备份文件。
3. 恢复时，点击 导入备份文件，选择备份 ZIP，按页面提示核对后恢复。
4. 需要调整存储位置时，使用下方 数据存储目录，选择新的空目录并按提示操作；迁移完成后需退出并重新打开程序。

备份包含知识库、规则、配置、密钥及日志，应妥善保管；授权需按规则单独激活或转移。截图只展示操作入口，不包含真实密钥或真实备份内容。

7. 常见问题

平时最常用的操作就是：登录微信、启动服务、维护答案、查看日志、定期备份。