用户操作手册

详细的功能说明和操作指导，涵盖所有功能模块

v2.0.0

更新时间：2025年1月

目录

概述

WXAUTO-MGT是一款智能微信消息管理工具，支持多AI平台集成和自动回复功能。

主要功能
  • 多微信实例管理
  • AI平台集成（OpenAI、Dify、Coze等）
  • 智能消息路由
  • Web远程管理
  • 移动端支持
系统要求
  • Windows 10/11 操作系统
  • 微信PC版已安装
  • 网络连接正常
  • 至少一个AI平台账号
快速开始：如果您是新用户，建议先阅读快速入门指南，5分钟即可完成基础配置。

实例初始化

配置微信实例，建立与微信API的连接。

启动软件

双击运行 WXAUTO管理工具.exe，等待主界面加载完成。软件会自动创建必要的配置文件和数据库。

添加微信实例

在"实例管理"选项卡中，点击"添加实例"按钮，填写以下信息：

实例名称：主微信（便于识别的名称）
API地址：http://localhost:5000
轮询间隔：5秒（建议5-10秒）
消息超时：30分钟
启用实例：✓ 勾选
启动微信API服务

点击工具栏"启动本地API客户端"按钮，启动 wxauto_http_api.exe 程序。确保微信PC版已登录。

验证连接

实例卡片显示绿色表示连接成功，红色表示连接失败。如果连接失败，请检查API服务是否正常运行。

添加服务平台

配置AI服务平台，实现智能自动回复功能。

提示：选择实例后，在中间区域点击"添加平台"按钮开始配置。每个实例可以配置多个服务平台。
Dify服务平台

企业级AI应用平台，支持工作流和知识库。

配置参数：
平台名称：Dify智能助手
平台类型：Dify
API Base URL：https://api.dify.ai/v1
API密钥：app-xxxxxxxxxxxxxxxx
对话ID：（可选，留空自动创建）
用户ID：default_user
注意：API密钥格式通常以 app- 开头，请确保从Dify控制台获取正确的密钥。
OpenAI兼容平台

支持ChatGPT、GPT-4等模型，以及其他OpenAI兼容的API。

配置参数：
平台名称：ChatGPT助手
平台类型：OpenAI
API Base URL：https://api.openai.com/v1
API密钥：sk-xxxxxxxxxxxxxxxx
模型名称：gpt-3.5-turbo
Temperature：0.7（0.0-2.0）
最大Token数：1000
系统提示词：你是一个有用的助手。
参数说明：
  • Temperature：控制回复随机性
  • Max Tokens：限制回复长度
  • 系统提示词：定义AI角色
推荐模型：
  • gpt-3.5-turbo：性价比高
  • gpt-4：质量更好
  • gpt-4-turbo：速度更快
扣子(Coze)服务平台

字节跳动AI平台，支持工作空间和智能体管理。

配置步骤：
输入API密钥

API密钥格式：pat_xxxxxxxxxxxxxxxx

选择工作空间

点击"刷新工作空间"按钮，从下拉列表中选择工作空间。

选择智能体

点击"刷新智能体"按钮，选择要使用的智能体。

可选设置

勾选"启用连续对话"以保持对话上下文。

关键词匹配服务平台

本地智能回复，无需API，支持多种匹配模式。

配置规则：
设置回复时间

配置最小和最大回复延时，模拟真人回复。

添加关键词规则
关键词：你好,hi,hello（逗号分隔）
匹配类型：包含匹配
回复内容：您好！有什么可以帮助您的吗？
随机回复：✓ 勾选
回复时间：1-3秒
匹配类型：
  • 完全匹配：消息完全等于关键词
  • 包含匹配：消息包含关键词
  • 模糊匹配：支持相似度匹配
使用技巧：
  • 多个关键词用逗号分隔
  • 多条回复用换行分隔
  • 启用随机回复增加真实感
只为记账服务平台

智能记账助手，自动识别和记录账单信息。

配置参数：
平台名称：记账助手
平台类型：只为记账
服务器地址：https://app.zhiweijz.cn
用户名：[email protected]
密码：your_password
自动登录：✓ 勾选
无关消息警告：✓ 勾选
获取账本

点击"获取账本"按钮，系统会自动登录并获取可用账本列表。

选择账本

从下拉列表中选择要使用的账本。

消息转发规则

配置智能消息路由规则，实现精确的消息转发控制。

添加转发规则

在右侧"消息转发规则配置"面板中，点击"添加规则"按钮。

配置规则参数
规则名称：AI助手规则
微信实例：主微信
聊天对象：*（所有聊天对象）
服务平台：ChatGPT助手
优先级：10
仅处理@消息：□ 不勾选
启用规则：✓ 勾选
聊天对象匹配规则
通配符匹配：
  • * - 匹配所有聊天对象
  • 工作群* - 匹配以"工作群"开头的群聊
  • *客服 - 匹配以"客服"结尾的聊天
精确匹配：
  • 技术交流群 - 匹配指定群聊
  • 张三 - 匹配指定好友
  • 客服小王 - 匹配指定联系人
优先级设置

数字越小优先级越高，建议按以下方式设置：

