Skip to content

v0.2.0

Choose a tag to compare

@claw-codes claw-codes released this 10 Apr 17:07
· 1 commit to main since this release

本版本新增群聊监听与 AI 自动回复能力,并增强微信隐藏到系统托盘后的恢复稳定性。

在此感谢 @yeafel666 愿意一起完善这个项目,为了修复一个问题积极的交流,用午休时间来完善项目,让我不知道如何感谢了,这又是一次让我体会到社区的魅力,真的会有人无私奉献来一起搞项目的,感动!

新增

  • 新增多群聊消息监听能力,支持为多个群打开独立聊天窗口并持续监听新消息。
  • 新增 WeChatClient.listen_groups(),可通过回调函数消费监听到的群聊消息。
  • 新增 WeChatClient.auto_reply_groups(),支持监听后自动回复群消息。
  • 新增 MessageEvent 和 WeChatGroupListener,封装群名、消息内容、群昵称、是否 @ 当前账号等监听事件信息。
  • 新增发送队列,自动回复时串行发送消息,避免多个群同时回复导致窗口焦点抢占。
  • 新增本库发送消息的回流忽略机制,降低机器人监听到自己回复后重复触发的风险。
  • 新增群昵称读取能力 group_manager.get_group_nickname(),用于判断群消息是否 @ 当前账号。
  • 新增通用 AI 模块 AIClient、AIConfig、AIResponder,支持 OpenAI 兼容接口、Responses API、Anthropic 风格接口和自定义回复回调。
  • 新增 AI 自动回复示例和自定义 AI 接入示例,方便接入第三方模型或企业内部 AI 服务。

优化

  • 多群监听采用单调度器分片轮询,减少多个窗口同时监听时的无效扫描。
  • 群聊监听初始化流程优化为“搜索群聊、读取群昵称、打开独立窗口”逐个完成,减少重复搜索。
  • AI 自动回复默认推荐 reply_on_at=True,普通消息只监听,只有被 @ 时才触发回复。
  • 微信隐藏到托盘后的恢复逻辑优先使用原生托盘消息,不再依赖窗口强制显示,避免出现黑窗口。

修复

  • 修复微信隐藏到系统托盘后无法正常唤出的问题。
  • 修复部分环境下通过 Win32 强制显示窗口会出现黑屏但 UI 仍可拖动的问题。
  • 修复系统任务栏隐藏或第三方 Dock 场景下依赖 UIA 托盘点击不稳定的问题。

文档

  • 更新 README 功能列表,补充多群监听、@ 触发 AI 自动回复、群昵称读取和自定义 AI 接入说明。
  • 更新 wx4-skill 文档,使 Claude Code / OpenClaw 能正确理解群聊监听与 AI 自动回复用法。
  • 更新示例文档和官网版本信息。