好友和群的管理操作有不少共性——都要按对象 ID 定位、都可能批量、都要控制频率。与其每个操作写一遍不如做一个统一的管理客户端把共性收口。这篇讲常见操作和这个收口怎么设计。一、常见操作清单好友侧查列表、查详情、改备注、打标签。群侧建群、拉人、踢人、查成员、改群名、发公告。这些操作的共同点是按对象 ID 定位——好友是 wxid群是群 ID。参数差异主要在操作类型和附加字段上。二、统一收口按操作类型路由把操作做成操作类型 目标 ID 附加参数的调用形式客户端内部按操作类型路由到对应路径。这样业务侧不用记一堆路径调用形式统一也方便在一处加日志和频率控制。后面加新操作只往映射表里加一行。三、批量操作分批与结果确认批量操作批量拉人、批量打标签要分批每批之间留间隔。批量失败时不能只看到整体失败要拿到逐条结果——哪几个成功、哪几个失败。分批的意义在于失败可控一批失败了只重试这一批不用整体重来。管理操作对照操作类别定位键批量支持注意点好友查询wxid列表分页游标要保存好友更新wxid单条为主长度限制群成员管理群 ID支持批量分批留间隔群信息维护群 ID单条长度限制统一管理客户端实现import time class ManageClient: API_PATH { friend.list: /friend/list, friend.remark: /friend/update, group.create: /group/create, group.add: /group/add, group.notice: /group/notice, } def __init__(self, api, token): self.api api self.token token def operate(self, action, target_id, **params): # 统一入口按操作类型路由到对应路径 path self.API_PATH.get(action) if path is None: raise ValueError(f未知操作: {action}) payload {target: target_id} payload.update(params) return self.api.post(path, payload, tokenself.token) def batch_add(self, group_id, wxids, size5): # 批量操作分批执行逐批确认结果 results [] for i in range(0, len(wxids), size): chunk wxids[i:i size] resp self.operate(group.add, group_id, memberschunk) results.append({ chunk: chunk, ok: resp.get(code) 0, detail: resp.get(data, {}), }) time.sleep(3) # 分批间隔降低频率风险 return results落地建议管理操作统一收口到一个客户端业务侧按类型加目标 ID 调用不用记路径。批量操作要分批并留间隔把逐条结果返回别只报整体成败。失败的批次单独重试不整体重来。查询类注意游标持久化更新类注意长度限制。微信侧的好友与群管理接口由Eyun这类个人微信API平台 提供操作编排与批量控制策略在自建服务实现具体字段以平台开发文档为准。