前言¶
在自动化工作流中，需要通过微信收发消息时，直接在代码里集成微信 API 存在账号风控风险，且需要维护登录态和组件环境。SkillHub 提供的「微信消息收发推送」Skill 把这一套逻辑封装成可配置的组件，通过参数传入配置，执行完成后销毁资源，降低开发成本和运维复杂度。
是什么¶
「微信消息收发推送」是 SkillHub 上的一个 Skill，由社区用户 user_0eb10066 发布，版本 1.0.0。它基于 .NET Framework 在 Windows 系统下运行，通过 UIA（UI Automation）捕获微信组件，实现消息收发功能。Skill 支持多种执行类型，入参可区分全局配置与业务参数，输出标准化 JSON 结果。
核心功能¶
消息分发架构¶
Skill 内部通过 Kafka 消费消息，主程序进行分发，支持以下消息类型：
- 进件消息
- 群发消息
- 附件消息
- 问答消息
问答消息会进行类型判断：文字问答和语音问答。语音问答需要先通过 Dify 语音转文字，再进入统一处理逻辑。
统一处理逻辑¶
所有消息共用统一的处理流程，按顺序执行以下步骤：
- 非法内容判断
- 群名判断
- 重复判断
- 模拟发送
- 失败重试
- 日志记录
- 消息回复（有回复逻辑）
资源管理¶
所有 Kafka 集群、Topic、OpenAI 密钥等配置通过任务入参传入。每次运行时临时创建 Kafka 连接，投递业务消息后销毁资源，避免长期占用连接。
执行类型¶
Skill 支持三种执行类型，通过入参区分全局配置与业务参数。执行完成后返回标准化的 JSON 结果。
安装与启用¶
Skill 已发布在 SkillHub，可以通过以下命令安装：
# SkillHub CLI 安装命令（假设格式）
skill install user_0eb10066/wxskill
安装后，在 SkillHub 的任务配置中引用该 Skill，并在任务入参中传入所需配置。
典型用法¶
基本配置¶
任务入参需要包含以下信息：
- Kafka 集群地址和 Topic
- OpenAI 密钥（用于语音转文字等能力）
- 执行类型（区分全局配置与业务参数）
- 目标好友/群聊信息
- 消息内容
消息发送示例¶
通过入参传递消息内容，Skill 会按照统一处理逻辑执行发送。对于批量群发，需要遵守行为约束：禁止短时间批量群发相同内容，单次批量发送必须加随机 2~5 秒间隔；禁止固定周期、机械规律操作，需模拟人类随机点击偏移、打字延迟。
问答消息处理¶
对于问答消息，Skill 会先判断是文字还是语音。如果是语音，会调用 Dify 语音转文字接口，得到文本后再进入统一处理逻辑进行回复。
适用场景与注意¶
运行环境¶
- 必须在 Windows 相关系统下运行，因为需要捕获微信组件
- 依赖 .NET Framework
- 自动化普通权限即可，部分 UIA 空间需要管理员权限
账号风控¶
账号风控是使用该 Skill 时需要重点关注的限制：
- 账号基础状态：账号已实名认证、绑定银行卡；新号、长期沉睡号、历史处罚号极易触发自动化风控
- 接收对象校验前置：目标好友/群聊真实存在、未拉黑、未删除；群聊未全员禁言、未限制外来消息
- 行为约束前置：
- 禁止短时间批量群发相同内容
- 单次批量发送必须加随机 2~5 秒间隔
- 禁止固定周期、机械规律操作，需模拟人类随机点击偏移、打字延迟
- 不能搭配批量加好友、自动抢红包等高风险功能同时运行
版本信息¶
当前版本为 1.0.0，来源为社区，分类为 ai-agent。
结尾¶
「微信消息收发推送」Skill 提供了一套结构化的消息收发方案，通过入参配置和标准化输出，降低了微信自动化的开发难度。使用时需注意 Windows 运行环境、.NET Framework 依赖以及账号风控限制。官方地址：https://api.skillhub.cn/user_0eb10066/wxskill
