# Wechat Message

> 此技能用于在 macOS/Windows 上通过脚本自动化发送微信消息。当用户需要"发送微信消息"、"给微信好友发消息"、"微信自动发送"、"微信群里发消息"、或提到"wechat message"、"微信自动化"时使用此技能。macOS 使用 AppleScript + cliclick，Windows 使用 PowerShell，按平台选用对应脚本。

- Skill: `tiancheng91/wechat-message` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add tiancheng91/wechat-message`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tiancheng91/wechat-message/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tiancheng91 (https://skillmd.com/u/tiancheng91)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tiancheng91/wechat-message

---


# 微信消息发送技能

此技能通过平台脚本实现微信消息的自动化发送：**macOS 使用 AppleScript + cliclick**，**Windows 使用 PowerShell**。按当前操作系统选用对应脚本即可。

## 功能概述

- 自动激活微信应用
- 搜索指定联系人或群组
- 发送指定消息内容
- 发送本地图片文件（指定路径）
- 支持中文和特殊字符

## 使用方法

### macOS（AppleScript）

```bash
osascript scripts/wechat_automation_script.applescript "<联系人名称>" "<消息内容>" "[图片路径]"
```

### Windows（PowerShell）

```powershell
powershell -ExecutionPolicy Bypass -File scripts/wechat_automation_script.ps1 "<联系人名称>" "<消息内容>" "[图片路径]"
```

### 参数说明

| 参数 | 必填 | 说明 |
|------|------|------|
| 联系人名称 | 是 | 微信联系人名称或群名称，需完全匹配 |
| 消息内容 | 否* | 要发送的消息文本；与图片至少填一项 |
| 图片路径/URL | 否* | 本地图片路径或 `http(s)://` 图片地址；与消息至少填一项 |

\* 消息与图片可同时提供：先发送文本，再发送图片。

### 使用示例

**macOS：**
```bash
osascript scripts/wechat_automation_script.applescript "张三" "你好，今天有空吗？"
osascript scripts/wechat_automation_script.applescript "工作群" "大家好！"
osascript scripts/wechat_automation_script.applescript "张三" "" "/Users/me/screenshot.png"
osascript scripts/wechat_automation_script.applescript "张三" "请看截图" "/Users/me/screenshot.png"
osascript scripts/wechat_automation_script.applescript "张三" "" "https://example.com/image.png"
```

**Windows：**
```powershell
powershell -ExecutionPolicy Bypass -File scripts/wechat_automation_script.ps1 "张三" "你好，今天有空吗？"
powershell -ExecutionPolicy Bypass -File scripts/wechat_automation_script.ps1 "工作群" "大家好！"
powershell -ExecutionPolicy Bypass -File scripts/wechat_automation_script.ps1 "张三" "" "C:\Users\me\screenshot.png"
```

## 工作流程

两平台流程一致，仅快捷键不同：

1. **激活微信** - 将微信窗口置于最前
2. **打开搜索** - macOS：`Cmd+F` / Windows：`Ctrl+F`
3. **搜索联系人** - 粘贴联系人名并选择第一个匹配结果（Ctrl+V / Cmd+V）
4. **定位输入框** - macOS：cliclick 点击窗口右下角 / Windows：Tab 键定位
5. **发送内容** - 粘贴文本和/或图片（剪贴板）并按回车发送
6. **收尾** - macOS：`Cmd+H` 隐藏窗口 / Windows：最小化窗口

## 注意事项

- **微信必须已登录** - 执行前确保微信已打开并登录
- **联系人名称需精确匹配** - 搜索时会选择第一个匹配结果
- **执行时间约 15 秒** - 脚本包含多个延时，执行期间勿操作微信
- **macOS**：需要安装 cliclick 并授予 **辅助功能** 权限
- **Windows**：若提示无法执行脚本，请使用 `-ExecutionPolicy Bypass`；若在微信内修改过「搜索」快捷键，需在 `.ps1` 中把 `^f` 改为对应快捷键

## 权限配置

### macOS

#### 1. 安装 cliclick

使用 Homebrew 安装：

```bash
brew install cliclick
```

#### 2. 授予辅助功能权限

1. **系统设置** → **隐私与安全性** → **辅助功能**
2. 将 **终端**（或 iTerm、Cursor 等）加入列表并勾选
3. 如有 **System Events**，建议一并勾选

### Windows

无需额外权限；首次运行若受限，使用 `-ExecutionPolicy Bypass` 执行脚本即可。

## 故障排除

| 问题 | 可能原因 | 解决方案 |
|------|----------|----------|
| 消息未发送 | 焦点未在输入框 | 执行期间勿切换窗口，可重试 |
| 不能获得 window 1 / 无效索引 | 微信被 Cmd+H 隐藏或最小化 | 脚本会先 `activate`，再 `open -a WeChat` 恢复一次；仍失败请手动打开微信 |
| 搜索不到联系人 | 名称不匹配 | 确认联系人/群名与微信中完全一致 |
| macOS 脚本无反应 | 未给辅助功能权限 | 在「辅助功能」中勾选终端等应用 |
| macOS 鼠标点击无效 | cliclick 未安装或权限不足 | `brew install cliclick` 并授予辅助功能权限 |
| Windows 无法执行脚本 | 执行策略限制 | 使用 `-ExecutionPolicy Bypass` |
| 发送中文乱码 | 编码问题 | 终端使用 UTF-8 编码 |

## 文件结构

```
wechat-message/
├── SKILL.md                                    # 本技能说明
├── README.md                                   # 使用说明
├── examples/
│   └── sample.md                               # 使用示例
└── scripts/
    ├── wechat_automation_script.applescript    # macOS 脚本
    └── wechat_automation_script.ps1            # Windows 脚本
```