goodqunbot

name	goodqunbot
displayName	微信消息助手
description	AI-powered WeChat message assistant. Retrieve recent messages from contacts/groups and send messages directly through AI chat. Windows 10/11 only. Requires WeChat PC client logged in.

微信消息助手 (WeChat Message Assistant)

This skill enables AI to interact with WeChat directly through AI chat, providing two core capabilities: retrieving recent messages and sending messages to contacts or groups.

Platform Requirements

• OS: Windows 10/11 only
• WeChat: WeChat PC client must be installed, running, and logged in
• Python: Python 3.11+ (automatically handled by Goodable)

Core Capabilities

1. Retrieve Recent Messages

Fetch the last 10-15 messages from any WeChat contact or group chat.

What you can ask:

Get the last 15 messages from "张三"
Show me recent messages from "Product Team" group
Retrieve messages from "李四", last 10 only

What AI will do:

• Opens the specified chat in WeChat
• Retrieves the requested number of messages (default: 15, max: 100)
• Returns messages with timestamp, sender, and content
• Formats as structured JSON for easy parsing

2. Send Messages

Send a text message to any WeChat contact or group chat.

What you can ask:

Send "Meeting at 3pm" to "张三"
Message "Product Team" group: "Release notes updated"
Tell "李四": "Please review the document"

What AI will do:

• Opens the specified chat in WeChat
• Sends the message content
• Confirms successful delivery

How to Use

Prerequisites

Before using this skill, ensure:

1. WeChat PC client is running
2. You are logged into your WeChat account
3. The contact/group name you specify exists in your WeChat

Example Usage

Scenario 1: Check messages from a colleague

User: "帮我看一下张三最近给我发了什么消息"
AI: [Runs get_messages.py script]
AI: "张三最近的5条消息：
1. [2024-01-28 10:30] 张三: 会议资料已发送
2. [2024-01-28 11:00] 张三: 请查收
..."

Scenario 2: Send a message

User: "给产品群发个消息：今天下午3点开会"
AI: [Runs send_message.py script]
AI: "消息已成功发送到产品群"

Instructions for AI

When the user requests WeChat message operations:

1. Retrieve Messages

Run the get_messages.py script:

python scripts/get_messages.py "<Contact/Group Name>" [count]

Parameters:

• Contact/Group Name: Exact name as shown in WeChat (required)
• count: Number of recent messages to retrieve (optional, default: 15, max: 100)

Output Format: The script returns JSON with message details:

[
  {
    "time": "2024-01-28 10:30:45",
    "sender": "张三",
    "content": "会议资料已发送",
    "type": "text"
  }
]

IMPORTANT - Output Formatting for User: After successfully retrieving messages, you MUST format them in a clean, readable way. DO NOT show raw JSON to the user.

For 5 or fewer messages - Use a numbered list:

📨 **张三** 的最近消息：

1. [2024-01-28 10:30] 张三: 会议资料已发送
2. [2024-01-28 11:00] 张三: 请查收
3. [2024-01-28 14:30] 你: 好的，已收到

Tips:

• Always include contact/group name in the header
• Keep timestamps concise (remove date if same day)
• Group consecutive messages from same sender when appropriate
• Highlight important information if user asks for summary

Error Handling:

• If WeChat is not running: "WeChat PC client is not running or not logged in"
• If contact not found: "Contact or group 'xxx' not found"
• Parse the error and provide user-friendly explanation in Chinese

2. Send Messages

Run the send_message.py script:

python scripts/send_message.py "<Contact/Group Name>" "<Message Content>"

Parameters:

• Contact/Group Name: Exact name as shown in WeChat (required)
• Message Content: Text message to send (required, cannot be empty)

Output:

• Success: "Message sent successfully to 'xxx'"
• Failure: Error message with details

Important Notes:

• Always enclose contact names and message content in quotes
• Contact names must match exactly as shown in WeChat
• For group chats, use the full group name
• Only text messages are supported (no images/files/emojis)

3. Best Practices

Name Matching:

• Ask user to confirm the exact contact/group name if unsure
• Suggest checking WeChat contact list for correct spelling
• Chinese names are case-sensitive and must match exactly

Error Recovery:

• If "WeChat not found" error: Ask user to start WeChat and log in
• If "Contact not found" error: Ask user to verify the name
• If script fails: Check if Python environment is properly set up

User Experience:

• Summarize retrieved messages in a readable format
• Confirm before sending messages if content seems important
• Provide context about what happened after each operation

Technical Details

Script Locations

skills/goodqunbot/
├── SKILL.md                    # This file
├── scripts/
│   ├── get_messages.py         # Retrieve messages
│   └── send_message.py         # Send messages
└── wxauto_lib/                 # WeChat automation library (pyc bytecode)

Implementation

Both scripts use the wxauto library (RPA-based WeChat automation):

get_messages.py:

• Initializes WeChat instance
• Opens specified chat with wx.ChatWith(who)
• Retrieves all messages with wx.GetAllMessage(savepic=False, savefile=False)
• Returns recent N messages as JSON

send_message.py:

• Initializes WeChat instance
• Sends message with wx.SendMsg(msg=message, who=who, clear=True)
• Returns success/failure status

Limitations

1. Platform: Windows only (wxauto uses Windows API)
2. Message Types: Text only (no images, files, or rich media)
3. Rate Limits: May be subject to WeChat's anti-spam mechanisms
4. Accuracy: Contact name must match exactly (case-sensitive)
5. State Dependency: Requires WeChat PC client to be running and logged in

Troubleshooting

Issue	Solution
"WeChat window not found"	Start WeChat PC client and log in
"Contact not found"	Verify exact contact/group name in WeChat
Script timeout	Check if WeChat is responding, restart if frozen
Import error	Ensure wxauto_lib directory exists in goodqunbot
Permission error	Run with appropriate user permissions on Windows

Privacy & Security

• Local Only: All operations are local, no data sent to external servers
• Read-Only Access: get_messages.py only reads, doesn't modify chat history
• User Control: send_message.py only sends when explicitly requested
• No Logging: Messages are not stored or logged by the scripts
• Compliance: Use responsibly and comply with WeChat Terms of Service

Related Features

This skill complements the GoodQunBot App (template.json), which provides:

• Web UI for browsing all groups
• AI-powered chat summaries
• Data visualization (activity charts, word clouds)
• Member management and business opportunity discovery

Skill vs App:

• Skill Mode: Quick AI-driven message operations in chat
• App Mode: Full-featured web interface for comprehensive chat management
• Both modes share the same wxauto library and work independently