0-10：重要业务规则（如客服群、工作群）
11-50：常规聊天规则（如朋友群、同事）
51-100：通用回复规则（如所有聊天对象）
最佳实践：为不同类型的聊天对象配置不同的AI平台和规则，实现个性化的自动回复体验。

Web控制台

通过Web界面远程管理和监控系统状态。

启动Web服务

在主界面工具栏中，点击"启动服务"按钮。默认端口为8443，可在Web管理选项卡中修改。

访问Web界面

点击"打开界面"按钮，系统会自动在浏览器中打开Web管理界面。

默认访问地址：http://127.0.0.1:8080
Web界面功能
主要页面：
  • 首页：系统状态概览
  • 实例管理：微信实例管理
  • 服务平台：AI平台配置
  • 转发规则：规则管理
  • 消息监控：实时消息流
功能特性：
  • 实时数据更新
  • 响应式设计
  • 移动端适配
  • 操作日志查看
  • 系统状态监控

移动端访问

在手机或平板上访问Web控制台，随时随地管理系统。

获取访问地址

在主界面Web服务控制区域查看IP地址和端口号。

示例地址：http://192.168.1.100:8080
网络要求

确保移动设备与运行软件的电脑在同一局域网内。

移动端功能
  • 查看实例状态
  • 监控消息处理
  • 查看系统日志
  • 基本配置管理
安全提示：建议在可信网络环境下使用，避免在公共网络中暴露管理界面。

监听对象管理

管理固定监听对象，监控特定聊天的消息活动。

添加监听对象

在"消息监听"选项卡中，点击"添加监听对象"按钮，选择实例和聊天对象。

监听状态说明
活跃

最近有消息活动

空闲

一段时间无消息

超时

长时间无消息

管理操作
  • 删除监听对象：点击操作列的"删除"按钮
  • 查看详情：点击对象名称查看详细信息
  • 重新初始化：对于超时的对象，删除后重新添加

高级功能

提升使用体验的高级设置和技巧。

配置导入导出
  • 导出配置：文件 → 导出配置
  • 导入配置：文件 → 导入配置
  • 支持完整的系统配置备份
日志管理
  • 实时日志查看
  • 不同级别日志区分
  • 日志文件自动轮转
性能优化
  • 合理设置轮询间隔
  • 限制监听对象数量
  • 定期清理日志文件
安全设置
  • API密钥加密存储
  • Web服务访问控制
  • 定期更换API密钥

故障排除

常见问题的诊断和解决方法。

连接问题
检查网络连接

确保能正常访问AI平台API

验证API密钥

确认密钥格式正确且未过期

检查防火墙

确保程序能正常访问网络

消息处理问题
检查规则配置

确认规则已启用且匹配正确

查看处理日志

通过日志定位具体问题

测试平台连接

使用测试连接功能验证平台状态

常见问题

用户经常遇到的问题和解决方案。

Q1: 实例连接失败怎么办？

A1: 请按以下步骤排查：

  1. 检查API地址格式是否正确（如：http://localhost:5000）
  2. 确认微信API服务（如wxauto_http_api.exe）是否正常运行
  3. 检查网络连接是否正常
  4. 验证API密钥是否正确（如果需要）
  5. 查看日志获取详细错误信息
Q2: 服务平台测试连接失败？

A2: 请检查以下项目：

  1. API密钥：确认密钥格式正确且未过期
  2. API地址：确认地址可访问且格式正确
  3. 网络连接：检查是否能正常访问外网
  4. 平台服务：确认第三方平台服务正常
  5. 账户状态：检查API账户余额和权限
Q3: 消息转发不生效？

A3: 请按以下步骤检查：

  1. 规则状态：确认转发规则已启用
  2. 聊天对象匹配：检查聊天对象名称是否完全匹配
  3. 服务平台状态：确认关联的服务平台工作正常
  4. 规则优先级：检查是否有更高优先级的规则覆盖
  5. @消息设置：确认@消息处理设置符合预期
  6. 实例状态：确认微信实例连接正常
Q4: Web控制台无法访问？

A4: 请检查以下设置：

  1. 服务状态：确认Web服务已启动（工具栏显示"停止服务"）
  2. 端口占用：检查8443端口是否被其他程序占用
  3. 防火墙设置：确认防火墙允许程序通过
  4. IP地址：确认使用正确的IP地址访问
  5. 浏览器兼容性：尝试使用不同浏览器访问
Q5: 如何提高回复质量？

A5: 以下建议可以提高AI回复质量：

  1. 优化系统提示词：详细描述AI的角色和回复风格
  2. 选择合适的模型：GPT-4质量更好，GPT-3.5性价比高
  3. 调整Temperature：降低值获得更稳定的回复
  4. 设置合理的Token限制：避免回复过长或过短
  5. 使用多平台策略：不同场景使用不同的AI平台

技术支持

获取帮助和支持的方式。

文档资源

查看完整的用户手册和API文档

快速入门
社区支持

加入用户交流群，与其他用户交流经验

技术支持

联系技术支持团队获取专业帮助

获取帮助
提交问题时请提供：软件版本、操作系统信息、详细的错误描述和相关日志信息，以便我们更好地帮助您解决问题。