WxChatBot

一、程序简介

本程序是基于您所提供的两个源代码文件（commands.py 与 main.py）所编译打包的可执行文件。核心功能是通过图形界面（GUI） 来配置并自动监听某个微信会话，随后由内置的 AI 自动回复消息。

本程序适用于在 Windows 系统下使用，能够自动调用微信客户端并实现和个人/群聊的“自动回复” 以及简单的自定义命令等功能。

二、环境与配置

1. 操作系统：Windows 10 及以上版本。
2. 微信环境：请确保电脑上已安装并登录 Windows 微信客户端，并能正常使用。
3. 网络环境：AI 调用依赖网络，请保持网络畅通，并确保您的 OpenAI Key 可用。
4. 初次运行：双击 xxx.exe 文件即可启动程序。启动后会自动打开图形界面。

三、使用方法

1. 基础步骤

以下步骤供您在打开 exe 程序后参考：

• 在图形界面上，找到 OpenAI API Key 输入框，并输入您的有效 Key。
• 可在“共享文件夹路径”处自行指定保存附件/文件的目录路径；若不需要可保持默认。 注意:因开发问题 此功能暂时停用
• 点击 “刷新列表”，等待系统获取您当前微信的会话列表。注意打开并登录你的微信 确保对话框位于桌面
• 在出现的会话列表中多选需要自动监听的目标（如好友、群聊名称）。
• 点击 “开始监听”，程序即可对勾选的目标会话开启自动回复。
• 建议在监听开始后在客户端发送 .help 以获得命令行帮助
• 如需停止监听，重新在列表中选取会话后点击 “停止监听”。或者点击“停止所有监听”以一次性停止。
• 在程序左下方可查看已对话的数量统计及日志信息。
• 注意: 因微信官方未开放端口供用户发送和接受信息 为尽量确保你的账号安全和对其微信用户政策 此程序通过模拟鼠标控制发送消息
• 综上所述 在使用程序监听时你无法正常操作电脑

因此版本程序限制 若服务端微信用户名非 栗大炮 不能使用群聊模式功能 若想使用群聊功能 可更改名字或等待下一版本更新

2. 扩展命令

如果您需要更灵活的操作，可在微信聊天窗口直接输入命令。常用命令示例：

• .addchat：选择要监听的会话并开始自动回复。
• .dchat：停止监听当前会话。
• .qun / .si：切换群聊模式 / 私聊模式。
• .clean：清空当前对话历史。
• .changechat：更换当前监听至其他会话。
• .help：查看所有可用命令以及用法。

3. 退出程序

关闭图形界面窗口即可退出程序，监听线程也会自动停止。若偶有不响应现象，可在任务管理器中结束进程。

点击停止监听时程序会在几秒钟内无相应 因其正在发送消息提示用户停止监听

四、可能遇到的问题与解决方案

• 无法获取到任何微信会话：

  请确认 Windows 微信客户端已打开并成功登录且位于桌面；若依旧无效，可尝试刷新列表或重启本程序。

• OpenAI API Key 无效或请求失败：

  请确认网络畅通并检查 Key 的正确性与可用额度。如果使用频繁，可能需等一段时间后再试。强烈不建议使用deepseek提供的api

• 群聊模式下无法自动回复：

  若您设置了“群聊”模式，但消息里未 @ 机器人名称（@栗大炮），程序不会回应，属正常现象。

• 自动回复消息为空或异常：

  可能是 AI 接口异常或无法生成内容，可适当降低提问难度，或检查 Key 及网络状况。

五、使用条款

1. 程序为闭源软件，仅限内部测试阶段使用，暂不对外开源。
2. 若需对外分发，请先获得授权。请勿擅自扩散或用于任何商业用途。
3. 对于在使用过程中产生的信息数据或聊天记录，本程序默认仅做本地存储。
4. 因本程序尚处于测试阶段，可能存在功能缺陷或操作异常。