ItChat项目实战：Python微信机器人开发进阶指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00702/article/details/148361090

ItChat项目实战：Python微信机器人开发进阶指南

ItChat littlecodersh/ItChat: ItChat 是一个强大的Python微信个人号API库，支持发送消息、接收消息、群聊管理等多种微信个人号操作，常用于微信机器人开发或者微信自动化任务处理。项目地址: https://gitcode.com/gh_mirrors/it/ItChat

前言

微信作为国内最流行的即时通讯工具，其API的开放程度一直备受开发者关注。本文将基于ItChat这个优秀的Python微信接口库，深入讲解如何实现微信机器人的进阶功能开发。

开发环境准备

在开始之前，请确保您的开发环境满足以下要求：

操作系统：Windows/Linux/macOS均可
Python版本：2.7或3.5+
微信版本：6.3.25或更高
必要库：ItChat、NetEaseMusicApi(可选)

安装ItChat库非常简单，只需执行：

pip install itchat

项目一：微信远程控制音乐播放器

功能设计

我们将实现一个可以通过微信远程控制的音乐播放器，主要功能包括：

发送"帮助"获取使用说明
发送"关闭"停止音乐播放
发送歌曲名称进行搜索和播放

核心技术实现

音乐控制部分

import os
from NetEaseMusicApi import interact_select_song

# 创建空文件用于停止音乐
with open('stop.mp3', 'w') as f: pass

def close_music():
    os.startfile('stop.mp3')  # Windows系统
    # macOS系统可使用：os.system('killall afplay')

微信交互部分

import itchat

HELP_MSG = u'''欢迎使用微信音乐播放器
发送"帮助"：显示本帮助
发送"关闭"：停止播放音乐
发送歌曲名：搜索并播放音乐'''

@itchat.msg_register(itchat.content.TEXT)
def music_player(msg):
    if msg['ToUserName'] != 'filehelper': return
    
    if msg['Text'] == u'关闭':
        close_music()
        itchat.send(u'音乐已关闭', 'filehelper')
    elif msg['Text'] == u'帮助':
        itchat.send(HELP_MSG, 'filehelper')
    else:
        try:
            song_info = interact_select_song(msg['Text'])
            itchat.send(song_info, 'filehelper')
        except Exception as e:
            itchat.send(u'歌曲搜索失败：'+str(e), 'filehelper')

itchat.auto_login(hotReload=True)
itchat.send(HELP_MSG, 'filehelper')
itchat.run()

技术要点解析

使用文件传输助手作为交互界面，避免影响正常聊天
auto_login的hotReload参数可实现热重载，避免频繁扫码
网易云音乐API提供了丰富的音乐搜索功能

项目二：智能消息助手

功能设计

传统消息功能缺乏个性化，我们将实现：

带昵称的个性化消息
针对特定分组的定向消息

基础消息实现

import itchat
import time

itchat.auto_login()

# 简单消息示例
friends = itchat.get_friends(update=True)[1:]  # 排除自己
for friend in friends:
    nickname = friend['DisplayName'] or friend['NickName']
    message = f"亲爱的{nickname}，祝您新年快乐！"
    itchat.send(message, friend['UserName'])
    time.sleep(0.5)  # 避免发送频率过高

分组消息实现

# 创建或获取特定群组
group_name = "VIP客户"
groups = itchat.search_chatrooms(name=group_name)
if not groups:
    print(f"未找到群组：{group_name}")
else:
    group = itchat.update_chatroom(groups[0]['UserName'])
    for member in group['MemberList']:
        friend = itchat.search_friends(userName=member['UserName'])
        if friend:
            nickname = friend['DisplayName'] or friend['NickName']
            message = f"尊敬的VIP客户{nickname}，专属优惠等您来！"
            itchat.send(message, friend['UserName'])
            time.sleep(0.5)

技术要点解析

get_friends获取好友列表时，第一个元素是自己
update_chatroom用于更新群成员信息
适当的延时可避免触发微信的频率限制

项目三：好友关系检测

功能设计

检测好友是否删除或拉黑自己，通过以下方式实现：

尝试将好友拉入临时群聊
根据返回状态判断好友关系
立即解散群聊避免被发现

核心实现代码

def check_friend_status(friend):
    # 创建临时群聊
    chatroom = itchat.create_chatroom([friend])
    if not chatroom['BaseResponse']['ErrMsg']:
        status = chatroom['MemberList'][0]['MemberStatus']
        # 立即解散群聊
        itchat.delete_member_from_chatroom(chatroom['UserName'], [friend])
        
        status_map = {
            3: "该好友已将你加入黑名单",
            4: "该好友已将你删除",
        }
        return status_map.get(status, "你们仍是好友关系")
    return "检测失败"

# 通过名片消息触发检测
@itchat.msg_register(itchat.content.CARD)
def on_receive_card(msg):
    if msg['ToUserName'] == 'filehelper':
        status = check_friend_status(msg['RecommendInfo'])
        itchat.send(status, 'filehelper')

itchat.auto_login(True)
itchat.run()